本文将以真正“跟着做就能成功”的方式， 一步一步教你如何使用 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 中添加或修改：
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 聊天，而是在用聊天工具远程操控一套本地智能系统。
接下来你可以继续做的事情包括：
- 接入国产模型降低使用成本
- 安装插件扩展能力
- 设计自己的自动化工作流
