OpenClaw 飞书接入完整教程

作者

：Rose | 云计算顾问 & 科技博主阅读时长：约 5 分钟适合人群：运维、开发者、AI Agent 玩家

📌 先说结论

飞书是 OpenClaw 内置功能，不需要安装任何插件！

OpenClaw 支持两种接入模式：

本文重点介绍 WebSocket 模式——扫码即用，无需配置服务器

🎯 你能学到什么

🚀 第1步：扫码授权（自动完成一切）

1.1 执行登录命令

openclaw channels login --channel feishu

1.2 扫码授权

命令执行后会输出一个二维码，用飞书 App 扫码确认授权。

1.3 选择群聊策略

扫码成功后，会出现群聊策略选项：

Group chat policy
> Open - respond in all groups (requires mention)
  Allowlist - only respond in specific groups
  Disabled - don not respond in groups

选择建议：新手选 Open，机器人会在所有群聊工作，但只在被@时才回复，不会乱说话。

扫码过程自动完成：

• 自动创建/关联机器人

• 自动获取 App ID 和 App Secret

• 自动配置事件订阅（WebSocket 模式无需手动配置）

• 自动写入配置文件

1.4 验证授权成功

# 检查飞书渠道状态
openclaw channels status --channel feishu

输出示例：

Channel: feishu
Status: connected ✅
Mode: websocket
App ID: cli_xxxxxxxxxxxxx

🔄 第2步：重启网关服务

2.1 重启 OpenClaw 网关

openclaw gateway restart

2.2 检查服务状态

# 查看网关状态
openclaw status

# 查看健康检查
openclaw health

输出示例：

Gateway: running ✅
WebSocket: connected ✅
Channel feishu: active ✅

✅ 第3步：验证连通性

3.1 飞书端测试

1. 打开飞书 → 搜索你的机器人名称

2. 发送任意消息，如「你好」

3. 机器人应自动回复 → 配置成功 ✅

3.2 命令行发送测试

# 发送测试消息
openclaw channels send --channel feishu --message "测试消息"

📊 接入流程总览

⚙️ 高级配置（可选）

如果默认配置不满足需求，可手动编辑配置文件：

配置文件位置

# 查看配置文件
cat ~/.openclaw/openclaw.json

WebSocket 模式配置示例

{
  "channels": {
    "feishu": {
      "connectionMode": "websocket",
      "enabled": true,
      "accounts": {
        "default": {
          "appId": "cli_xxxxxxxxxxxxx",
          "appSecret": "你的AppSecret"
        }
      }
    }
  }
}

🔧 Webhook 模式（特殊需求用）

如果你需要固定的公网回调地址，可使用 Webhook 模式：

飞书开放平台配置

1. 创建自建应用：飞书开放平台 → 企业自建应用 → 创建应用

2. 开启机器人能力：添加应用能力 → 机器人

3. 配置权限（必须项）：

1. 配置事件订阅：进入「事件与回调」→「事件配置」：

   ① 选择订阅方式：选择「长链接」

   ② 添加事件：点击「添加事件」→ 搜索"消息" → 勾选以下5个事件：事件名称事件编码用途接收消息im.message.receive_v1用户发送新消息至机器人消息已读im.message.message_read_v1消息被阅读消息被reactionim.message.reaction.created_v1消息被添加reaction消息被取消reactionim.message.reaction.deleted_v1消息被取消reaction消息撤回im.message.recalled_v1消息被撤回

   ③ 添加回调：回调配置 → 添加回调 → 勾选「卡片回传交互」

2. 保存配置：点击保存，等待配置生效（通常1-2分钟）

OpenClaw Webhook 配置

{
  "channels": {
    "feishu": {
      "connectionMode": "webhook",
      "webhookPort": 3000,
      "webhookHost": "https://你的公网域名或IP",
      "accounts": {
        "default": {
          "appId": "cli_xxxxxxxxxxxxx",
          "appSecret": "你的AppSecret"
        }
      }
    }
  }
}

🔍 常见问题排查

Q1：扫码后提示「授权超时」

# 重新执行登录命令
openclaw channels login --channel feishu

Q2：消息发送成功但收不到回复

检查 OpenClaw 服务是否正常运行：

openclaw status
openclaw logs --channel feishu

Q3：如何查看飞书机器人的 App ID？

openclaw channels info --channel feishu

📊 WebSocket vs Webhook 对比

如果你觉得这篇教程有用：

关注作者

后续会持续更新 OpenClaw + AI Agent 的实战教程

关于作者

我是 Rose，云计算顾问 + 科技博主，专注 AI Agent 落地实践。