从零开始一口气看懂飞书+OpenClaw工作流搭建!

前言：这是第一篇。以后，这些需要你慢慢看、反复抄作业的硬核图文与结构化内容，都能在公众号里更直观地看到。

来源：川川初学两周亲身搭建经验

剑妈整理定位：可教学的完整教程

配套环境： MacBook Air M3 + 飞书 + OpenClaw前置要求：会用飞书、会打字

模块一｜认识工具：OpenClaw × 飞书是什么

1-1.

OpenClaw 是什么？

OpenClaw（小龙虾）是一款开源的个人 AI Agent 系统，可以运行在你的个人电脑或服务器上。和传统 AI 工具的核心区别：

特性	OpenClaw	传统 AI
使用方式	在飞书/Telegram 等聊天软件内直接使用	需要打开专门网页/APP
对话记忆	跨平台持久记忆，跨会话连续	每次对话独立，关闭即消失
主动推送	支持定时提醒和主动通知	只能被动响应
数据存储	本地 Markdown 文件	存储在云端
定制能力	完全可编程 Skills 系统，按需扩展	有限的自定义

一句话定位：

你自己的 AI 分身，跑在你的电脑里，24 小时待命。

飞书作为协作底座的优势

飞书天然承载了大量工作信息和协同动作，为 OpenClaw 提供了更适合落地的运行环境。OpenClaw 飞书官方插件能做的事：

读写飞书文档（云文档、多维表格）

发送和接收飞书消息

管理飞书日历和日程

操作飞书任务

以你的身份完成工作（真正的数字分身）

1-3. 为什么两者组合是"黄金搭档"？

川川真实感受：*"以前 AI 很聪明，却拿不到我真正工作的上下文。它无法直接访问我的文档、消息、日历或任务信息，于是我只能不断手动复制、粘贴、转述。结果就是，AI 在飞快进化，人却还在反复做信息搬运。"*OpenClaw × 飞书 = AI 进入真实工作流两者结合后，文档、消息、日历这些真正承载工作的信息流，就不需要你再一趟趟搬运了——你只要下达目标，它就能在飞书里完成动作。

1-4. 川川 4 层 × 7 角色体系一览

川川用 2 周搭建了一套完整的 AI 协作架构：总控层

剑妈（总控调度官）— 统一收口、决策分发

教员（学习教练官）— 学习计划、知识整理

尚龙（文案主笔官）— 文案生产、脚本撰写（只写文字）

一鸣（复盘优化官）— 每日复盘、验收把关

马布斯（首席分析师）— 复杂策略分析、研究、深度思考，策略层

雷布斯（内容增长官）— 视频制作、品牌营销内容制作的执行层

伊织（心跳检查官）— Cron 状态监控（独立 Agent，不进群），心跳层

模块一·踩坑记录

踩坑	解决
以为 OpenClaw 只是另一个聊天机器人	理解它是本地部署的 AI 系统，有记忆、能主动推送、可编程
混淆 OpenClaw 和普通 AI 对话	OpenClaw = 你的数字分身，不只是工具

模块二｜环境准备：从零安装 OpenClaw

1. 硬件与软件要求

检查清单：

Node.js v22+（检查命令：node -v）

npm 或 pnpm（二选一）

飞书账号（国内版）

稳定的网络连接

川川环境：MacBook Air M3，系统 macOS Darwin 24.6.0，Node v22.22.0

2. 安装 OpenClaw CLI

方式一：npm（推荐）

Plain Text npm install -g openclaw@latest

验证安装：

Plain Text openclaw --version

2-3. 快速启动向导

运行 openclaw onboard 开始交互式配置：

确认风险提示 → 输入 Yes

选择 QuickStart（快速启动）

模型配置：选择你的 AI 提供商（MiniMax / 月之暗面等）

输入 API Key

跳过渠道配置（后续再配）

跳过技能配置（后续再装）

