OpenClaw Channel 对接飞书：从零到一实现企业级 AI 助理

摘要：本文详细介绍如何使用 OpenClaw 框架快速搭建飞书（Feishu）机器人通道，实现企业内部的 AI 助理部署。通过配置飞书开放平台应用和 OpenClaw 的 channel 系统，你可以轻松拥有一个支持群聊、私聊、消息路由的智能助理。

一、OpenClaw 是什么？

OpenClaw 是一个多通道 AI 助理框架，支持将大语言模型能力快速对接到各种通讯平台。它的核心优势包括：

• 多通道网关：一套代码，对接多个平台（飞书、Telegram、WhatsApp 等）
• 插件化架构：通过扩展机制灵活添加新功能
• 本地优先：数据不出域，适合企业私有化部署
• Agent 路由：根据消息来源自动路由到不同的 AI 助理

二、飞书开放平台准备工作

2.1 创建企业自建应用

1. 访问 飞书开放平台
2. 登录企业管理员账号（个人一样）
3. 点击「创建应用」→ 选择「企业自建应用」
   
4. 填写应用名称（如：AI 助理）、图标、描述

2.2 获取应用凭证

创建完成后，在「凭证与基础信息」页面获取：

• App ID（如：cli_xxxx）
• App Secret（如：xxxxxxx）

⚠️ 注意：App Secret 仅显示一次，请妥善保存！

2.3 配置机器人能力

在「应用能力」→「机器人」中：

• 启用机器人

• 配置机器人名称和头像

• 开启「接收消息」权限、

  

  不清楚如何配置的可以直接用这个脚本导入权限

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

2.4 配置事件订阅（可选）

如需接收群聊消息、添加好友等事件：

1. 进入「事件订阅」页面
2. 填写请求地址（OpenClaw Gateway 的 Webhook URL）
3. 订阅所需事件（如：im.message.receive_v1）
   
   记得先要发布 不然不会生效；
   如果出现无法添加事件的别着急 就先去配置openclaw的飞书连接再回来开通事件

三、OpenClaw 配置飞书 Channel

3.1 安装 OpenClaw

不详细介绍如何部署了可以参考之前部署文章

npm install -g openclaw

3.2 配置 channels

前提如果本地还未安装 飞书渠道 需要先安装后配置

3.2.1 openclaw 飞书安装过程

win + X 选择 -> 终端管理员 -> 进入cmd 窗口
1 命令行输入

openclaw channels add

随后会进入一个命令行交互界面，你可以使用 方向键 移动选项、空格键 选择、回车键 确认

记住选择 Feishu/Lark (飞书) (configured) 空格选中 然后回车
后面就按步骤 配置即可

3.2.2 channel配

编辑 ~/.openclaw/openclaw.json，添加飞书 channel 配置：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "connectionMode": "websocket",
      "domain": "feishu",
      "accounts": {
        "mj_bot": {
          "appId": "cli_xxxx",
          "appSecret": "yxxxxxxxxxxxx"
        },
        "default": {
          "groupPolicy": "open"
        }
      }
    }
  }
}

配置说明：

字段	说明
enabled	是否启用该 channel
connectionMode	连接模式（websocket / webhook）
domain	飞书域名（feishu / lark）
accounts	多账号配置，支持多个机器人
groupPolicy	群聊策略（open / closed / mention-only）

3.3 配置 Agent 路由

OpenClaw 支持根据消息来源路由到不同的 Agent：

{
  "bindings": [
    {
      "agentId": "main",
      "match": {
        "channel": "feishu",
        "accountId": "mj_bot"
      }
    },
    {
      "agentId": "serv_ops",
      "match": {
        "channel": "feishu",
        "accountId": "mj_servops_bot"
      }
    }
  ]
}

这样，不同机器人收到的消息会由不同的 AI 助理处理。

四、启动服务

4.1 启动 Gateway

openclaw gateway start

Gateway 是 OpenClaw 的消息网关，负责：

• 接收飞书推送的消息
• 转发给对应的 Agent 处理
• 将回复发送回飞书

4.2 验证连接

查看 Gateway 状态：

openclaw gateway status

查看飞书 channel 日志：

openclaw channels logs --channel feishu

打开飞书APP尝试给这机器人发一个消息

出现如上提示不要慌
继续到终端输入这段提示代码

openclaw pairing approve feishu 你的提示码

这样一番操作基本都已经开通了个人助理机器人
如果不知道哪些实用的skill 可以参考这里的skill
实用skill

五、高级配置

5.1 多机器人部署

企业可能需要多个机器人服务于不同部门。OpenClaw 支持在同一个配置中管理多个飞书应用：

"accounts": {
  "hr_bot": {
    "appId": "cli_hr_xxxxx",
    "appSecret": "xxxxx"
  },
  "it_bot": {
    "appId": "cli_it_xxxxx",
    "appSecret": "xxxxx"
  }
}

5.2 安全加固

Token 认证

"gateway": {
  "auth": {
    "mode": "token",
    "token": "your_secure_token_here"
  }
}

命令权限控制

"gateway": {
  "nodes": {
    "allowCommands": [
      "browser.*",
      "agent-browser.*"
    ],
    "denyCommands": [
      "camera.snap",
      "screen.record"
    ]
  }
}

5.3 日志与监控

OpenClaw 支持详细的日志记录：

# 查看特定 channel 的消息日志
openclaw logs --filter "channel=feishu"

# 查看消息处理耗时
openclaw logs --filter "message.duration_ms"

六、常见问题

Q1: 消息收不到怎么办？

• 检查飞书应用是否已发布
• 验证事件订阅 URL 是否正确
• 查看 Gateway 日志确认是否有报错

Q2: 群聊中机器人不回复？

• 确认 groupPolicy 配置
• 检查机器人是否已添加到群聊
• 验证 Agent 是否正常响应

Q3: 如何调试消息流转？

开启详细日志：

openclaw logs --level debug

七、总结

通过 OpenClaw 的 channel 系统，你可以在 30 分钟内完成飞书机器人的从零部署。核心步骤：

1. ✅ 飞书开放平台创建应用
2. ✅ 配置 openclaw.json 的 channels 和 bindings
3. ✅ 启动 Gateway 服务
4. ✅ 测试消息收发

OpenClaw 的优势在于标准化和可扩展性——今天对接飞书，明天对接 Telegram，代码无需修改，只需配置 channel 即可。

---

参考资料：

• OpenClaw 官方文档
• 飞书开放平台
• OpenClaw GitHub

作者：小白
发布时间：2026 年 3 月 13 日
标签：OpenClaw, 飞书, AI 助理, 企业应用, Channel 对接