Multi-Agents Assistant based on OpenClaw and Discord Bot

A local OpenClaw multi‑agent system for crypto market monitoring, integrated with a Discord bot. It collects KOL signals, prediction market data, and generates structured sentiment analysis reports.

Architecture

Agents:

• main: default orchestrator, routes tasks to sub‑agents.
• x_kol_bot: collects high‑signal X (Twitter) KOL posts (X.com only).
• media_bot: aggregates top crypto news from Cointelegraph, CoinDesk, BlockBeats, The Block.
• polymarket_bot: collects prediction markets from Polymarket, Kalshi, CoinMarketCap Prediction Markets.
• crypto_analyst: aggregates x_kol_bot + media_bot + polymarket_bot and produces a report with views, trade ideas, risks.

Primary outputs (in workspace/io/):

• x_feed.txt
• media_feed.txt
• polymarket.csv
• analysis_report.md

Specs and templates:

• <OPENCLAW_HOME>/workspace/OUTPUT_SPEC.md
• <OPENCLAW_HOME>/workspace-x_kol_bot/OUTPUT_TEMPLATE.md
• <OPENCLAW_HOME>/workspace-media_bot/OUTPUT_TEMPLATE.md
• <OPENCLAW_HOME>/workspace-polymarket_bot/OUTPUT_TEMPLATE.md
• <OPENCLAW_HOME>/workspace-crypto_analyst/OUTPUT_TEMPLATE.md

Repo Layout

• <OPENCLAW_HOME>/openclaw.json OpenClaw config
• <OPENCLAW_HOME>/clawbot/ Discord bot implementation
• <OPENCLAW_HOME>/clawbot.config.json Discord bot config
• <OPENCLAW_HOME>/workspace-* Agent workspaces
• <OPENCLAW_HOME>/logs/ Gateway and bot logs
• <OPENCLAW_HOME>/workspace/io/ Aggregated IO artifacts
• <OPENCLAW_HOME>/workspace/validation/ Validation utilities

Discord Bot (clawbot)

Cogs-based bot with config in root.

Run manually:

<OPENCLAW_HOME>/.venv/bin/python <OPENCLAW_HOME>/clawbot/clawbot.py

LaunchAgent (daemon) config:

• ~/Library/LaunchAgents/com.openclaw.clawbot.plist

Control:

launchctl load ~/Library/LaunchAgents/com.openclaw.clawbot.plist
launchctl start com.openclaw.clawbot
launchctl stop com.openclaw.clawbot
launchctl unload ~/Library/LaunchAgents/com.openclaw.clawbot.plist

OpenClaw Gateway

Gateway is local with password auth.

Restart:

openclaw gateway restart

Agent Routing

Current Discord binding routes to main:

• <OPENCLAW_HOME>/openclaw.json -> bindings.agentId = "main"

From Discord, ask main to spawn sub‑agents, for example:

• “启动 x_kol_bot 抓取 X 上的 KOL 内容”
• “让 media_bot 抓取今日媒体 TOP10”
• “让 polymarket_bot 更新 top20 预测市场”
• “用 crypto_analyst 生成分析报告”

Security Placeholders

Replace secrets with placeholders in docs and configs.

Examples:

• discord_token: YOUR_DISCORD_BOT_TOKEN
• gateway_password: YOUR_GATEWAY_PASSWORD
• api_key: YOUR_PROVIDER_API_KEY

Architecture Flow (OpenClaw Multi‑Agent)

flowchart TD
  U["User (Discord)"] --> D["Discord Bot (clawbot)"]
  D --> G["OpenClaw Gateway (WS 18789)"]

  G --> GA["Gateway Auth (password)"]
  GA --> GR["Routing Rules (bindings)"]
  GR --> M["main agent (orchestrator)"]

  M --> C1["Context Loader"]
  C1 --> SO["SOUL.md (behavior contract)"]
  C1 --> US["USER.md (user prefs)"]
  C1 --> MM["MEMORY.md (long-term)"]
  C1 --> M
  M --> S1["sessions_spawn"]

  S1 --> XK["x_kol_bot (X/KOL collector)"]
  S1 --> MB["media_bot (news aggregator)"]
  S1 --> PM["polymarket_bot (market collector)"]
  S1 --> CA["crypto_analyst (sentiment/report)"]

  XK --> XKCTX["workspace-x_kol_bot/MEMORY.md"]
  XKCTX --> XK
  MB --> MBCTX["workspace-media_bot/MEMORY.md"]
  MBCTX --> MB
  PM --> PMCTX["workspace-polymarket_bot/MEMORY.md"]
  PMCTX --> PM
  CA --> CACTX["workspace-crypto_analyst/MEMORY.md"]
  CACTX --> CA

  M --> SH["shared handoff notes"]
  SH --> XK
  SH --> MB
  SH --> PM
  SH --> CA

  XK --> XF["x_feed.txt"]
  MB --> MF["media_feed.txt"]
  PM --> PC["polymarket.csv"]
  XF --> CA
  MF --> CA
  PC --> CA
  CA --> AR["analysis_report.md"]

  AR --> QG["Output Quality Gate (validate_outputs.py)"]
  QG --> OK["Pass/Fail"]
  QG --> REP["repair_outputs.py (if needed)"]

Loading

Local Development

Create venv and install dependencies:

python3 -m venv <OPENCLAW_HOME>/.venv
<OPENCLAW_HOME>/.venv/bin/python -m pip install discord.py

Quality Gate

Validation scripts live in:

• <OPENCLAW_HOME>/workspace/validation/validate_outputs.py
• <OPENCLAW_HOME>/workspace/validation/quality_gate.py
• <OPENCLAW_HOME>/workspace/validation/repair_outputs.py

Suggested flow:

<OPENCLAW_HOME>/workspace/validation/quality_gate.py

Notes

• Ensure agent auth profiles are configured under each agent dir in <OPENCLAW_HOME>/agents/.
• If a provider key is missing, OpenClaw will emit FailoverError in gateway logs.