{"id":"55536379-c437-4dec-9f08-b5589700f79b","entityType":"agent","slug":"voidborne-d-add-telegram-agent","name":"add-telegram-agent","canonicalUrl":"https://xpersona.co/agent/voidborne-d-add-telegram-agent","canonicalPath":"/agent/voidborne-d-add-telegram-agent","generatedAt":"2026-04-17T06:03:28.810Z","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":"Add Telegram Agent --- name: add-telegram-agent description: Add a new Telegram bot agent (subagent) to an existing OpenClaw gateway. Use when: user wants to create a new agent with its own Telegram bot, add a second/third bot to the gateway, or set up a multi-agent Telegram deployment. Requires only the Telegram bot token from user. --- Add Telegram Agent Add a new isolated agent with its own Telegram bot to the running OpenClaw gatew","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. Last updated 4/15/2026.","installCommand":"git clone https://github.com/voidborne-d/add-telegram-agent.git","sourceUrl":"https://github.com/voidborne-d/add-telegram-agent","homepage":null,"primaryLinks":[{"label":"View Source","url":"https://github.com/voidborne-d/add-telegram-agent","kind":"source"}],"safetyScore":94,"overallRank":31.3,"popularityScore":0,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Add Telegram Agent --- name: add-telegram-agent description: Add a new Telegram bot agent (subagent) to an existing OpenClaw gateway. Use when: user wants to cr"},"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":[{"label":"customize","status":"self-declared"}],"verifiedCount":0,"selfDeclaredCount":2,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"},{"key":"customize","type":"capability","support":"supported","confidenceSource":"profile","notes":"Declared in agent profile metadata"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile capability:customize|supported|profile"}},"adoption":{"evidence":{"source":"no-adoption-signals","verified":false,"confidence":"low","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":"No source adoption metrics were available."},"stars":0,"forks":0,"downloads":null,"packageName":null,"latestVersion":null,"tractionLabel":null},"release":{"evidence":{"source":"agent-index","verified":false,"confidence":"medium","updatedAt":"2026-04-15T00:19:07.671Z","emptyReason":null},"lastUpdatedAt":"2026-04-15T05:21:22.124Z","lastCrawledAt":"2026-04-15T00:19:07.671Z","lastIndexedAt":null,"nextCrawlAt":"2026-04-16T00:19:07.671Z","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/voidborne-d/add-telegram-agent.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://xpersona.co/api/v1/agents/voidborne-d-add-telegram-agent/snapshot","contractUrl":"https://xpersona.co/api/v1/agents/voidborne-d-add-telegram-agent/contract","trustUrl":"https://xpersona.co/api/v1/agents/voidborne-d-add-telegram-agent/trust"},"curlExamples":["curl -s \"https://xpersona.co/api/v1/agents/voidborne-d-add-telegram-agent/snapshot\"","curl -s \"https://xpersona.co/api/v1/agents/voidborne-d-add-telegram-agent/contract\"","curl -s \"https://xpersona.co/api/v1/agents/voidborne-d-add-telegram-agent/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-04-17T06:03:28.810Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://xpersona.co/api/v1/agents/voidborne-d-add-telegram-agent/dossier","snapshotUrl":"https://xpersona.co/api/v1/agents/voidborne-d-add-telegram-agent/snapshot","contractUrl":"https://xpersona.co/api/v1/agents/voidborne-d-add-telegram-agent/contract","trustUrl":"https://xpersona.co/api/v1/agents/voidborne-d-add-telegram-agent/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: add-telegram-agent\ndescription: Add a new Telegram bot agent (subagent) to an existing OpenClaw gateway. Use when: user wants to create a new agent with its own Telegram bot, add a second/third bot to the gateway, or set up a multi-agent Telegram deployment. Requires only the Telegram bot token from user.\n---\n\n# Add Telegram Agent\n\nAdd a new isolated agent with its own Telegram bot to the running OpenClaw gateway.\n\n## Required Input\n\n- **Bot token** from BotFather (e.g. `123456:ABC-xyz`)\n- **Agent ID** — short lowercase slug (e.g. `social`, `news`, `alerts`)\n\n## Procedure\n\n### 1. Derive paths\n\n```\nCONFIG = ~/.openclaw/openclaw.json\nWORKSPACE = ~/.openclaw/workspace-<agentId>\nAGENT_DIR = ~/.openclaw/agents/<agentId>/agent\n```\n\n### 2. Create workspace and agent dir\n\n```bash\nmkdir -p \"$WORKSPACE\"\nmkdir -p \"$AGENT_DIR\"\n```\n\nCreate minimal workspace files:\n\n```bash\n# AGENTS.md — copy from main or create minimal\ncat > \"$WORKSPACE/AGENTS.md\" << 'EOF'\n# AGENTS.md\nRead SOUL.md, USER.md, and memory files at session start.\nEOF\n\n# SOUL.md — placeholder, user can customize later\ncat > \"$WORKSPACE/SOUL.md\" << 'EOF'\n# SOUL.md\nDefine this agent's personality here.\nEOF\n```\n\n### 3. Edit openclaw.json — THREE required changes\n\nAll three are mandatory. Missing any one causes routing failure or gateway crash.\n\n#### 3a. Add agent to `agents.list`\n\n```json\n{\n  \"id\": \"<agentId>\",\n  \"workspace\": \"~/.openclaw/workspace-<agentId>\",\n  \"model\": { \"primary\": \"anthropic/claude-sonnet-4-5\" }\n}\n```\n\n#### 3b. Add Telegram account under `channels.telegram.accounts`\n\n```json\n\"<agentId>\": {\n  \"name\": \"<agentId>\",\n  \"enabled\": true,\n  \"dmPolicy\": \"pairing\",\n  \"botToken\": \"<TOKEN>\",\n  \"groupPolicy\": \"allowlist\",\n  \"streamMode\": \"partial\"\n}\n```\n\n⚠️ **Critical**: Use `\"streamMode\": \"partial\"` for streaming. Do NOT use `\"streaming\": \"on\"` — that is an invalid value and may prevent gateway startup.\n\nValid streaming values: `\"off\"` | `\"partial\"` | `\"block\"` | `\"progress\"`\n\n#### 3c. Add binding to route account → agent\n\n```json\n{\n  \"agentId\": \"<agentId>\",\n  \"match\": {\n    \"channel\": \"telegram\",\n    \"accountId\": \"<agentId>\"\n  }\n}\n```\n\n⚠️ **Critical**: Without a binding, inbound messages from this bot have no route and go to the default agent or are silently dropped.\n\n### 4. Restart gateway and verify\n\n```bash\nopenclaw gateway restart\nsleep 3\nopenclaw gateway status\nopenclaw agents list --bindings\n```\n\n### 5. Pair the first user\n\nDM the new bot on Telegram, then:\n\n```bash\nopenclaw pairing list telegram\nopenclaw pairing approve telegram <CODE>\n```\n\n## Common Mistakes\n\n| Mistake | Symptom | Fix |\n|---------|---------|-----|\n| Missing binding | Messages go to wrong agent or nowhere | Add binding entry |\n| `\"streaming\": \"on\"` | Gateway crash or no streaming | Use `\"streamMode\": \"partial\"` |\n| Reusing main workspace | Session/auth collisions | Always create separate workspace |\n| Missing agent in `agents.list` | Gateway ignores the account | Add agent entry |\n\n## Checklist\n\nBefore restart, verify ALL three exist in config:\n\n- [ ] `agents.list` has entry with correct `id` and `workspace`\n- [ ] `channels.telegram.accounts` has entry with `botToken`\n- [ ] `bindings` has entry mapping `accountId` → `agentId`\n","readmeExcerpt":"--- name: add-telegram-agent description: Add a new Telegram bot agent (subagent) to an existing OpenClaw gateway. Use when: user wants to create a new agent with its own Telegram bot, add a second/third bot to the gateway, or set up a multi-agent Telegram deployment. Requires only the Telegram bot token from user. --- Add Telegram Agent Add a new isolated agent with its own Telegram bot to the running OpenClaw gatew","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"CONFIG = ~/.openclaw/openclaw.json\nWORKSPACE = ~/.openclaw/workspace-<agentId>\nAGENT_DIR = ~/.openclaw/agents/<agentId>/agent"},{"language":"bash","snippet":"mkdir -p \"$WORKSPACE\"\nmkdir -p \"$AGENT_DIR\""},{"language":"bash","snippet":"# AGENTS.md — copy from main or create minimal\ncat > \"$WORKSPACE/AGENTS.md\" << 'EOF'\n# AGENTS.md\nRead SOUL.md, USER.md, and memory files at session start.\nEOF\n\n# SOUL.md — placeholder, user can customize later\ncat > \"$WORKSPACE/SOUL.md\" << 'EOF'\n# SOUL.md\nDefine this agent's personality here.\nEOF"},{"language":"json","snippet":"{\n  \"id\": \"<agentId>\",\n  \"workspace\": \"~/.openclaw/workspace-<agentId>\",\n  \"model\": { \"primary\": \"anthropic/claude-sonnet-4-5\" }\n}"},{"language":"json","snippet":"\"<agentId>\": {\n  \"name\": \"<agentId>\",\n  \"enabled\": true,\n  \"dmPolicy\": \"pairing\",\n  \"botToken\": \"<TOKEN>\",\n  \"groupPolicy\": \"allowlist\",\n  \"streamMode\": \"partial\"\n}"},{"language":"json","snippet":"{\n  \"agentId\": \"<agentId>\",\n  \"match\": {\n    \"channel\": \"telegram\",\n    \"accountId\": \"<agentId>\"\n  }\n}"}],"parameters":{},"dependencies":[],"permissions":[],"extractedFiles":[],"languages":["typescript"],"docsSourceLabel":"GITHUB OPENCLEW","editorialOverview":"Add Telegram Agent --- name: add-telegram-agent description: Add a new Telegram bot agent (subagent) to an existing OpenClaw gateway. Use when: user wants to create a new agent with its own Telegram bot, add a second/third bot to the gateway, or set up a multi-agent Telegram deployment. Requires only the Telegram bot token from user. --- Add Telegram Agent Add a new isolated agent with its own Telegram bot to the running OpenClaw gatew","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":381,"uniquenessScore":61,"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-04-17T06:03:28.810Z","emptyReason":null},"items":[{"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":"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-04-10T18:48:31.762Z","createdAt":"2026-02-25T03:38:16.584Z","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"}]}}}