my-project-public

repository

loading code, commits, and activity

repositories

loading repo index

#1	{
#2	"skillId": "solana-clawd",
#3	"name": "solana-clawd",
#4	"description": "One-shot setup and operation guide for the solana-clawd agentic engine. Use when: cloning the repo, setting up MCP tools, starting the Telegram bot, deploying to Fly.io/Netlify, hatching blockchain buddies, running OODA loops, configuring voice mode (ElevenLabs + Grok), minting Metaplex agents, managing the vault, running the worker swarm, or contributing to the project. Covers all 31 MCP tools, 18 buddy species, 9 spinners, 60+ Telegram commands, 95 skills, and the full repo structure.",
#5	"category": "solana-dev",
#6	"path": "solana-clawd/SKILL.md",
#7	"url": "https://x402.wtf/api/skills/solana-clawd",
#8	"tags": [
#9	"solana",
#10	"clawd"
#11	],
#12	"requiredEnv": [],
#13	"homepage": null,
#14	"attestation": {
#15	"status": "pending",
#16	"isFormallyVerified": false,
#17	"attestationPda": null,
#18	"verificationTimestamp": null
#19	},
#20	"markdown": "---\nname: solana-clawd\ndescription: 'One-shot setup and operation guide for the solana-clawd agentic engine. Use when: cloning the repo, setting up MCP tools, starting the Telegram bot, deploying to Fly.io/Netlify, hatching blockchain buddies, running OODA loops, configuring voice mode (ElevenLabs + Grok), minting Metaplex agents, managing the vault, running the worker swarm, or contributing to the project. Covers all 31 MCP tools, 18 buddy species, 9 spinners, 60+ Telegram commands, 95 skills, and the full repo structure.'\nmetadata:\n {\n \"solanaos\": {\n \"emoji\": \"\\U0001F43E\",\n \"requires\": {\n \"env\": [\"HELIUS_API_KEY\"],\n \"bins\": [\"node\", \"npm\"]\n }\n }\n }\n---\n\n# solana-clawd — The Agentic Engine Solana Deserves\n\nRepo: [github.com/x402agent/solana-clawd](https://github.com/x402agent/solana-clawd)\nLive: [solanaclawd.com](https://solanaclawd.com)\nnpm: `solana-clawd` (v1.6.0)\nToken: `$CLAWD` — `8cHzQHUS2s2h8TzCmfqPKYiM4dSt4roa3n7MyRLApump`\n\n## When to Use\n\n- Setting up solana-clawd from scratch (clone, install, configure)\n- Connecting MCP tools to Claude Desktop, Cursor, VS Code\n- Starting the Telegram trading bot\n- Deploying the web app or MCP server\n- Hatching blockchain buddies or running spinners\n- Running OODA trading loops\n- Running Phoenix perpetuals through the official Solana CLAWD perps agent and bundled Vulcan skills\n- Configuring voice mode (ElevenLabs + Grok)\n- Minting agents on Metaplex\n- Managing encrypted vault secrets\n- Contributing new tools, buddies, or skills\n\n## One-Shot Install\n\n```bash\ngit clone https://github.com/x402agent/solana-clawd\ncd solana-clawd\nnpm run setup\n```\n\n`npm run setup` is the canonical bootstrap. It installs dependencies, builds the root runtime, builds `MCP/`, builds `packages/agentwallet/`, builds the main web app, builds the Clawd Vault web app, builds the wiki app, syncs the skills catalog, and creates `.env` from `.env.example` if needed.\n\nMinimum keys needed for live Solana data: `HELIUS_API_KEY` (free at helius.dev).\n\n### Quick Demo (no keys needed)\n\n```bash\nnpm run demo\nnpm run birth\nnpm run spinners\n```\n\n### Install As A Standalone Skill\n\nInstall only the master `solana-clawd` skill:\n\n```bash\nnpx skills add x402agent/solana-clawd --path skill/solana-clawd\n```\n\nInstall the full Solana-clawd skill pack from this repo:\n\n```bash\nnpx skills add x402agent/solana-clawd\n```\n\n## MCP Setup\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"solana-clawd\": {\n \"command\": \"node\",\n \"args\": [\"/path/to/solana-clawd/MCP/dist/index.js\"],\n \"env\": { \"HELIUS_API_KEY\": \"your-key\" }\n }\n }\n}\n```\n\n### Cursor / VS Code\n\n```json\n{\n \"solana-clawd\": {\n \"command\": \"node\",\n \"args\": [\"MCP/dist/index.js\"],\n \"cwd\": \"/path/to/solana-clawd\"\n }\n}\n```\n\n### Public HTTP (no install)\n\n```json\n{\n \"solana-clawd\": { \"type\": \"http\", \"url\": \"https://solana-clawd.fly.dev/mcp\" }\n}\n```\n\n## MCP Tools (31)\n\n\| Category \| Tools \| Description \|\n\|----------\|-------\|-------------\|\n\| Market Data (8) \| `solana_price`, `solana_trending`, `solana_token_info`, `solana_wallet_pnl`, `solana_search`, `solana_top_traders`, `solana_wallet_tokens`, `sol_price` \| Live prices, trending, security scores, smart money, PnL \|\n\| Helius Onchain (8) \| `helius_account_info`, `helius_balance`, `helius_transactions`, `helius_priority_fee`, `helius_das_asset`, `helius_webhook_create`, `helius_webhook_list`, `helius_listener_setup` \| RPC, DAS metadata, enhanced txs, webhooks, WebSocket \|\n\| Agent Fleet (3) \| `agent_spawn`, `agent_list`, `agent_stop` \| Spawn research/OODA/scanner/dream agents \|\n\| Memory (2) \| `memory_recall`, `memory_write` \| KNOWN/LEARNED/INFERRED 3-tier memory \|\n\| Metaplex (6) \| `metaplex_mint_agent`, `metaplex_register_identity`, `metaplex_read_agent`, `metaplex_delegate_execution`, `metaplex_verify_mint`, `metaplex_agent_wallet` \| Mint AI agents as MPL Core assets \|\n\| Pump.fun (8) \| `pump_token_scan`, `pump_buy_quote`, `pump_sell_quote`, `pump_graduation`, `pump_market_cap`, `pump_top_tokens`, `pump_new_tokens`, `pump_cashback_info` \| Bonding curve scanner, quotes, graduation \|\n\| Skills (2) \| `skill_list`, `skill_read` \| Browse and load 95 SKILL.md files \|\n\n## Phoenix Perps: Vulcan / Rise SDK\n\nThe repo includes the full Vulcan skill pack under `vulcan-cli-master/skills` and exposes forwarding skills under `skills/vulcan-`.\n\nUse this loading order for Phoenix perps work:\n\n1. `skills/vulcan/SKILL.md`\n2. `vulcan-cli-master/CONTEXT.md`\n3. `vulcan-cli-master/skills/INDEX.md`\n4. Focused skills such as `vulcan-market-intel`, `vulcan-risk-management`, `vulcan-trade-execution`, `vulcan-twap-execution`, `vulcan-grid-trading`, or `vulcan-ta-strategy`\n\nOfficial Python perps agent:\n\n```bash\ncd solana-python-agent\npython perps_agent.py health\npython perps_agent.py market SOL\npython perps_agent.py paper-order buy SOL --notional-usdc 100\npython perps_agent.py preflight\n```\n\nSafety contract:\n\n- Paper mode is default.\n- Live orders require explicit `--yes`.\n- Live strategies require preflight and explicit mode selection.\n- The agent never reads or prints private keys, wallet passwords, or MCP config secrets.\n\n## Telegram Bot\n\n```bash\n# Set minimum env vars\nexport TELEGRAM_BOT_TOKEN=<from-botfather>\nexport HELIUS_API_KEY=<from-helius.dev>\nexport TELEGRAM_ALLOWED_CHATS=<your-chat-id> # lock to your user\n\n# Start\nnpx tsx src/telegram/index.ts\n```\n\n### Key Commands\n\n\| Category \| Commands \|\n\|----------\|----------\|\n\| Market* \| `/sol`, `/price <mint>`, `/trending`, `/token <mint>`, `/wallet <addr>`, `/market`, `/latest`, `/graduated` \|\n\| Research \| `/research <mint>`, `/deepresearch <mint>`, `/ooda`, `/chart <mint>`, `/trades <mint>`, `/toptraders <mint>`, `/holders <mint>` \|\n\| Pump.fun \| `/scan`, `/snipe`, `/stop`, `/signal`, `/grad <mint>`, `/mcap <mint>`, `/cashback <mint>` \|\n\| Helius \| `/balance`, `/tokens`, `/txs`, `/slot`, `/assets` \|\n\| AI \| `/grok <q>`, `/xsearch <q>`, `/wsearch <q>`, `/imagine <prompt>`, `/video <prompt>`, `/vision <url>` \|\n\| Twitter \| `/tweet <text>`, `/reply <id> <text>`, `/like <id>`, `/rt <id>`, `/tsearch <q>`, `/autotweet on` \|\n\| Vault \| `/vault`, `/vault store <label> <secret>`, `/vault get <id>`, `/vault lock` \|\n\| System \| `/status`, `/agentstate`, `/skills`, `/help`, `/watch <mint>` \|\n\n## Voice Mode\n\nThe web app at `solanaclawd.com/voice` supports two providers:\n\n\| \| ElevenLabs \| Grok (xAI) \|\n\|---\|---\|---\|\n\| Agent \| Conversational AI (signed URL) \| Realtime API (ephemeral tokens, server VAD) \|\n\| TTS \| Roger, Sarah, River, Will \| Rex, Eve, Ara, Sal, Leo + speech tags \|\n\| Tools \| -- \| Web search during conversation \|\n\n```bash\n# Required env vars (web/.env)\nELEVEN_LABS_API_KEY=<elevenlabs-key>\nELEVENLABS_AGENT_ID=<agent-id>\nXAI_API_KEY=<xai-key>\n```\n\n## Blockchain Buddies\n\n18 species across 5 categories. 8 stats per buddy. 5 rarity tiers (common 60% to legendary 1%). Multi-frame ASCII sprites with 12 hat options.\n\n```typescript\nimport { createBlockchainBuddy, formatBuddyCard } from 'solana-clawd/buddy'\nconst buddy = createBlockchainBuddy()\nconsole.log(formatBuddyCard(buddy))\n```\n\nSpecies: SolDog, BONK Dog, dogwifhat, Jupiter Agg, Raydium LP, Whale, Bull, Bear, MEV Shark, Octopus, DeGod, y00t, Okay Bear, Pepe, Pump.fun, Sniper Bot, Validator, RPC Node.\n\n## OODA Trading Loop\n\n```bash\nnpx tsx examples/ooda-loop.ts\n```\n\n```\nOBSERVE -> sol_price, trending, helius_priority_fee, memory KNOWN\nORIENT -> score candidates (trend + momentum + liquidity + participation - risk)\nDECIDE -> confidence >= 60? -> size band\nACT -> trade_execute gated at `ask` permission\nLEARN -> write INFERRED -> Dream agent promotes to LEARNED\n```\n\n9 built-in agents: Explore, Scanner, PumpScanner, SniperBot, OODA, Dream, Analyst, Monitor, MetaplexAgent.\n\n## Metaplex Agent Minting\n\n```typescript\nimport { createAgentUmiFromEnv, mintClawdAgentFromTemplate } from 'solana-clawd/metaplex'\nconst umi = createAgentUmiFromEnv('solana-devnet')\nconst result = await mintClawdAgentFromTemplate(umi, 'trader', {\n uri: 'https://arweave.net/metadata.json',\n network: 'solana-devnet',\n})\n```\n\nTemplates: `explorer`, `scanner`, `trader`, `analyst`, `monitor`, `custom`.\nNetworks: solana-mainnet, solana-devnet, localnet, eclipse, sonic, fogo.\n\n## Vault (AES-256-GCM)\n\n```typescript\nimport { SolanaVault } from 'solana-clawd/vault'\nconst vault = await SolanaVault.create('passphrase')\nawait vault.store('api_key', 'sk-live-...', 'Helius key')\nvault.lock() // zero-fills key from memory\n```\n\nAuto-locks after 15 min. Scrypt-derived master key. Sentinel validation.\n\n## Deploy\n\n### Fly.io (MCP server)\n\n```bash\ncd MCP && fly launch --config fly.toml\nfly secrets set HELIUS_API_KEY=key MCP_API_KEY=optional-bearer\n```\n\n### Netlify (web app)\n\n```bash\nnetlify deploy --prod\n# Set env: ELEVEN_LABS_API_KEY, ELEVENLABS_AGENT_ID, XAI_API_KEY\n```\n\n### Worker Swarm (iii SDK)\n\n```bash\ncd tailclawd/quickstart\niii -c iii-config.yaml # start engine\ndocker compose up --build # start 4 workers (TS + Rust + Python)\n```\n\n## Repo Structure\n\n```\nMCP/ 31 MCP tools, STDIO + HTTP + SSE transport\nsrc/ 58 subsystems, 400+ files (engine, agents, telegram, buddy, pump, voice...)\nweb/ Next.js frontend (chat, buddies, voice) — solanaclawd.com\ngateway/ Express API + Telegram bot + Birdeye WebSocket\npackages/ agentwallet (encrypted Solana+EVM vault SDK)\nbeepboop/ macOS menu bar companion (SwiftUI, Claude vision, voice)\nllm-wiki-tang/ Research knowledge base (Next.js + FastAPI + Supabase)\ntailclawd/ TailClawd web UI + iii SDK worker swarm\nelevenlabs-mcp-main/ ElevenLabs MCP server\nformal_verification/ Lean 4 risk engine spec\nskills/ 95 SKILL.md knowledge documents\nexamples/ 4 runnable demos (buddies, wallet listener, OODA, x402)\ndocs/ architecture.md (48KB), migration guide, risk engine spec\n```\n\n## Environment Variables\n\nSee `.env.example` (55 lines). Minimum:\n\n```bash\nHELIUS_API_KEY= # Free at helius.dev (1M credits/month)\n```\n\nFull list by category:\n\n\| Category \| Keys \|\n\|----------\|------\|\n\| Core \| `HELIUS_API_KEY`, `HELIUS_RPC_URL`, `SOLANA_TRACKER_API_KEY`, `BIRDEYE_API_KEY` \|\n\| LLM \| `ANTHROPIC_API_KEY`, `OPENROUTER_API_KEY`, `XAI_API_KEY` \|\n\| Voice \| `ELEVEN_LABS_API_KEY`, `ELEVENLABS_AGENT_ID` \|\n\| Telegram \| `TELEGRAM_BOT_TOKEN`, `TELEGRAM_CHAT_ID`, `TELEGRAM_ALLOWED_CHATS`, `TELEGRAM_ADMIN_IDS` \|\n\| Wallet \| `SOLANA_PUBLIC_KEY`, `SOLANA_PRIVATE_KEY`, `VAULT_PASSPHRASE` \|\n\| Social \| `CONSUMER_KEY`, `SECRET_KEY`, `ACCESS_TOKEN`, `ACCESS_TOKEN_SECRET`, `BEARER_TOKEN` \|\n\| Deploy \| `MCP_API_KEY`, `CONVEX_URL`, `CONVEX_DEPLOY_KEY` \|\n\n## Pitfalls\n\n- No dotenv auto-load — Telegram bot needs `source .env` or `set -a && source .env && set +a` before running\n- Helius free tier — 1M credits/month, enough for dev but not high-frequency polling\n- Pump sniper — Requires `SOLANA_PRIVATE_KEY` for live execution; signal-only mode works without\n- Voice mode — Both ElevenLabs and xAI consume credits per request; monitor usage\n- Wiki sub-project — `web/wiki/` has separate dependencies; excluded from main Next.js build via `eslint.dirs`\n- Node 20+ required — uses native WebSocket, `structuredClone`, other modern APIs\n- Bun compatible but tested primarily on Node; `bun:bundle` feature gates exist in voice code\n\n## Contributing\n\n```bash\nnpm run build # TypeScript compilation\nnpm run dev # watch mode\nnpm run typecheck # strict type checking\nnpm run mcp:build # MCP server only\nnpm run demo # test the demo\nnpm run birth # test buddy hatching\nnpm run skills:catalog # regenerate skill manifest\n```\n\nHigh-impact areas: new MCP tools, buddy species, spinners, voice agent skills, Telegram commands. See `CONTRIBUTING.md`.\n"
#21	}
#22

z6Mkq5mY3JWtxoxUobWcfNHm7AkRubgSWEZTkBVqZXJviFZ5/my-project-public