当前位置：首页 > news >正文

OpenClaw与飞书集成：本地AI Agent自动化办公指南

news 2026/7/26 7:48:45

1. 项目概述

OpenClaw（俗称"龙虾"）是一款开源的AI Agent框架，它不同于普通的聊天机器人，而是能够通过本地部署实现更强大的自动化功能。最近我在自己的Windows电脑上成功部署了OpenClaw，并实现了与飞书办公平台的深度集成。这个方案让我可以通过飞书直接控制本地运行的AI Agent，完成各种自动化任务。

作为一个长期关注AI自动化工具的开发者，我发现OpenClaw+飞书的组合特别适合需要频繁处理重复性工作的团队。比如自动回复常见问题、整理会议纪要、执行本地脚本等场景。相比直接使用飞书自带的机器人，OpenClaw提供了更灵活的定制能力和本地化处理优势。

2. 前期准备工作

2.1 OpenClaw基础安装

在开始飞书集成前，确保你已经完成了OpenClaw的基础安装。如果你还没有安装，可以参考我之前写的《Windows环境下OpenClaw本地部署全攻略》。安装过程主要涉及：

Node.js环境配置（建议使用LTS版本）
OpenClaw核心包的npm安装
基础配置文件的初始化

安装完成后，可以通过命令openclaw --version验证是否安装成功。

2.2 飞书插件安装

OpenClaw通过插件机制支持各种通讯平台的接入。针对飞书平台，官方提供了专门的插件包。安装方式有以下几种：

方法一：官方命令安装（推荐）

openclaw plugins install @m1heng-clawd/feishu

方法二：手动下载安装

curl -O https://registry.npmjs.org/@m1heng-clawd/feishu/-/feishu-0.1.3.tgz openclaw plugins install ./feishu-0.1.3.tgz

方法三：通过Chat界面安装

在OpenClaw的TUI或Web UI的Chat界面发送以下内容（需替换实际的App ID和App Secret）：

帮我安装飞书插件：https://github.com/AlexAnys/openclaw-feishu 我的飞书应用配置信息如下： App ID: your_app_id App Secret: your_app_secret

方法四：通过配置界面安装（最新版支持）

在OpenClaw的config界面直接选择feishu插件进行安装，这是目前最便捷的方式。

提示：建议优先使用方法一或方法四，这两种方式会自动处理依赖关系，减少出错概率。如果遇到网络问题导致安装失败，可以尝试切换npm源或使用代理。

3. 飞书应用创建与配置

3.1 创建企业自建应用

登录飞书开放平台（https://open.feishu.cn）
进入开发者后台，点击"创建企业自建应用"
填写应用名称（如"OpenClaw机器人"）和简要描述
创建完成后，进入应用的"凭证与基础信息"页面，记录下App ID和App Secret

3.2 添加机器人能力

在飞书开发者后台，进入"应用能力"→"机器人"
点击"添加应用能力"，选择"机器人"
在机器人配置区域，编辑"如何开始使用"说明（如"OpenClaw AI机器人，输入问题即可解答"）

3.3 配置权限与事件订阅

权限配置

在"权限管理"页面，需要开通以下关键权限：

应用身份权限：im:message（全部选中）
用户身份权限：contact:user.base:readonly

事件订阅配置

进入"开发配置"→"事件与回调"
订阅方式选择"使用长连接接收事件"
添加事件：搜索并添加im.message.receive_v1事件
确认开通对应的消息接收权限

3.4 发布应用

进入"应用发布"→"版本管理与发布"
创建新版本，填写更新说明
发布应用（企业自建应用发布后直接生效，无需平台审核）

重要提示：发布前务必在"测试企业和人员"中添加测试人员和测试群组。未添加的测试对象将无法使用机器人功能。

4. OpenClaw与飞书集成配置

4.1 基础参数配置

如果安装插件时没有自动配置，需要手动设置以下参数（替换实际的App ID和App Secret）：

