企业官网建设流程全解析

KiloClaw Telegram 接入指南：Bot 配置、群聊权限与访问控制全流程

【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kilocode

KiloClaw 是 Kilo 提供的托管式 OpenClaw 服务，支持把 AI Agent 接入 Telegram 等第三方聊天平台，使其 24/7 自动执行任务。本文以仓库内官方文档 telegram.md 为骨架，完整讲解从 BotFather 创建机器人、绑定 Bot Token、加入群聊、关闭隐私模式、获取群聊 ID，到通过groupPolicy/requireMention/allowFrom精细控制群内触发权限的完整流程，读者可按步骤直接落地自己的 Telegram 接入。

前置说明：根据文档内置的 kiloclaw-eol.md 提示，KiloClaw 已停止向新用户开放，产品支持正在结束，本文档仅为存量用户保留的参考内容，不再持续维护。以下操作步骤与配置均以当前仓库文档及项目源码为准。

KiloClaw 与 Telegram 的关系

在 KiloClaw Overview 中，KiloClaw 被定义为 Kilo 的托管 OpenClaw 服务：一键部署一个面向个人或组织的 AI Agent，无需自建 Docker、服务器和配置文件。OpenClaw 是一个 7×24 小时运行的开源 AI Agent，除自带的一等公民频道 Kilo Chat 外，还支持接入 Telegram、Discord、Slack 等第三方聊天平台，让你直接在常用聊天软件里下发指令并接收执行结果。

第三方平台接入的通用流程（见 chat-platforms/index.md）为：

1. 在Settings中配置该频道的 Token；
2. Redeploy（重新部署）KiloClaw 实例；
3. 在聊天应用中发起配对（pairing）；
4. 在 KiloClaw UI 中批准配对请求。

本文接下来的内容，就是把上述通用流程落实到 Telegram 上，并解决"如何在群聊里控制 Agent 行为"这一核心问题。

连接 KiloClaw 与 Telegram

将你的 KiloClaw Agent 接入 Telegram 的本质，是创建一个 Telegram Bot 并把它的 Token 交给 KiloClaw。官方提供了一份视频教程（Telegram Setup Guide），核心步骤如下：

1. 打开 Telegram，搜索并进入 @BotFather；
2. 发送/newbot命令，按提示为机器人命名并设置用户名，完成创建；
3. 复制 BotFather 返回的Bot Token（格式类似123456789:AA...，请妥善保管，它就是机器人的身份凭证）；
4. 登录 KiloClaw dashboard，进入Settings标签页；
5. 将 Token 粘贴到Telegram Bot Token字段；
6. 点击Save保存；
7. 重新部署（Redeploy）你的 KiloClaw 实例，让 Token 配置生效；
8. 在 Telegram 中给你的机器人发送一条私聊消息/start，完成初始化配对。

在 dashboard.md 的Settings > Channels一节中对此有更明确的说明：Kilo Chat 作为一等频道始终可用且无需 Token，而 Telegram、Discord、Slack 需要分别填入各自的 Bot Token；并且"保存 Token 后必须Redeploy或Restart OpenClaw，变更才会生效"。这与上面第 7 步遥相呼应——Redeploy 是配置生效的必要步骤，它本质上是"停止机器 → 应用当前配置（环境变量、密钥、频道 Token）→ 重新启动"（见 dashboard.md 的 Redeploy 说明）。

另外，文档明确说明"你可以随时移除或替换已配置的 Token"。也就是说，Token 管理是动态的：换号、轮换密钥或停用某个机器人时，只需回到 Settings 修改后重新 Redeploy 即可，无需重建实例。

当新频道首次被初始化，或新设备首次连接 Control UI 时，KiloClaw 仪表盘上会出现Pairing Requests（配对请求），需要你在批准后才能开始交互（见 overview.md 与 dashboard.md）。发/start的过程正是触发该配对请求的入口。

将 KiloClaw 添加到 Telegram 群聊

默认情况下，即使把机器人拉进群，KiloClaw也不会在群里发言——机器人"进群即隐身"。如果你希望 KiloClaw 在群聊中工作，必须主动修改配置。整个过程分四步。

Step 1：把机器人加进群

1. 打开目标 Telegram 群；
2. 点击群名称进入群信息页；
3. 点击Add Members（添加成员）；
4. 搜索你的机器人用户名并添加。

这一步只是"入场"，此时机器人仍不会响应任何群消息，需要继续完成后面的配置。

Step 2：关闭隐私模式（Privacy Mode）

Telegram 机器人默认开启隐私模式：机器人只能看到"直接 @ 它"的消息。要让机器人能看到群里的全部消息，必须通过 BotFather 关闭该模式：

1. 打开与 @BotFather 的私聊；
2. 发送/setprivacy命令并选择你的机器人；
3. 选择Disable（关闭隐私模式）；
4. 把机器人移出群聊后重新拉回来，变更才会生效。

这是 Telegram 平台侧对机器人权限的硬性约束，与 KiloClaw 自身的配置无关，但却是"机器人能感知全群消息"的前提。只有关闭隐私模式，KiloClaw 的requireMention等群策略才有意义（见 Step 4）。

Step 3：获取群聊 ID

