> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmax.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenClaw + Telegram

> 在 Telegram 上部署 OpenClaw 机器人，接入 AihubMax

## 概述

使用 OpenClaw 和 AihubMax 部署一个 Telegram AI 聊天机器人。本指南将帮助你设置 OpenClaw 实例，使你能在 Telegram 对话中直接与 AI 模型交互。

<Info>
  本指南假设你已完成基本的 [OpenClaw 手动安装](/zh/integration-guide/openclaw)。如果尚未安装，请先完成 OpenClaw 的配置。
</Info>

## 前置条件

<CardGroup cols={2}>
  <Card title="AihubMax API Key" icon="key">
    一个有效的 AihubMax API Key。
  </Card>

  <Card title="OpenClaw 实例" icon="server">
    一个运行中的 OpenClaw 实例（参见[手动安装](/zh/integration-guide/openclaw)）。
  </Card>

  <Card title="Telegram 账号" icon="paper-plane">
    用于通过 BotFather 创建机器人的 Telegram 账号。
  </Card>
</CardGroup>

## 配置步骤

<Steps>
  <Step title="第一步：创建 Telegram 机器人">
    1. 打开 Telegram，访问 [@BotFather](https://t.me/BotFather)。
    2. 发送 `/start`，然后发送 `/newbot`。
    3. 为机器人设置一个用户名（必须以 `bot` 结尾，如 `my_foxapi_bot`）。
    4. BotFather 会提供一个 **Bot Token**——保存好用于下一步。

    ```
    Token 格式示例: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz
    ```
  </Step>

  <Step title="第二步：通过 Onboarding 配置 Telegram 频道">
    如果你还没有完成 OpenClaw 的初始化，运行 onboarding 向导并选择 Telegram 作为频道：

    ```bash theme={null}
    openclaw onboard --install-daemon
    ```

    在提示时选择 **"Telegram (Bot API)"**，并粘贴你的 Bot Token。

    如果你已经完成了初始化，可以手动将 Telegram 配置添加到 `~/.openclaw/openclaw.json`：

    ```json theme={null}
    {
      "channels": {
        "telegram": {
          "enabled": true,
          "botToken": "your-telegram-bot-token",
          "dmPolicy": "pairing",
          "groups": {
            "*": {
              "requireMention": true
            }
          }
        }
      }
    }
    ```
  </Step>

  <Step title="第三步：配对 Telegram 账号">
    配置好 Telegram 频道后，需要配对你的 Telegram 账号。在 Telegram 中与机器人开始对话，你会收到一个配对码。

    然后运行：

    ```bash theme={null}
    openclaw pairing approve telegram <配对码>
    ```
  </Step>

  <Step title="第四步：测试机器人">
    1. 打开 Telegram，搜索你的机器人用户名。
    2. 发送一条测试消息，如 **"你好！"**
    3. 机器人应该通过 AihubMax 配置的 AI 模型进行回复。

    <Note>
      在群聊中，机器人默认需要 `@提及` 才会回复。你可以在 `groups` 配置中修改此行为。
    </Note>
  </Step>
</Steps>

## 使用方式

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

## 验证连接

向你的 Telegram 机器人发送消息：

```
你是谁？你正在使用什么模型？
```

机器人应该通过 AihubMax 配置的 AI 模型返回回复。

## 常见问题

<AccordionGroup>
  <Accordion title="机器人不回复消息">
    * 检查 `openclaw.json` 中的 bot token 是否正确。
    * 确认 OpenClaw 守护进程正在运行：`openclaw status`
    * 确认 AihubMax API Key 有效且余额充足。
    * 检查日志中是否有错误信息。
  </Accordion>

  <Accordion title="收不到配对码">
    * 确认 `openclaw.json` 中 Telegram 频道已启用。
    * 修改配置后重启 OpenClaw 守护进程。
    * 尝试先给机器人发送 `/start`。
  </Accordion>

  <Accordion title="私聊正常但群聊不回复">
    * 群聊默认需要 `@提及` 机器人。
    * 可以设置 `"requireMention": false` 允许自由回复。
    * 确保机器人已被添加为群成员。
  </Accordion>
</AccordionGroup>