AI 与 OpenClaw

本文面向使用 OpenIMSDK 的用户，说明如何通过 OpenClaw Gateway 接入 OpenIMServer，并完成“发送第一条消息”的验证。

1. 前置条件

• 你已经部署了 OpenIMServer 和 ChatServer，已部署并启动 OpenClaw Gateway，并能在运行 Gateway 的机器上执行 openclaw 命令。

2. 注册 OpenClaw 用户

1. 注册用户

登陆管理后台，默认地址为http://server_ip:11002，server_ip为open-im-server部署地址 ip。

选择 用户管理->用户列表，点击右边创建新用户：

输入账号相关信息：

获取管理员 token

参考 获取管理员 Token 文档获取管理员 token。

获取用户 token

拿到管理员 token 后，参考 获取用户 Token 文档为指定用户签发登录 token。userID 填写刚刚注册的用户的 userID，platformID 填写 12（表示 bot）。

3. 安装 OpenIM Channel 插件

openclaw plugins install @openim/openclaw-channel

插件地址：https://www.npmjs.com/package/@openim/openclaw-channel

4. 启用插件并配置 OpenIM Channel

方式 A：交互式配置（推荐）

openclaw openim setup

按提示填入 token、wsAddr、apiAddr 等信息。

方式 B：直接编辑配置文件

编辑：~/.openclaw/openclaw.json

示例：

{
  "channels": {
    "openim": {
      "accounts": {
        "default": {
          "enabled": true,
          "token": "your_token",
          "wsAddr": "ws://127.0.0.1:10001",
          "apiAddr": "http://127.0.0.1:10002"
        }
      }
    }
  }
}

5. 验证：发送第一条消息

使用 OpenIM 通过 userID 搜索对应的机器人账号，对机器人账号发送一条消息，验证是否能够自动回复。

若对方成功收到消息，则说明 OpenClaw 已完成 OpenIM 接入。

6. 常见问题

• 提示 OpenIM is not connected：通常由 token、wsAddr、apiAddr 配置错误或网络不可达导致。请先核对配置，然后结合 OpenClaw Gateway 日志定位原因。