OpenClaw 接入飞书机器人

OpenClaw 是一个开源 AI 框架，通过接入飞书，你可以在飞书中直接与 AI 助手交互，实现自动化任务。本文只讲最直接的命令行配置模式，去掉所有废话，纯干货，5 分钟搞定。

第一步：在飞书开放平台创建机器人应用

1. 登录 飞书开放平台，点击「创建企业自建应用」，填写名称、描述，上传图标后提交。

2. 进入应用详情页，左侧「凭证与基础信息」，复制 App ID 和 App Secret（保存好，后续要用）。

3. 左侧「添加应用能力」→ 点击「机器人」并添加，让应用具备机器人身份。

第二步：在 OpenClaw 中配置飞书通道

登录 OpenClaw 所在服务器，执行以下命令（替换双引号内的内容为真实信息）：

# 设置 App ID 和 Secret
openclaw config set channels.feishu.appId "你的 App ID"
openclaw config set channels.feishu.appSecret "你的 App Secret"

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

# 使用 WebSocket 长连接（无需公网地址）
openclaw config set channels.feishu.connectionMode websocket

# 重启网关使配置生效
openclaw gateway restart

第三步：在飞书开放平台完成连接配置

1. 回到飞书开放平台，左侧「事件与回调」→「事件配置」，将订阅方式改为「长连接接收事件」，保存。

   如果提示“未建立长连接”，检查 App ID/Secret 是否正确，并执行 openclaw gateway restart 后重试。

2. 添加必要事件：点击「添加事件」，搜索并添加 “接收消息”（私聊响应必需）。

3. 左侧「权限管理」，搜索并添加以下权限：

   • im:message（收发消息）

   • im:message.p2p_msg:readonly（读取私信）

   • im:message.group_at_msg:readonly（接收群 @）

   • im:message:send_as_bot（以机器人身份发消息）

4. 左侧「版本管理与发布」，创建版本并提交发布（必须发布，权限才能生效）。

第四步：开始使用

1. 在飞书通讯录中搜索你的机器人，发送任意消息。机器人会回复一条配对命令（如 openclaw pair --code xxxxx）。

2. 复制该命令，到 OpenClaw 服务器终端执行，完成配对。

3. 再次向机器人发消息，即可正常对话。群聊中 @ 机器人也能响应。

常见问题

• 事件订阅保存失败：检查 OpenClaw 配置是否正确，网关是否运行，WebSocket 是否启用。

• 机器人无回复：检查权限是否已添加并发布，配对是否成功。

• 连接不稳定：OpenClaw 支持自动重连，无需手动干预。

觉得文章有用，微信打赏一元。