实战案例

OpenClaw + Telegram:打造你的专属 AI 机器人全攻略

· 约 9 分钟阅读

Telegram 是 OpenClaw 最流行的接入渠道之一。通过 Telegram 机器人,你可以在手机上随时随地控制你的 AI 助手,发送指令、接收结果、管理自动化任务。这篇文章是 OpenClaw Telegram 渠道的完整实战指南。

为什么选 Telegram?

  • 跨平台:手机、电脑、平板都能用
  • 响应速度快,消息推送及时
  • 支持机器人 API,功能丰富
  • 支持文件传输(可以发文档给 AI 处理)
  • 支持群组,整个团队可以共用一个机器人
  • 不需要手机号码绑定(可用匿名账号)

第一步:创建 Telegram 机器人

  1. 在 Telegram 中搜索 @BotFather
  2. 发送 /newbot
  3. 输入机器人显示名称(如:My OpenClaw Assistant)
  4. 输入机器人用户名(必须以 bot 结尾,如:myopenclaw_bot)
  5. 复制获得的 Token(格式:7234567890:AAHxxx...

第二步:配置 OpenClaw

openclaw channel add telegram

# 输入 Bot Token
# 选择访问模式(私聊/群组/全部)

或者直接编辑配置文件:

# ~/.openclaw/config.yml
channels:
  telegram:
    enabled: true
    bot_token: "7234567890:AAHxxx..."
    allowed_user_ids: [123456789]   # 你的 Telegram 用户 ID
    allow_groups: false              # 是否允许群组使用

如何获取你的 Telegram 用户 ID?

在 Telegram 中搜索 @userinfobot,发送任意消息,它会返回你的用户 ID。

基础指令使用

OpenClaw 接入 Telegram 后,直接发送自然语言指令即可:

# 普通对话
今天苏州天气怎么样?

# 执行任务
帮我搜索一下 OpenClaw 最新版本的更新内容

# 系统操作(需要 shell 技能)
检查一下服务器的内存使用情况

# 文件处理(发送文件后)
帮我总结一下这份 PDF 的主要内容

# 设置定时任务
每天早上 9 点提醒我开站会

内置命令

命令 功能
/start 开始/重置会话
/help 显示帮助信息
/status 查看 OpenClaw 系统状态
/tasks 查看所有定时任务
/memory 查看当前记忆摘要
/model 切换 LLM 模型
/clear 清除当前会话上下文

进阶用法:文件处理

直接向机器人发送文件,然后说明要做什么:

# 发送一个 PDF/Word 文档,然后说:
帮我提取这份合同中的关键条款,列成清单

# 发送一张图片,然后说:
帮我描述这张图片的内容,并提取其中的文字

# 发送一个 CSV 文件,然后说:
帮我分析这份数据,找出销售最好的 TOP 5 产品

群组使用配置

允许团队成员在群组中使用:

# ~/.openclaw/config.yml
channels:
  telegram:
    allow_groups: true
    group_ids: [-100123456789]      # 允许的群组 ID(负数)
    require_mention: true           # 必须 @机器人才触发
    group_allowed_user_ids:         # 群组中允许使用的用户
      - 123456789
      - 987654321

群组中使用时:

@你的机器人名称 帮我查一下明天的会议安排

消息格式设置

# 让机器人回复使用 Markdown 格式
openclaw config set telegram.parse_mode markdown

# 长消息自动分段
openclaw config set telegram.max_message_length 4000

安全建议

  • 务必设置 allowed_user_ids 白名单,防止陌生人调用
  • 敏感操作(如 shell 命令执行)需要二次确认
  • 定期检查 Bot Token 是否泄露
  • 不要在群组中开启 shell 技能权限

故障排查

机器人不响应消息

openclaw status          # 检查服务是否运行
openclaw logs -f         # 实时查看日志

收到”未授权”提示:你的 Telegram 用户 ID 不在白名单,检查 allowed_user_ids 配置。

机器人发不出消息:先在 Telegram 中发送 /start 给机器人,机器人需要先收到消息才能主动发送。

小结

Telegram + OpenClaw 是目前最流畅的移动端 AI 助手体验。配置好后,你的手机就是控制整个 AI 自动化系统的遥控器——随时下指令,随时收结果,随时查看定时任务运行情况。


相关阅读:

📚 相关文章

分享到: QQ 微博