跳过钩子配置完成后看到"Setup complete"即成功

2-4.

配置文件结构初识

配置文件位置：~/.openclaw/openclaw.json关键字段：

model — 模型配置

channels — 聊天渠道（飞书等）

agents — Agent 配置

skills — 技能扩展川川配置文件参考结构：

JSON { "model": "minimax-portal/MiniMax-M2.5", "channels": { "feishu": { "enabled": true, "appId": "cli_xxx", "appSecret": "xxx", "domain": "feishu" } } }

模块二·踩坑记录

踩坑	解决
Node 版本过低（低于 v22）	先升级 Node：nvm install 22 或从 nodejs.org 下载安装
npm 安装失败（网络问题）	切换淘宝镜像：npm config set registry https://registry.npmmirror.com
向导中断后无法续接	删掉 ~/.openclaw/ 重新 openclaw onboard
配置文件格式错误导致 gateway 无法启动	用 openclaw gateway run --allow-unconfigured 急救

模块三｜飞书机器人配置：开放平台实操

3-1. 创建飞书企业自建应用

步骤：

打开飞书开放平台（open.feishu.cn）

点击「创建企业自建应用」

填写应用名称（如"我的 OpenClaw AI"）和描述

点击创建记录凭证：创建后在「凭证与基础信息」页面，复制保存：

App ID（如 cli_axxx）

App Secret

App Secret 只显示一次，必须立即复制保存！

3-2. 启用机器人能力

进入应用 → 左侧「添加应用能力」

选择「机器人」→「添加」

机器人能力开启成功

3-3. 配置权限（批量导入）

左侧「权限管理」→「批量导入/导出权限」

粘贴以下 JSON：

JSON { "scopes": { "tenant": [ "im:message", "im:message.p2p_msg:readonly", "im:message.group_at_msg:readonly", "im:message:send_as_bot", "contact:user.base:readonly" ] } }

点击「新增权限」→「确认开通」

3-4. 配置事件订阅

左侧「事件与回调」→「事件配置」

点击「订阅方式」旁的编辑图标 → 选择「长连接（WebSocket）」→ 保存

点击「添加事件」→ 搜索「接收消息」→ 勾选 im.message.receive_v1 → 确认

3-5. 发布应用

左侧「版本管理与发布」→「创建版本」

填写版本号（如 1.0.0）和版本说明

点击「保存」

点击「确认发布」

模块三·踩坑记录

踩坑	解决
App Secret 只显示一次，没复制	飞书不支持再次完整查看，只能新建应用重新获取
权限漏配，导致机器人无法发消息	必须包含 im:message 和 im:message:send_as_bot
未发布版本，配置不生效	每次修改配置后必须重新发布版本
事件订阅选错模式（选了 HTTP）	必须选「长连接」，HTTP 模式需要公网服务器

模块四｜连接配置：OpenClaw × 飞书插件

4-1. 安装飞书官方插件

方式一：命令行（推荐）

Plain Text openclaw plugins enable feishu

方式二：手动安装（3.x 版本）

Bash # 1. 设置 npm 镜像 npm config set registry https://registry.npmmirror.com # 2. 下载安装包 curl -o /tmp/feishu.tgz https://npmmirror.com/package/@openclaw-lark/feishu/latest/files # 3. 安装 npm install -g /tmp/feishu.tgz # 4. 运行安装向导 feishu-plugin-onboard install

验证安装：

Plain Text openclaw plugins list

看到 feishu 的 Status 为 loaded 即成功。

4-2. 配置 channel 连接

方式一：交互式配置

Plain Text openclaw channels add

选择 Feishu/Lark (飞书) → 输入 App ID → 输入 App Secret → 选择域名（国内选 feishu）→ 选择群聊策略（选 Open）→ 完成方式二：手动编辑配置文件编辑 ~/.openclaw/openclaw.json，在 channels.feishu 下添加：

