{"id":"cef9d293-e039-4120-81a6-28a33e23ff30","entityType":"agent","slug":"rikouu-openclaw-multiagent","name":"multiagent","canonicalUrl":"https://www.xpersona.co/agent/rikouu-openclaw-multiagent","canonicalPath":"/agent/rikouu-openclaw-multiagent","generatedAt":"2026-10-10T00:54:20.503Z","source":"GITHUB_OPENCLEW","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":null},"description":"Manage multi-agent Telegram group collaboration for OpenClaw. Use when: (1) adding a new agent/bot to the team, (2) removing an agent, (3) listing current agents, (4) diagnosing multi-agent configuration issues, (5) clearing session caches, (6) syncing workspace team info. Triggers: 'multiagent', 'add agent', 'remove agent', 'agent doctor', 'agent list', 'clear sessions', 'multi-agent'. --- name: multiagent description: \"Manage multi-agent Telegram group collaboration for OpenClaw. Use when: (1) adding a new agent/bot to the team, (2) removing an agent, (3) listing current agents, (4) diagnosing multi-agent configuration issues, (5) clearing session caches, (6) syncing workspace team info. Triggers: 'multiagent', 'add agent', 'remove agent', 'agent doctor', 'agent list', 'clear sessions', 'multi-age","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 6 GitHub stars reported by the source. Last updated 4/15/2026.","installCommand":"git clone https://github.com/rikouu/openclaw-multiagent.git","sourceUrl":"https://github.com/rikouu/openclaw-multiagent","homepage":null,"primaryLinks":[{"label":"View Source","url":"https://github.com/rikouu/openclaw-multiagent","kind":"source"}],"safetyScore":94,"overallRank":35.5,"popularityScore":21,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Manage multi-agent Telegram group collaboration for OpenClaw. Use when: (1) adding a new agent/bot to the team, (2) removing an agent, (3) listing current agent"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"GITHUB OPENCLEW","verified":false,"confidence":"medium","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":null},"stars":6,"forks":2,"downloads":null,"packageName":null,"latestVersion":null,"tractionLabel":"6 GitHub stars"},"release":{"evidence":{"source":"agent-index","verified":false,"confidence":"medium","updatedAt":"2026-04-15T00:18:47.625Z","emptyReason":null},"lastUpdatedAt":"2026-04-15T05:21:22.124Z","lastCrawledAt":"2026-04-15T00:18:47.625Z","lastIndexedAt":null,"nextCrawlAt":"2026-04-16T00:18:47.625Z","lastVerifiedAt":null,"highlights":[]},"execution":{"evidence":{"source":"GITHUB OPENCLEW","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"git clone https://github.com/rikouu/openclaw-multiagent.git","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/rikouu-openclaw-multiagent/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/rikouu-openclaw-multiagent/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/rikouu-openclaw-multiagent/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/rikouu-openclaw-multiagent/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/rikouu-openclaw-multiagent/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/rikouu-openclaw-multiagent/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"GITHUB_OPENCLEW","generatedAt":"2026-10-10T00:54:20.503Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/rikouu-openclaw-multiagent/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/rikouu-openclaw-multiagent/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/rikouu-openclaw-multiagent/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/rikouu-openclaw-multiagent/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"GITHUB OPENCLEW","verified":false,"confidence":"high","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":null},"readme":"---\nname: multiagent\ndescription: \"Manage multi-agent Telegram group collaboration for OpenClaw. Use when: (1) adding a new agent/bot to the team, (2) removing an agent, (3) listing current agents, (4) diagnosing multi-agent configuration issues, (5) clearing session caches, (6) syncing workspace team info. Triggers: 'multiagent', 'add agent', 'remove agent', 'agent doctor', 'agent list', 'clear sessions', 'multi-agent'.\"\nuser_invocable: true\n---\n\n# Multi-Agent Manager\n\nManage OpenClaw multi-agent Telegram group collaboration. Automates the error-prone process of adding/removing agents and keeps configurations consistent.\n\n## Operations\n\n| Command | Description |\n|---------|-------------|\n| `add-agent` | Add a new agent to the team |\n| `remove-agent` | Remove an agent from the team |\n| `list-agents` | List all agents and their status |\n| `doctor` | Diagnose configuration issues |\n| `clear-sessions` | Clear session caches |\n| `update-workspaces` | Sync AGENTS.md across all workspaces |\n| `setup-comms` | Configure/update group chat settings |\n\nScript location: `scripts/manage.sh`\n\n## Adding an Agent\n\n### Prerequisites\n\n1. Create a bot via BotFather (`/newbot`)\n2. **Disable privacy mode**: `/setprivacy` -> select bot -> `Disable`\n3. Add bot to the Telegram group\n4. Note the bot token and username\n\n### Steps\n\n```bash\nbash scripts/manage.sh add-agent <id> <name> <role> <model> <bot_token> <bot_username> <group_chat_id>\n```\n\nExample:\n```bash\nbash scripts/manage.sh add-agent xiaoli 小丽 \"数据分析师\" \"anthropic/claude-sonnet-4-6\" \\\n  \"1234567890:AAH...\" \"@xiaoli_data_bot\" \"-100XXXXXXXXXX\"\n```\n\nThis automatically:\n1. Validates the agent ID is unique\n2. Updates `openclaw.json` — 5 config sections:\n   - `agents.list[]` — agent definition (model, workspace, mentionPatterns)\n   - `bindings[]` — agentId <-> telegram accountId mapping\n   - `channels.telegram.accounts.{id}` — bot token + group config\n   - `tools.agentToAgent.allow[]` — adds new agent to global allow list\n   - Each existing agent's `subagents.allowAgents[]` — bidirectional visibility\n3. Creates workspace directory with AGENTS.md, SOUL.md, USER.md\n4. Syncs AGENTS.md in all existing workspaces\n5. Clears all session caches\n6. Restarts the gateway\n\n### Post-add Checklist\n\n- [ ] Verify bot privacy mode is disabled (`can_read_all_group_messages: true`)\n- [ ] Remove and re-add bot to group if privacy was changed after joining\n- [ ] Test: send `@botname hello` in group, verify the correct bot responds\n\n## Removing an Agent\n\n```bash\nbash scripts/manage.sh remove-agent <id>\n```\n\nRemoves all configuration references, updates other agents' allow lists, syncs workspaces, clears sessions, restarts gateway. Does NOT delete the workspace directory (moved to `.bak`).\n\n## Listing Agents\n\n```bash\nbash scripts/manage.sh list-agents\n```\n\nParses `openclaw.json` and displays each agent's ID, name, model, bot username, and binding status.\n\n## Diagnosing Issues (Doctor)\n\n```bash\nbash scripts/manage.sh doctor\n```\n\nChecks:\n- Each agent has a corresponding binding\n- Each agent has a telegram account config with bot token\n- `agentToAgent.allow` includes all agent IDs\n- Each agent's `subagents.allowAgents` includes all peers\n- Workspace directories exist\n- AGENTS.md uses `accountId` (not `account`)\n- `mentionPatterns` are configured\n- Group chat ID is consistent across accounts\n\n## Clearing Sessions\n\n```bash\nbash scripts/manage.sh clear-sessions [agent_id|all]\n```\n\nDeletes session cache files. Required after modifying AGENTS.md or SOUL.md — otherwise agents keep using cached instructions.\n\nSession store locations: `~/.openclaw/agents/{id}/sessions/sessions.json`\n\n## Updating Workspaces\n\n```bash\nbash scripts/manage.sh update-workspaces\n```\n\nRegenerates the team collaboration section in every agent's AGENTS.md with current team member list, ensuring all agents have consistent information.\n\n## Key Pitfalls\n\n1. **`accountId` not `account`** — The `message` tool parameter is `accountId`. Writing `account` silently falls back to default (main agent's bot).\n\n2. **`sessions_send` never delivers to Telegram** — It always uses webchat internally. Agents must use the `message` tool to post results to the group.\n\n3. **Session cache blocks config changes** — After editing AGENTS.md or SOUL.md, clear sessions or changes won't take effect.\n\n4. **BotFather privacy mode** — Must be `Disabled`. Change takes effect only after removing and re-adding bot to group.\n\n5. **Topic/forum mode adds complexity** — Session keys get `:topic:N` suffixes. Use plain group mode unless you specifically need topics.\n\nFor detailed troubleshooting, read [references/troubleshooting.md](references/troubleshooting.md).\nFor config structure details, read [references/config-guide.md](references/config-guide.md).\n\n## Workspace Templates\n\n### AGENTS.md Template\n\nThe template uses these placeholders (replaced by `manage.sh`):\n\n| Placeholder | Description |\n|-------------|-------------|\n| `{{AGENT_ID}}` | Agent's ID (e.g., `xiaoma`) |\n| `{{AGENT_NAME}}` | Display name (e.g., `小码`) |\n| `{{AGENT_ROLE}}` | Role description |\n| `{{BOT_USERNAME}}` | Telegram bot username |\n| `{{GROUP_CHAT_ID}}` | Telegram group chat ID |\n| `{{TEAM_TABLE}}` | Auto-generated team member table |\n| `{{SESSION_KEYS}}` | Auto-generated session key table |\n\nTemplate content is embedded in `scripts/manage.sh` (function `generate_agents_md`).\n\n### SOUL.md Template\n\nA minimal SOUL.md is generated with the agent's name and role. Edit it after creation to add personality details.\n\n### USER.md Template\n\nA minimal USER.md pointing to the owner. Edit after creation.\n","readmeExcerpt":"--- name: multiagent description: \"Manage multi-agent Telegram group collaboration for OpenClaw. Use when: (1) adding a new agent/bot to the team, (2) removing an agent, (3) listing current agents, (4) diagnosing multi-agent configuration issues, (5) clearing session caches, (6) syncing workspace team info. Triggers: 'multiagent', 'add agent', 'remove agent', 'agent doctor', 'agent list', 'clear sessions', 'multi-age","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"bash scripts/manage.sh add-agent <id> <name> <role> <model> <bot_token> <bot_username> <group_chat_id>"},{"language":"bash","snippet":"bash scripts/manage.sh add-agent xiaoli 小丽 \"数据分析师\" \"anthropic/claude-sonnet-4-6\" \\\n  \"1234567890:AAH...\" \"@xiaoli_data_bot\" \"-100XXXXXXXXXX\""},{"language":"bash","snippet":"bash scripts/manage.sh remove-agent <id>"},{"language":"bash","snippet":"bash scripts/manage.sh list-agents"},{"language":"bash","snippet":"bash scripts/manage.sh doctor"},{"language":"bash","snippet":"bash scripts/manage.sh clear-sessions [agent_id|all]"}],"parameters":{},"dependencies":[],"permissions":[],"extractedFiles":[],"languages":["typescript"],"docsSourceLabel":"GITHUB OPENCLEW","editorialOverview":"Manage multi-agent Telegram group collaboration for OpenClaw. Use when: (1) adding a new agent/bot to the team, (2) removing an agent, (3) listing current agents, (4) diagnosing multi-agent configuration issues, (5) clearing session caches, (6) syncing workspace team info. Triggers: 'multiagent', 'add agent', 'remove agent', 'agent doctor', 'agent list', 'clear sessions', 'multi-agent'. --- name: multiagent description: \"Manage multi-agent Telegram group collaboration for OpenClaw. Use when: (1) adding a new agent/bot to the team, (2) removing an agent, (3) listing current agents, (4) diagnosing multi-agent configuration issues, (5) clearing session caches, (6) syncing workspace team info. Triggers: 'multiagent', 'add agent', 'remove agent', 'agent doctor', 'agent list', 'clear sessions', 'multi-age","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":394,"uniquenessScore":63,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T00:54:20.503Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/github_openclew","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}