OpenClaw 简介
OpenClaw 是一款开源的个人 AI Agent 系统，部署在电脑或服务器上，如同一个 24 小时待命的 AI 助手。
为何选择飞书集成
通过 OpenClaw 飞书插件，你可以以个人身份调用飞书的各种能力：读取群聊、查看文档、撰写与修改文档、发送消息、预约日程、创建多维表格等。相比其他平台，飞书在国内具有中文界面和文档优势，生态更成熟，开放能力更强，能获取更多工作上下文。
安全提示
核心风险
该插件会通过飞书接口连接你的工作数据（消息、文档、日历、联系人）。AI 能读到的内容理论上存在泄露可能。虽然做了安全防护，但系统尚未完全成熟稳定。
强烈建议：现阶段请勿使用公司/企业飞书账号！务必使用个人账号体验和测试。
其他风险
- AI 幻觉：可能误解意图或生成不准确内容。
- 操作不可逆：代发的消息以你的名义发出，无法撤回。
- 应对方法：涉及发送、修改、写入等重要操作，务必'先预览，再确认'。
使用建议
先拿个人账号安全地体验，待后续安全隔离能力更成熟后，再考虑接入真实工作环境。
安装方式选择
本地部署
- 优点：数据完全在本地，隐私性高；无需持续支付云端费用。
- 缺点：依赖电脑性能与网络；需自行维护；操作门槛较高。
- 适合人群：个人开发者、对数据安全要求高的团队。
云端部署
- 优点：操作简单，推荐新手；24 小时在线；性能稳定。
- 缺点：需支付服务器费用；数据存储在云端。
- 适合人群：团队协作、需要 7x24 小时服务的场景。
本地部署指南
前置知识｜什么是终端？
终端是 Mac 自带的程序，允许通过文字命令直接控制电脑。在 Mac 上安装 OpenClaw 必须使用它。
如何找到终端
- 程序坞 > 启动台 > 其他 > 终端
- 打开程序坞搜索'终端'
如何使用终端
打开'终端' > 输入指令 > 点击'回车'确认。
环境准备
安装 Node.js
- 访问 Node.js 官网 https://nodejs.org/zh-cn
- 下载安装包（建议选择 22.x LTS 版本）
- 运行安装包，按步骤操作即可。
安装 Homebrew 和 Git
- 下载并运行 Homebrew 安装包。
- 安装 Git：打开 Git 官网 https://git-scm.com/install/mac，将 Homebrew 下的指令复制到'终端'运行。
注意：不要复制brew install git$符号，只复制英文部分。
Step 1｜安装 OpenClaw
- 打开 OpenClaw 官网：https://openclaw.ai/
- 下滑找到'Quick Start'，获取安装指令。
- 打开'终端'输入以下指令：
如果出现 'error' 报错，尝试强制执行：npm i -g openclawsudo npm i -g openclaw - 验证安装成功：
若看到版本号，说明安装完成。openclaw --version
Step 2｜接入飞书
1. 创建飞书机器人并开启权限
后续会提供一键创建机器人的能力，敬请期待。
2. 创建企业自建应用
- 登录开发者后台：开发者后台 - 飞书开放平台，创建企业自建应用。
- 填写信息：
- 应用名称：自定义
- 应用描述：简单描述用途
- 应用图标：暂时可不传
- 点击'创建'按钮，跳转至应用详情页。
3. 添加应用能力
在能力列表中找到'机器人'能力卡片，点击'添加'。
4. 批量导入应用权限
- 在应用详情页左侧目录树，找到 权限管理 > 批量导入/导出权限。
- 清空输入框内容，复制下方代码块完整粘贴，点击'确定新增权限'：
{"scopes":{"tenant":["contact:contact.base:readonly","docx:document:readonly","im:chat:read","im:chat:update","im:message.group_at_msg:readonly","im:message.p2p_msg:readonly","im:message.pins:read","im:message.pins:write_only","im:message.reactions:read","im:message.reactions:write_only","im:message:readonly","im:message:recall","im:message:send_as_bot","im:message:send_multi_users","im:message:send_sys_msg","im:message:update","im:resource","application:application:self_manage","cardkit:card:write","cardkit:card:read"],"user":["contact:user.employee_id:readonly"
5. 获取应用凭证
- 在应用详情页左侧目录，找到'凭证与基础信息'。
- 复制并妥善保存以下两项信息：
- App ID：格式如
cli_xxxxxxxxxxxx - App Secret：一串长字符串，不可泄露。
- App ID：格式如
6. 安装飞书官方插件
依次在终端中执行以下命令：
npm config set registry https://registry.npmjs.org
curl -o /tmp/feishu-openclaw-plugin-onboard-cli.tgz https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/90600c5361ebe210fdae13020544bdc7_GmKPCTpnyF.tgz
npm install /tmp/feishu-openclaw-plugin-onboard-cli.tgz -g
若出现 'error' 报错，尝试强制执行：
sudo npm install /tmp/feishu-openclaw-plugin-onboard-cli.tgz -g
rm /tmp/feishu-openclaw-plugin-onboard-cli.tgz
feishu-plugin-onboard install
输入完所有指令后，需填写刚才获取的飞书机器人 APP ID 和 APP Secret。
遇到问题怎么办？
运行诊断指令：
feishu-plugin-onboard doctor
尝试自动修复：
feishu-plugin-onboard doctor --fix
配置完成后，启动 OpenClaw
openclaw gateway run --allow-unconfigured
注意：此指令运行后，终端页面不能关闭。后续指令需新建终端页面运行（快捷键：Command + T）。
验证安装成功：
- 运行上述代码后，若看到服务启动日志，说明插件开始运行。
- 运行以下指令检查插件状态：
ID 为 feishu-openclaw-plugin 的 Status 为 'loaded'，即表示已成功启用。openclaw plugins list
订阅机器人长链接
- 进入 飞书开放平台，找到刚创建的应用，配置'事件与回调'。
- 进入 事件配置 > 订阅方式 > 使用长链接接受事件 > 保存。
- 添加'接收消息'事件。
- 进行'回调配置'，搜索并添加'卡片回传交互'，点'确认添加'。
7. 发布应用
应用必须发布后才能在飞书中使用。
- 点击上方'创建版本'。
- 填写版本号（如
1.0.0）和版本描述。 - 点击'确定'创建版本，成功后点击版本右侧的'发布'按钮，等待管理员审批。
Step 3｜飞书初始化配置
1. 配置 AI 大模型
推荐大模型：火山引擎、MinMax 或其他模型厂商。先获取 API Key，然后运行指令：
openclaw config
按照提示选择：Local > Model > 选择模型厂商 > Paste API key now > 输入「API key」。
2. 运行 OpenClaw Gateway
打开'终端'依次输入以下指令：
openclaw gateway install
openclaw gateway start
openclaw gateway status
出现绿色 'loaded' 即为安装成功。
3. 打开飞书机器人
'开发者小助手'会将审批通过的应用推送到你的消息界面，点击'打开应用'。
4. 配对绑定
在飞书中向机器人发送任意消息，系统会生成一个配对码（有效期 5 分钟）。 打开'终端'执行以下命令完成绑定：
openclaw pairing approve feishu <配对码> --notify
如果未收到授权申请，可在聊天框输入 /feishu auth。
至此，已完成飞书内安装 OpenClaw 的全部配置。试试跟它说：'你好！'吧～
常用指令
| 指令名称 | 指令代码 |
|---|---|
| 确认是否安装成功 | /feishu start |
| 批量完成用户授权 | /feishu auth |
| 切换为流式回复 | openclaw config set channels.feishu.streaming true |
| 检查配置是否正常 | /feishu doctor |
推荐应用场景
OpenClaw 能将你从重复性、低价值的劳动中解放出来。通过自然语言指令就能完成日常办公任务，实现远程控制与自动化执行。
核心功能
- 智能早报生成：自动抓取天气、日历事件、新闻热点和未读邮件摘要，通过飞书消息同步给你。
- 邮件与日程管理：读取收件箱，提取会议/任务信息生成飞书日程，异常邮件实时推送。
- 文件智能整理：按规则扫描本地文件与云文档，自动分类、归档并生成目录索引，还能提供知识问答。
- 跨端远程办公：在手机飞书发送指令，由部署在电脑或服务器的 OpenClaw 执行复杂任务。
实际效果
- 时间节省：日均处理邮件超 50 封，日程创建效率提升 80%。
- 错误率降低：文件整理错误率从 17% 降至 0%。
- 重复劳动减少：每日固定流程耗时减少 73%。
- 响应速度：远程任务执行，突破时空限制，指令即结果。
团队协作场景：构建多 Agent AI 助理团队
OpenClaw 的多 Agent 架构支持搭建专业化分工的 AI 团队，搭配云文档、多维表格等功能，让 AI 们在飞书群中实现高效协作。
| 角色名称 | 核心职责 | 适用场景 |
|---|---|---|
| AI 大总管 | 总协调、任务分发、进度跟踪 | 项目启动、跨部门需求对接 |
| AI 资讯助理 | 行业资讯收集、定时推送、趋势分析 | 市场调研、竞品分析、日报生成 |
| AI 内容助理 | 文案创作、视频脚本、文档生成 | 内容营销、方案撰写、会议纪要 |
| AI 代码助理 | 技术支持、代码审查、方案设计 | 技术评审、BUG 排查、架构咨询 |
| AI 任务助理 | 任务跟踪、提醒催办、状态同步 | 项目管理、OKR 跟进、待办提醒 |
常见问题清单
1. 常见终端指令
| 指令名称 | 指令代码 | 使用说明 |
|---|---|---|
| 启动 AI 网关服务 | openclaw gateway run | 必用指令，运行时需保留该终端窗口 |
| 彻底停止后台运行的网关进程 | openclaw gateway stop | |
| 重启网关 | openclaw gateway restart | 修改了配置文件后，必须运行此指令才能生效 |
| 启动交互式安装向导 | openclaw configure | 用于设置飞书应用的 App ID、Secret 以及选择大模型供应商 |
| 启动可视化界面 | openclaw dashboard | 包含聊天、控制、代理与技能、配置等板块 |
| 自动诊断 | openclaw doctor | 检查系统环境、依赖项和配置是否存在异常 |
| 获取运行状态 | openclaw health | 获取网关和已连接渠道的实时运行状态 |
| 打开插件列表 | openclaw plugins list |
2. OpenClaw 消耗贵吗？
目前火山方舟 Coding Plan 已经支持了 OpenClaw，Lite 套餐首月订阅价格优惠，限频不限量，基本可以实现 tokens 自由。消耗情况取决于用法，丰俭由人。
3. 插件安装完运行后，报 cannot find module xxx
原因是系统没有安装插件的依赖（可能是安装被中断或权限问题）。
解决方法：进入插件安装目录，运行 npm install。
4. 如果想要切换到流式输出怎么配置
切换到流式输出：
openclaw config set channels.feishu.streaming true
不用流式输出：
openclaw config set channels.feishu.streaming false
流式输出卡片上支持显示更多内容：
openclaw config set channels.feishu.footer.elapsed true // 开启耗时
openclaw config set channels.feishu.footer.status true // 开启状态展示
5. 如何修改飞书机器人在群内的回复方式
# 查看当前配置
openclaw config get channels.feishu
# 设置需要 @ 才回复
openclaw config set channels.feishu.requireMention true--json
# 设置不需要 @ 也回复
openclaw config set channels.feishu.requireMention open--json
# 给特定群设置规则
openclaw config set channels.feishu.groups.群 ID.requireMention true--json
# 重启 Gateway 生效
sh /workspace/projects/scripts/restart.sh
模式 1：只有 @机器人 才回复（最常用）
配置方法
openclaw config set channels.feishu.requireMention true--json
sh /workspace/projects/scripts/restart.sh
完整配置示例
{"channels":{"feishu":{"enabled":true,"appId":"cli_你的 AppID","appSecret":"你的 AppSecret","requireMention":true,"groupPolicy":"open"}}}
模式 2：不用 @，所有消息都回复
配置方法
openclaw config set channels.feishu.requireMention false--json
sh /workspace/projects/scripts/restart.sh
完整配置示例
{"channels":{"feishu":{"enabled":true,"appId":"cli_你的 AppID","appSecret":"你的 AppSecret","requireMention":"open","groupPolicy":"open"}}}
注意：这个模式在大群里容易刷屏，谨慎使用！
模式 3：只有指定群 @机器人 才回复（高级）
效果
- 大部分群：不用 @ 也能回复（或者完全不回复）
- 特定群：必须 @ 才回复
- 适合：不同群不同规则，比如工作群严格一点，闲聊群随意一点
配置方法 第一步：获取群 ID。让 Bot 加入群后，发送任意消息，然后在日志里找群 ID。 第二步：配置特定群规则。
# 先设置默认所有群都不需要 @
openclaw config set channels.feishu.requireMention open--json
# 然后给特定群设置需要 @（这里群 ID 只是示例，你要替换成真实的）
openclaw config set channels.feishu.groups.oc_xxxxxxxx.requireMention true--json
# 重启生效
sh /workspace/projects/scripts/restart.sh
完整配置示例
{"channels":{"feishu":{"enabled":true,"appId":"cli_你的 AppID","appSecret":"你的 AppSecret","requireMention":"open","groupPolicy":"open","groups":{"oc_532044075a61d112f04fa63109c75e9b":{"requireMention":true},"oc_另一个群 ID":{"requireMention":true}}}}}
