OpenClaw Telegram集成教程：从创建Bot到配置完成的完整指南

凌晨两点，我盯着屏幕上的代码调试窗口，突然想到一个问题需要AI帮忙。打开浏览器、登录ChatGPT网站、等加载——这一套流程下来得好几分钟。那一刻我在想，要是能在Telegram上直接问我的AI助手该多好，就像和朋友聊天一样自然。

后来我发现，这个需求实现起来比想象中简单多了。OpenClaw配合Telegram Bot，半小时就能搞定。你不需要懂复杂的后端开发，也不用担心服务器配置——跟着这篇教程走，你也能拥有一个24小时在线的AI私人助手。

说实话，第一次看到Bot在Telegram里回复我的时候，那种成就感还挺爽的。今天我就把整个流程手把手教给你，包括那些我踩过的坑和常见的问题排查方法。准备好了吗？咱们开始吧。

低成本“养虾”指南：ArkClaw 让 AI Agent 真正平民化

最近很火的 OpenClaw（龙虾）好用但配置太劝退？字节火山引擎出的 ArkClaw 直接把门槛打到了地板。无需折腾服务器和 Token 配置，一键就能拥有一个 24 小时在线、能控浏览器、跑脚本、管日历的“AI 牛马”。

重点是真便宜： 月费仅 9.9 元，使用我的邀请码 ZLKUK54M（点击这里注册） 仅需 8.9 元。如果你是程序员，直接入 Coding Plan Pro 还能免费白嫖。

准备工作：你需要知道的基础概念

在动手之前，咱们先搞清楚几个关键概念。这不是无聊的理论课，理解这些能让你少走很多弯路。

Telegram Bot不是普通账号。它更像一个自动回复机器人的接口，可以接收消息、发送回复，但不能主动发起对话。想象一下客服机器人，你问它问题它才会回答。

BotFather是谁？ 这是Telegram官方提供的”Bot工厂”，所有Bot都从这里诞生。它本身也是一个Bot，通过和它对话就能创建、配置你自己的Bot。第一次听说的时候我还觉得挺有意思——用Bot来管理Bot。

OpenClaw在这里扮演什么角色？ 简单说，它是连接Telegram和AI大模型的桥梁。Telegram负责收消息，OpenClaw接收后转给Claude或GPT，然后把AI的回复再发回Telegram。整个流程你完全不用写代码。

你需要准备这些东西：

• 一个Telegram账号（应该都有吧）
• 已安装并运行的OpenClaw（如果还没装，可以参考官方文档或我之前写的安装教程）
• AI模型的API Key（Claude、GPT、Gemini都行，有免费额度的也可以先测试）

老实讲，这些准备工作其实不复杂。OpenClaw支持多平台（Telegram、WhatsApp、微信等）和多种AI模型，配置一次之后想换模型也很方便。

第一步：通过BotFather创建你的Telegram Bot

好了，正戏开始。打开Telegram，在搜索框输入 @BotFather，认准那个带蓝色认证标志的官方账号。别点错了，山寨的可不少。

创建Bot的对话流程超简单：

1. 给BotFather发送 /newbot 命令
2. 它会问你Bot的显示名称，随便起个好听的，比如”我的AI助手”
3. 接着要设置用户名，这个有讲究：必须以bot结尾，而且全网唯一。我第一次起名AIAssistantBot就被占用了，试了三四次才成功

如果你遇到”用户名已被占用”，试试加点数字或者你的名字缩写，比如 MyAwesomeAI2024Bot。

获取Bot Token是最关键的一步。创建成功后，BotFather会发给你一长串字符，格式大概像这样：

123456789:ABCdefGHIjklMNOpqrsTUVwxyz1234567890

这个Token就像你家钥匙一样重要。我见过有人不小心把Token提交到公开的GitHub仓库，结果额度被刷爆了，损失了好几百块。建议你马上复制到密码管理器或者加密笔记里，千万别发到聊天记录或者云笔记这种地方。

可选但建议做的配置：

