⚠️ 待验证案例：本案例基于 OpenClaw Telegram 集成的真实能力描述，具体响应时间因服务器配置而异。如果你跑通了，欢迎联系站长提交验证记录。

🔧 Step 0：先配置消息接收渠道

⚠️ 本案例需要发送通知到你的手机，先配置消息渠道 👉 去配置 Telegram/飞书/微信接入 →

解决什么问题

OpenClaw 装在服务器上，你在外面没法用——这个场景解决这个问题：

谁会用到：把 OpenClaw 部署在 VPS/家庭服务器上的用户
省了什么：不用 SSH 登录，不用打开网页，直接 Telegram 消息操控
效果是什么：发一句话 → OpenClaw 收到 → 执行 → 把结果发回来

典型用法：

查一下 github.com/openclaw/openclaw 最新的 issue
帮我把 /home/server/backup.sh 跑一遍
现在几点，天气怎么样
把任务队列里第一个任务做掉
我家服务器 CPU 占用多少

前置条件

OpenClaw 已安装并运行（VPS、家庭服务器、本地机器均可）
一个 Telegram 账号
知道自己的 Telegram 用户 ID（下面有获取方法）
Claude Max 账号，或 Anthropic API Key

获取 Telegram 用户 ID：给 @userinfobot 发任意消息，它会回复你的 ID（纯数字，如 8526440826）。

用到的工具

工具	用途	获取方式
Telegram 集成（内置）	收发 Telegram 消息	OpenClaw 内置，配置 Bot Token 即可
anthropic/claude-sonnet-4-6	理解指令，执行任务	Claude Max 账号，或 console.anthropic.com

预期结果

配置完成后：

你发消息 → OpenClaw 秒级响应
任务执行中 → 可以收到进度通知
任务完成 → 结果直接回复到 Telegram 对话

两步上手

第一步：创建 Telegram Bot，获取 Token

在 Telegram 里找到 @BotFather
发送 /newbot
按提示给 Bot 起名字（如 MyOpenClawBot）
BotFather 会给你一个 Token，格式类似 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw
保存好这个 Token

第二步：告诉 OpenClaw 连上这个 Bot

把下面这段发给你的 OpenClaw（通过任何你现在能访问它的方式）：

帮我配置 Telegram 集成，让我可以通过 Telegram 给你发指令。

Bot Token：<你的Bot Token>
我的 Telegram 用户 ID：<你的用户ID>

配置完成后，给我发一条 Telegram 消息"你好，OpenClaw 已连线！"来确认配置成功。

配置完成后，以后就可以直接在 Telegram 里操控 OpenClaw 了。

常用指令示例

以下是一些发给 OpenClaw 的实用指令：

# 查询类
现在北京天气怎么样
帮我查一下最新的 OpenClaw 更新日志

# 任务执行类
把我工作区里的任务队列发给我看看
帮我给旭发一条消息，说我今天完成了XXX

# 系统信息类
服务器现在运行状态怎么样
帮我看看有没有新的 GitHub 通知

# 文件操作类（谨慎使用）
读取 /workspace/PROGRESS.md 给我看

安全配置建议

OpenClaw 接受 Telegram 指令时，默认只响应你自己（通过你的用户 ID 验证）。但还是建议：

不要公开 Bot Token：Bot Token 相当于密钥，泄露了别人可以冒充你操控 OpenClaw
用私聊，不用群组：群组里 Bot 会被多人触发，容易误操作
敏感操作二次确认：让 OpenClaw 在执行删除、发送外部消息等操作前先问你确认

# 在 SOUL.md 或 AGENTS.md 里加这条规则：
# 通过 Telegram 收到涉及删除文件、发送公开消息、重启服务的指令时，先回复"确认执行[操作名]？回复 YES 继续"

进阶：让 OpenClaw 主动推送通知

除了被动响应，还可以让 OpenClaw 在完成任务后主动告诉你：

# cron 任务完成后自动通知
openclaw cron add \
  --name "每日系统状态播报" \
  --cron "0 8 * * *" \
  --tz "Asia/Shanghai" \
  --message "帮我检查服务器运行状态，包括：磁盘空间、内存使用率、最近的错误日志（最多5条）。把结果整理成简洁的每日报告发给我。" \
  --announce \
  --channel telegram \
  --to "你的Telegram用户ID"

这样每天早8点你会在 Telegram 收到一条服务器健康报告。

怎么验证成功了

完成配置后，直接在 Telegram 里给你的 Bot 发消息：你好
OpenClaw 应该在几秒内回复一条消息
再发：现在几点了 — 它应该回答当前时间
最后发：帮我读一下工作区的 HEARTBEAT.md — 它应该读取并回复内容

踩坑记录

Bot 没有响应

症状：给 Bot 发消息，没有任何回复。

解法：

确认你先给 Bot 发过 /start 命令（Telegram 要求用户先主动开始对话）
检查 OpenClaw 服务是否正在运行：openclaw status
检查 Bot Token 是否填写正确

响应延迟很高

症状：发消息后要等 10 秒以上才回复。

解法：OpenClaw 部署在国内服务器时，Telegram API 访问可能不稳定。可以考虑：

给 OpenClaw 服务器配置代理
或者用支持 Telegram 的海外服务器部署

收到消息但不执行

症状：OpenClaw 回复了，但没有按指令操作，只是在解释。

解法：指令要具体明确。不说帮我看看服务器，说检查服务器的 CPU 使用率和内存占用，给我数字。

多个 OpenClaw 实例冲突

症状：发消息后收到两条回复，或者回复内容混乱。

解法：一个 Bot Token 只能对应一个 OpenClaw 实例。如果你有多台服务器，每台都需要创建独立的 Bot。

不满意怎么调

想加快速命令 → 让 OpenClaw 帮你配置快捷指令映射，比如发 /status 自动触发状态检查
想接收告警推送 → 结合 cron 或 heartbeat，让 OpenClaw 在检测到异常时主动给你发 Telegram
想多人共用 → 在 AGENTS.md 里配置白名单，允许多个用户 ID 发指令
想接入群组 → 可以把 Bot 加入群组，但建议用特定前缀触发，如 @BotName 帮我查...

Telegram 指令控制 OpenClaw