跳转到主要内容
将 Telegram 连接到您的 LemonClaw 实例。本指南适用于托管的 Claw 实例和自托管的 LemonClaw 部署。您只需要从 BotFather 获取一个 bot token，即可在 2 分钟内开始与 AI 聊天。

​
先决条件

​
设置指南

1

使用 BotFather 创建机器人

  1. 打开 Telegram 并搜索 @BotFather
  2. 发送 /newbot
  3. 为您的机器人选择一个显示名称（例如 “My AI Assistant”）
  4. 选择一个以 bot 结尾的用户名（例如 my_ai_assistant_bot）
  5. BotFather 将回复您的 Bot Token —— 如下所示：
123456789:ABCdefGHIjklMNOpqrsTUVwxyz
请务必保密您的 bot token！任何拥有此 token 的人都可以控制您的机器人。
2

打开 LemonClaw WebUI

  1. 如果您使用的是托管的 Claw，请前往您的 Claw Dashboard 并点击 Open WebUI
  2. 如果您是自托管 LemonClaw，请打开您自己的 WebUI（例如 http://your-ip:18789）并使用您的 token 登录
  3. 在 WebUI 中，导航至 Settings → Channels
  4. 展开 Telegram 部分
  5. 粘贴您的 Bot Token
  6. 点击 Save
3

开始聊天

  1. 打开 Telegram 并通过用户名找到您的机器人
  2. 发送任意消息（例如 “Hello!”）
  3. 第一个用户将自动配对为所有者 —— 无需代码！
  4. 开始与 AI 聊天！

​
可选：自定义机器人资料

创建机器人后，您可以使用 BotFather 对其进行自定义：
命令用途
/setdescription设置机器人的简介/描述
/setabouttext设置 “关于” 部分
/setuserpic上传个人资料图片
/setcommands添加命令建议

​
在群组中使用

隐私模式（Privacy Mode）在 Telegram 机器人中默认启用。在群聊中，机器人只能看到以下消息：
  • 以 / 开头（命令）
  • 直接 @ 提及机器人
  • 是对机器人消息的回复
要让机器人看到所有群组消息，请通过 BotFather 禁用隐私模式：发送 /setprivacy → 选择您的机器人 → 选择 Disable。注意：您必须将机器人从现有群组中移除并重新添加，此更改才能生效。

​
群组设置

在 LemonClaw WebUI 的 Channels 设置中配置群组行为：
设置选项描述
Group Policy公开 (默认) / 白名单 / 已禁用控制谁可以在群组中触发机器人
Require @mention开启 / 关闭机器人仅在被 @ 提及（@mentioned）时响应（推荐）
Group IDs聊天 ID 列表限制在特定群组（留空 = 所有群组）
Group Allowed Users用户 ID 列表仅这些用户可以触发机器人（白名单模式）
Group Policy 控制谁可以在群组中给机器人发消息，而 Group IDs 控制机器人在哪些群组中响应。结合使用两者以实现精细化控制。

​
私聊策略

控制谁可以向您的机器人发送私聊消息：
策略行为
Pairing (默认)新用户将获得一个配对码 —— 在 WebUI 中输入以进行授权
Allowlist仅您指定的用户 ID 可以给机器人发消息
Open任何人都可以给机器人发消息（请谨慎使用 —— 会消耗您的 AI 额度）

​
故障排除

  • 验证 bot token 是否正确（没有多余的空格）
  • 检查您的实例是否正在运行（仪表板中显示绿色状态）
  • 尝试从仪表板重启实例
  • 确保您是向机器人发送私聊消息，而不是在群组中
  • 配对系统在收到新用户的首条消息时激活
  • 响应时间取决于所选的 AI 模型
  • 较大的模型（Claude Opus, GPT-5）可能需要几秒钟
  • 检查您的 LemonData 余额 —— 余额不足会导致错误