JSON { "channels": { "feishu": { "enabled": true, "appId": "cli_你的AppID", "appSecret": "你的AppSecret", "domain": "feishu", "groupPolicy": "open" } } }

4-3. 飞书官方插件权限配置（OAuth）

在飞书中发送命令完成授权：

打开飞书，找到你的机器人

给机器人发送：/feishu auth

按提示完成用户授权

4-4. 重启与验证

重启 Gateway：

Plain Text openclaw gateway restart

验证连接成功：

在飞书中找到你的机器人

给它发一条消息（如"你好"）

如果收到回复，说明连接成功**检查插件状态：**在 OpenClaw 对话中发送：/feishu start在 OpenClaw 对话中发送：/feishu doctor（深度诊断）

模块四·踩坑记录

踩坑	解决
飞书插件与旧版三方插件冲突	先删除旧插件：openclaw plugins remove feishu，再重装
重启后连接失败	检查 App ID 和 App Secret 是否正确
流式输出卡顿	关闭流式模式：openclaw config set channels.feishu.streaming false
Gateway 启动失败	用 openclaw gateway run --allow-unconfigured 急救，再排查配置
插件状态显示 disabled	运行 openclaw plugins enable feishu 重新启用

模块五｜Agent 配置与多 Agent 协作

5-1. 理解 OpenClaw Agent 架构

OpenClaw 的核心理念：不同任务交给不同的专业 Agent，各司其职，协同工作。

概念	说明
Main Agent（主控）	默认 Agent，负责总调度和收口
Sub-Agent（子 Agent）	专业 Agent，执行特定任务（如马布斯、尚龙等）
Session（会话）	每个 Agent 独立的工作上下文
Skill（技能）	Agent 的工具包，扩展能力

5-2. 创建你的第一个 Agent

川川的 Agent 体系（4机器人 + 4群模型）：

Agent	角色定位	形态	核心职责
剑妈	总控调度官	Main Agent	统一收口、决策分发、协调各 Agent
尚龙	文案主笔官	飞书群	内容生产、脚本撰写
教员	学习教练官	飞书群	学习计划、知识整理
一鸣	复盘风控官	飞书群	每日复盘、验收把关

Agent 创建命令：

Plain Text openclaw agents create

5-3. 多飞书账号 × 多 Agent 绑定

场景：不同飞书群对应不同 Agent，实现专业化分工。配置示例（openclaw.json）：

JSON { "channels": { "feishu": { "accounts": { "main": { "appId": "cli_main", "appSecret": "xxx", "botName": "剑妈" }, "shanglong": { "appId": "cli_sl", "appSecret": "xxx", "botName": "尚龙" } } } }, "bindings": [ { "accountId": "main", "agentId": "jianma" }, { "accountId": "shanglong", "agentId": "shanglong" } ] }

川川实践：

总控群 → 剑妈（主 Agent，直接响应）

尚龙群 → 尚龙群角色（群内尚龙执行文案）

各群成员互相隔离，看不到其他 Agent 的上下文

5-4. Cron 自动化任务配置

核心命令：

命令	功能
openclaw cron list	查看所有定时任务
openclaw cron create	创建新任务
openclaw cron delete	删除任务

川川的 Cron 任务清单（参考）：

任务	时间	内容
财经早报	08:00	今日财经要闻 20 条
财经午报	12:30	午间财经动态
财经晚报	22:00	晚间财经总结
热点推荐	22:00	短视频选题推荐 3 条
心跳检查	每小时	Cron 状态 + Context 监控
日历提醒	每小时+5分	今日日程查询

踩坑：任务太重导致超时（60 秒限制）

解决：重构为轻量独立任务，不在单次执行中做复杂操作

原则：Cron 任务只做检查/推送，复杂逻辑交给 Sub-Agent

5-5. Skill 安装与管理

Skill 市场：

clawhub.ai — 官方 Skill 市场

npx skills add — 川川安装的部分Skills：

