OpenClaw绑定飞书完整指南:10分钟打造智能办公助手

OpenClaw 绑定飞书完整指南：打造你的智能办公助手

只需10分钟，让 AI 助手入驻你的飞书群聊

═════════

前言

OpenClaw（小龙虾）作为2026年最火爆的 AI 智能体，不仅能帮你写代码、处理文件、管理日程，还能直接接入飞书群聊，成为你团队的24小时智能助手。

本文将手把手教你完成 OpenClaw 与飞书的绑定配置，让 AI 真正融入你的工作流。

═════════

一、准备工作

1.1 你需要准备什么？

项目	说明
OpenClaw 已安装	本地或云端部署完成
飞书账号	个人或企业账号均可
飞书群聊	需要添加机器人的群组
管理员权限	添加机器人需要群管理员权限

1.2 检查 OpenClaw 状态

在终端执行以下命令，确保 OpenClaw 正常运行：

bash
openclaw status

看到 Gateway: running 即表示服务正常。

═════════

二、飞书端配置

2.1 创建飞书机器人

步骤1：进入飞书开放平台

访问飞书开放平台
使用你的飞书账号登录
点击右上角「开发者后台」

步骤2：创建企业自建应用

点击「创建企业自建应用」
填写应用信息：
- 应用名称：OpenClaw助手（或自定义）
- 应用描述：AI智能办公助手
- 应用图标：上传你喜欢的图标
点击「创建应用」

步骤3：获取凭证信息

创建完成后，进入应用详情页，记录以下信息：

App ID（应用凭证）
App Secret（应用密钥）

⚠️ 重要：App Secret 只会显示一次，请立即复制保存！

2.2 配置机器人权限

步骤1：添加机器人能力

在应用详情页，点击「能力管理」
找到「机器人」能力，点击「添加」
配置机器人信息：
- 机器人名称：OpenClaw
- 机器人描述：你的AI智能助手
- 机器人头像：上传头像

步骤2：配置权限范围

点击「权限管理」
搜索并添加以下权限：
- im:chat:readonly（读取群聊信息）
- im:message:send（发送消息）
- im:message:receive（接收消息）
- contact:user.department:readonly（读取组织架构）

步骤3：发布应用

点击「版本管理与发布」
点击「创建版本」
填写版本信息（可随意填写）
点击「申请发布」
联系企业管理员审批

2.3 将机器人加入群聊

步骤1：获取群聊信息

打开目标飞书群聊
点击右上角「...」→「群设置」
找到「群机器人」选项
点击「添加机器人」
搜索你创建的「OpenClaw助手」
点击「添加」

步骤2：记录群聊ID

在群设置页面，找到「群信息」
复制「群ID」（格式类似 oc_xxxxxxxxxxxxxxxx）

═════════

三、OpenClaw 端配置

3.1 编辑配置文件

打开 OpenClaw 的配置文件：

bash
# 配置文件路径~/.openclaw/config.yaml

3.2 添加飞书通道配置

在配置文件中添加以下内容：

yaml
channels:  feishu:    enabled: true    app_id: "你的_App_ID"    app_secret: "你的_App_Secret"    encrypt_key: ""  # 可选，用于消息加密    verification_token: ""  # 可选，用于验证    default_chat_id: "你的_群聊ID"

3.3 完整配置示例

yaml
# OpenClaw 主配置name: "我的OpenClaw"# AI 模型配置model:  provider: dashscope  model: kimi-k2.5# 通道配置channels:  # 飞书配置  feishu:    enabled: true    app_id: "cli_xxxxxxxxxxxxxxxx"    app_secret: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"    default_chat_id: "oc_xxxxxxxxxxxxxxxx"    # 其他通道（可选）  telegram:    enabled: false  discord:    enabled: false# 技能配置skills:  - name: searxng    enabled: true  - name: weather    enabled: true

3.4 重启 OpenClaw 服务

保存配置后，重启服务使配置生效：

bash
openclaw gateway restart

═════════

四、验证连接

4.1 检查服务状态

bash
openclaw status

确认看到类似输出：

text
Gateway: runningChannels:  - feishu: connected ✅

4.2 测试消息发送

在飞书群聊中 @机器人发送测试消息：

text
@OpenClaw助手 你好

如果收到回复，说明连接成功！

═════════

五、常用功能演示

5.1 信息查询

text
@OpenClaw助手 今天天气怎么样？

5.2 文件处理

text
@OpenClaw助手 帮我总结这个文档的要点[上传文件]

5.3 代码辅助

text
@OpenClaw助手 写一个Python脚本，批量重命名文件夹里的图片

5.4 日程管理

text
@OpenClaw助手 提醒我明天下午3点开会

═════════

六、进阶配置

6.1 多群聊支持

如果需要将机器人添加到多个群聊，配置如下：

yaml
channels:  feishu:    enabled: true    app_id: "cli_xxxxxxxxxxxxxxxx"    app_secret: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"    chats:      - id: "oc_xxxxxxxxxxxxxxxx"  # 技术群        name: "技术部"      - id: "oc_yyyyyyyyyyyyyyyy"  # 产品群        name: "产品部"

6.2 消息模板配置

自定义机器人的回复风格：

yaml
channels:  feishu:    enabled: true    # ...其他配置    templates:      welcome: "你好！我是OpenClaw助手，有什么可以帮你的吗？"      error: "抱歉，我遇到了一点问题，请稍后再试。"

6.3 权限控制

限制机器人的使用范围：

yaml
channels:  feishu:    enabled: true    # ...其他配置    allowed_users:      - "ou_xxxxxxxxxxxxxxxx"  # 允许的用户ID    allowed_groups:      - "oc_xxxxxxxxxxxxxxxx"  # 允许的群聊ID

═════════

七、常见问题排查

7.1 机器人无响应

可能原因	解决方案
配置未生效	执行 `openclaw gateway restart`
App ID/Secret 错误	检查配置是否与飞书后台一致
机器人未进群	确认已在群设置中添加机器人
权限不足	检查是否申请了必要的权限

7.2 消息发送失败

bash
# 查看详细日志openclaw logs --channel feishu

7.3 连接状态检查

bash
# 测试飞书连接openclaw channel test feishu

═════════

八、安全建议

保护凭证信息：不要将 App ID 和 App Secret 提交到公开代码仓库
使用环境变量：建议将敏感信息配置在环境变量中
定期轮换密钥：定期在飞书后台重置 App Secret
限制权限范围：只申请必要的权限，遵循最小权限原则

═════════

九、总结

完成以上步骤后，你就拥有了一个7×24小时在线的飞书 AI 助手。无论是日常问答、文件处理还是自动化任务，OpenClaw 都能帮你高效完成。

下一步建议：

探索 OpenClaw 的 Skills 技能系统
配置更多通道（如钉钉、企业微信）
开发自定义技能满足团队需求

═════════

参考资源

OpenClaw 官方文档
飞书开放平台文档
OpenClaw GitHub 仓库

═════════

本文更新于 2026年3月15日