clawdsolana SolanaOS — The Solana Computer
Autonomous operator runtime for Solana trading, research, wallets, and hardware control.
Repo: github.com/x402agent/SolanaOS Hub: seeker.solanaos.net Souls: souls.solanaos.net Docs: go.solanaos.net
Install
npx solanaos-cli install
# or
git clone https://github.com/x402agent/SolanaOS.git && cd solanaos && make build
After install: solanaos daemon starts everything.
Solana Blockchain Queries
SolanaOS uses SolanaTracker RPC + Datastream for real-time data. No Python script needed — queries are built into the Go binary.
Wallet & Balance
solanaos solana wallet # agent wallet address + SOL balance
solanaos solana balance <pubkey> # any wallet balance
solanaos solana health # RPC health check
Token Research
solanaos solana research <mint> # deep research: price, holders, liquidity, chart
solanaos solana trending # trending tokens from SolanaTracker
Via Telegram: /wallet, /trending, /research <mint>
On-Chain Registry
solanaos solana register # register agent on-chain (devnet NFT)
solanaos solana registry # view registered agents
Trading — OODA Loop
The OODA loop (Observe → Orient → Decide → Act) runs autonomously:
solanaos ooda --sim # paper trading (simulated)
solanaos ooda --live # live trading (real SOL)
solanaos ooda --interval 30 # custom interval in seconds
Multi-Venue Strategy
Three venues with one shared risk engine:
| Venue | Use case |
|---|---|
| Solana Spot | Pump.fun launches, meme rotations, breakout continuation |
| Hyperliquid Perps | Liquid directional expression, funding dislocations |
| Aster Perps | Solana-native perp exposure, shared wallet context |
Key Strategy Parameters
# Via Telegram /set command:
/set rsi_period 14
/set stop_loss 7
/set take_profit 25
/set position_size 10
| Parameter | Default | Range |
|---|---|---|
rsi_period |
14 | 5–30 |
rsi_overbought |
72 | 60–90 |
rsi_oversold |
28 | 10–40 |
ema_fast |
9 | 3–20 |
ema_slow |
21 | 10–100 |
stop_loss |
7% | 1–50% |
take_profit |
25% | 1–500% |
position_size |
10% | 1–50% |
Confidence Model
Trades scored 0.00–1.00: trend structure (0.25), momentum (0.20), liquidity (0.20), participation (0.15), execution risk (0.20). Entry requires ≥0.60 confidence.
Drawdown Cascade
| Drawdown | Action |
|---|---|
| 5% | Reduce weakest exposure, block high-risk entries |
| 8% | Close all perps, spot-only mode |
| 12% | Full halt until review |
Gateway & Seeker
solanaos gateway start # start gateway API (port 18790)
solanaos gateway setup-code # print QR for Seeker pairing
Pair at seeker.solanaos.net/dashboard or scan the QR code with the Android app.
Telegram Bot
Auto-registers commands on daemon start. Key commands:
| Command | What |
|---|---|
/status |
Full agent status |
/wallet |
Address + SOL balance |
/trending |
Trending tokens |
/ooda |
Trigger OODA cycle |
/strategy |
Show parameters |
/memory |
Honcho peer card + facts |
/recall <query> |
AI memory retrieval |
/miner |
BitAxe fleet status |
Memory — Honcho v3
Three memory layers:
- Local Vault (
~/.solanaos/memory/) — decisions, lessons, trades, research - Honcho v3 — cross-session dialectic memory with user modeling
- Convex — cloud persistence for Hub + Android sync
# Telegram commands:
/memory # show peer card + known facts
/recall <query> # AI-powered memory retrieval
/remember <fact> # save durable fact
/honcho_status # bridge config
BitAxe Mining (MawdAxe)
# In .env:
BITAXE_HOST=192.168.1.42
BITAXE_ENABLED=true
Fleet dashboard: seeker.solanaos.net/mining
Chrome Extension
Load chrome-extension/ folder unpacked in chrome://extensions. Tabs: Wallet, Seeker, Miner, Chat, Tools.
Minimum .env
SOLANA_TRACKER_API_KEY=your-key
OPENROUTER_API_KEY=sk-or-v1-...
TELEGRAM_BOT_TOKEN=your-token
TELEGRAM_ID=your-chat-id
HONCHO_ENABLED=true
HONCHO_API_KEY=hch-v3-...
Hub Pages
| Page | URL |
|---|---|
| Launch | solanaos.net |
| Dashboard | seeker.solanaos.net/dashboard |
| Mining | seeker.solanaos.net/mining |
| Strategy Builder | seeker.solanaos.net/strategy |
| Skill Creator | seeker.solanaos.net/create |
| Skills | seeker.solanaos.net/skills |
| Souls | souls.solanaos.net |
Setup Guides
| Guide | URL |
|---|---|
| Gateway | /setup/gateway |
| Telegram | /setup/telegram |
| Metaplex Agent | /setup/metaplex |
| BitAxe Mining | /setup/mining |
| Chrome Extension | /setup/extension |
SolanaOS · Built by SolanaOS Labs · MIT License · Powered by Go · Built on Solana