| name | solana-clawd |
| description | solana-clawd — an open-source Solana AI agent framework built from Clawd Code's leaked agentic engine and the SolanaOS operator runtime. TypeScript MCP server for Clawd Desktop, Cursor, VS Code, or headless node. 31+ tools for Solana trading, on-chain intelligence, wallet management, Pump.fun scanning, MawdBot trading agents, Honcho v3 memory, Privy agentic wallets, and multi-venue perp execution (Hyperliquid + Aster). Use when asked about Solana trading, memecoin analysis, Pump.fun launches, MawdBot operations, OODA loops, wallet management, token research, agentic wallets, or any SolanaOS/solana-clawd surface.
|
| license | MIT |
| metadata | {"solana-clawd":{"version":"1.0.0","author":"8BIT Labs / x402agent","category":"solana-crypto","venues":["solana-spot","hyperliquid","aster"],"requires_bins":["node","npm"],"requires_env":["HELIUS_API_KEY"]}} |
solana-clawd — Complete Agent Skill
Give this file to any AI agent (Claude, Codex, GPT-4, DeepSolana, Hermes, etc.)
to fully install, configure, and operate solana-clawd in one shot.
_____ __ ________ __
/ ___/____ / /___ _____ ____ _ / ____/ /___ __ ______/ /
\__ \/ __ \/ / __ `/ __ \/ __ `/ / / / / __ `/ | /| / / __ /
___/ / /_/ / / /_/ / / / / /_/ / / /___/ / /_/ /| |/ |/ / /_/ /
/____/\____/_/\__,_/_/ /_/\__,_/ \____/_/\__,_/ |__/|__/\__,_/
╔══════════════════════════╗
║ POWERED BY xAI GROK ║
╚══════════════════════════╝
What You Are Installing
solana-clawd — Grok-powered Solana AI agent framework by 8BIT Labs.
TypeScript modules that compile to a deployable MCP server with:
- 31+ MCP tools — Helius RPC, DAS, WebSocket, Solana market data, Jupiter swaps
- MawdBot trading agent — OODA loop for Solana spot, Pump.fun, memecoins
- Honcho v3 memory — persistent cross-session reasoning (KNOWN/LEARNED/INFERRED)
- Privy agentic wallets — policy-based guardrails, autonomous transactions
- Multi-venue perps — Hyperliquid + Aster perpetuals
- x402 payments — USDC-on-Solana facilitator for agent-to-agent commerce
Links
Install
git clone https://github.com/x402agent/solana-clawd
cd solana-clawd
npm install
npm run build
Quick Start
npm run demo
npm run birth
npm run spinners
Minimum .env
HELIUS_API_KEY=your-helius-key
HELIUS_RPC_URL=https://mainnet.helius-rpc.com/?api-key=your-key
SOLANA_PRIVATE_KEY=your-base58-key
XAI_API_KEY=your-xai-key
PRIVY_APP_ID=your-privy-app-id
HONCHO_API_KEY=your-honcho-key
Verify
npx solana-clawd --version
npx solana-clawd status
MawdBot Trading Agent
MawdBot is the primary trading agent inside solana-clawd. It runs an OODA loop
for Solana spot trading with Pump.fun integration.
Commands
/mawd status # OODA loop state, watchlist, positions
/mawd sim # Switch to simulated trading mode
/mawd live # Switch to live trading mode
/mawd scan # Run Pump.fun scanner
/mawd buy <token> <sol> # Buy via Jupiter
/mawd sell <token> <pct> # Sell (supports "50%", "all")
/mawd watch <mint> # Add to watchlist
/mawd unwatch <mint> # Remove from watchlist
/mawd positions # Open positions across venues
/mawd strategy # Current strategy parameters
OODA Loop
OBSERVE → prices, volume, funding, OI, holders, dev-wallet
ORIENT → RSI/EMA/ATR scoring, confidence model
DECIDE → confidence ≥ 0.60 → size band
ACT → Jupiter swap / Hyperliquid order / Aster order
LEARN → persist to Honcho, feed auto-optimizer
Drawdown Cascade
| Drawdown | Action |
|---|
| 5% | Reduce weakest, block Pump.fun |
| 8% | Close perps, spot-only |
| 12% | Full halt |
Memory Tiers (SolanaOS Epistemology)
Three tiers: KNOWN (API data, expires), LEARNED (trade patterns, persistent), INFERRED (correlations, held loosely).
/memory Status + peer card
/recall <query> AI-powered recall via dialectic
/remember <fact> Save durable conclusion
/ask_memory <question> Ask about yourself
/forget <query> Delete matching memories
/dream Trigger memory consolidation
Perps Trading
Hyperliquid
/hl Account overview
/hl_positions Open positions + PnL
/hl_open BTC long 0.01 5x Open position
/hl_close BTC Close position
Aster (Solana-native)
/aster Account summary
/aster_positions Open positions
/aster_open SOL long Open position
/aster_close SOL Close position
MCP Tools
31 tools across 6 categories:
| Category | Tools |
|---|
| Helius RPC | account_info, balance, transactions, priority_fee |
| Solana Market | price, trending, token_info, wallet_pnl |
| Trading | pump_token_scan, pump_buy_quote, pump_sell_quote |
| Memory | memory_recall, memory_write |
| Wallet | balance, address, transfer |
| Agent | agent_spawn, agent_list, agent_stop |
Key Files
| File | Purpose |
|---|
SOUL.md | Agent identity and epistemology |
STRATEGY.md | Multi-venue strategy (SolanaOS v2.0) |
TRADE.md | Pump.fun trading agent skill |
mcp-server/ | MCP server implementation |
src/ | Core engine (58 subsystems, 400+ source files) |
animations/ | Unicode spinners, buddy birth ceremony |
buddy/ | Blockchain Buddy companion system |
metaplex/ | Agent minting via mpl-agent-registry |
One-Shot Agent Prompt
Read SKILL.md in the solana-clawd project root.
Follow every step. My .env values are:
HELIUS_API_KEY=...
SOLANA_PRIVATE_KEY=...
XAI_API_KEY=...
Complete the full installation.
After install: npx solana-clawd status && npx solana-clawd demo
solana-clawd v1.0.0 · MIT · github.com/x402agent/solana-clawd
Powered by xAI Grok · Built on Solana · SolanaOS compatible
x.com/clawddevs · solanaclawd.com