• 用 /setdescription 给Bot设置简介，用户点开Bot时会看到
• 用 /setabouttext 设置”关于”信息
• 用 /setuserpic 上传个头像，看起来专业点

别忘了获取你自己的Telegram用户ID！这个待会儿配置白名单时要用。在Telegram搜索 @userinfobot，给它发个 /start，它会返回你的数字ID，看起来像 123456789 这样。把这个也记下来。

第二步：配置OpenClaw的Telegram Channel

拿到Bot Token后，接下来就是配置OpenClaw了。这一步看起来有点技术，但说白了就是编辑一个JSON文件。

找到配置文件。当前（2026）OpenClaw 的默认状态目录通常是 ~/.openclaw/，主配置文件为 openclaw.json。Telegram 的字段名与层级以官方 Telegram 频道文档为准；旧资料里的 ~/.clawdbot/config/channels.json 来自更名前的路径，如你仍在使用旧目录，请先对照系列中的更名说明做迁移。Docker 部署时请确认挂载的是否为 OPENCLAW_HOME / ~/.openclaw 对应路径。

KiloClaw - 企业级 OpenClaw 托管服务，赋能 AI Agent 自动化编排与智能模型路由

立即开始 →推广

下面是一段便于理解的示意（单人自用、显式允许自己的用户 ID，关闭「仅靠配对」的不确定性）。实际键名、默认值（例如默认 DM 常为 pairing）以官方文档与向导生成的文件为准，不要照抄过时的数组结构：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "YOUR_BOT_TOKEN_HERE",
      "dmPolicy": "allowlist",
      "allowFrom": [123456789]
    }
  }
}

字段说明（与官方对齐的要点）：

• botToken：从 BotFather 复制的 Token，注意不要夹带空格或换行
• dmPolicy / allowFrom：控制谁能给 Bot 发私聊；单人自用可采用 allowlist + 自己的数字 ID（更省心）。若使用官方默认的 pairing，首次私聊需要在网关侧执行 openclaw pairing approve telegram <CODE>（详见官方文档）
• enabled：是否启用该频道

怎么编辑这个文件？

如果你在 Linux 或 Mac 上：

nano ~/.openclaw/openclaw.json

如果用 Docker，进入容器后编辑挂载目录下的同一文件名（容器内路径取决于你的 compose 挂载）。

docker exec -it openclaw sh
vi /root/.openclaw/openclaw.json

或者直接在宿主机上编辑挂载目录的文件。

常见错误提醒：

• JSON格式要严格：最后一个键值对后面不能有逗号
• Token粘贴时容易多复制引号或空格，仔细检查
• allowFrom 是数组；即使只有一个用户也要写成数组形式（详见官方文档中的 ID 格式说明）

我第一次配置的时候就是多了个逗号，OpenClaw启动失败，查日志找了半天才发现。JSON格式检查工具（比如在线的JSONLint）能帮你避免这种低级错误。

第三步：设置白名单保护你的Bot

说到白名单，这个真的太重要了。想象一下，你的Bot Token不小心泄露了，全世界任何人都能用你的Bot消耗你的AI额度。我有个朋友就这样，一个月的Claude额度三天就用完了。

为什么必须设置白名单：

• 防止陌生人滥用你的AI额度（这是真金白银啊）
• 避免敏感信息泄露（你和AI的对话可能包含工作内容）
• 控制使用成本（特别是用GPT-4这种贵的模型）

怎么配置访问策略？还记得之前让你用 @userinfobot 获取的用户ID吗？在官方配置里，私聊侧常见字段是 channels.telegram.allowFrom（配合 dmPolicy）。

单用户（仅允许自己）示例（字段需写在 channels.telegram 下）：

"dmPolicy": "allowlist",
"allowFrom": [123456789]

多用户（团队）：

"dmPolicy": "allowlist",
"allowFrom": [123456789, 987654321, 555555555]

如何获取其他人的Telegram ID：