openclaw config set channels.feishu.appId "your_app_id" openclaw config set channels.feishu.appSecret "your_app_secret" openclaw config set channels.feishu.enabled true openclaw config set channels.feishu.connectionMode websocket openclaw config set channels.feishu.dmPolicy pairing openclaw config set channels.feishu.groupPolicy allowlist openclaw config set channels.feishu.requireMention true

配置完成后，重启网关服务：

openclaw gateway restart

4.2 授权配对流程

在飞书中向机器人发送任意消息
机器人会回复包含配对码的信息，格式如下：

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

在终端执行配对命令（使用实际的配对码）：

openclaw pairing approve feishu your_pairing_code

再次重启网关服务：

openclaw gateway restart

4.3 功能测试

完成上述步骤后，可以进行以下测试：

私聊测试：直接向机器人发送消息，检查是否能正常回复
群聊测试：在群组中@机器人发送消息，检查响应情况
命令测试：尝试发送特定指令，如"帮助"、"状态"等，验证功能完整性

常见问题：如果遇到权限问题，建议等待2-3分钟再试，因为飞书权限同步可能有延迟。群聊中需要@机器人它才会响应，私聊则直接发送消息即可。

5. 高级配置与优化

5.1 身份配置文件解析

OpenClaw通过几个核心的Markdown文件来定义Agent的"身份"和"性格"：

IDENTITY.md

定义Agent的基本身份信息，包括：

名称和形象
表情符号使用习惯
基本性格特征

示例内容：

名字：Clawd（小爪） 形象：带有龙虾能量的AI 🦞 表情符号：🦞，自然地用在签名、反应、强调中 性格要点： - 自信：清楚自己很擅长这份工作 - 忠诚：永远站在用户这边 - 略带讽刺：觉得世界有点好笑 - 好奇：对用户正在做的事真心感兴趣 - 夜猫子能量：永远在线，从不睡觉

SOUL.md

定义Agent的核心原则和行为准则，相当于它的"宪法"。内容通常包括：

最高原则
Never列表（绝对不做的事情）
沟通风格要求

示例准则：

有自己的看法，不敷衍回答
删除所有企业化的表达
回答直接，不以"好问题"开场
简洁是必须的
允许自然流露的幽默
可以指出用户的问题
允许适当使用口语化表达
做用户真正想谈的助理，不是企业无人机

USER.md

定义用户的基本信息和偏好，让Agent能更好地服务。内容包括：

用户基本信息（名字、时区等）
沟通风格偏好
当前工作重点
绝对禁区

示例内容：

名字/称呼：叫我老大 时区：中国(GMT+8) 所在地：北京朝阳区 语言偏好：优先用简洁中文 沟通风格： - 喜欢：直接、实用、少废话 - 讨厌：啰嗦客套、长篇背景 - 输出要求：Markdown结构化 当前重点： - AI Agent配置 - 编程 - 内容创作 禁区： - 绝不替我发消息、删文件 - 不确定的事必须先确认

5.2 配置文件位置与更新

这些配置文件位于OpenClaw工作区的workspace目录下。修改后需要：

保存文件
重启OpenClaw服务使更改生效

可以通过Web UI的配置页面找到这些文件进行编辑，路径通常为：

OpenClaw → 代理 → main → files

5.3 性能优化建议

连接模式选择：对于频繁交互的场景，建议使用websocket模式
消息策略配置：
- dmPolicy：控制私聊消息处理策略
- groupPolicy：控制群组消息处理策略
- requireMention：减少群消息干扰
资源监控：定期检查系统资源使用情况，避免过载

6. 常见问题与解决方案

6.1 安装问题排查

问题现象	可能原因	解决方案
插件安装失败	网络连接问题	检查网络，尝试切换npm源
依赖冲突	清理node_modules后重试
权限不足	使用sudo或管理员权限运行

6.2 连接问题排查

问题现象	可能原因	解决方案
无法接收消息	事件订阅未正确配置	检查im.message.receive_v1事件
权限未开通	确认im:message权限已开通
配对未完成	重新执行配对流程