Openclaw 类多agent应用配置飞书的方法

xiuyu

11天前发布

140

配置 OpenClaw 连接飞书主要有两种方式：一种是使用官方集成的 feishu 频道，另一种是使用社区插件。当前搜索结果中，步骤最清晰、信息最完整的教程是基于官方 feishu 频道的配置方法。

整个流程分为三步：在飞书开放平台创建应用并配置权限、在 OpenClaw 中填入凭证、最终发布与测试。

📝 第一步：飞书开放平台配置

你需要在飞书开放平台创建一个企业自建应用，并为其添加机器人能力。

登录并创建应用：访问飞书开放平台，使用你的飞书账号（需具备管理员权限）登录。进入“开发者后台”，点击“创建企业自建应用”。
添加机器人能力：在应用的配置页面，点击左侧的“添加应用能力”，找到并添加“机器人”。
配置权限：这是至关重要的一步。进入“权限管理”页面，点击“批量导入/导出权限”。将下方完整的 JSON 权限代码粘贴进去，点击“格式化”和“申请开通”即可完成权限配置。

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

（这是核心权限，用于收发消息和发送卡片。部分教程中权限列表更长，可按需导入）

配置事件订阅：为了让 OpenClaw 能接收到你发送的消息，需要配置事件订阅。进入“事件与回调”页面，将“订阅方式”改为 “使用长连接接收事件” ，然后添加一个名为 im.message.receive_v1（接收消息）的事件。
获取凭证：最后，进入“凭证与基础信息”页面，复制 App ID 和 App Secret，保存好备用。

⚙️ 第二步：OpenClaw 配置

在 OpenClaw 端，你可以通过命令行或编辑配置文件来完成配置。

🐚 方法一：通过命令行配置 (推荐)

这是最快的方式，在终端中依次执行以下命令即可：

# 设置飞书应用的 App ID
openclaw config set channels.feishu.appId "你的_App_ID"

# 设置飞书应用的 App Secret
openclaw config set channels.feishu.appSecret "你的_App_Secret"

# 启用飞书频道
openclaw config set channels.feishu.enabled true

# 设置私聊策略为“配对模式”（更安全）
openclaw config set channels.feishu.dmPolicy pairing

# （可选）设置在群聊中必须@机器人才回复
openclaw config set channels.feishu.requireMention true

📝 方法二：直接编辑配置文件

如果你更习惯直接编辑文件，可以修改 ~/.openclaw/openclaw.json，在 channels 字段下添加 feishu 配置：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "你的_App_ID",
      "appSecret": "你的_App_Secret",
      "dmPolicy": "pairing",
      "groupPolicy": "allowlist",
      "requireMention": true
    }
  }
}

🚀 第三步：发布应用并测试

发布应用：回到飞书开放平台，点击左侧的“版本管理与发布”，创建一个新版本。填写版本号（如 1.0.0）和更新说明，然后点击“确认发布”。个人开发者账号通常即刻生效，企业账号可能需要管理员审核。
重启 OpenClaw 网关：在终端执行 openclaw gateway restart 命令，使配置生效。
开始对话：打开飞书客户端，在搜索框中找到你刚刚创建的应用（机器人）。进入聊天窗口，发送“你好”或“Hello”，机器人能正常回复就表示配置成功啦！

💡 进阶配置与排障

群聊使用说明

默认行为：在群聊中，机器人需要被 @ 才会回复，以免刷屏。
修改策略：你可以通过命令 openclaw config set channels.feishu.groupPolicy open 将群聊策略改为“开放模式”，允许机器人在不被@的情况下也响应消息。

常见问题排查

机器人无响应：最常见的原因是权限配置不完整或应用未成功发布。请仔细检查。
无法接收消息：确认在“事件与回调”中是否正确选择了 “长连接” 模式，并添加了 im.message.receive_v1 事件。
配对问题：如果遇到 No pending pairing request 的报错，可以在服务器终端用命令手动批准配对请求：
```
openclaw pairing list feishu   # 查看配对码
openclaw pairing approve feishu 配对码   # 批准配对
```