第一步：登录飞书开放平台

打开 飞书开放平台，使用飞书 App 扫描二维码登录。

登录成功后进入开发者后台，可以看到已有应用列表和”创建企业自建应用”按钮。

第二步：创建企业自建应用

点击 “创建企业自建应用” 按钮，在弹窗中填写：

• 应用名称: OpenClaw（自定）
• 应用描述: OpenClaw AI 助手飞书机器人（自定）
• 应用图标: 选择机器人图标

创建成功后自动跳转到”添加应用能力”页面，左上角可以看到应用名称和状态。

第三步：添加机器人能力

在”添加应用能力”页面，点击 机器人 卡片下的 “添加” 按钮。

添加成功后跳转到机器人配置页面，左侧导航栏出现”机器人”菜单项。

第四步：获取应用凭证

进入 凭证与基础信息 页面，获取以下凭证（后续服务器端配置需要）：

• App ID: cli_xxxxx(你的App ID)
• App Secret: 点击眼睛图标显示明文后复制

第五步：配置权限

进入 权限管理 页面，使用 批量导入 功能一次性添加所需权限。

点击 “批量导入/导出权限” 按钮，在 Monaco 编辑器中粘贴以下 JSON：

{
  "scopes": {
    "tenant": [
      "im:message",
      "im:message:send_as_bot",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "contact:user.base:readonly"
    ]
  }
}

点击 “下一步，确认新增权限”，在弹出的开通权限面板中确认。

注意: Monaco 编辑器的自动缩进可能导致逐字符输入时 JSON 格式错乱。推荐使用剪贴板粘贴（Cmd+A 全选 → Cmd+V 粘贴）。

第六步：首次发布应用

进入 版本管理与发布 页面，创建 v1.0.0 版本并发布。飞书个人版应用免审核，提交后自动通过。

首次发布是为了让应用处于”已启用”状态，后续才能完成服务器端 WebSocket 连接。

第七步：OpenClaw 服务器端配置

安装飞书插件

openclaw plugins install @m1heng-clawd/feishu

编辑配置文件

在 ~/.openclaw/openclaw.json 中添加 channels.feishu 配置：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_xxxxx(你的App ID)",
      "appSecret": "xxxxx(你的App Secret)",
      "connectionMode": "websocket",
      "dmPolicy": "pairing",
      "groupPolicy": "open"
    }
  }
}

重启网关并验证

openclaw gateway restart
openclaw logs

日志中应看到：

feishu[default]: bot open_id resolved: ou_xxxxxxxxxxxxx
feishu[default]: starting WebSocket connection...
feishu[default]: WebSocket client started

第八步：配置事件订阅

WebSocket 连接成功后，返回飞书开放平台 事件与回调 页面。

保存长连接订阅方式

点击 “订阅方式” 按钮，确认已选中 “使用长连接接收事件（推荐）”，点击 “保存”。

重要: 必须先完成服务器端配置（第七步）并确认 WebSocket 连接成功，否则保存时会报错”未检测到应用连接信息”。

添加 im.message.receive_v1 事件

保存订阅方式后，“添加事件” 按钮变为可用。点击后在搜索框中输入”接收消息”，勾选 接收消息 v2.0 (im.message.receive_v1)，点击 “确认添加”。

事件列表中可以看到：

• 接收消息 v2.0 im.message.receive_v1
• 订阅类型：应用身份
• 所需权限：已开通

第九步：重新发布应用

添加事件订阅后，页面顶部提示”版本发布后，当前修改方可生效”。

点击 “创建版本”，填写版本号 1.1.0，更新说明填写”添加事件订阅：接收消息 im.message.receive_v1”，保存后确认发布。

发布成功后：

• 版本详情显示 “已发布”
• 更新说明：添加事件订阅：接收消息 im.message.receive_v1
• 应用能力：机器人（已启用）
• 事件订阅变更：使用长连接接收事件
• 顶部提示变为 “当前修改均已发布”

第十步：配对与激活

1. 在飞书 App 中搜索 “OpenClaw” 机器人
2. 发送任意消息（如”你好”）
3. 机器人回复配对信息： OpenClaw: access not configured. Your Feishu user id: ou_xxxxxxxxxxxxx Pairing code: XXXXXX Ask the bot owner to approve with: openclaw pairing approve feishu XXXXXX
4. 在终端执行配对命令： openclaw pairing approve feishu <配对码>
5. 输出 Approved feishu sender ou_xxxxxxxxxxxxx 即表示配对成功

此后在飞书中向 OpenClaw 机器人发送消息即可正常交互。

完整操作顺序