最新版OpenClaw小龙虾对接飞书详细流程OpenClaw 飞书机器人配置指南本文档详细说明如何配置 OpenCla

OpenClaw 飞书机器人配置指南

本文档详细说明如何配置 OpenClaw 与飞书机器人的集成。

前置准备

已安装 OpenClaw（版本 2026.3.11 或更高）
拥有飞书开发者后台的管理员权限
飞书应用已创建或准备创建

飞书开发者后台配置

1. 创建飞书应用

登录飞书开发者后台
点击「创建企业自建应用」
填写应用名称和描述，选择应用类型

2. 配置应用凭证

在「凭证与基础信息」页面获取：

App ID：如 cli_xxxxxxxxxxxxxxxx
App Secret：如 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

3. 配置事件订阅（长连接模式）

进入「事件与回调」→「订阅方式」：

选择 「使用长连接接收事件」（WebSocket 模式，无需公网 IP）
在「事件订阅」中添加以下事件：
- im.message.receive_v1 - 接收消息

4. 配置应用权限

在「权限管理」→「应用能力」中添加所需权限，常用权限包括：

消息相关：

im:message - 获取与发送消息
im:message:send_as_bot - 以应用身份发消息
im:chat - 获取群组信息
im:chat:readonly - 读取群组信息

用户相关：

contact:user.base:readonly - 获取用户基本信息
contact:user:readonly - 获取用户详细信息

文档相关：

docx:document - 文档操作权限
drive:drive - 云空间权限
bitable:app - 多维表格权限

日历相关：

calendar:calendar - 日历权限
calendar:calendar.event - 日程权限

5. 配置应用发布

在「应用发布」→「版本管理与发布」：

创建新版本
填写版本号和更新说明
提交审核（如需）并发布

OpenClaw 配置

1. 编辑配置文件

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

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_xxxxxxxxxxxxxxxx",
      "appSecret": "你的AppSecret",
      "connectionMode": "websocket",
      "domain": "feishu",
      "groupPolicy": "open",
      "dmPolicy": "pairing"
    }
  },
  "plugins": {
    "allow": ["openclaw-lark"],
    "entries": {
      "openclaw-lark": {
        "enabled": true
      }
    }
  },
  "tools": {
    "profile": "full"
  }
}

2. 配置项说明

配置项	说明
`enabled`	是否启用飞书渠道
`appId`	飞书应用的 App ID
`appSecret`	飞书应用的 App Secret
`connectionMode`	连接模式，`websocket` 使用长连接
`groupPolicy`	群聊策略：`open` 开放所有群，`allowlist` 仅允许指定群
`dmPolicy`	私聊策略：`pairing` 需要配对，`open` 开放所有私聊
`tools.profile`	工具权限配置：`full` 允许所有工具

3. 安装飞书插件

openclaw plugin install @larksuite/openclaw-lark

发布应用与重启网关

1. 发布飞书应用版本

在飞书开发者后台：

进入「应用发布」→「版本管理与发布」
点击「创建版本」
填写版本号（如 1.0.0）和更新说明
点击「发布」按钮

⚠️ 重要：每次修改应用配置后都需要发布新版本才能生效！

2. 重启 OpenClaw 网关

在终端执行：

openclaw gateway restart

或重启整个服务：

openclaw gateway stop
openclaw gateway start

3. 验证连接状态

openclaw status

确认输出中 Channels 部分显示：

│ Feishu   │ ON      │ OK     │ configured             │

私聊配对与授权

1. 私聊机器人

在飞书中找到你的机器人，发送私聊消息（任意内容）。

2. 获取配对码

机器人会返回：

配对码：如 ABC123
授权提示：需要进行用户授权

示例返回：

你好！我是 OpenClaw 机器人。

请先完成配对：
配对码：ABC123

请在 OpenClaw 终端输入：
openclaw pair ABC123

完成后还需要进行授权操作。

3. 在终端配对

openclaw pair ABC123

替换 ABC123 为实际收到的配对码。

插件诊断与工具配置

1. 运行插件诊断

在 OpenClaw 对话中输入：

/feishu doctor

诊断命令会检查：

飞书插件是否正确加载
权限配置是否完整
连接状态是否正常

2. 修改工具配置

如果诊断提示工具权限不足，修改配置：

openclaw config set tools.profile full

或在配置文件中：

{
  "tools": {
    "profile": "full"
  }
}

3. 重启生效

openclaw gateway restart

完成授权

1. 发起授权

在 OpenClaw 对话中输入：

/feishu auth

2. 确认授权

系统会返回授权链接或卡片，点击链接完成飞书用户授权。

3. 验证授权状态

授权成功后，可以测试机器人功能：

/feishu doctor

确认所有检查项通过。

常见问题

Q: 机器人不响应消息？

检查以下项目：

事件订阅是否正确
- 确认已添加 im.message.receive_v1 事件
- 确认使用长连接模式
应用版本是否发布
- 每次配置修改后都需要发布新版本
群聊策略是否开放
```
openclaw config get channels.feishu.groupPolicy
```
应为 open 或配置了 groupAllowFrom
网关是否重启
```
openclaw gateway restart
```

Q: 私聊提示需要配对？

私聊策略默认为 pairing，需要先配对：

私聊机器人获取配对码
在终端执行 openclaw pair <配对码>

如需开放所有私聊：

openclaw config set channels.feishu.dmPolicy open

Q: 工具调用失败？

检查工具配置：

openclaw config get tools.profile

应为 full 或自定义的允许列表。

Q: 如何查看日志？

# 实时查看日志
openclaw logs --follow

# 或直接查看日志文件
tail -f /tmp/openclaw/openclaw-$(date +%Y-%m-%d).log

Q: 如何更新飞书插件？

openclaw plugin update @larksuite/openclaw-lark
openclaw gateway restart

配置文件完整示例

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_a939c12043f89cc7",
      "appSecret": "your-app-secret-here",
      "connectionMode": "websocket",
      "domain": "feishu",
      "groupPolicy": "open",
      "dmPolicy": "pairing"
    }
  },
  "plugins": {
    "allow": ["openclaw-lark"],
    "entries": {
      "openclaw-lark": {
        "enabled": true
      }
    }
  },
  "tools": {
    "profile": "full",
    "web": {
      "search": {
        "provider": "brave"
      }
    }
  }
}

最新版OpenClaw小龙虾对接飞书详细流程