OpenClaw + Telegram 配置完全教程：5 分钟把 Claude 变成你的私人 Telegram 机器人

OpenClaw 支持多种消息渠道，其中 Telegram 是最推荐的——延迟低、手机体验好、支持 Markdown 格式显示代码。本文带你 5 分钟完成配置。

第一步：创建 Telegram Bot#

1. 打开 Telegram，搜索 @BotFather
2. 发送 /newbot
3. 输入机器人名称（显示名，例如：My Claude Assistant）
4. 输入用户名（必须以 bot 结尾，例如：myclaudeassistant_bot）
5. BotFather 返回 Bot Token，格式：123456789:ABCdefGHIjklMNOpqrsTUVwxyz

保存好 Token，后面配置需要用到。

第二步：获取你的 Telegram User ID#

User ID 是一串数字，例如：123456789。配置白名单时需要用到。

第三步：安装 OpenClaw#

# macOS / Linux
curl -fsSL https://install.openclaw.ai | bash

# 或 npm
npm install -g openclaw

# 验证安装
openclaw --version

第四步：配置 Telegram 渠道#

openclaw configure --section telegram

按提示输入：

也可以直接编辑配置文件 ~/.openclaw/config.json：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123456789:ABCdefGHIjklMNOpqrsTUVwxyz",
      "allowedUsers": [123456789],
      "adminUsers": [123456789]
    }
  }
}

第五步：配置 Claude API Key#

openclaw configure --section ai
# 输入 ANTHROPIC_API_KEY

# 或直接设置环境变量
export ANTHROPIC_API_KEY=sk-ant-你的key

第六步：启动 OpenClaw#

openclaw start

看到如下输出说明成功：

第七步：测试#

在 Telegram 找到你的机器人，发送：

或者直接发一条消息：

机器人应该会回复！

设置为系统服务（后台常驻运行）#

# macOS：使用 launchd
openclaw service install
openclaw service start

# Linux：使用 systemd
openclaw service install --systemd
systemctl --user enable openclaw
systemctl --user start openclaw

群组模式#

想在 Telegram 群组里使用：

1. 把机器人加入群组（管理员权限）
2. 在群里发消息时 @机器人用户名 触发
3. 配置里把群组 ID 加入 allowedGroups

{
  "channels": {
    "telegram": {
      "allowedGroups": [-1001234567890],
      "mentionRequired": true
    }
  }
}

常见问题#

Q：机器人不回复消息？ 检查：1) Token 是否正确；2) 你的 User ID 是否在 allowedUsers；3) OpenClaw 进程是否在运行（openclaw status）

Q：国内无法连接 Telegram？ 需要配置代理：

export HTTPS_PROXY=http://127.0.0.1:7890
openclaw start

Q：怎么让机器人在手机休眠时也能收到消息？ OpenClaw 需要运行在一台 24 小时开机的服务器上（家里的 Mac Mini、树莓派或云服务器）。

Q：可以配置多个 Telegram Bot 吗？ 目前每个 OpenClaw 实例只支持一个 Telegram Bot，但可以运行多个 OpenClaw 实例。

来源：OpenClaw 官方文档 | Telegram Bot API