Bot Architecture Overview
EditBot Architecture Overview
DeepBlue is a 5-agent autonomous Discord + Telegram system running on a VPS at /home/ubuntu/bots/.
The Team
| Agent | File | Role | Interface |
|---|---|---|---|
| EXEC | bot_exec.py |
Trading ops manager, auto-tuning, alerts | Discord #strategy, #boardroom |
| Mr. Clawford | bot_clawford.py |
Social media, growth, engagement | Discord #general, MoltX |
| Dr. ZoidClaw | bot_zoidclaw.py |
BTC intel, macro research, performance analysis | Discord #market-intel |
| Fishy | bot_fishy.py |
Finance, 5-min BTC trading, payments | Discord #finance |
| Squid | Claude Code CLI | Infrastructure, code, deploys, debugging | Terminal |
| OpenClaw | Telegram (Opus 4.6) | EXEC agent via Telegram, website, content | Telegram |
Key Files
| Path | Purpose |
|---|---|
base_agent.py |
Base class — memory, XP, proxy_chat, agent_run |
shared_config.py |
Channel IDs, bot tokens (from .env), proxy config |
polymarket_engine.py |
Polymarket engine: FiveMinMarketDiscovery, FiveMinRiskEngine, PolymarketClient |
momentum_engine.py |
Technical signals: MomentumSignalGenerator (candle), RealtimeSignalGenerator (websocket) |
btc_realtime.py |
Binance websocket feed: real-time BTC/ETH/SOL/XRP tick data + orderbook imbalance |
market_maker_engine.py |
Market-making: RewardMarketScanner, MarketMakerEngine, MMRiskEngine |
trading_config.json |
Runtime trading config (live-reloaded) |
taskboard.json |
Inter-bot task queue |
memories/*.json |
Per-bot persistent memory files |
Services (systemd --user)
deepblue-exec
deepblue-clawford
deepblue-zoidclaw
deepblue-fishy
deepblue-watchdog
deepblue-api
deepblue-acp
Infrastructure
- Claude Max proxy:
http://localhost:3456/v1/chat/completions(always use Opus) - Chat model:
claude-opus-4— used for proxy_chat and agent_run - Website: https://deepbluebase.xyz + https://error403agent.github.io/clawford/
- Wallet:
0x47ffc880cfF2e8F18fD9567faB5a1fBD217B5552(Base + Polygon)
Base Agent (CompanyAgent)
All bots inherit from CompanyAgent in base_agent.py:
- XP system: award_xp(), award_powder() for gamification
- Memory: per-bot JSON memory files at memories/*.json
- Taskboard: inter-bot task queue at taskboard.json
- proxy_chat(): calls Claude Opus via the Max proxy
- agent_run(): full Claude Code agent mode with tools (9 BLOCKED_PATHS protect credentials)
- Output sanitizer: catches leaked API keys before Discord send
Codebase Graph (God Nodes)
The graphify knowledge graph identified these as the most connected abstractions:
RealtimeSignalGenerator— 290 edges (core signal engine)PolymarketClient— 273 edges (API wrapper for all trades)FiveMinMarketDiscovery— 265 edges (market discovery for 5-min windows)MomentumSignalGenerator— 238 edges (candle-based signal fallback)CompanyAgent— 213 edges (bot base class, everything inherits from it)FiveMinRiskEngine— 81 edges (circuit breaker + position sizing)ChainlinkFeed— Polymarket data streams for resolution price