OpenClaw 3.31 手把手 + 避坑指南

配置飞书权限
在「权限管理」页面，点击「批量导入」，粘贴下面的 JSON：

{
  "scopes": {
    "tenant": [
      "im:message",
      "im:message:send_as_bot",
      "im:message.p2p_msg:readonly",
      "im:message.group_at_msg:readonly",
      "im:message:readonly",
      "im:resource",
      "im:chat.members:bot_access",
      "im:chat.access_event.bot_p2p_chat:read",
      "contact:user.employee_id:readonly",
      "application:application:self_manage",
      "application:bot.menu:write"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}
⚠️ 权限一定要给够！少了 im:message:send_as_bot 会导致机器人发不出消息，这是最容易踩的坑。

启用机器人
在「应用功能」→「机器人」里：

启用机器人能力
设置机器人名字（比如"Ai助手"）
6. 配置事件订阅
重点来了：这一步要先确保 OpenClaw Gateway 已经在运行！

在「事件订阅」页面：

选择「使用长连接接收事件」（WebSocket）
添加事件：im.message.receive_v1
⚠️ 如果 Gateway 没运行，长连接会失败，配置保存不了。先执行 openclaw gateway status 确保是 running 状态。

配置 OpenClaw
有两种方式，推荐第一种。

方式一：CLI 配置（推荐）
openclaw channels add
选择 Feishu，然后粘贴 App ID 和 App Secret。

方式二：手动改配置文件
编辑 ~/.openclaw/openclaw.json：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "dmPolicy": "pairing",
      "accounts": {
        "main": {
          "appId": "cli_xxx",
          "appSecret": "xxx",
          "name": "Ai助手"
        }
      }
    }
  }
}
💡 如果你用的是飞书国际版（Lark），加一行 "domain": "lark"。

第三步：启动 + 测试
1. 启动 Gateway
openclaw gateway
# 或者后台运行
openclaw gateway start
2. 在飞书里找到机器人
打开飞书，在聊天列表里应该能看到你的机器人。

3. 发送测试消息
给机器人发条消息，比如"你好"。

4. 配对验证
默认情况下，机器人会回复一个配对码。这是安全机制，防止陌生人随便跟你的 AI 聊天。

在终端执行：

openclaw pairing list feishu
你会看到类似这样的输出：

Pending pairing requests:
  feishu: ou_xxx123 → Code: 123456
然后批准它：

openclaw pairing approve feishu 123456
搞定！现在可以正常聊天了。