OpenClaw接入飞书 | 活死人の行知路

1 创建飞书应用

消息平台-飞书

1.1 创建应用

➜ 打开飞书开放平台，点击右上角【开发者后台】：

➜ 点击【创建企业自建应用】：

➜ 填写应用名称和描述后点击【创建】：

➜ 进入到默认页面，点击添加【机器人】，之后会在左侧「添加应用能力」下方出现「机器人」选项：

1.2 获取凭证

➜ 在「凭证与基础信息」页面，复制：App ID（格式如 cli_xxx） 和 App Secret:

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

1.3 配置权限

➜ 左侧选择「权限管理」，在中间面板点击【批量导入/导出权限】。

➜ 在弹出的「批量导入/导出权限」框中，点击「导入」：

➜ 粘贴以下 JSON 配置一键导入所需权限：

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "event:ip_list",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

1.4 启用机器人能力

可选，略。

1.5 启用飞书插件

使用 openclaw plugins enable feishu 开启 OpenClaw 内置的飞书插件（默认是 disable 状态，loaded 为开启）。

# 启用飞书插件
openclaw plugins enable feishu

# 查看插件列表
openclaw plugins list

➜ 启用后回到 OpenClaw 页面的频道页面就会看到添加的飞书（随着版本的迭代，页面可能也会随之变化）。

1.6 添加飞书渠道

如果你刚安装 OpenClaw，请运行设置向导：

openclaw onboard

📢 Group chat policy 选择 Open

📢 feishu 这个顶级配置下的 appId 和 appSecret 是默认机器人配置，必须要有！！我尝试过如果没有这些配置会影响创建多Agent时，各个Agent无法给出他们各自的独立工作空间目录，它们会使用默认的工作空间。

修改配置文件，增加一个默认的飞书渠道账号，这里顶级appId和appSecret与main中的一致：

{
	channels: {
    feishu: {
      enabled: true,
      appId: 'cli_a93dd554f179dcd4',
      appSecret: '__OPENCLAW_REDACTED__',
      connectionMode: 'websocket',
      domain: 'feishu',
      groupPolicy: 'open',
      accounts: {
        main: {
          appId: 'cli_a93dd554f179dcd4',
          appSecret: '__OPENCLAW_REDACTED__',
          botName: '数字助手-Aei',
        },
      },
    },
  },
  
}

📢 注意：这里需要先将feishu下的顶级appId和appSecret先移除掉，之后再创建多agent的时候再添加回来。

1.7 配置事件订阅

在 事件订阅 页面：

选择使用长连接接收事件（WebSocket 模式）
添加事件：

im.message.receive_v1（接收消息）
im.message.reaction.created_v1 (消息被reaction)
im.message.reaction.deleted_v1 (消息被取消reaction)
application.bot.menu_v6 (机器人自定义菜单事件)

⚠️ 注意：如果网关未启动或渠道未添加，长连接设置将保存失败。

1.8 发布应用

在 版本管理与发布 页面创建版本
提交审核并发布
等待管理员审批（企业自建应用通常自动通过）

➜ 在左侧导航侧选择「版本管理与发布」，中间面板中点击【创建版本】，然后输入“版本号”与“更新说明”，最后拉到最下方点击【保存】按钮，页面会提示发布信息，点击【确认发布】，企业自建应用通常自动通过。

2 测试

2.1 发送消息

➜ 打开飞书客户端，点开“开发者小助手”，找到之前的审批，点击“打开应用”

➜ 此时会进入机器人对话页可以进行对话了。

2.2 配对授权

➜ 默认情况下，机器人会回复一个 配对码，需要批准此代码：

➜ 复制并执行提供的命令：

openclaw pairing approve feishu <配对码>

➜ 批准后即可正常对话。

3 添加多个飞书渠道

3.1 配置

{
  channels: {
    feishu: {
      enabled: true,
      domain: 'feishu',
      groupPolicy: 'open',
      appId: 'cli_a93dd554f179dcd4',
      appSecret: '__OPENCLAW_REDACTED__',
      connectionMode: 'websocket',
      accounts: {
        aei: {
          appId: 'cli_a93dd554f179dcd4',
          appSecret: '__OPENCLAW_REDACTED__',
          botName: '数字助手-Aei',
          domain: 'feishu',
          groupPolicy: 'open',
        },
        alex: {
          appId: 'cli_a93c79ee44389cb6',
          appSecret: '__OPENCLAW_REDACTED__',
          botName: '项目经理-Alex',
          domain: 'feishu',
          groupPolicy: 'open',
        },
        mia: {
          appId: 'cli_a930a4dd46ba1cb1',
          appSecret: '__OPENCLAW_REDACTED__',
          botName: '产品经理-Mia',
          domain: 'feishu',
          groupPolicy: 'open',
        },
      },
    },
  },
  
  ...
}