OpenClaw飞书配置记录

在豆包不断的错误指导下，最后死啃 https://docs.openclaw.ai/zh-CN 文档，终于配置成功， 小龙虾开始工作了！
太牛了！

来，我告诉你怎么玩飞书里的OpenClaw：

🎮 我能帮你做什么

💬 聊天对话

• 问问题：搜索网络、查资料、解释概念

• 写东西：写邮件、写文档、写代码

• 改东西：修改文字、润色文章、翻译

📝 飞书集成（超级强大）

• 文档操作：读写飞书文档

• 知识库：查询、创建、管理Wiki页面

• 云盘：上传、下载、管理文件

• 多维表格：读写数据，像Excel一样操作

🛠️ 技术任务

• 运行命令：在Linux服务器上执行命令

• 管理文件：读写、编辑、整理文件

• 代码操作：写代码、改代码、调试

🤖 自动化

• 定时任务：设置提醒、定时检查

• 子任务：把复杂任务交给子助手处理

🎯 使用场景举例

“帮我总结这篇文档” → 我会读取飞书文档并总结

“查查今天天气” → 我会搜索并告诉你

“写个Python脚本爬取这个网站” → 我会写代码并运行

“提醒我明天下午3点开会” → 我会设置定时提醒

“把这个数据整理到多维表格” → 我会写入飞书Bitable

🚀 现在试试

随便问我点啥：

• “帮我查下今天的新闻”

• “写一封请假邮件”

• “解释一下什么是AI”

想玩什么？

帮我整理下配置 openclaw和飞书的过程 md格式

目录

• 环境准备
• 安装OpenClaw
• 修复飞书插件
• 创建飞书应用
• 配置飞书权限
• 配置OpenClaw
• 测试连接
• 使用指南

环境准备

系统要求

• 操作系统：Linux / macOS / Windows
• Node.js：建议 v22.x 或更高版本
• 网络：能访问飞书开放平台

检查安装

1
2

node --version
npm --version

安装OpenClaw

全局安装

1

npm install -g openclaw

初始化

1

openclaw onboard

按照提示完成初始化配置。

修复飞书插件

问题说明

如果飞书插件加载失败，显示缺少依赖（如 @sinclair/typebox），需要修复。

修复步骤

1. 进入飞书插件目录

1

cd ~/.openclaw/extensions/feishu

2. 修改 package.json

编辑 package.json，移除 devDependencies 中的 workspace:*：

修改前：

修改后：

3. 安装依赖

1

npm install

4. 验证修复

1

openclaw status

飞书通道应该显示 SETUP 或 OK。

创建飞书应用

访问开放平台

打开：https://open.feishu.cn

创建应用

1. 点击「创建企业自建应用」
2. 填写应用名称和描述
3. 点击「创建」

获取应用凭证

进入应用 → 「凭证与基础信息」

获取以下信息：

• App ID：cli_xxxxxxxxx
• App Secret：点击「查看」复制

配置飞书权限

必需权限

在飞书开放平台，进入应用 → 权限管理，添加并启用以下权限：

基础权限

• im:message - 消息权限
• im:chat - 会话权限
• contact:user.base:readonly - 读取用户基本信息
• contact:contact.base:readonly - 读取联系人信息

文档/知识库权限（可选）

• drive:drive - 云盘权限
• drive:file:readonly - 读取文件
• docx:document - 文档权限
• wiki:wiki:readonly - 知识库只读

权限授权

如果提示权限未授权，访问以下链接授权：

1

https://open.feishu.cn/app/你的AppID/auth?q=contact:contact.base:readonly

发布应用

配置完成后，需要：

• 进入「版本管理与发布」
• 点击「发布新版本」
• 或添加到测试群组

配置OpenClaw

方式一：使用命令行配置

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

openclaw gateway config.patch '{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_xxxxxxxxx",
      "appSecret": "你的AppSecret",
      "connectionMode": "websocket",
      "dmPolicy": "pairing",
      "groupPolicy": "allowlist"
    }
  }
}'

方式二：直接编辑配置文件

编辑 ~/.openclaw/openclaw.json：

配置说明

重启服务

配置完成后会自动重启，或手动重启：

1

openclaw gateway restart

测试连接

检查状态

1

openclaw status

预期输出：

1
2
3
4
5
6

Channels
┌──────────┬─────────┬────────┬─────────┐
│ Channel  │ Enabled │ State  │ Detail  │
├──────────┼─────────┼────────┼─────────┤
│ Feishu   │ ON      │ OK     │ configured│
└──────────┴─────────┴────────┴─────────┘

检查权限

通过OpenClaw命令检查飞书权限：

1
2

# 我可以帮你检查
openclaw feishu:scopes

或直接问我：“检查飞书权限”

使用指南

基本对话

发送消息：

• 直接向飞书机器人发送消息
• 或在群聊中@机器人

示例：

1
2
3

你好
帮我查下天气
写一封请假邮件

飞书文档操作

读取文档：

1
2

帮我读取这个文档的链接
总结一下这个文档内容

写入文档：

1
2

帮我创建一个文档，标题是xxx
把这段话写到文档里

知识库操作

查询Wiki：

1

帮我查下知识库里关于xxx的内容

创建页面：

1

在知识库创建一个页面，标题是xxx

多维表格操作

查询数据：

1
2

帮我读取这个多维表格的数据
筛选出状态为完成的数据

写入数据：

1
2

添加一条记录到这个表格
更新这条记录的状态为已完成

云盘操作

文件管理：

1
2

帮我列出云盘的文件
上传这个文件到云盘

高级功能

定时提醒：

1

提醒我明天下午3点开会

运行命令：

1
2

在服务器上执行这个命令
帮我查看磁盘空间

代码任务：

1
2

写一个Python脚本爬取这个网站
帮我修复这个bug

常见问题

飞书连接失败

检查网络：

1

ping open.feishu.cn

检查日志：

1

openclaw logs --follow

权限错误

1. 确认飞书开放平台权限已启用
2. 确认应用已发布
3. 访问授权链接重新授权

插件加载失败

参考修复飞书插件章节。

进阶配置

允许特定用户私信

获取用户的 open_id 后：

1

openclaw channel configure feishu --allow-from "ou_xxxxxxxxx,ou_yyyyy"

开放模式（允许所有人）

⚠️ 不推荐生产环境使用

启用Webhook模式

需要公网服务器和配置nginx反向代理：

在飞书开放平台配置：

• Encrypt Key：生成随机密钥
• Verification Token：设置验证令牌
• Request URL：http://你的域名/feishu/events

技术支持

• OpenClaw文档：https://docs.openclaw.ai
• 飞书开放平台：https://open.feishu.cn
• 社区支持：https://discord.com/invite/clawd

更新日志

• 2026-02-11：首次编写，涵盖OpenClaw飞书配置完整流程

祝你使用愉快！🐚