5分钟搞定！手把手教你把 OpenClaw 接入飞书

做 AI 助手很多同学在本地部署了 OpenClaw，但大多是通过网页或终端来使用。

其实，OpenClaw 可以直接接入飞书，让你在飞书里直接跟 AI 对话，体验和微信群聊一样流畅。

今天手把手教大家操作。

先搞清楚一件事：OpenClaw 接入飞书是什么原理？

简单来说，飞书提供了一个「机器人」能力，你可以把 OpenClaw 注册为一个飞书机器人。

当用户在飞书里给机器人发消息，飞书会把消息转发给 OpenClaw，OpenClaw 处理完再通过飞书的 API 把回复发回来。

整个过程是被动接收、主动推送——飞书负责通信管道，OpenClaw 负责大脑。

第一步：创建飞书自建应用

这一步骤需要在飞书开放平台操作，全程浏览器完成，不需要敲代码。

1.1 打开飞书开放平台

浏览器访问：https://open.feishu.cn/app^[1]

用你的飞书账号登录（需要管理员权限，或者让管理员给你开权限）。

1.2 创建应用

点击右上角「创建企业自建应用」：

• 应用名称：随便起，比如「AI 助手」
• 应用描述：可以写「基于 OpenClaw 的 AI 助手」
• 图标：可以上传一个机器人图标，不上传也行

创建完成后，你会得到一个 App ID 和 App Secret，这两个值复制保存好，后面配置要用。

1.3 开启机器人能力

进入应用后，左侧菜单找「添加应用能力」→「机器人」，点击启用。

这一步不能跳过，否则后续无法接收消息。

1.4 配置权限

左侧菜单「权限管理」，搜索并开通以下权限（企业自建应用通常默认有基础权限，按需补充）：

• im:message — 获取与发送消息
• im:message:receive_v1 — 接收消息（事件订阅）
• im:chat（可选）—  获取群信息

1.5 配置事件订阅

左侧菜单「事件与回调」→「事件订阅」：

• 请求地址填：https://你的OpenClaw域名/feishu/webhook
• 订阅的事件：选择「接收消息」

如果你用的是 WebSocket 模式（推荐），只需要填 wss://你的OpenClaw域名/feishu 的地址，不需要配置这里的 HTTP 回调。

1.6 发布应用

配置完成后，需要「创建版本」并提交审核（或直接发布，取决于你的飞书企业设置）。

管理员审核通过后，应用就正式可用了。

第二步：在 OpenClaw 里配置飞书

SSH 登录到你的服务器，编辑 OpenClaw 的配置文件：

nano ~/.openclaw/openclaw.json

找到 channels 节点，添加（或修改）飞书配置：

"channels": {
  "feishu": {
    "enabled": true,
    "mode": "websocket",
    "app_id": "cli_xxxxxxxxxxxxx",
    "app_secret": "xxxxxxxxxxxxxxxxxxxx",
    "bot_name": "AI助手",
    "auto_reply": true
  }
}

关键参数说明：

第三步：重启 OpenClaw

配置改好后，重启服务让配置生效：

# 如果用 systemd 管理
systemctl --user restart openclaw-gateway

# 或者直接重启
openclaw gateway restart

然后查看日志确认飞书连接是否成功：

journalctl --user -u openclaw-gateway -f

看到类似这行就说明连接成功：

feishu[default]: WebSocket client started
feishu[default]: bot info probe OK

第四步：测试一下

在飞书里搜索你的机器人名字，找到后直接发一条消息：

• 「你好」
• 「你是谁」

如果机器人秒回，恭喜你，接入成功！

常见问题

Q：消息发出去没有反应，怎么排查？

先检查三件事：

1. OpenClaw 日志有没有收到消息（journalctl 看飞书 channel 的日志）
2. 飞书应用有没有发布（开发者后台「版本管理与发布」）
3. 机器人有没有被加入正确的会话

Q：WebSocket 和 HTTP 回调哪个好？

推荐 WebSocket，只需要配置一次，不需要暴露额外的 HTTP 回调地址，稳定性也更好。

Q：怎么让机器人只在特定群里响应？

在 openclaw.json 的 feishu 配置里加 allowed_chats 字段：

"allowed_chats": ["oc_xxxxxxx1", "oc_xxxxxxx2"]

填入群 ID（从群信息里可以找到）。

最后

整个接入过程其实不复杂，最容易踩的坑就两个：

1. 飞书应用没发布——刚创建完一定要提交审核/发布，否则机器人收不到消息
2. App ID / App Secret 填错了——检查复制粘贴有没有多空格或遗漏

接好后，你就有了一个完全私有部署的 AI 助手，跑在自己的服务器上，数据不经过任何第三方——比直接用各种 AI 客户端隐私多了。

有问题欢迎留言，看到都会回。

往期相关教程：

• 零门槛！5分钟在服务器上部署 OpenClaw
• OpenClaw 配置文件详解，让你的 AI 助手更听话

引用链接