飞书 / Lark 接入

飞书是 OpenClaw 官方支持的渠道，国内用户推荐首选。

创建飞书应用

1. 进入开发者后台

访问 飞书开放平台，登录后点击「创建企业自建应用」。

2. 添加机器人能力

在应用详情页 → 添加应用能力 → 选择「机器人」。

3. 获取凭证

在「凭证与基础信息」页面记录：

• App ID
• App Secret

4. 配置权限

在「权限管理」中搜索并开通以下权限：

权限	权限标识	说明
获取与发送单聊消息	im:message	基础消息能力
以应用身份发送消息	im:message:send_as_bot	Bot 发送消息
获取群组信息	im:chat	群聊支持
读取群消息	im:chat:read	群聊消息读取
获取消息中的资源文件	im:resource	图片/文件处理
接收群聊@消息	im:message.group_at_msg:readonly	群聊 @机器人
接收单聊消息	im:message.p2p_msg:readonly	私聊消息
获取用户基本信息	contact:user.base:readonly	用户识别

5. 配置事件订阅

在「事件订阅」页面：

• 订阅方式选择 长连接（无需公网回调地址）
• 添加事件：im.message.receive_v1（接收消息）

连接到 OpenClaw

方式一：命令行配置

openclaw config set channels.feishu.appId "cli_xxxx"
openclaw config set channels.feishu.appSecret "xxxx"
openclaw config set channels.feishu.enabled true

方式二：编辑配置文件

编辑 ~/.openclaw/openclaw.json：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_xxxx",
      "appSecret": "xxxx"
    }
  }
}

重启 Gateway：

openclaw gateway restart

发布应用

1. 在飞书开放平台点击「版本管理与发布」
2. 创建版本并提交审核
3. 管理员在飞书管理后台审批通过
4. 应用上线后，员工可在飞书中搜索并使用机器人

使用方式

• 私聊：直接给机器人发消息
• 群聊：在群中 @机器人 + 消息内容
• 首次使用需要完成配对（pairing）

使用 openclaw-cn

如果使用 openclaw-cn 中文版，飞书适配已内置，配置更简单：

npm install -g openclaw-cn@latest
openclaw-cn onboard --install-daemon
# 向导中直接选择飞书渠道

常见问题

机器人收不到消息

1. 检查事件订阅是否配置了 im.message.receive_v1
2. 确认订阅方式为「长连接」
3. 检查权限是否全部开通并审批通过
4. 运行 openclaw doctor 检查连接状态

群聊中不响应

• 确认已开通 im:message.group_at_msg:readonly 权限
• 群聊中必须 @机器人 才会触发响应
• 检查机器人是否已被添加到群中