配置群权限时，你需要知道群的chat ID。文档给出了两种获取方式：

• 转发法：把群里的一条消息转发给 @userinfobot，它会直接回显该群的 chat ID；
• 日志法：先往群里发一条消息，然后在服务器上运行openclaw logs --follow，从日志中读取chat.id字段的值。

需要特别注意的是 ID 的符号特征：普通群和超级群（supergroup）的 ID 都是负数，例如-1001234567890。超级群是 Telegram 自动升级后的群形态（成员超过阈值或开启某些功能后自动转换），其 ID 通常以-100开头。在后续配置中请原样保留负号和数字，不要自行截断或取绝对值。

Step 4：在 OpenClaw 中配置群

拿到群 ID 后，把该群加入 KiloClaw（OpenClaw）的允许列表。有两种方式：

方式一：通过私聊直接告诉机器人。给机器人发一条自然语言指令，例如：

"Add Telegram group-1001234567890to my allowed groups. Require a @mention to respond."

OpenClaw 会解析这条指令并写入自身配置——这是 Agent 驱动的配置方式，适合快速操作。

方式二：在 OpenClaw Control UI 的配置中直接写入 JSON。这是确定性的配置方式，便于精确控制和版本化管理：

{ "channels": { "telegram": { "groupPolicy": "allowlist", "groups": { "-1001234567890": { "requireMention": true } } } } }

各字段含义如下：

文档特别指出：如果你希望机器人在群里无需被 @ 就回复每条消息，把requireMention设为false即可。反之，设置为true能有效降低群内噪音，避免机器人在无关讨论中被反复触发。

进阶访问控制：如果想进一步限制"群内哪些成员能触发机器人"，可以在该群配置中增加allowFrom字段，填入允许触发的用户 ID 列表。更高级的访问控制模式可参考 OpenClaw 官方的 groups 文档（文档中给出的链接为 https://docs.openclaw.ai/channels/groups，仓库内未附带该外部页面内容，此处仅作指引）。

配置语义与安全边界解读

从上面的 JSON 配置可以看出，KiloClaw 的 Telegram 群聊模型是"白名单 + 触发条件 + 成员过滤"三层结构：

1. 白名单（groupPolicy: allowlist）：从平台层面圈定哪些群是"受信群"。没有出现在groups中的群，即使机器人被拉进去也不会参与，这与默认"不进群发言"的行为形成一致的安全兜底；
2. 触发条件（requireMention）：在受信群内进一步决定响应粒度——是"全员可见、每条必回"还是"仅在被召唤时回应"；
3. 成员过滤（allowFrom）：在群内继续收敛到指定用户，防止任何群成员都能滥用你的 Agent（例如执行文件操作、shell 命令等）。

从仓库文档结构看，同样的群策略配置模式也出现在 slack.md 与 discord.md 中（仓库内可检索到requireMention/groupPolicy/allowFrom同名配置项），说明这套"频道 + 群策略"是 KiloClaw 所有第三方聊天平台的统一设计范式，掌握 Telegram 的配置即掌握了其余平台的大部分概念。

常见问题与排障要点

结合 dashboard.md 与 overview.md 中的相关说明，可以归纳出接入过程中的几个高频注意点：

• Token 保存后机器人无响应：先确认是否执行了Redeploy（或Restart OpenClaw）。文档明确强调保存频道 Token 后必须重新部署/重启，变更才会生效，这是最常见的遗漏步骤。
• 机器人进了群但从不回复：优先检查是否关闭了 BotFather 的隐私模式（Step 2），并确认已按"移出再拉回"的方式使变更生效；其次确认该群 ID 已写入groups白名单。
• 群 ID 配置后依然无效：核对 ID 是否为负值、是否完整（超级群前缀-100不可省略），可用openclaw logs --follow观察实际到达的chat.id与配置是否一致。
• 私聊正常但群聊异常：私聊与群聊走的是两套权限逻辑——私聊触发 pairing（配对），群聊受 groupPolicy 管辖，需分别排查。
• 配置被改坏：如果 Agent 在编辑openclaw.json时引入了错误导致实例异常，可从 KiloClaw 仪表盘的Settings > Danger Zone点击Restore Config：它会把当前openclaw.json备份到/root/.openclaw/，再根据环境变量（频道 Token、模型设置等）重写配置并重启网关，且不影响持久卷上的文件与工作区数据（见 dashboard.md）。该操作不可撤销，执行前务必确认。

总结

接入 Telegram 的本质链条可以浓缩为一句话：BotFather 建 Bot → Settings 填 Token → Redeploy 生效 →/start配对 → 关闭隐私模式并重加群 → 取负值群 ID → 写入 allowlist 群策略。其中requireMention控制响应粒度、allowFrom控制触发成员、groupPolicy: allowlist控制受信群范围，三者共同构成一个可审计、可收敛的群聊访问控制体系。文档来源见 packages/kilo-docs/pages/kiloclaw/chat-platforms/telegram.md，配套的仪表盘操作说明见 packages/kilo-docs/pages/kiloclaw/dashboard.md，平台总览见 packages/kilo-docs/pages/kiloclaw/overview.md。

【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kilocode