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/kilocodeKiloClaw 是 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为在Settings中配置该频道的 TokenRedeploy重新部署KiloClaw 实例在聊天应用中发起配对pairing在 KiloClaw UI 中批准配对请求。本文接下来的内容就是把上述通用流程落实到 Telegram 上并解决如何在群聊里控制 Agent 行为这一核心问题。连接 KiloClaw 与 Telegram将你的 KiloClaw Agent 接入 Telegram 的本质是创建一个 Telegram Bot 并把它的 Token 交给 KiloClaw。官方提供了一份视频教程Telegram Setup Guide核心步骤如下打开 Telegram搜索并进入 BotFather发送/newbot命令按提示为机器人命名并设置用户名完成创建复制 BotFather 返回的Bot Token格式类似123456789:AA...请妥善保管它就是机器人的身份凭证登录 KiloClaw dashboard进入Settings标签页将 Token 粘贴到Telegram Bot Token字段点击Save保存重新部署Redeploy你的 KiloClaw 实例让 Token 配置生效在 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把机器人加进群打开目标 Telegram 群点击群名称进入群信息页点击Add Members添加成员搜索你的机器人用户名并添加。这一步只是入场此时机器人仍不会响应任何群消息需要继续完成后面的配置。Step 2关闭隐私模式Privacy ModeTelegram 机器人默认开启隐私模式机器人只能看到直接 它的消息。要让机器人能看到群里的全部消息必须通过 BotFather 关闭该模式打开与 BotFather 的私聊发送/setprivacy命令并选择你的机器人选择Disable关闭隐私模式把机器人移出群聊后重新拉回来变更才会生效。这是 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 后把该群加入 KiloClawOpenClaw的允许列表。有两种方式方式一通过私聊直接告诉机器人。给机器人发一条自然语言指令例如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 } } } } }各字段含义如下配置项类型作用channels.telegram.groupPolicystring群聊策略取值为allowlist白名单表示只有groups中列出的群会被响应channels.telegram.groupsobject以群 ID 为 key 的群配置集合groups.群ID.requireMentionboolean是否要求必须 机器人才响应true表示只有被 时才回复false表示群内每条消息都响应文档特别指出如果你希望机器人在群里无需被 就回复每条消息把requireMention设为false即可。反之设置为true能有效降低群内噪音避免机器人在无关讨论中被反复触发。进阶访问控制如果想进一步限制群内哪些成员能触发机器人可以在该群配置中增加allowFrom字段填入允许触发的用户 ID 列表。更高级的访问控制模式可参考 OpenClaw 官方的 groups 文档文档中给出的链接为 https://docs.openclaw.ai/channels/groups仓库内未附带该外部页面内容此处仅作指引。配置语义与安全边界解读从上面的 JSON 配置可以看出KiloClaw 的 Telegram 群聊模型是白名单 触发条件 成员过滤三层结构白名单groupPolicy: allowlist从平台层面圈定哪些群是受信群。没有出现在groups中的群即使机器人被拉进去也不会参与这与默认不进群发言的行为形成一致的安全兜底触发条件requireMention在受信群内进一步决定响应粒度——是全员可见、每条必回还是仅在被召唤时回应成员过滤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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 KiloClaw Telegram 接入指南：Bot 配置、群聊权限与访问控制全流程
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/kilocodeKiloClaw 是 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为在Settings中配置该频道的 TokenRedeploy重新部署KiloClaw 实例在聊天应用中发起配对pairing在 KiloClaw UI 中批准配对请求。本文接下来的内容就是把上述通用流程落实到 Telegram 上并解决如何在群聊里控制 Agent 行为这一核心问题。连接 KiloClaw 与 Telegram将你的 KiloClaw Agent 接入 Telegram 的本质是创建一个 Telegram Bot 并把它的 Token 交给 KiloClaw。官方提供了一份视频教程Telegram Setup Guide核心步骤如下打开 Telegram搜索并进入 BotFather发送/newbot命令按提示为机器人命名并设置用户名完成创建复制 BotFather 返回的Bot Token格式类似123456789:AA...请妥善保管它就是机器人的身份凭证登录 KiloClaw dashboard进入Settings标签页将 Token 粘贴到Telegram Bot Token字段点击Save保存重新部署Redeploy你的 KiloClaw 实例让 Token 配置生效在 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把机器人加进群打开目标 Telegram 群点击群名称进入群信息页点击Add Members添加成员搜索你的机器人用户名并添加。这一步只是入场此时机器人仍不会响应任何群消息需要继续完成后面的配置。Step 2关闭隐私模式Privacy ModeTelegram 机器人默认开启隐私模式机器人只能看到直接 它的消息。要让机器人能看到群里的全部消息必须通过 BotFather 关闭该模式打开与 BotFather 的私聊发送/setprivacy命令并选择你的机器人选择Disable关闭隐私模式把机器人移出群聊后重新拉回来变更才会生效。这是 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 后把该群加入 KiloClawOpenClaw的允许列表。有两种方式方式一通过私聊直接告诉机器人。给机器人发一条自然语言指令例如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 } } } } }各字段含义如下配置项类型作用channels.telegram.groupPolicystring群聊策略取值为allowlist白名单表示只有groups中列出的群会被响应channels.telegram.groupsobject以群 ID 为 key 的群配置集合groups.群ID.requireMentionboolean是否要求必须 机器人才响应true表示只有被 时才回复false表示群内每条消息都响应文档特别指出如果你希望机器人在群里无需被 就回复每条消息把requireMention设为false即可。反之设置为true能有效降低群内噪音避免机器人在无关讨论中被反复触发。进阶访问控制如果想进一步限制群内哪些成员能触发机器人可以在该群配置中增加allowFrom字段填入允许触发的用户 ID 列表。更高级的访问控制模式可参考 OpenClaw 官方的 groups 文档文档中给出的链接为 https://docs.openclaw.ai/channels/groups仓库内未附带该外部页面内容此处仅作指引。配置语义与安全边界解读从上面的 JSON 配置可以看出KiloClaw 的 Telegram 群聊模型是白名单 触发条件 成员过滤三层结构白名单groupPolicy: allowlist从平台层面圈定哪些群是受信群。没有出现在groups中的群即使机器人被拉进去也不会参与这与默认不进群发言的行为形成一致的安全兜底触发条件requireMention在受信群内进一步决定响应粒度——是全员可见、每条必回还是仅在被召唤时回应成员过滤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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考