1. 让对方在Telegram搜索 @userinfobot（官方更推荐：先私聊你的 Bot，再用 openclaw logs --follow 从日志读取 from.id，见官方文档）
2. 发送 /start 命令
3. 把返回的数字ID告诉你
4. 你添加到 allowFrom 数组里

如果你是给团队配置，建议维护一个文档记录所有授权用户的ID和名字，方便管理。有人离职了就及时从白名单移除，这是基本的安全意识。

关于 Pairing（配对）模式：

官方默认的 Telegram DM 策略常为 pairing：首次私聊需要在网关机器上执行 openclaw pairing approve telegram <CODE>。若你希望像本教程这样「只靠用户 ID 即可访问」，可使用 dmPolicy: "allowlist" 并显式填写 allowFrom（详见官方文档）。

第四步：启动OpenClaw并测试连接

配置完成，激动人心的时刻到了。启动OpenClaw，看看你的Bot能不能正常工作。

启动 Gateway：

如果是本地安装（已执行过 openclaw onboard --install-daemon 时，可先 openclaw gateway status）：

openclaw gateway
# 或使用已安装的系统服务：
openclaw gateway start

从源码开发模式启动属于少数场景，日常使用者以 Gateway CLI 为准；不要用臆测的 npm start 代替官方文档中的命令。

如果用Docker部署：

docker compose up -d

检查服务状态：

启动后，看看日志确认Telegram Channel是否成功加载。用Docker的话：

docker compose logs openclaw -f

你应该能看到类似这样的日志：

阿里云 - 开发者上云首选，轻量服务器专享 8.5 折优惠，助力项目快速上线

领取 8.5 折优惠 →推广

[INFO] Loading Telegram channel: telegram-main
[INFO] Telegram bot connected successfully
[INFO] Listening for messages...

如果看到报错信息，别慌，记下错误内容，待会儿咱们有问题排查清单。

第一次对话测试（这是最激动的时刻）：

1. 在Telegram搜索你的Bot用户名（就是创建时那个以bot结尾的）
2. 点击聊天窗口下方的 Start 按钮
3. 发送一条测试消息，比如”你好”或”Hi there”
4. 如果一切正常，几秒钟后Bot会回复AI生成的内容

我第一次看到Bot回复的时候，真的有点小激动。那种感觉就像你亲手造了个机器人，然后它真的能和你聊天了。

如果Bot没有响应怎么办？先别急着重装，往下看问题排查清单，90%的问题都能快速解决。

常见问题排查清单

Bot不响应？配置不生效？别慌，咱们一步步排查。我把遇到过的问题都整理成了checklist，照着查基本都能解决。

问题1：Bot完全不响应任何消息

这是最常见的问题，可能原因有好几个。按这个顺序检查：

• OpenClaw服务是否正在运行？用 docker ps 或 ps aux | grep openclaw 确认
• Bot Token是否正确配置？检查 ~/.openclaw/openclaw.json 里 channels.telegram.botToken，确保没有多余的空格或引号
• 你的用户ID是否在 allowFrom（allowlist 策略）或已完成 pairing（pairing 策略）？再用 @userinfobot 或官方推荐的日志方式确认 ID
• 配置文件JSON格式是否正确？用JSONLint在线工具检查一下
• AI模型的API Key是否有效且有额度？登录AI服务商后台查看余额

排查命令：

# 查看OpenClaw日志
docker compose logs openclaw -f

# 检查配置文件格式
cat ~/.openclaw/openclaw.json | jq .

问题2：收到”Unauthorized”或”Forbidden”错误

这个错误十有八九是白名单问题。检查：

• 在 dmPolicy: "allowlist" 下，你的 Telegram 用户ID是否在 allowFrom 中（官方也接受带前缀的字符串形式，见文档）
• 若使用 pairing，请确认已在网关侧 openclaw pairing approve telegram <CODE>
• 修改配置后记得重启OpenClaw服务

问题3：Bot响应很慢

如果Bot要等很久才回复，可能是这些原因：

• AI模型API响应慢（特别是高峰期）
• 网络连接问题（检查服务器到AI服务商的网络）
• 服务器资源不足（查看CPU和内存使用率）

