x402agent/SolanaOS / skills/swarm-orchestrator
swarm-orchestrator
VerifiedOrchestrate multi-bot trading swarms on Pump.fun with persona-driven agents
Swarm Orchestrator
Manage multi-bot trading swarms with agent personas, epistemological memory, and cross-bot event routing.
Prerequisites
- SolanaOS core installed
TELEGRAM_BOT_TOKENfor Telegram gateway (optional)HELIUS_RPC_URLconfigured
Quick Start
# Start the swarm orchestrator
npm run swarm
# Start SolanaOS agent orchestrator
npm run claw
npm run claw:dev # with hot reload
Agent Roles
| Role | Description | Auto-Actions |
|---|---|---|
sniper | Snipe new token launches | Monitor → Buy on launch |
monitor | On-chain event watcher | Observe → Alert |
fee-claimer | Claim creator fees | Check → Claim automatically |
analyst | Price/curve analysis | Observe → Report |
momentum | Momentum-based trading | RSI+EMA → Execute |
graduation | Target near-graduation tokens | Monitor progress → Buy |
market-maker | Provide liquidity | Buy/sell oscillation |
launcher | Create new tokens | Build → Launch |
channel-feed | Telegram channel updates | Events → Post |
outsider | Call tracking + leaderboards | Track → Score |
Persona Assignment
Every agent can be born with one of 43+ DeFi personas:
# Via Telegram
/spawn analyst --persona whale-watcher
/spawn sniper --persona alpha-leak-detector
/personas # Browse all personas
/personas trading # Filter by category
Persona Categories
| Category | Count | Examples |
|---|---|---|
| 🪙 Crypto | 6 | Whale Watcher, Alpha Detector |
| 🏦 DeFi | 14 | Yield Farmer, Flash Loan Analyst |
| 📈 Trading | 5 | Pump SDK Expert, MEV Researcher |
| 🔒 Security | 6 | Smart Contract Auditor |
| 📚 Education | 2 | DeFi Mentor |
Event Bus
All bots communicate through a pub/sub event bus:
| Event | Source | Description |
|---|---|---|
token:launch | websocket-server | New token detected |
token:graduation | monitor | Token completed bonding curve |
trade:buy / trade:sell | swarm-bot | Trade executed |
alert:whale | monitor | Large transaction detected |
fee:claim | fee-claimer | Fee claimed successfully |
call:new | outsiders-bot | New call registered |
Memory System
Each agent gets its own ClawVault with 3-tier epistemological memory:
- KNOWN (60s TTL) — live market data
- LEARNED (7d TTL) — validated patterns
- INFERRED (3d TTL) — hypotheses
/memory <agent-id> # View agent's memory
/agents # List agents with memory stats
/health # Collective memory overview
Telegram Commands
| Command | Description |
|---|---|
/spawn <role> [--persona <id>] | Spawn agent |
/stop <id> | Stop an agent |
/agents | List active agents |
/personas [query] | Browse personas |
/memory <id> | View agent memory |
/health | Swarm health dashboard |
/price <mint> | Token price |
/quote <mint> <sol> | Buy/sell quote |
/curve <mint> | Bonding curve state |
/events | Recent event stream |
Bot Manager
The bot manager handles lifecycle for sub-bots:
import { BotManager, EventBus } from "solanaos";
const eventBus = new EventBus(5000);
const manager = new BotManager(eventBus);
await manager.start("telegram-bot");
await manager.start("swarm-bot");
manager.startHealthChecks();
// Route events
eventBus.on("alert:whale", (event) => {
console.log("Whale detected:", event.data);
});
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |