Cloudo AgentsCloudo Agents

把你的智能体接入 Telegram

大约 5 分钟。完成后，你会拥有一个 Telegram 机器人，可以从手机或电脑端的真实 Telegram 聊天里 和你的智能体对话。

开始之前

  • 已经部署好、并在门户中显示为 active（在线）的智能体
  • 一个手机或电脑端的 Telegram 账号（免费，不需要开发者账号）
  • 大约 5 分钟
先讲一个概念

Telegram 的“机器人”其实就是一个由软件而不是人来运营的 Telegram 账号。Telegram 自带一个叫@BotFather 的机器人，用来创建其它机器人。你给 @BotFather 发消息， 拿到一个 token，把它粘贴到 OpenClaw，你的智能体就能作为一个 Telegram 聊天对象被访问了。

步骤 1 — 打开 Telegram，与 BotFather 对话

  1. 打开 Telegram（手机或电脑都行，没区别）。
  2. 在搜索框输入 @BotFather，点击带有蓝色已验证勾的那条结果。不要选那些山寨账号——只有官方账号才有那个勾。
  3. 点 Start。

步骤 2 — 创建一个新机器人

  1. 发送 /newbot 作为聊天消息。
  2. BotFather 会询问 display name（显示名称）。这就是用户在聊天顶部看到的名字—— 只要可读就行。例如：Acme Support。
  3. BotFather 会询问 username（用户名）。它必须：
    • 以 bot 结尾（例如 acme_support_bot）
    • 在整个 Telegram 中全局唯一（你可能要多试几个）
    • 只使用字母、数字和下划线
  4. BotFather 会回复一条包含 HTTP API token 的消息。它长这样：
    123456789:ABCdefGHIjklMNOpqrSTUvwxYZ1234567890
请像对待密码一样对待这个 token

拥有这个 token 的人都能以你的机器人身份收发消息。不要把它粘贴到公开聊天、截图或 git 提交里。 一旦泄漏，向 BotFather 发送 /revoke 把它作废并生成一个新的。

步骤 3 — 把 token 粘贴到 OpenClaw

  1. 在 Cloudo 门户里，对你要连接的智能体点击 Open my OpenClaw。 你会进入该智能体的 OpenClaw 界面，地址是你专属的子域名。
  2. 打开 Channels 标签页。
  3. 点击 Telegram，然后点击 Connect。
  4. 把步骤 2 得到的 token 粘贴到 Bot Token 字段。
  5. 点击 Save。OpenClaw 会通过调用 Telegram 的getMe 接口验证 token，并显示类似这样的信息：
    Connected as @acme_support_bot (Acme Support)

步骤 4 — 发送第一条消息

  1. 在 Telegram 里，搜索你机器人的用户名（以 bot 结尾的那个）。
  2. 点击 Start。
  3. 随便发一条消息。你的智能体应该在几秒内以它配置好的语气回复。

如果约 10 秒内还没收到回复，请跳到下面的 故障排查。

可选润色

设置机器人命令（让用户看到菜单）

回到 @BotFather，发送 /setcommands，选择你的机器人，然后发送类似这样的列表：

help - Show what I can do
reset - Start over
contact - Talk to a human

Telegram 会把它们以菜单形式展示在聊天里。请确保你智能体的灵魂（SOUL）知道每个命令该做什么—— 否则菜单就只是装饰。

头像和描述

同样通过 @BotFather：

  • /setuserpic — 上传一张方形图片（你的 logo 就行）
  • /setdescription — 首次打开聊天的用户能看到的简短文字
  • /setabouttext — 在机器人个人资料里显示的更短的文字

隐私模式（群聊）

默认情况下，机器人在群聊里只能看到提及它或回复它的消息（“隐私模式”）。 如果你希望你的智能体读取群里的每条消息，向 BotFather 发送 /setprivacy 并选择 Disable。大多数机器人都应该保持启用状态—— 读取群里所有消息既侵扰，也会更快耗尽你的额度。

故障排查

机器人显示“在线”但不回复

按顺序检查：

  1. OpenClaw 的 Channels 标签页——连接状态是否仍然显示为 connected？
  2. 门户里的 额度余额——如果已经为零，你的智能体将无法回复。 先充值再试。
  3. 智能体的 会话日志——打开智能体的仪表板，检查最近的消息。 如果你能看到收到的消息但没有发出回复，请联系支持并提供详细信息，我们会帮你定位问题。

“401 Unauthorized” 或 “invalid token”

token 错误，或已经被撤销。回到 @BotFather，发送 /mybots，选择你的机器人，再选 API Token。 复制当前的 token，粘贴到 OpenClaw 的 Telegram 渠道配置中，保存。

我发了消息但什么都没到 OpenClaw

Telegram 通过 webhook 或长轮询投递消息。OpenClaw 默认使用 webhook， 这意味着 Telegram 需要能访问到你智能体的子域名。请确认：

  • 你智能体的子域名——在门户里 Open my OpenClaw 旁显示—— 能在浏览器中打开并显示 OpenClaw 的界面。这说明 TLS 和可达性都正常。 （sslip 风格的子域名使用自签证书，首次访问会有浏览器警告——对于开发租户这是预期的。）
  • OpenClaw 里填的 bot token 与 BotFather 当前显示的 token 一致。
  • 你没有不小心把同一个机器人连到了两个 OpenClaw 实例。Telegram 的 webhook 是一个单端点—— 谁最后设置的，谁有效。

如果仍然卡住，请从门户提交工单，提供：你的租户 ID、机器人的用户名（不是 token）、 以及没收到回复的那条消息的时间戳。我们可以在 VM 上检索智能体的日志。

我想删除这个机器人

在 @BotFather 里发送 /deletebot，选择该机器人，确认。 注意：用户名在删除后约 24 小时内仍被保留——你不能立刻复用它。

就这样。同一个机器人可以在 Telegram 上回复客户，同时 OpenClaw 也照样处理你的 Discord 和 Slack——一个智能体，所有渠道，每个平台都不需要额外配置。下一步： 连接 Discord 或 Slack。

接入 Telegram — Cloudo 文档