飞书机器人接入

准备工作

请开启SCNet OpenClaw服务，确保OpenClaw处于"运行中"状态：

第一步：创建飞书应用

打开飞书开放平台

访问 飞书开放平台，使用飞书账号登录。

创建飞书应用

1. 点击 创建企业自建应用，填写应用名称和描述并选择应用图标

2. 添加「机器人」能力

启用机器人能力（可选）

在 应用能力 > 机器人 页面：

1. 开启机器人能力，配置完成后，会默认开启
2. 配置机器人名称

获取应用凭证与回调加密策略凭证

在应用的 凭证与基础信息 页面，复制：

• App ID（格式如 cli_xxx）
• App Secret

❗ 重要：请妥善保管 App Secret，不要分享给他人。

在事件与回调页面，点击加密策略，保存Verification Token与Encrypt Key。
注意：Encrypt Key需要自行设置，不能使用默认值。

配置应用权限

在 权限管理 页面，点击 批量导入 按钮，粘贴以下 JSON 配置一键导入所需权限：

{
  "scopes": {
    "tenant": [
      "im:message",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:chat",
      "im:chat:readonly",
      "im:chat.members:bot_access",
      "im:resource",
      "contact:user.base:readonly",
      "contact:user.employee_id:readonly"
    ],
    "user": []
  }
}

📌核心权限说明：

• im:message / im:message:readonly：读取、接收飞书消息。
• im:message:send_as_bot：以机器人身份回复消息。
• im:chat / im:chat:readonly：获取群聊信息、管理群权限。
• contact:user.base:readonly：读取用户基础信息（用于身份识别）。

第二步：配置OpenClaw feishu channel

配置feishu channels

在超算互联网OpenClaw页面，点击代理，选择Raw，在右边的json配置中找到channels配置，修改feishu下的以下五项：

1. enabled修改为true
2. appId修改为第一步应用凭证的appId
3. appSecret修改为第一步应用凭证的Secret
4. verificationToken修改为第一步回调加密策略的凭证的Verification Token
5. encryptKey修改为第一步回调加密策略的凭证的Encrypt Key
   

⚙️ 注意： 一定要仔细检查每一项配置是否正确，不能有任何错误。

配置plugins entries

配置plugins-entries，配置feishu的enabled为true，最后点击save保存，等待服务重启完成，右上角健康状况正常。

📌说明： 点击保存后，界面 / 日志里不再显示明文，统一替换为 __OPENCLAW_REDACTED__

这是OpenClaw 的敏感信息脱敏标记，不是配置错误，而是安全机制。

第三步：配置飞书事件订阅

配置事件订阅

⚠️⚠️⚠️ 注意： 该步需要校验飞书机器人与OpenClaw的连接关系，因此必须先配置完成上述第二步配置OpenClaw feishu channel，才能进行事件配置。

1. 点击 事件与回调，订阅方式选择，"将事件发送至 开发者服务器"

此处请求地址为已启动的OpenClaw服务公网域名+ /feishu/events，域名地址如下：

请求地址URL拼接示例：https://c-2033480479177613313.ksai.scnet.cn:58043/feishu/events

2. 点击 保存 后，飞书机器人将校验与OpenClaw的连接可用性，若连接可用则可正常保存；若报错则需要检查请求地址是否正确和OpenClaw服务是否正常。

添加事件

📌说明：
1）事件订阅后，飞书机器人将接收所有消息事件，包括群聊消息、单聊消息等。
2）为当前事件订阅添加事件，选择应用身份订阅，搜索 im.message.receive_v1，其他均可选，点击添加 后，即可订阅该事件。

第四步：发布&使用

在飞书开放平台，点击创建版本，发布最新版本，等待管理员审批（企业自建应用通常自动通过）

1. 在 版本管理与发布 页面创建版本
2. 输入必要的信息，点击 保存 后，提交审核并发布。
3. 等待管理员审批（企业自建应用通常自动通过）

📌 说明： 在应用发布完成后，即可在飞书使用，如下图所示：

常见问题

1. 事件配置点击保存后，提示“返回数据不是合法的JSON格式” 答：
   1）OpenClaw配置好feishu channel后，需要仔细检查每一项配置是否正确，不能有任何错误。
   2）需要检查OpenClaw服务是否正常启动，是否可以访问。
   

2. OpenClaw配置RAW文件中appSecret和verificationToken，点击保存失败，显示“_OPENCLAW_REDACTED_” 答：正常现象。这里显示 __OPENCLAW_REDACTED__ 是 OpenClaw 的安全脱敏保护机制，表示系统已将你的填入内容识别为敏感信息，默认不直接展示或写入配置文件，以防止泄露。

3. OpenClaw配置好feishu channel时，事件与回调中的回调配置是必须配置的吗？ 答：不是必须配置的。飞书开放平台「回调配置」页签仅用于交互式卡片等即时交互场景，OpenClaw飞书机器人仅依赖「事件配置」接收消息，该页签无需配置，保持「未配置」状态完全不影响机器人正常使用。