改善方法：

• 换个响应更快的AI模型试试
• 如果用的是GPT-4，可以先试试GPT-3.5或Claude 3 Haiku
• 升级服务器配置或优化网络

问题4：配置文件修改后不生效

这个我也遇到过，改了半天配置发现根本没用。原因：忘记重启服务了。

解决方法：

docker compose restart
# 或者
systemctl restart openclaw

问题5：如何查看Bot的对话历史

OpenClaw会把对话记录保存在本地。你可以：

• 查看日志文件（默认路径）
• 使用OpenClaw的Control UI（如果启用了）
• 直接查看数据库（SQLite或其他配置的数据库）

问题6：Bot Token泄露了怎么办

如果不小心把Token提交到公开仓库或者泄露了：

1. 立即在BotFather中使用 /revoke 命令撤销Token
2. 用 /token 命令生成新的Token
3. 更新OpenClaw配置文件
4. 重启服务
5. 检查AI服务商的用量，看是否被滥用

进阶配置（可选）

基础功能已经完全够用了，但如果你想玩点高级的，OpenClaw还有很多可以折腾的地方。

配置欢迎消息和命令菜单：

在BotFather中，你可以用 /setcommands 给Bot设置命令菜单，比如：

start - 开始对话
help - 查看帮助
clear - 清空对话历史

用户输入 / 时就能看到这些命令提示。

Railway - 现代化的部署平台，告别繁琐运维，让代码分钟级上线

立即开始 →推广

启用DM配对模式：

如果你想让多个人使用但又不想手动管理白名单，可以试试配对码模式：

"enableDmPairing": true

OpenClaw会生成一个配对码，用户首次使用时输入配对码即可激活。这个适合做成服务给其他人用。

配置不同用户使用不同AI模型：

OpenClaw支持按用户分配不同的AI模型。比如管理员用GPT-4，普通用户用GPT-3.5。具体配置可以参考OpenClaw官方文档的Multi-Model部分。

集成OpenClaw Skills：

Skills是OpenClaw的杀手级功能，可以让AI助手执行实际操作，比如：

• 文件管理（创建、读取、编辑文件）
• Shell命令执行
• 网页搜索
• 代码编写和调试

不过Skills功能需要谨慎开启，尤其是Shell命令执行，安全风险比较大。

设置对话记忆和个性化响应：

OpenClaw会自动保存对话历史，你可以配置记忆长度、个性化提示词等，让AI助手更符合你的使用习惯。

这些进阶功能我就不展开了，感兴趣可以去OpenClaw官方文档深入研究。

结论

说了这么多，回头看整个流程其实并不复杂。从BotFather创建Bot、获取Token，到配置OpenClaw、设置白名单，再到启动测试，整个过程半小时足够了。

回顾一下最容易出错的地方：

• Bot Token一定要妥善保管，别提交到公开仓库
• 白名单配置是安全的关键，别图省事跳过这一步
• JSON格式要严格，多一个逗号都会导致配置失败
• 改了配置记得重启服务，不然不生效

如果你按着这篇教程走下来，现在应该已经有一个能正常工作的Telegram AI助手了。打开Telegram随时问它问题，不用再打开浏览器、登录网站、等加载，体验真的舒服太多。

接下来你可以做什么：

• 试试不同的AI模型，看看哪个更适合你的需求
• 探索OpenClaw的Skills功能，让AI助手能执行实际操作
• 如果觉得好用，也可以给团队成员配置上

OpenClaw不只支持Telegram，还能接入WhatsApp、企业微信等平台。掌握了这套配置方法，其他平台也是触类旁通。

遇到问题别慌，回头看看问题排查清单，或者去OpenClaw社区问问。折腾这些工具的乐趣不就在于此嘛——每次解决一个问题，都能学到新东西。

现在，去和你的AI助手聊聊天吧！

15 分钟阅读 · 发布于: 2026年2月5日 · 修改于: 2026年4月29日

Easton

AI与智能