本文将以真正“跟着做就能成功”的方式, 一步一步教你如何使用 Clawdbot 部署一个可用的 Telegram AI 助手。
阅读前提:你已经成功部署并启动了 Clawdbot 核心服务。
一、整体流程先看懂(非常重要)
部署 telegram 助手本质只做三件事:
- 在 Telegram 创建一个 Bot
- 把 Bot Token 配置到 Clawdbot
- 重启服务并验证是否能对话
如果你后面遇到问题,80% 都出在 Token 或服务没重启。
二、Step 1:在 Telegram 创建你的专属机器人
1️⃣ 打开 BotFather
- 打开 Telegram
- 搜索
@BotFather - 点击进入官方机器人
2️⃣ 创建新 Bot
向 BotFather 发送:
/newbot
按提示依次完成:
- 设置机器人显示名称(可中文)
- 设置用户名(必须以
bot结尾)
3️⃣ 保存 Bot Token(非常重要)
创建成功后,BotFather 会返回一串类似这样的字符串:
123456789:AAxxxxxxxxxxxxxxxxxxxx
这就是 Telegram Bot Token,请妥善保存,不要泄露。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
三、Step 2:将 Telegram Token 配置到 Clawdbot
接下来这一步是最容易出错的地方, 请严格按顺序操作。
1️⃣ 找到 Clawdbot 配置文件
不同部署方式路径略有不同:
| 部署方式 | 配置文件位置 |
|---|---|
| Docker 部署 | .env |
| 脚本 / npm 安装 | ~/.clawdbot/clawdbot.json |
2️⃣ 写入 Telegram Token
Docker 部署用户,在 .env 中添加或修改:
由于我高估了大家对zblog程序的熟知度,发现还有很多站长并不是太熟悉这款程序,甚至连后台的登陆入口都不清楚。所以我晚上抽了一点点时间把该ZBLOG企业网站源码进行的修正,补充了大家的一些问题。并且我写了比较详细的使用教程,能够帮助新手朋友修改变成自己的企业网站使用。 修订版本改进了几处问题: 第一,修正了单页面中的顶部BANNER FLASH幻灯图片的显示错误问题; 第二,修正了在产品中心标题显
TELEGRAM_BOT_TOKEN=你的TelegramToken
注意:
- 不要加引号
- 不要有多余空格
3️⃣ 重启 Clawdbot 服务(必须)
docker-compose restart
如果你没有重启服务,Clawdbot 是不会读取新配置的。
四、Step 3:验证 Telegram 助手是否部署成功
1️⃣ 启动机器人
- 在 Telegram 搜索你创建的机器人
- 点击进入对话
- 发送
/start
2️⃣ 发送测试指令
例如:
列出当前目录的文件
如果机器人返回执行结果, 说明 Telegram 助手已经成功部署。
如果能执行系统指令,说明 Clawdbot 与 Telegram 的链路是完整的。
五、常见失败原因与排查思路
| 问题现象 | 排查重点 |
|---|---|
| 机器人完全没反应 | Token 是否正确 / 服务是否重启 |
| 一直显示处理中 | AI 模型配置是否可用 |
| 报权限相关错误 | 数据目录与系统权限 |
六、Telegram 助手的正确使用建议
- 优先使用自然语言描述任务
- 不要一次性下达过于复杂的指令
- 重要操作先让 AI 说明执行计划
- 避免在主力设备执行高风险系统命令
七、总结
当 Telegram 助手部署完成后, Clawdbot 才真正从“服务”变成“可随时对话的 AI 执行者”。
你不是在和 AI 聊天,而是在用聊天工具远程操控一套本地智能系统。
接下来你可以继续做的事情包括:
- 接入国产模型降低使用成本
- 安装插件扩展能力
- 设计自己的自动化工作流









