连接 Telegram Bot

预计用时：10 分钟 | 前置条件：已完成 OpenClaw 安装

为什么连接 Telegram

到目前为止，你的 AI 助手只能在电脑终端里对话。但你不可能随时坐在电脑前。

把 OpenClaw 连上 Telegram 之后：

手机随时对话 — 通勤路上、排队等候、躺在床上，想到什么问什么
不需要开电脑 — 只要你的 Mac 在家开着（或有服务器），Bot 就永远在线
对话有记忆 — OpenClaw 的记忆系统在 Telegram 上同样生效，它会记住你说过的话
支持图片和文件 — 可以发图片让 AI 分析，或者让 AI 帮你处理文件

整个过程只需要三样东西：一个 Telegram 账号、一个新建的 Bot、几行配置。

第一步：创建 Telegram Bot

Telegram 的 Bot 不需要写代码。你只需要找一个叫 BotFather 的官方机器人，按照对话流程就能创建。

1.1 找到 BotFather

打开 Telegram（手机或电脑端都行），在搜索栏输入 @BotFather。

认准官方的那个——名字旁边有一个蓝色的验证对号。点进去，点击底部的 Start 按钮开始对话。

1.2 创建新 Bot

给 BotFather 发送：

code

/newbot

BotFather 会依次问你两个问题：

问题 1：你的 Bot 叫什么名字？

这是显示名称，可以用中文，比如：

code

我的AI助手

问题 2：你的 Bot 用户名是什么？

这是 Telegram 里的唯一标识符，必须用英文，并且以 bot 结尾。比如：

code

my_ai_helper_bot

用户名是全局唯一的。如果提示已被占用，换一个试试。可以在名字里加上你的名字缩写或数字，比如 neo_ai_2026_bot。

1.3 保存 Bot Token

创建成功后，BotFather 会给你一条消息，里面包含你的 Bot Token。它看起来像这样：

code

7123456789:AAHxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

把这个 Token 复制下来，保存到安全的地方。后面配置时需要用到。

这个 Token 就是你的 Bot 的"钥匙"。任何拿到它的人都能控制你的 Bot。不要发给别人，不要发到群里，不要上传到 GitHub。

第二步：获取你的 User ID

OpenClaw 需要知道"谁有权限和这个 Bot 对话"。为此，你需要获取自己的 Telegram User ID。

在 Telegram 搜索 @userinfobot，点进去，发送任意一条消息（比如"hi"）。

它会立刻回复你的用户信息，其中有一行：

code

Id: 123456789

这串数字就是你的 User ID。记下来。

User ID 和你的用户名（@xxx）不是一回事。User ID 是纯数字，不会变。

第三步：配置 OpenClaw

现在你手上有两样东西：Bot Token 和 User ID。接下来把它们告诉 OpenClaw。

方式一：用配置菜单（推荐新手）

code

bash ~/.openclaw/config-menu.sh

在菜单中选择 Telegram 相关的选项，按提示输入 Bot Token 和 User ID。配置完成后菜单会自动重启服务。

方式二：直接编辑配置文件

如果你更喜欢手动操作，用任何文本编辑器打开 ~/.openclaw/openclaw.json：

code

# 用 VS Code 打开
code ~/.openclaw/openclaw.json
 
# 或者用系统自带的编辑器
open -e ~/.openclaw/openclaw.json
 
# 或者用终端编辑器
nano ~/.openclaw/openclaw.json

找到 channels 部分（如果没有就新增），添加 Telegram 配置：

code

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "7123456789:AAHxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "dmPolicy": "pairing"
    }
  }
}

注意：上面的 botToken 要替换成你自己的。dmPolicy 设为 "pairing" 表示需要配对认证才能和 Bot 对话，这是最安全的方式。

编辑完保存，然后重启 OpenClaw 让配置生效：

code

openclaw gateway restart

第四步：配对认证

配置好之后，你的 Bot 还不会直接回复你。因为我们启用了 pairing 安全策略——你需要先"配对"，证明这个 Telegram 账号是你本人。

4.1 触发配对

打开 Telegram，找到你刚创建的 Bot，给它发一条消息：

code

你好

Bot 不会回复你的问题，而是会回复一个 配对码，看起来类似：

code

ABCD1234

4.2 在终端完成配对

回到你的 Mac 终端，执行：

code

openclaw pairing approve telegram ABCD1234

把 ABCD1234 替换成你实际收到的配对码。

终端会提示配对成功。

4.3 验证配对

可以查看当前所有已配对的用户：

code

openclaw pairing list

你应该能看到你的 Telegram User ID 出现在列表中。

第五步：测试

回到 Telegram，给你的 Bot 再发一条消息：

code

你好，你是谁？

如果一切正常，Bot 会在几秒钟内回复你。恭喜，你的 AI 助手正式上线了。

试试问它一些问题：

"帮我翻译这段话成英文：今天天气真好"
"Python 里怎么读取一个 CSV 文件？"
"给我讲个冷笑话"

个性化你的 AI

OpenClaw 有一个特殊的文件叫 SOUL.md，它定义了你的 AI 助手的"人设"——性格、说话风格、擅长什么、禁止做什么。

用编辑器打开它：

code

code ~/.openclaw/workspace/SOUL.md

你可以自由编辑这个文件。比如：

code

# 关于我
 
你是小助手，Neo 的个人 AI 助手。
 
## 性格
 
- 说话简洁，不啰嗦
- 有幽默感，偶尔开玩笑
- 用中文回答，除非用户用英文提问
 
## 擅长
 
- 编程（Python、TypeScript、Rust）
- 翻译（中英互译）
- 写作（技术文档、博客）
 
## 规则
 
- 不确定的事情要说明，不要编造
- 涉及金融投资的建议要加免责声明

编辑完保存，不需要重启 OpenClaw，下一次对话就会自动生效。

排错指南

问题 1：给 Bot 发消息，完全没有任何回复

检查 OpenClaw 是否在运行：

code

openclaw gateway status

如果显示 stopped 或者报错，先启动：

code

openclaw gateway start

检查配对状态：

code

openclaw pairing list

如果列表为空，说明还没有配对成功。重新走一遍第四步。

检查日志找线索：

code

openclaw logs --follow

打开实时日志后，再去 Telegram 发一条消息，观察终端里有没有输出。

问题 2：Bot 回复很慢（超过 30 秒）

这通常是 AI 模型响应慢，不是 OpenClaw 的问题。可能的原因：

网络到 OpenAI 服务器较慢
Codex 服务器正在高峰期
你的问题很复杂，模型需要更多时间思考

如果经常很慢，可以考虑换一个更快的模型（比如 gpt-4o-mini）。

问题 3：Bot 回复了，但内容不对或者乱码

检查推理引擎是否正常：

code

openclaw doctor

看模型相关的检查项是否通过。如果 Codex OAuth Token 过期了，重新授权：

code

openclaw models auth login --provider openai-codex

问题 4：配对码输入后提示失败

确保配对码没有过期（收到后尽快使用）
确保输入时大小写和字符完全一致
如果反复失败，重启 OpenClaw 后重试：

code

openclaw gateway restart

然后在 Telegram 重新发消息获取新的配对码。

小结

到这里，你已经完成了：

创建了自己的 Telegram Bot
把 Bot 连接到了 OpenClaw
完成了安全配对
可以用手机随时和 AI 对话了

你的 AI 助手现在是一个真正随身携带的智能助理了。

下一步

你的 AI 助手已经能用了，但安全方面还需要加固。下一步我们会设置权限控制、沙箱隔离等安全措施，确保你的数据和账号万无一失。

安全加固 -->