【工具相关】OpenClaw 配置使用飞书：打造智能飞书助手全流程指南（亲测有效，放心享用）

OpenClaw 配置使用飞书：打造智能飞书助手全流程指南

本文将详细介绍如何在 OpenClaw 中配置飞书集成,实现 AI 助手与飞书的深度结合,让你的数字助理真正融入工作流。

一、为什么选择飞书集成？

飞书作为企业级协作平台，集成了即时通讯、文档协作、日历、云盘等功能。将 OpenClaw 与飞书集成后，你可以：

🤖 AI 助手直达工作群：在飞书群聊中直接@机器人获取帮助
📝 文档智能处理：自动读写飞书文档、表格、知识库
📲 消息自动化：定时提醒、状态更新、信息推送
🔍 知识库增强：结合飞书知识库提供精准问答

二、前置准备

1. 环境要求

OpenClaw v2026.3+（已内置飞书插件）
Node.js v18+
Windows/macOS/Linux 系统

2. 飞书开发者账号

你需要一个飞书企业管理员账号来创建应用。

三、详细配置步骤

步骤 1：创建飞书应用

访问飞书开放平台
点击 创建企业应用
填写应用名称（如 "OpenClaw AI 助手"）和描述
保存后进入应用详情页

步骤 2：获取凭证信息

在应用详情页的 Credentials & Basic Info 中获取：

App ID ：格式如 cli_xxx
App Secret ：密钥字符串

步骤 3：配置应用权限

在 Permissions 页面，点击 Batch import 并粘贴以下权限配置：

json 复制代码

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:read",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

⚠️ 关键权限 ：im:message:send_as_bot 是发送消息的必需权限！

步骤 4：启用机器人能力

在 App Capability > Bot 中：

✅ 启用机器人能力
设置机器人名称（如 "OpenClaw 助手"）

步骤 5：配置事件订阅

⚠️ 重要：确保网关已启动后再配置！

在 Event Subscription 中
选择 Use long connection to receive events（WebSocket）
添加事件：im.message.receive_v1
保存配置

步骤 6：配置 OpenClaw

方法一：使用向导（推荐）

bash 复制代码

openclaw onboard

按照向导输入 App ID 和 App Secret。

方法二：手动配置

编辑 ~/.openclaw/openclaw.json：

json 复制代码

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_a92574f769799cb5",
      "appSecret": "blYFWKa7Bz5YWHeBrBAcXc7mAwXESerN",
      "connectionMode": "websocket",
      "domain": "feishu",
      "groupPolicy": "open",
      "dmPolicy": "pairing"
    }
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback"
  }
}

💡 配置说明：

dmPolicy: 私聊策略（pairing=需要配对，open=直接允许）

groupPolicy: 群聊策略（open=所有群，allowlist=指定群）

步骤 7：启动网关服务

bash 复制代码

openclaw gateway

检查状态：

bash 复制代码

openclaw gateway status

正常输出应包含：

复制代码

Gateway: bind=loopback (127.0.0.1), port=18789
RPC probe: ok
Listening: 127.0.0.1:18789

四、使用指南

1. 首次使用配对

当用户首次与机器人聊天时，会收到配对码：

复制代码

OpenClaw: access not configured.
Your Feishu user id: ou_xxx
Pairing code: FE6P7PNK
Ask the bot owner to approve with:
openclaw pairing approve feishu FE6P7PNK

作为机器人所有者，执行：

bash 复制代码

openclaw pairing approve feishu FE6P7PNK

2. 发送消息给用户

通过 API 发送私聊消息：

bash 复制代码

# 获取访问令牌
curl -X POST "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal" \
  -H "Content-Type: application/json" \
  -d '{"app_id":"cli_xxx","app_secret":"xxx"}'

# 发送消息
curl -X POST "https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=open_id" \
  -H "Authorization: Bearer t-g1043b8WHNMHVMD5DXZCJHUKZ2D7..." \
  -H "Content-Type: application/json" \
  -d '{
    "receive_id": "ou_xxx",
    "msg_type": "text",
    "content": "{\"text\":\"你好！\"}"
  }'

3. 文档操作示例

读取飞书文档：

json 复制代码

{
  "action": "read",
  "doc_token": "ABC123def"
}

写入文档：

json 复制代码

{
  "action": "write",
  "doc_token": "ABC123def",
  "content": "# 标题\n\n这是通过 OpenClaw 自动生成的内容"
}

五、常见问题排查

❌ 问题1：Bot has NO availability to this user

原因：用户未与机器人建立会话
解决：让用户先给机器人发一条消息，或执行配对批准

❌ 问题2：Invalid access token

原因：token 过期或格式错误
解决：重新获取 tenant_access_token

❌ 问题3：field validation failed (receive_id_type required)

原因：API 请求缺少必要参数
解决 : 确保 URL 中包含 ?receive_id_type=open_id

❌ 问题4：404 page not found

原因：API 路径错误
解决：使用正确的端点 https://open.feishu.cn/open-apis/im/v1/messages

六、高级配置

多账号支持

json 复制代码

{
  "channels": {
    "feishu": {
      "defaultAccount": "main",
      "accounts": {
        "main": {
          "appId": "cli_xxx",
          "appSecret": "xxx",
          "botName": "主助手"
        },
        "backup": {
          "appId": "cli_yyy",
          "appSecret": "yyy",
          "enabled": false
        }
      }
    }
  }
}

消息流控制

json 复制代码

{
  "channels": {
    "feishu": {
      "typingIndicator": false,
      "resolveSenderNames": false,
      "streaming": true
    }
  }
}

七、安全最佳实践

权限最小化：只授予必要权限
密钥保护：不要将 appSecret 提交到代码仓库
定期轮换：定期更换 appSecret
监控日志 ：定期检查 openclaw-*.log 日志

八、实战案例

场景：自动会议提醒

bash 复制代码

# 创建定时任务
cron add --job '{
  "name": "会议提醒",
  "schedule": {"kind": "at", "at": "2026-03-12T09:00:00Z"},
  "payload": {
    "kind": "systemEvent",
    "text": "提醒：今天上午10点有部门会议，请准时参加"
  },
  "sessionTarget": "main",
  "delivery": {"mode": "announce"}
}'

场景：文档摘要生成

用户在飞书中分享文档链接
OpenClaw 自动读取文档内容
生成摘要并通过飞书回复

九、总结

通过本文的详细指导，你已经掌握了 OpenClaw 飞书集成的完整流程。从应用创建、权限配置到实际使用，每一步都经过验证。

核心要点回顾：

✅ 正确配置权限是成功的关键
✅ 首次使用需要配对批准
✅ 消息发送需注意 receive_id_type 参数
✅ PowerShell 显示乱码是编码问题，非实际消息问题

现在，你的 AI 助手已经准备好在飞书中为你服务了！🚀

本文基于 OpenClaw v2026.3.7 版本编写，如有版本差异请参考官方文档。
飞书 API 文档：https://open.feishu.cn/document
OpenClaw 官方文档：https://docs.openclaw.ai

作者：根根的爪爪 🐾

日期：2026年3月11日

版本：v1.0