Skill	功能	安装命令
news-aggregator	综合新闻 28 源	npx skills add news-aggregator -g -y
hackernews	AI/科技热点	npx skills add hackernews -g -y
tushare-finance	A股/港股数据	npx clawhub install tushare-finance
skill-vetter	安全扫描	npx clawhub install skill-vetter

模块五·踩坑记录

踩坑	解决
多 Agent 上下文相互干扰	每个 Agent 用独立 session，配置文件分离
角色定位不清导致调度混乱	每个 Agent 有明确的 SOUL.md，边界清晰
Cron 任务超时（60 秒限制）	拆分重任务为轻量独立任务
Session 文件卡住（lock 残留）	删除 ~/.openclaw/agents/*/.lock，或 /reset 重置
Skill 安装失败	检查网络，或用 npm config set registry 切换镜像

模块六｜实战工作流：完整案例解析

6-1. 消息自动化

场景：热点推荐自动推送到总控群流程：

Plain Text 22:00 Cron 触发 → OpenClaw 调用 news-aggregator Skill 获取今日热点 → 剑妈分析筛选出 3 条优质选题 → 自动推送到飞书总控群 → 川川决策"做第 X 条" → 触发尚龙文案链路

6-2. 日历自动化

场景：每日日程自动查询 + 早安播报配置： Cron 任务（每小时）→ 调用飞书日历 API → 格式化输出 → 推送给我川川的早安播报内容：

今日日程有几项

是否有重要会议

天气情况

6-3. 文档自动化

场景：每日成长日记自动同步到飞书云文档流程：

Plain Text 每日收尾时 → 剑妈整理今日成果 → 调用飞书文档 API → 写入《易川AI成长日记》文档 → 同步到教员群（教程沉淀）

相关工具：

feishu_create_doc — 创建新文档

feishu_fetch_doc — 读取文档

feishu_update_doc — 更新文档

6-4. 多维表格自动化

场景：知识库自动沉淀飞书多维表格自动化的核心能力：

触发条件	执行动作
添加新记录时	发送通知 / 新增记录 / 更新记录
修改记录时	AI 生成文本 / 发送消息
定时触发	自动汇总数据 / 推送报表
点击按钮	发送消息卡片 / 执行其他自动化

川川场景：内容生产链路中，每个任务的完成状态自动同步到多维表格看板。

6-5. 任务自动化

场景：内容生产链路自动创建子任务完整链路：

Plain Text 川川决策"做第 X 条" → 剑妈推送任务单到尚龙群 → 尚龙给出 3 个策略选项 → 川川选策略 → 尚龙执行文案 → 雷布斯制作内容 → 一鸣复盘

飞书任务 API：

feishu_task_task — 创建/查询/更新任务

feishu_task_subtask — 子任务管理

feishu_task_comment — 任务评论

6-6. 多 Agent 协作实战

川川内容生产链路的完整多 Agent 协作：

Plain Text ① 22:00 热点日报（Cron） ↓ ② 剑妈推荐 3 条（总控群）每条包含：切入点 + 适合人群 + 推荐理由 ↓ ③ 川川决策："做第 X 条"（总控群回复） ↓ ④ 剑妈推送完整任务单 → 尚龙群 ↓ ⑤ 尚龙给出 3 个策略选项 ↓ ⑥ 川川选策略（尚龙群） ↓ ⑥.5 剑妈询问川川是否有额外观点/感受（如有则融合） ↓ ⑥.7 剑妈确认 Demo 测试还是正式发布 ↓ ⑦ 尚龙执行文案/脚本 ↓ ⑧ 雷布斯制作内容 ↓ ⑨ 川川验收 ↓ ⑩ 一鸣复盘

关键心法：

总控收口，执行层不直接找用户。用户只对剑妈说话。

模块七｜架构总结与落地路径

7-1. 川川 4 机器人 × 4 群协作模型（现行版）

说明：初期规划为"4层 × 11角色"，经 Day1-14 实际搭建后调整为更精简的"4层 × 7角色"模型。

Agent/群	形态	核心职责
剑妈	Main Agent（机器人）	总控调度、决策分发、统一收口
马布斯	独立 Sub-Agent（机器人）	复杂策略分析、深度研究（不进群）
雷布斯	独立 Sub-Agent（机器人）	视频制作、品牌增长（不进群）
伊织	独立 Cron Agent（机器人）	心跳检查、状态监控（不进群）
尚龙群	飞书群	文案主笔、内容脚本执行
教员群	飞书群	学习计划、知识整理
一鸣群	飞书群	每日复盘、验收把关
总控群	飞书群	全局调度、任务入口

协作原则：

统一从剑妈统筹和收口

马布斯/雷布斯/伊织作为独立 Agent，不进群，任务完成后回传剑妈收口

剑妈是唯一调度入口，各群角色各司其职

层级	角色	形态	核心职责
总控层	剑妈	Main Agent	统一收口、决策分发、总控复盘
策略层	马布斯	独立 Sub-Agent	复杂策略分析、深度研究
	教员	飞书群	学习计划、知识整理
执行层	尚龙	飞书群	文案主笔、内容脚本
	雷布斯	独立 Sub-Agent	视频制作、品牌增长
复盘层	一鸣	飞书群	每日复盘、验收把关
心跳与审查	伊织	独立 Sub-Agent	按时反馈心跳、把关运行是否顺畅

7-2. 落地路径建议

第一天：安装跑通

安装 OpenClaw CLI

创建飞书应用，获取凭证

配置飞书 channel，验证连接成功第二天：单 Agent 跑通

配置官方插件

完成 OAuth 授权

让机器人完成一个简单任务（如查天气）第三-七天：多 Agent 协作

创建第二个 Agent

配置多飞书账号绑定

设计你的第一套协作流程第二周：Cron 自动化

配置第一个定时任务

验证心跳机制

优化任务稳定性

7-3. 从 0 到 1 的检查清单

安装阶段

Node.js v22+ 已安装

OpenClaw CLI 已安装

openclaw --version 能正常输出版本配置阶段

飞书开放平台应用已创建

App ID 和 App Secret 已记录

机器人能力已开启

权限已配置并开通

事件订阅已配置（长连接）

应用已发布连接阶段

openclaw plugins enable feishu 成功

openclaw channels add 配置成功

openclaw gateway restart 无报错

飞书机器人能正常收发消息Agent 阶段

主 Agent 能正常工作

第一个 Sub-Agent 已创建

角色定位清晰（SOUL.md 已写）自动化阶段

第一个 Cron 任务已配置

心跳机制已验证

消息推送链路跑通

附录

附录 A：命令速查表

命令	功能
openclaw --version	查看版本
openclaw onboard	启动配置向导
openclaw gateway restart	重启网关
openclaw plugins list	查看已装插件
openclaw plugins enable feishu	启用飞书插件
openclaw channels add	添加渠道
openclaw agents create	创建 Agent
openclaw cron list	查看定时任务
/feishu doctor	飞书诊断

附录 B：飞书官方文档链接

文档	链接
OpenClaw 飞书官方插件介绍	飞书官方文章
OpenClaw × 飞书 20+用法	飞书官方文章
OpenClaw 完全搞懂指南	飞书官方文章
飞书开放平台	open.feishu.cn
OpenClaw 官网	openclaw.ai

附录 C：配置文件模板

JSON { "model": "minimax-portal/MiniMax-M2.5", "channels": { "feishu": { "enabled": true, "appId": "cli_你的AppID", "appSecret": "你的AppSecret", "domain": "feishu", "groupPolicy": "open" } }, "agents": { "main": { "name": "剑妈", "model": "minimax-portal/MiniMax-M2.5" } } }

整理：剑妈（川川 AI 营销系统总控）