跳转到主要内容

​
概述

使用 OpenClaw 和 FoxAPI 部署一个 Telegram AI 聊天机器人。本指南将帮助你设置 OpenClaw 实例，使你能在 Telegram 对话中直接与 AI 模型交互。
本指南假设你已完成基本的 OpenClaw 手动安装。如果尚未安装，请先完成 OpenClaw 的配置。

​
前置条件

FoxAPI API Key

一个有效的 FoxAPI API Key。

OpenClaw 实例

一个运行中的 OpenClaw 实例（参见手动安装）。

Telegram 账号

用于通过 BotFather 创建机器人的 Telegram 账号。

​
配置步骤

1

第一步：创建 Telegram 机器人

  1. 打开 Telegram，访问 @BotFather。
  2. 发送 /start，然后发送 /newbot。
  3. 为机器人设置一个用户名（必须以 bot 结尾，如 my_foxapi_bot）。
  4. BotFather 会提供一个 Bot Token——保存好用于下一步。
Token 格式示例: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz
2

第二步：通过 Onboarding 配置 Telegram 频道

如果你还没有完成 OpenClaw 的初始化，运行 onboarding 向导并选择 Telegram 作为频道：
openclaw onboard --install-daemon
在提示时选择 “Telegram (Bot API)“，并粘贴你的 Bot Token。如果你已经完成了初始化，可以手动将 Telegram 配置添加到 ~/.openclaw/openclaw.json：
{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "your-telegram-bot-token",
      "dmPolicy": "pairing",
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}
3

第三步：配对 Telegram 账号

配置好 Telegram 频道后，需要配对你的 Telegram 账号。在 Telegram 中与机器人开始对话，你会收到一个配对码。然后运行：
openclaw pairing approve telegram <配对码>
4

第四步：测试机器人

  1. 打开 Telegram，搜索你的机器人用户名。
  2. 发送一条测试消息，如 “你好！”
  3. 机器人应该通过 FoxAPI 配置的 AI 模型进行回复。
在群聊中，机器人默认需要 @提及 才会回复。你可以在 groups 配置中修改此行为。

​
使用方式

操作方法
私聊直接给机器人发送任何消息
群聊在群中 @提及机器人
切换模型通过 openclaw model switch CLI 命令

​
验证连接

向你的 Telegram 机器人发送消息： 
你是谁？你正在使用什么模型？
机器人应该通过 FoxAPI 配置的 AI 模型返回回复。

​
常见问题

  • 检查 openclaw.json 中的 bot token 是否正确。
  • 确认 OpenClaw 守护进程正在运行：openclaw status
  • 确认 FoxAPI API Key 有效且余额充足。
  • 检查日志中是否有错误信息。
  • 确认 openclaw.json 中 Telegram 频道已启用。
  • 修改配置后重启 OpenClaw 守护进程。
  • 尝试先给机器人发送 /start。
  • 群聊默认需要 @提及 机器人。
  • 可以设置 "requireMention": false 允许自由回复。
  • 确保机器人已被添加为群成员。