Home
Softono
a

alexanys

Professional software vendor delivering innovative solutions on the Softono platform. Specialized in both open-source and proprietary software development.

Total Products
3

Software by alexanys

awesome-openclaw-usecases-zh
Open Source

awesome-openclaw-usecases-zh

<div align="center"> <img width="1500" height="500" alt="OpenClaw AI 智能体最佳用例与案例合集 - 50 个真实场景" src="https://github.com/user-attachments/assets/4ae57dfb-4f18-4677-9136-43bf93017250" /> <br/> <br/> <p><strong>50 个经过验证的真实场景,手把手教你用 AI 智能体自动化工作与生活</strong></p> <br/> [![Awesome](https://awesome.re/badge.svg)](https://awesome.re) ![用例数量](https://img.shields.io/badge/用例-50-blue?style=flat-square) ![中文](https://img.shields.io/badge/语言-简体中文-red?style=flat-square) ![新手友好](https://img.shields.io/badge/难度-新手友好-green?style=flat-square) ![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square) [![GitHub](https://img.shields.io/badge/主仓库-GitHub-black?style=flat-square&logo=github)](https://github.com/AlexAnys/awesome-openclaw-usecases-zh) [![AtomGit](https://img.shields.io/badge/国内托管-AtomGit-orange?style=flat-square)](https://atomgit.com/alex_anys/awesome-openclaw-usecases-zh) **[快速开始](#-新手入门指南)** · **[用例目录](#-目录)** · **[贡献指南](CONTRIBUTING.md)** </div> --- # Awesome OpenClaw 最佳案例合集(中文版)🇨🇳 > 解决 OpenClaw 普及的瓶颈:不是 ~~技能~~,而是找到 **能改善你生活的方式**。 > > 一份面向中文用户的 OpenClaw 真实使用案例合集,包含社区验证的国际用例的中国适配,国内生态特色用例,从零入门。 <details> <summary><strong>📖 来源声明</strong></summary> 本仓库受 [awesome-openclaw-usecases](https://github.com/hesamsheikh/awesome-openclaw-usecases) 启发,在其基础上独立发展,包含大量国内生态原创用例和适配内容。感谢原作者 [hesamsheikh](https://github.com/hesamsheikh) 和所有社区贡献者。 </details> > **2026.5.4 更新**:新增 Multica 多 CLI 协作看板用例——把 OpenClaw / Claude Code / Codex / Hermes 拉进同一个 Web 看板,Apache 2.0 自部署友好。详见 [基础设施与 DevOps](#基础设施与-devops)。 --- ## 🗂 目录 - [新手入门指南](#-新手入门指南) - **[🇨🇳 中国特色用例](#-中国特色用例)** — 23 个国内生态用例 - [平台机器人](#平台机器人) (4) — 飞书、钉钉、企业微信等 IM 平台 AI 接入 - [内容创作与发布](#内容创作与发布) (3) — 小红书、公众号、播客全流程自动化 - [数据研究与监控](#数据研究与监控) (7) — A 股、财报、竞品、论文、中文互联网研究 - [办公与客户服务](#办公与客户服务) (4) — 邮件、会议、多渠道客服、电商多 Agent - [个人助理与智能体架构](#个人助理与智能体架构) (5) — 早间简报、人格档案、多 Agent 编排 - **[🌐 通用场景](#-通用场景)** — 国际用例合集(部分含国内适配) - [社交媒体](#社交媒体) (4) — Reddit、YouTube、X 等平台内容聚合 - [创意与构建](#创意与构建) (3) — 内容创作流水线、从零构建产品 - [基础设施与 DevOps](#基础设施与-devops) (5) — 服务器自愈、工作流编排、可观测性、智能体看板 - [生产力](#生产力) (16) — 邮件、日程、笔记、CRM、个人助理 - [研究与学习](#研究与学习) (9) — 知识库、市场调研、论文发现、竞品分析 - [金融与交易](#金融与交易) (1) — 预测市场模拟交易 --- ## 🚀 新手入门指南 [OpenClaw](https://github.com/openclaw/openclaw)(前身为 ClawdBot、MoltBot)是一个开源的 **个人 AI 智能体**。和普通 AI 聊天不同,它能主动执行任务、永久记住你的偏好、连接多个平台、按时间表自动运行。简单来说,是一个 **7×24 小时在线的 AI 员工**。[查看官方中文教程](https://docs.openclaw.ai/zh-CN) <details> <summary><strong>🚀 三步开始使用(点击展开)</strong></summary> ``` 1️⃣ 安装 OpenClaw → github.com/openclaw/openclaw 2️⃣ 从下方选一个感兴趣的用例开始,或连接你的 Telegram / Discord / 飞书 / 钉钉 / 企业微信 3️⃣ 复制用例中的提示词,粘贴给你的 OpenClaw ``` 就这么简单。 </details> <details> <summary><strong>📖 核心概念一看就懂(点击展开)</strong></summary> | 概念 | 英文 | 一句话解释 | 生活类比 | |:---:|:---:|---|---| | 工作区 | Workspace | 智能体的"家",所有文件都在这里 | 像员工的办公桌 | | 灵魂 | SOUL.md | 定义智能体的性格、语气和边界 | 像一个人的性格和价值观 | | 操作手册 | AGENTS.md | 告诉智能体如何工作、如何记忆 | 像岗位说明书 | | 记忆 | Memory | 记住你说过的话和偏好 | 像一个越来越懂你的老助理 | | 技能 | Skill | 教会智能体做好某件事的知识包 | 像老师傅传授的经验诀窍 | | 工具 | Tool | 智能体能调用的具体能力(读文件、搜索、发消息等) | 像员工手边的办公工具 | | 频道 | Channel | 连接 Telegram、飞书、Discord 等平台 | 像员工的多个联系方式 | | 提示词 | Prompt | 你给它的指令 | 像给员工安排工作 | | 定时任务 | Cron Job | 按时间表自动执行 | 像设了个闹钟 | | 心跳 | Heartbeat | 定期自动检查状态并主动汇报 | 像保安巡逻 | | 子智能体 | Sub-agent | 派出"分身"并行处理 | 像带了一个小团队 | | 上下文 | Context | 智能体当前能"看到"的所有信息 | 像工作记忆,桌上摊开的文件 | | 节点 | Node | 把手机/平板连接为智能体的"眼睛和手" | 像给员工配了手机 | </details> ### 如何阅读本合集? 每个用例都按统一格式组织: | 章节 | 内容 | |------|------| | **痛点** | 这个用例解决什么问题 | | **它能做什么** | 具体功能列表 | | **所需技能** | 需要安装哪些插件 | | **如何设置** | 手把手教你配置(含可复制的提示词) | | **实用建议** | 踩过的坑和最佳实践 | > 💡 **提示**:代码块中的英文 prompt(提示词)建议直接复制使用,效果最佳。每段 prompt 上方都有中文说明帮你理解其作用。 > 🤖 **Agent 友好**:本合集的用例格式经过结构化设计,除了方便你阅读,也可以尝试将用例文件交给 AI 智能体辅助执行设置步骤。这是一个实验性的思路,效果因用例复杂度而异——具体说明见 [AGENT-GUIDE.md](AGENT-GUIDE.md)。 --- > ⚠️ **安全提醒**:本合集引用的技能和第三方依赖**未经维护者审核**。使用前请审查源代码、检查权限,避免硬编码凭证。 > 难度说明:⭐ 复制粘贴即可用 · ⭐⭐ 需要简单配置 · ⭐⭐⭐ 需要一定技术基础 --- ## 🇨🇳 中国特色用例 > 为中国工具生态设计或适配的用例,使用飞书、钉钉、企业微信、小红书等国内平台。标注"适配"的用例在国际版基础上增加了国内方案。共 23 个,按场景分 5 类。 ### 平台机器人 把 OpenClaw 接入国内 IM 和办公平台,在日常对话中使用 AI。 | 名称 | 描述 | 难度 | |------|------|:---:| | [飞书 AI 助手](usecases/cn-feishu-ai-assistant.md) | 把 OpenClaw 部署为飞书机器人,在对话中直接触发 AI 任务,支持文档自动化 | ⭐⭐ | | [飞书全能操作台(Lark CLI)](usecases/cn-feishu-lark-cli.md) | 让 AI Agent 以你的身份操作飞书——搜文档、读妙记、查日历、发消息,覆盖 11 个领域 200+ 命令 | ⭐ | | [钉钉 AI 助手](usecases/cn-dingtalk-ai-assistant.md) | 把 OpenClaw 部署为钉钉机器人,Stream 模式无需公网 IP | ⭐⭐ | | [企业微信 AI 助手](usecases/cn-wecom-ai-assistant.md) | 在企业微信中使用 AI,通过微信插件让个人微信也能用 | ⭐⭐ | ### 内容创作与发布 从选题、写作、排版到发布的自动化流水线。 | 名称 | 描述 | 难度 | |------|------|:---:| | [小红书内容自动化](usecases/cn-xiaohongshu-automation.md) | 从选题、文案、封面图到定时发布的全流程自动化 | ⭐ | | [微信公众号自动发布](usecases/cn-wechat-mp-automation.md) | Markdown 转排版 + 草稿箱推送,含账号权限矩阵与 IP 白名单配置 | ⭐⭐ | | [播客制作流水线(适配)](usecases/podcast-production-pipeline.md) | 从选题到发布的全流程播客制作自动化(小宇宙/喜马拉雅/B站) | ⭐⭐ | ### 数据研究与监控 商业数据、学术论文、互联网内容的采集与分析。 | 名称 | 描述 | 难度 | |------|------|:---:| | [A 股每日行情监控](usecases/cn-a-share-monitor.md) | 盘前简报 + 盘后复盘 + 板块资金流向,AKShare/MCP 数据源 | ⭐⭐ | | [AI 财报追踪器(适配)](usecases/earnings-tracker.md) | A 股财报追踪,AKShare 免费数据源 + 业绩预告/快报自动化 | ⭐⭐ | | [竞争对手分析与价格监控(适配)](usecases/competitive-intelligence.md) | Perplexity + Firecrawl MCP 竞品周报,百度指数/微信指数/飞书推送 | ⭐⭐ | | [开发前创意验证器(适配)](usecases/pre-build-idea-validator.md) | 编码前自动扫描竞品(百度指数/微信指数/V2EX/少数派) | ⭐⭐ | | [中文互联网 30 天研究](usecases/cn-internet-research-30days.md) | 8 大中文平台(微博/B站/知乎/抖音/小红书/微信/百度/头条)内容聚合研究 | ⭐⭐ | | [HuggingFace 论文发现(适配)](usecases/hf-papers-research-discovery.md) | 每日热门 ML 论文筛选 + arXiv 深读,HF 镜像站/飞书推送 | ⭐ | | [arXiv 论文阅读与 LaTeX 写作(适配)](usecases/arxiv-paper-reader-latex-writer.md) | 论文获取/章节浏览/摘要速扫 + LaTeX 即时编译,中文模板/Docker 镜像适配 | ⭐⭐ | ### 办公与客户服务 企业内部工作流、会议协作、对外客服。 | 名称 | 描述 | 难度 | |------|------|:---:| | [办公自动化套件](usecases/cn-office-automation.md) | 邮件管理、文件整理、会议纪要、周报生成,支持 163/QQ/Outlook | ⭐⭐ | | [会议纪要与待办自动化(适配)](usecases/meeting-notes-action-items.md) | 会议转录自动生成纪要并创建任务(飞书妙记/腾讯会议/钉钉) | ⭐⭐ | | [多渠道 AI 客户服务(适配)](usecases/multi-channel-customer-service.md) | 企业微信/抖音/小红书多渠道客服自动化 | ⭐⭐⭐ | | [电商多 Agent 架构](usecases/cn-ecommerce-multi-agent.md) | 多 Agent 绑定飞书群实现电商角色分工,4 个 Skill 覆盖销售/库存/客户全场景 | ⭐⭐ | ### 个人助理与智能体架构 日常推送、人格档案、多智能体编排。 | 名称 | 描述 | 难度 | |------|------|:---:| | [早间简报(适配)](usecases/custom-morning-brief.md) | 每日定时推送简报到飞书/钉钉,支持中文新闻源和 cron 配置 | ⭐ | | [数字人格蒸馏(适配)](usecases/digital-persona-distillation.md) | 从 12+ 平台聊天记录提取 4 维人格档案,含飞书/微信采集和 PIPL 提醒 | ⭐⭐⭐ | | [多智能体协作操作系统](usecases/cn-multi-agent-operating-system.md) | 把 OpenClaw 变成专业分工、协同、稳定迭代的智能体系统 | ⭐⭐⭐ | | [Agent Swarm 一人开发团队(适配)](usecases/agent-swarm-dev-team.md) | OpenClaw 编排 Codex + Claude Code 舰队,全自动化开发流水线 | ⭐⭐⭐ | | [Multica 智能体看板(适配)](usecases/multica-managed-agents.md) | 把 OpenClaw / Claude Code / Codex / Hermes 拉进同一个 Web 看板,Issue 即任务、Apache 2.0 自部署 | ⭐⭐ | --- ## 🌐 通用场景 > OpenClaw 国际社区贡献的通用用例,按场景分类。部分用例已在文件底部补充了国内适配章节。 ### 社交媒体 > 自动聚合你关心的内容,告别信息焦虑 | 名称 | 描述 | 难度 | |------|------|:---:| | [每日 Reddit 摘要](usecases/daily-reddit-digest.md) | 根据你的偏好,生成你喜爱的 subreddit 精选摘要 | ⭐ | | [每日 YouTube 摘要](usecases/daily-youtube-digest.md) | 获取你关注频道的每日新视频摘要,不错过任何内容 | ⭐ | | [X 账号分析](usecases/x-account-analysis.md) | 获取你的 X(原 Twitter)账号的定性分析 | ⭐⭐ | | [多源科技新闻摘要](usecases/multi-source-tech-news-digest.md) | 自动聚合 109+ 来源的科技新闻,支持质量评分和多渠道分发 | ⭐⭐ | ### 创意与构建 > 让 AI 智能体帮你创作内容、从零构建产品 | 名称 | 描述 | 难度 | |------|------|:---:| | [目标驱动的自主任务](usecases/overnight-mini-app-builder.md) | 告诉 AI 你的目标,它自动拆解并每天执行,还能一夜之间造出迷你应用 | ⭐⭐ | | [YouTube 内容流水线](usecases/youtube-content-pipeline.md) | 为 YouTube 频道自动化视频创意发掘、研究和追踪 | ⭐⭐⭐ | | [多智能体内容工厂](usecases/content-factory.md) | 在 Discord 中运行研究、写作、设计三个智能体组成的内容流水线 | ⭐⭐⭐ | ### 基础设施与 DevOps > 让服务器自己修自己,你只管睡觉 | 名称 | 描述 | 难度 | |------|------|:---:| | [n8n 工作流编排](usecases/n8n-workflow-orchestration.md) | 通过 webhook 将 API 调用委托给 n8n 工作流,智能体从不接触凭证 | ⭐⭐⭐ | | [Opik 可观测性追踪](usecases/opik-openclaw-observability.md) | 将 OpenClaw 运行链路接入 Opik,统一查看 LLM/工具/子智能体追踪,并监控 token 与成本 | ⭐⭐ | | [自愈家庭服务器](usecases/self-healing-home-server.md) | 运行始终在线的基础设施智能体,自动发现并修复故障 | ⭐⭐⭐ | | [Agent Swarm 一人开发团队](usecases/agent-swarm-dev-team.md) | OpenClaw 编排 Codex + Claude Code 舰队实现全自动化开发流水线(国内适配) | ⭐⭐⭐ | | [Multica 智能体看板](usecases/multica-managed-agents.md) | 多 CLI 智能体统一 Web 看板,Issue 即任务、Skills 可复用,Apache 2.0 自部署(国内适配) | ⭐⭐ | ### 生产力 > 把重复性工作交给 AI,专注于真正重要的事 | 名称 | 描述 | 难度 | |------|------|:---:| | [定制早间简报](usecases/custom-morning-brief.md) | 每天醒来就有专属简报——新闻、任务、内容草稿、AI 推荐操作(国内适配) | ⭐ | | [收件箱整理](usecases/inbox-declutter.md) | 自动总结新闻通讯并发送摘要邮件,告别邮件堆积 | ⭐ | | [第二大脑](usecases/second-brain.md) | 随手发消息记住一切,在自定义仪表板中随时搜索 | ⭐ | | [个人 CRM](usecases/personal-crm.md) | 自动从邮件和日历中发现并追踪联系人,支持自然语言查询 | ⭐⭐ | | [健康与症状追踪器](usecases/health-symptom-tracker.md) | 追踪食物摄入和症状以识别过敏诱因,带有定期签到提醒 | ⭐ | | [基于电话的个人助理](usecases/phone-based-personal-assistant.md) | 通过电话或短信从任何手机访问你的 AI 智能体 | ⭐⭐ | | [多渠道个人助理](usecases/multi-channel-assistant.md) | 一个 AI 助理统管 Telegram、Slack、邮件和日历 | ⭐⭐ | | [家庭日历与家务助理](usecases/family-calendar-household-assistant.md) | 聚合所有家庭日历到早间简报,监控消息获取预约,管理家庭库存 | ⭐⭐ | | [Todoist 任务管理器](usecases/todoist-task-manager.md) | 将 AI 推理和进度日志同步到 Todoist,实时看到智能体在做什么 | ⭐⭐ | | [多渠道 AI 客户服务](usecases/multi-channel-customer-service.md) | WhatsApp + Instagram + 邮件 + Google 评价统一到 AI 收件箱(国内适配) | ⭐⭐⭐ | | [活动嘉宾确认](usecases/event-guest-confirmation.md) | 自动逐一呼叫嘉宾确认出席、收集备注并编译摘要 | ⭐⭐ | | [项目状态管理](usecases/project-state-management.md) | 事件驱动的项目追踪,自动捕获上下文,取代静态看板 | ⭐⭐⭐ | | [动态仪表板](usecases/dynamic-dashboard.md) | 实时仪表板,子智能体并行从 API、数据库和社交媒体获取数据 | ⭐⭐⭐ | | [自主项目管理](usecases/autonomous-project-management.md) | 使用 STATE.yaml 模式协调多智能体项目,无需人工编排 | ⭐⭐⭐ | | [多智能体专业团队](usecases/multi-agent-team.md) | 4 个专业 AI 智能体(战略+开发+营销+商务)作为你的虚拟团队 | ⭐⭐⭐ | | [数字人格蒸馏](usecases/digital-persona-distillation.md) | 从 12+ 平台聊天记录提取 4 维人格档案(国内适配) | ⭐⭐⭐ | ### 研究与学习 > 让 AI 帮你整理知识、追踪市场、发现机会 | 名称 | 描述 | 难度 | |------|------|:---:| | [个人知识库 (RAG)](usecases/knowledge-base-rag.md) | 把 URL、推文和文章拖入聊天,构建可语义搜索的知识库 | ⭐⭐ | | [AI 财报追踪器](usecases/earnings-tracker.md) | 追踪科技/AI 公司财报,自动化预览、提醒和详细摘要(国内适配) | ⭐⭐ | | [语义记忆搜索](usecases/semantic-memory-search.md) | 为 OpenClaw 记忆文件添加向量驱动的语义搜索 | ⭐⭐ | | [市场研究与产品工厂](usecases/market-research-product-factory.md) | 从 Reddit 和 X 挖掘真实痛点,让 AI 构建解决方案 MVP | ⭐⭐⭐ | | [开发前创意验证器](usecases/pre-build-idea-validator.md) | 编码前自动扫描竞品,返回竞争度评分(国内适配) | ⭐⭐ | | [竞争对手分析与价格监控](usecases/competitive-intelligence.md) | Perplexity + Firecrawl MCP 构建竞品周报,月 $1.20 替代 $150 订阅(国内适配) | ⭐⭐ | | [HuggingFace 论文发现](usecases/hf-papers-research-discovery.md) | 每日热门 ML 论文筛选、元数据浏览、社区信号 + arXiv 深读(国内适配) | ⭐ | | [arXiv 论文阅读与 LaTeX 写作](usecases/arxiv-paper-reader-latex-writer.md) | 论文获取/章节浏览/摘要速扫 + LaTeX 即时编译,无需本地 TeX 环境(国内适配) | ⭐⭐ | | [中文互联网 30 天研究](usecases/cn-internet-research-30days.md) | 8 大中文平台内容聚合研究,三级降级策略,零配置可用 4 个免费平台 | ⭐⭐ | ### 金融与交易 > 用 AI 在预测市场上做模拟交易和策略回测 | 名称 | 描述 | 难度 | |------|------|:---:| | [Polymarket 自动驾驶](usecases/polymarket-autopilot.md) | 自动化预测市场模拟交易,带回测、策略分析和每日绩效报告 | ⭐⭐⭐ | --- > 💡 能用好 OpenClaw 这些用例,说明你在 AI 协作上很领先了。这些工具的背后,是 Coding Agent 工程能力的快速发展。想更自由地发挥这个能力,打造个性化生产级应用,欢迎关注 **[Agent-First Development](https://github.com/AlexAnys/agent-first-dev)**——基于斯坦福大学教授等授权,为所有背景的同学设计。项目开发中,欢迎宝贵反馈。 ## 🌟 为什么选择这个合集? | | 自己摸索 | 看碎片教程 | **本合集** | |---|:---:|:---:|:---:| | 用例经过真实验证 | ❌ 不确定能否跑通 | ⚠️ 质量参差不齐 | ✅ 每个用例有来源佐证 | | 国内生态适配 | ❌ 需自行替换工具 | ❌ 多为海外方案 | ✅ 飞书/钉钉/企业微信/小红书 | | 帮你选对方向 | ❌ skill 太多无从下手 | ⚠️ 只讲功能不讲场景 | ✅ 按真实场景组织,难度分级 | | 照做就能跑通 | ❌ 缺配置和提示词 | ⚠️ 步骤常不完整 | ✅ 完整步骤 + 可复制的提示词 | | 从零入门 | ❌ 默认你已经会了 | ⚠️ 各说各的 | ✅ 核心概念解释 + 新手指南 | --- ## 🤝 贡献 我们欢迎经过验证的真实用例。详见 [CONTRIBUTING.md](CONTRIBUTING.md)。 - **提交国内生态用例**(飞书、钉钉、企业微信、小红书等) - **适配国际用例**(在已有用例基础上增加国内方案) - **改进现有内容**(补充实践经验、修正过时信息) > 收录标准:真实跑通 + 多源验证 + 读者照做能复现。不接受未测试的用例和加密货币相关内容。 --- ## 📌 相关资源 - [OpenClaw 官方仓库](https://github.com/openclaw/openclaw) — 安装和官方文档 - [GitHub 主仓库](https://github.com/AlexAnys/awesome-openclaw-usecases-zh) — 主要开发与讨论在此进行 - [AtomGit 国内托管](https://atomgit.com/alex_anys/awesome-openclaw-usecases-zh) — 国内访问更快,内容同步更新 --- <div align="center"> **觉得有用?请给个 ⭐ Star 支持一下,让更多中文用户发现这个合集!** </div> --- ## 📈 Star History <a href="https://star-history.com/#AlexAnys/awesome-openclaw-usecases-zh&Date"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=AlexAnys/awesome-openclaw-usecases-zh&type=Date&theme=dark" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=AlexAnys/awesome-openclaw-usecases-zh&type=Date" /> <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=AlexAnys/awesome-openclaw-usecases-zh&type=Date" /> </picture> </a>

Education & Learning AI Agents
4.3K Github Stars
openclaw-feishu
Open Source

openclaw-feishu

# feishu-openclaw 飞书 × OpenClaw 保姆级配置指南 & 社区支持 **让每个人都能用飞书轻松接入 OpenClaw(原 Clawdbot)。** --- ### 📚 [awesome-openclaw-usecases-zh](https://github.com/AlexAnys/awesome-openclaw-usecases-zh) — 装好了 OpenClaw,然后呢? > > Skills 装了一堆,教程收藏了一堆,工具越来越多——但最缺的不是能力,而是**经过国内适配和验证的场景**。 > > 39 个真实用例,含飞书、钉钉、企业微信、小红书等**国内生态适配方案**,每个都有完整步骤和可复制的提示词。 > > **[查看中文最佳用例合集 →](https://github.com/AlexAnys/awesome-openclaw-usecases-zh)** --- ## 🆕 飞书官方开源 Lark CLI(2026.3.28) 飞书官方开源了 [Lark CLI](https://github.com/larksuite/cli)(MIT 协议)——让你的 AI Agent 直接操作飞书:搜文档、读妙记、查日历、发消息、操作多维表格…… **2500+ API,11 个业务领域,19 个 AI Agent Skills**。 安装只需要告诉你的 Agent 一句话,你只需要点一个授权链接。 👉 **[Lark CLI 上手指南](docs/lark-cli-guide.md)** --- ## 📢 飞书官方插件上线(2026.3.6) 飞书团队正式推出了 OpenClaw 飞书官方插件。目前飞书接入 OpenClaw 共有三种插件方式: - **(a) 飞书官方插件** — 飞书团队开发维护,支持以用户身份操作文档、日历、任务等 - **(b) OpenClaw 内置飞书插件** — OpenClaw 社区维护(`@openclaw/feishu`),OpenClaw ≥ 2026.2 已内置 - **(c) 本项目插件** — 本仓库早期开发的社区飞书插件(已停止更新,推荐迁移到 a 或 b) **👉 想了解飞书官方和 OpenClaw 内置插件的区别?** 看 [两个插件怎么选](#-飞书官方-vs-openclaw-内置怎么选) **👉 本项目插件的老用户?** 看 [如何迁移到飞书官方或 OpenClaw 内置插件](#-从旧版迁移) --- ## 📋 目录 - [🆕 Lark CLI(飞书官方开源 CLI)](#-飞书官方开源-lark-cli2026328) - [飞书官方插件(安装指南)](#-飞书官方插件) - [飞书官方 vs OpenClaw 内置:怎么选?](#-飞书官方-vs-openclaw-内置怎么选) - [OpenClaw 内置插件教程(从零配置)](#-openclaw-内置插件教程从零配置) - [从旧版迁移](#-从旧版迁移) - [常见问题 & 排查清单](#-常见问题--排查清单)(含 [API 配额耗尽](#api-配额被耗尽没怎么用却超限了) 排查) - [进阶配置参考](#-进阶配置参考) - [Lark(国际版)接入指南](#-lark国际版接入指南) - [更新日志](#-更新日志) - [致社区](#致社区) - [链接](#-链接) --- > ### 🚀 [OpenCrew](https://github.com/AlexAnys/opencrew) — 把你的 OpenClaw 变成一支 AI 团队 > > 多个 Agent 各管各的领域,Slack 频道=岗位,经验自动沉淀。 > > 3 个 Agent 起步 · 10 分钟部署 · 不用写代码 > > **[查看 GitHub →](https://github.com/AlexAnys/opencrew)** --- ## 🆕 飞书官方插件 飞书团队推出的 OpenClaw 官方插件,最大的不同是:**以你的身份操作飞书**(通过 OAuth 授权)。 这意味着 AI 不只是"聊天机器人",而是能直接帮你写文档、建多维表格、约日程、管理任务——就像一个能操作飞书的数字分身。 **👉 [查看飞书官方插件安装指南](docs/feishu-official-plugin.md)** > ⚠️ **OpenClaw 3.x 用户**:官方安装工具 `feishu-plugin-onboard` 有版本检查 bug([#59](https://github.com/AlexAnys/openclaw-feishu/issues/59)),会误报版本过低。安装指南中已提供替代方式,直接 `openclaw plugins install @larksuiteoapi/feishu-openclaw-plugin` 即可绕过。 > 📖 飞书团队的完整图文教程:[OpenClaw 飞书官方插件上线 | 一文讲清功能、安装更新教程与常见问题](https://www.feishu.cn/content/article/7613711414611463386) --- ## 📊 飞书官方 vs OpenClaw 内置:怎么选? 两个插件**不能同时使用**(安装官方插件时会自动禁用内置插件)。 | 维度 | 飞书官方插件 | OpenClaw 内置插件 | |---|---|---| | **操作身份** | 以**你本人**身份(OAuth) | 以**机器人**身份 | | **消息** | 读取、发送、回复、搜索 | 读取、发送、回复 | | **文档** | 创建 + 编辑 + 读取 | 读取为主 | | **多维表格** | 完整操作(表、字段、记录、视图) | 基础读写 | | **日历日程** | ✅ 创建/查询/修改/搜索/忙闲查询 | ❌ | | **任务管理** | ✅ 创建/查询/更新/完成/子任务 | ❌ | | **知识库** | ✅ 完整读写 | ✅ 只读 | | **云盘** | ✅ 上传/下载 | ✅ 基础操作 | | **流式输出** | ✅ | ✅ | | **安装复杂度** | 需要额外安装 CLI 工具 + OAuth 授权 | OpenClaw 内置,`openclaw channels add` 即可 | | **维护方** | 飞书团队 | OpenClaw 社区 | | **问题反馈** | 飞书反馈群 | 本项目 Issues / Discord | ### 选择建议 **选飞书官方插件,如果你:** - 想让 AI 帮你操作飞书(写文档、建表、约会议) - 需要日历、任务管理等高级功能 - 想要以自己身份发消息(不是机器人名义) **选 OpenClaw 内置插件,如果你:** - 主要用飞书做聊天入口,让 AI 回答问题、执行本地任务 - 不需要 AI 操作飞书文档/日历/任务 - 偏好更简单的安装流程(内置即用) > ⚠️ **两种插件互斥,只能启用一个。** 安装飞书官方插件时会自动禁用内置插件,反之亦然。如果两个都装了,会出现 `duplicate plugin id` 报错导致飞书功能不可用。遇到这种情况: > ```bash > # 删除用户目录下的重复插件 > rm -rf ~/.openclaw/extensions/feishu > openclaw gateway restart > ``` > 如果想从内置切换到官方插件,见 [从 OpenClaw 内置插件迁移到飞书官方插件](#从-openclaw-内置插件迁移到飞书官方插件)。 --- ## 🚀 OpenClaw 内置插件教程(从零配置) > 适用于:第一次使用 OpenClaw + 飞书的新用户,选择 OpenClaw 内置插件方案。 > 前提:已安装 OpenClaw 并正常运行(`openclaw gateway status` 能看到状态)。 > 预计耗时:15–20 分钟。 ### 第一步:创建飞书应用(机器人) 1. 打开 [飞书开放平台](https://open.feishu.cn/app),用飞书账号登录 2. 点击 **创建企业自建应用** 3. 填写应用名称(随意,比如 "我的 AI 助手")和描述 4. 选一个图标(可以之后改) ### 第二步:启用机器人能力 进入你刚创建的应用: 1. 左侧菜单找到 **应用能力** > **机器人** 2. **开启**机器人能力 3. 给机器人起个名字 ### 第三步:配置权限 1. 左侧菜单进入 **权限管理** 2. 点击 **批量导入** 3. 粘贴以下 JSON(一键导入所有需要的权限): ```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:write", "contact:user.employee_id:readonly", "corehr:file:download", "docs:document.content:read", "event:ip_list", "im:chat", "im:chat.access_event.bot_p2p_chat:read", "im:chat.members:bot_access", "im:message", "im:message.group_at_msg:readonly", "im:message.group_msg", "im:message.p2p_msg:readonly", "im:message:readonly", "im:message:send_as_bot", "im:resource", "sheets:spreadsheet", "wiki:wiki:readonly" ], "user": [ "aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read" ] } } ``` ### 第四步:配置事件订阅 > ⚠️ 这一步**必须在 OpenClaw 网关启动后**再做,否则保存会失败。 > 先做第五、六步,回来再做这一步也可以。 1. 左侧菜单进入 **事件与回调** > **事件配置** 2. 请求方式选择:**使用长连接接收事件**(这是关键!不需要公网服务器) 3. 添加事件:搜索 `im.message.receive_v1`(接收消息),勾选添加 ### 第五步:记下凭证 在应用的 **凭证与基础信息** 页面,复制: - **App ID**(格式如 `cli_xxxxxxxxx`) - **App Secret** > ❗ App Secret 很重要,请妥善保管,不要分享。 ### 第六步:发布应用 1. 左侧菜单 **版本管理与发布** 2. **创建版本** → 填写版本说明 → 提交 3. 等待审批(企业内部应用通常自动通过,几秒到几分钟) ### 第七步:在 OpenClaw 中配置飞书 > OpenClaw ≥ 2026.2 已内置飞书插件,**不需要额外安装**,直接配置即可。 > > 💡 如果你在首次 `openclaw setup` 时看到 "Install Feishu plugin?",选择 **"Download from npm"** 即可进入配置流程。选了 "Skip" 也没关系,用下面的命令随时添加。 打开 **终端(Terminal)**: ```bash # 1. 添加飞书渠道(交互式,跟着提示走) openclaw channels add # 选择 Feishu → 粘贴 App ID → 粘贴 App Secret # 2. 重启网关 openclaw gateway restart # 3. 查看日志,确认连接成功 openclaw logs --follow ``` ### 第八步:发消息测试 1. 在飞书里搜索你的机器人名字,打开对话 2. 发一条消息,比如"你好" 3. 如果机器人回复了**配对码**,在终端运行: ```bash openclaw pairing approve feishu <配对码> ``` 4. 授权后再发一条消息,收到正常回复 = 配置完成 🎉 > **回来补第四步**:如果你先跳过了事件订阅,现在网关已启动,回到飞书开放平台把第四步做完,保存后重启网关(`openclaw gateway restart`)。 ### 第九步(可选):让机器人开机自启 ```bash openclaw gateway install ``` 这样电脑重启后机器人也会自动上线。 --- ## 🔄 从旧版迁移 > 适用于:之前使用本项目(独立桥接或 npm 插件)的老用户。 > 两种方式任选其一,效果一样。 ### 迁移前须知 - ✅ 你之前创建的飞书应用(机器人)**可以继续用**,不需要重新创建 - ✅ App ID 和 App Secret 不变 - ✅ 迁移后聊天记录不受影响(记录在飞书端) - ⚠️ 迁移过程中机器人会短暂离线(几分钟) --- ### 方式一:通过 OpenClaw 升级(推荐,最省事) 如果你的 OpenClaw 版本 ≥ 2026.2,升级后官方飞书插件已经内置,只需要: #### 1. 升级 OpenClaw ```bash openclaw update ``` 升级完成后会自动重启网关。 #### 2. 添加飞书渠道 ```bash openclaw channels add ``` 选择 **Feishu** → 粘贴你的 **App ID** → 粘贴你的 **App Secret**。 > App ID 和 App Secret 在哪?之前可能保存在 `~/.clawdbot/secrets/feishu_app_secret`,可以 `cat` 查看。 > 如果找不到,去 [飞书开放平台](https://open.feishu.cn/app) → 你的应用 → **凭证与基础信息** 重新复制。 #### 3. 补全飞书应用权限 官方插件支持图片、文件、流式输出等更多功能,需要在飞书开放平台补几个权限: 1. 打开 [飞书开放平台](https://open.feishu.cn/app) → 进入你的应用 2. 进入 **权限管理** → 点击 **批量导入** 3. 粘贴以下内容一键导入: ```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:write", "contact:user.employee_id:readonly", "corehr:file:download", "docs:document.content:read", "event:ip_list", "im:chat", "im:chat.access_event.bot_p2p_chat:read", "im:chat.members:bot_access", "im:message", "im:message.group_at_msg:readonly", "im:message.group_msg", "im:message.p2p_msg:readonly", "im:message:readonly", "im:message:send_as_bot", "im:resource", "sheets:spreadsheet", "wiki:wiki:readonly" ], "user": [ "aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read" ] } } ``` > 已有的权限会自动跳过,不会重复添加。 4. 导入后 → **创建新版本** → **发布**(让新权限生效) #### 4. 清理旧插件/桥接 ```bash # 移除旧的 npm 插件(如果装过) openclaw plugins remove feishu-openclaw 2>/dev/null # 停掉旧的桥接服务(如果用过独立桥接) launchctl unload ~/Library/LaunchAgents/com.clawdbot.feishu-bridge.plist 2>/dev/null # 重启网关 openclaw gateway restart ``` 然后跳到下方 [验证](#验证) 确认一切正常。 --- ### 方式二:不升级 OpenClaw,只加飞书 适用于不想整体升级 OpenClaw、只想加飞书的情况。 > **注意**:OpenClaw ≥ 2026.2 已内置飞书插件,**不需要** `openclaw plugins install`。直接配置即可。 #### 1. 准备好你的飞书凭证 - **App ID**:格式如 `cli_xxxxxxxxx` - **App Secret** > 之前可能保存在 `~/.clawdbot/secrets/feishu_app_secret`,可以 `cat` 查看。 > 如果找不到,去 [飞书开放平台](https://open.feishu.cn/app) → 你的应用 → **凭证与基础信息** 重新复制。 #### 2. 补全飞书应用权限 (同方式一的第 3 步,权限 JSON 一样,这里不重复粘贴——往上翻到方式一的权限 JSON 复制即可。) 1. [飞书开放平台](https://open.feishu.cn/app) → 你的应用 → **权限管理** → **批量导入** → 粘贴上方 JSON 2. 导入后 → **创建新版本** → **发布** #### 3. 配置飞书渠道 ```bash # 添加飞书渠道(交互式引导) openclaw channels add # → 选择 Feishu # → 粘贴 App ID # → 粘贴 App Secret # 移除旧的 npm 插件(如果装过) openclaw plugins remove feishu-openclaw 2>/dev/null # 停掉旧的桥接服务(如果用过独立桥接) launchctl unload ~/Library/LaunchAgents/com.clawdbot.feishu-bridge.plist 2>/dev/null # 重启网关 openclaw gateway restart ``` --- ### 验证 ```bash # 查看日志,确认飞书连接成功 openclaw logs --follow ``` 日志中看到类似 `feishu ws connected` 或 `feishu provider ready` 就说明连上了。 在飞书里给机器人发一条消息,正常收到回复 = 迁移完成 🎉 > **配对授权**:如果机器人回复了一个配对码,在终端运行: > ```bash > openclaw pairing approve feishu <配对码> > ``` > 授权后就能正常对话了。这是一次性操作。 ### 迁移后清理(可选) 稳定运行几天后,可以清理旧文件: ```bash # 删除旧的 launchd 配置(桥接用户) rm -f ~/Library/LaunchAgents/com.clawdbot.feishu-bridge.plist # 旧的桥接项目文件夹可以归档或删除 # (建议先保留一段时间,确认没问题再删) ``` ### 从 OpenClaw 内置插件迁移到飞书官方插件 如果你正在使用 OpenClaw 内置插件,想切换到飞书官方插件: 1. 按照 [飞书官方插件安装指南](docs/feishu-official-plugin.md) 执行安装 2. 安装过程中会**自动禁用** OpenClaw 内置飞书插件 3. 完成 OAuth 授权后即可使用 > 如果想切回内置插件:卸载官方插件后重启网关,内置插件会自动恢复。 --- ## 🔧 常见问题 & 排查清单 > 遇到问题先看这里。如果没找到答案,欢迎开 [Issue](https://github.com/AlexAnys/openclaw-feishu/issues)。 ### 没有消息发送框?(最常见) 这是因为**事件订阅没有配置**。JSON 批量导入权限不会自动配置事件订阅,需要手动添加: 1. 飞书开放平台 → 你的应用 → **事件与回调** 2. 添加事件:`im.message.receive_v1`(接收消息 v2.0) 3. 订阅方式:选择 **「使用长连接接收事件」** 4. **版本管理** → 创建新版本 → 发布上线 > ⚠️ 配置事件订阅前,确保 OpenClaw Gateway 已启动,否则长连接验证会失败。 ### 机器人完全没反应(收不到消息) 按顺序检查: 1. **网关在运行吗?** ```bash openclaw gateway status ``` 如果没运行:`openclaw gateway restart` 2. **飞书应用发布了吗?** 去飞书开放平台 → 你的应用 → 版本管理,确认有已发布的版本 3. **事件订阅配置了吗?** - 是否选了 **"使用长连接接收事件"**(不是 Webhook) - 是否添加了事件 `im.message.receive_v1` 4. **权限够吗?** 至少需要:`im:message`、`im:message.p2p_msg:readonly`、`im:message:send_as_bot` 5. **看日志**: ```bash openclaw logs --follow ``` 发一条消息,看日志有没有反应 ### 时断时续(有时能回复,有时没反应) 常见原因: - **网络波动**:飞书 WebSocket 断开后通常会自动重连,但如果你的网络不稳定(尤其是 VPN/代理环境),可能频繁断连 - **网关重启**:检查是否有什么在反复触发网关重启 ```bash openclaw logs | grep -i "restart\|reconnect\|disconnect" ``` - **DNS 问题**:如果你在国内使用代理,确保 `open.feishu.cn` 走直连(不走代理) ### 开了代理(Clash / V2Ray)后连不上? 日志报 `400 The plain HTTP request was sent to HTTPS port`,token 和 WebSocket 都失败。 **原因**:Axios 自动读取 `HTTP_PROXY` / `HTTPS_PROXY` 环境变量,将飞书请求以明文 HTTP 发到 443 端口,被服务端拒绝。 **解决**:通过 `NO_PROXY` 环境变量排除飞书域名,或在代理规则中将 `feishu.cn` 设为直连。 ### 发图片 / 发文件,AI 看不到 1. **检查权限**:必须有 `im:resource` 权限 2. 在飞书开放平台补权限后,记得 **创建新版本 → 发布** 3. 重启网关:`openclaw gateway restart` ### AI 说生成了图片,但飞书没收到 1. 确认有 `im:resource` 权限(用于上传图片到飞书) 2. 检查日志中有没有 upload 相关的错误 ### 群聊中机器人不回复 1. 默认需要 **@机器人** 才会回复 2. 确认机器人已被添加到群聊 3. 检查 `groupPolicy` 配置(见[进阶配置](#群组配置)) ### 回复特别慢 - 这通常是 AI 模型的响应速度决定的,和飞书插件关系不大 - 可以开启**流式输出**(默认已开启),让回复逐步显示而不是等全部生成后一次发送 - 如果超过 30 秒无回复,检查日志看是不是模型调用出错 ### "Unknown model" 错误 - 通常发生在模型配置变更后,重启网关即可: ```bash openclaw gateway restart ``` ### 配对码是什么?怎么用? 首次和机器人对话时,出于安全考虑,机器人会回复一个配对码(一串字母数字)。你需要在终端"批准"这个配对: ```bash openclaw pairing approve feishu <配对码> ``` 批准后这个飞书用户就可以正常和机器人对话了。这是一次性操作。 ### 首次 setup 提示 "Install Feishu plugin?" 这是正常的。OpenClaw 已内置飞书插件,但向导默认需要你确认启用。选择 **"Download from npm"** 即可,之后会直接进入 App ID / App Secret 的配置步骤。 如果选了 "Skip for now",可以随时通过 `openclaw channels add` 手动添加飞书渠道。 ### 提示 "duplicate plugin id detected" 这说明飞书插件同时存在于两个位置:OpenClaw 内置目录(stock extension)和用户目录(`~/.openclaw/extensions/feishu/`)。 **原因**:OpenClaw ≥ 2026.2 已内置飞书插件,如果又手动执行了 `openclaw plugins install @openclaw/feishu`,就会产生重复。 **解决**:删除用户目录下的副本,保留内置版本即可: ```bash rm -rf ~/.openclaw/extensions/feishu openclaw gateway restart ``` ### API 配额被耗尽(没怎么用却超限了) **现象**:飞书开放平台显示 API 月度调用量(免费 50,000 次)耗尽,但你几乎没有主动使用飞书机器人。 **原因**:OpenClaw Gateway 每 60 秒对所有启用的 channel 执行一次健康探测。飞书插件的探测会调用 `bot/v3/info` API,每次计入月度配额。单台机器每月消耗约 27,000 次;**两台机器共用同一个飞书 App 就会超限**。 **影响范围**:仅消耗 API 配额,不影响消息收发。消息通过 WebSocket 长连接接收,与 health check 无关。 **修复**(发给你的 AI 助手即可): ``` 我的飞书 API 月度配额被意外耗尽了。这是 OpenClaw health check 导致的已知问题(每 60 秒调用一次 bot/v3/info API)。请帮我排查和修复: 1. 运行 `openclaw channels status` 查看飞书是否启用 2. 如果我不需要飞书对话功能,禁用它:`openclaw config set channels.feishu.enabled false && openclaw gateway restart` 3. 如果有多台机器运行 OpenClaw,在不需要飞书的机器上禁用 4. 如果需要保留飞书,确认只有一台机器启用(单台不会超限) ``` > 📖 详细背景和诊断步骤见 [docs/api-quota-fix.md](docs/api-quota-fix.md) ### Lark(国际版)用户 Lark 后台不开放 WebSocket 长连接,需要用 **Webhook 模式**。详见 [Lark 接入指南](#-lark国际版接入指南)。 --- ## 📚 进阶配置参考 ### 配置文件位置 ``` ~/.openclaw/openclaw.json ``` ### 基础配置示例 ```json5 { channels: { feishu: { enabled: true, dmPolicy: "pairing", accounts: { main: { appId: "cli_xxxxxxxxx", appSecret: "你的AppSecret", botName: "我的AI助手", }, }, }, }, } ``` ### 群组配置 **默认行为**:所有群组允许,但必须 @机器人。 **特定群组无需 @(直接回复所有消息)**: ```json5 { channels: { feishu: { groups: { oc_你的群组ID: { requireMention: false }, }, }, }, } ``` **只允许特定用户在群组中使用**: ```json5 { channels: { feishu: { groupPolicy: "allowlist", groupAllowFrom: ["ou_用户1", "ou_用户2"], }, }, } ``` > 获取群组 ID(`oc_xxx`)/ 用户 ID(`ou_xxx`):给机器人发消息后看日志 `openclaw logs --follow`。 ### 流式输出 默认开启。机器人会边生成边更新消息,而不是等全部写完再发。 ```json5 { channels: { feishu: { streaming: true, // 流式卡片输出(默认 true) blockStreaming: true, // 块级流式(默认 true) }, }, } ``` 如需关闭(等完整回复后一次性发送):设 `streaming: false`。 ### 多 Agent 路由 一个飞书机器人可以对接多个不同的 AI Agent(比如不同的人聊不同的Agent): ```json5 { bindings: [ { agentId: "main", match: { channel: "feishu", peer: { kind: "dm", id: "ou_用户A" } }, }, { agentId: "另一个agent", match: { channel: "feishu", peer: { kind: "group", id: "oc_某群组" } }, }, ], } ``` ### 访问控制策略 | 策略 (`dmPolicy`) | 行为 | |---|---| | `"pairing"` | **默认**。新用户收到配对码,管理员批准后可对话 | | `"allowlist"` | 仅白名单用户可对话 | | `"open"` | 允许所有人对话 | | `"disabled"` | 禁止私聊 | ### 常用命令速查 | 命令 | 说明 | |---|---| | `openclaw gateway status` | 查看网关状态 | | `openclaw gateway restart` | 重启网关 | | `openclaw gateway install` | 安装为开机自启服务 | | `openclaw logs --follow` | 实时查看日志 | | `openclaw pairing list feishu` | 查看待授权配对 | | `openclaw pairing approve feishu <CODE>` | 批准配对 | | `openclaw plugins list` | 查看已安装插件 | --- ## 🌏 Lark(国际版)接入指南 > Lark 后台目前不开放 WebSocket 长连接能力,所以不能像飞书国内版那样"零公网"直连。 > 需要改用 **Webhook 模式**:Lark 主动把消息推送到你提供的一个公网 URL。 ### 与飞书版的区别 | | 飞书(国内版) | Lark(国际版) | |---|---|---| | 连接方式 | WebSocket 长连接 ✅ | **Webhook HTTP 回调** | | 需要公网? | ❌ 不需要 | ✅ 需要(或用隧道) | | 开发者平台 | [open.feishu.cn](https://open.feishu.cn) | [open.larksuite.com](https://open.larksuite.com) | ### 第一步:配置 OpenClaw 在 `~/.openclaw/openclaw.json` 中配置飞书渠道: ```json5 { channels: { feishu: { domain: "lark", connectionMode: "webhook", webhookPort: 3000, webhookPath: "/feishu/events", accounts: { main: { appId: "cli_xxxxxxxxx", appSecret: "你的AppSecret" } } } } } ``` > 也可以把 `domain`、`connectionMode` 等字段放在 account 级别,这样可以一个 account 连飞书、另一个连 Lark。 ### 第二步:启动网关 + 暴露到公网 > ⚠️ **必须先启动网关**,再去 Lark 后台填 URL。因为 Lark 填写 URL 时会立刻发验证请求,网关没启动就会验证失败。 **先启动网关:** ```bash openclaw gateway restart openclaw logs --follow ``` 看到 `Webhook server listening on port 3000` 说明启动成功。按 `Ctrl+C` 退出日志(网关仍在后台运行)。 **再暴露端口到公网。** 推荐 **Cloudflare Tunnel**(免费、稳定): ```bash # 安装 cloudflared(macOS) brew install cloudflared # 一键暴露本地 3000 端口(临时,用于测试) cloudflared tunnel --url http://localhost:3000 ``` 运行后会得到一个公网 URL,类似:`https://xxx-yyy-zzz.trycloudflare.com` **记下这个 URL,下一步要用。** > **与 VPN/代理兼容性**:Cloudflare Tunnel 不创建虚拟网卡、不修改系统路由表,与 Clash Verge、V2Ray 等代理工具**完全兼容**,可以同时使用。 如需固定域名(推荐正式使用时配置): ```bash cloudflared tunnel login cloudflared tunnel create feishu-bot cloudflared tunnel route dns feishu-bot feishu.yourdomain.com cloudflared tunnel run --url http://localhost:3000 feishu-bot ``` 其他隧道方案也可以: - **ngrok**:`ngrok http 3000`(免费版 URL 会变) - **Tailscale Funnel**:如果你已在用 Tailscale,配置最简单 ### 第三步:配置 Lark 后台 1. 打开 [Lark Developer Console](https://open.larksuite.com/app) 2. 创建应用、添加机器人能力(操作步骤同飞书版) 3. 进入 **Event Subscriptions**: - **Request URL** 填入上一步拿到的公网 URL + webhook 路径,例如: `https://xxx-yyy-zzz.trycloudflare.com/feishu/events` - 点保存后 Lark 会立刻发验证请求,OpenClaw 自动通过(前提是网关和隧道都在运行) - 如果验证失败:检查网关是否启动、隧道是否运行、URL 是否拼对 4. 添加事件:`Receive messages - im.message.receive_v1` 5. 权限配置同飞书版 ### 第四步:发消息测试 在 Lark 里搜索你的机器人,发一条消息。查看日志确认收到: ```bash openclaw logs --follow ``` 收到正常回复 = 配置完成。 ### 注意事项 - Webhook 模式下,OpenClaw 网关必须持续运行且公网可访问 - 如果使用临时隧道(`cloudflared tunnel --url`),每次重启 URL 会变,需要去 Lark 后台更新 Request URL - 建议正式使用时配置固定域名的 Cloudflare Tunnel - 飞书国内版也可以使用 webhook 模式(设 `connectionMode: "webhook"`),但没必要——WebSocket 模式更简单 - 如果你在 Lark 后台开启了事件加密,需要在配置中额外添加 `encryptKey` 和 `verificationToken`(从 Lark 后台的 Encrypt Key / Verification Token 处复制) --- ## 常见问题(快问快答) **Q: 需要服务器吗?** 不需要。飞书用 WebSocket 长连接,你的电脑(Mac / Windows / Linux)直接连飞书云端,不需要公网 IP。 **Q: 电脑关机了怎么办?** 机器人会离线。开机后自动重连(如果配了开机自启)。要 24/7 在线可以用一台常开的机器(Mac Mini、NAS、云服务器等)。 **Q: 飞书免费版能用吗?** 可以。自建应用和机器人功能对所有飞书版本开放。 **Q: 能同时接 Telegram / 微信等其他渠道吗?** 可以。OpenClaw 原生支持多渠道,飞书只是其中之一,互不影响。 **Q: 飞书官方插件和 OpenClaw 内置插件能同时用吗?** 不能。安装飞书官方插件时会自动禁用 OpenClaw 内置插件。两者只能二选一。 --- ## 📝 更新日志 ### 2026.03.30 — Lark CLI 上手指南 - 🆕 飞书官方开源 [Lark CLI](https://github.com/larksuite/cli)(MIT),一行命令调飞书 2500+ API - 📖 新增 [Lark CLI 保姆级上手指南](docs/lark-cli-guide.md)——安装、配置、OAuth 授权、Agent 调用示例 - 🔧 与插件/桥接互补:插件管对话,CLI 管操作 ### 2026.03.07 — 飞书官方插件上线 - 🆕 新增飞书官方插件介绍及对比 - 📖 新增 [飞书官方插件安装指南](docs/feishu-official-plugin.md) - 🔄 更新项目定位:从"三方桥接→内置插件迁移"到"帮用户选对方案" - 🗑️ 移除早期独立桥接模式文档(已停止维护) ### 2026.03.02 — API 配额排查 - 🔧 新增 API 配额耗尽问题的根因分析和修复指南 ### 2026.02.24 — Lark 支持 + Webhook 模式 (v0.4.0) - 🌏 新增 Lark(国际版)支持:`domain: "lark"` 配置 - 🔗 新增 Webhook 连接模式:解决 Lark 无法使用 WebSocket 的问题 - 📖 新增 Lark 接入指南:含 Cloudflare Tunnel 内网穿透教程 - 🛡️ Lark 用户误配 WebSocket 时自动 fallback 到 Webhook 并提示 - 🔧 端口冲突、graceful shutdown 等稳定性改进 ### 2026.02 — 定位转型 本项目从独立桥接/插件转型为 **飞书 × OpenClaw 配置指南 & 社区支持中心**。 OpenClaw 已内置官方飞书插件(`@openclaw/feishu`),本项目继续为社区提供:保姆级教程、迁移指南、常见问题答疑。 ### 2026.02.02 — 媒体功能大更新(桥接模式) - ✅ 飞书传图 → AI 能看图 - ✅ 飞书传视频/文件 → 桥接可接收下载 - ✅ AI 生图 → 自动回传飞书 - ✅ 列表格式修复 - ✅ 本地文件发送白名单安全控制 ### 2025.2.1 同步更新飞书插件,适配 OpenClaw。 --- ## 致社区 感谢大家一直以来的支持与信任 🙏 本项目最初是为了让飞书用户能更方便地接入 AI 助手——从独立桥接、到 npm 插件,再到一路踩坑填坑,这些都是大家的反馈推着走过来的。 现在,不仅 OpenClaw 内置了飞书插件(`@openclaw/feishu`),飞书团队也推出了官方的 OpenClaw 插件(`feishu-openclaw-plugin`),还开源了 Lark CLI 让所有 Agent 框架都能操作飞书。**这是件好事**——说明飞书 + AI 这条路走通了,社区的需求被看到了。 **本项目会继续为大家服务:** - 🎯 为非技术背景的伙伴提供**最友好的入门引导** - 📊 帮你理清不同方案的区别,选对适合自己的路径 - 🔧 **常见问题答疑** & 排查清单——官方文档没覆盖到的坑,这里帮你踩 - 🔄 为老用户提供**迁移指南** 遇到问题随时开 Issue,我们一起解决。 --- ## 🔗 链接 - 📖 [飞书官方插件教程](https://www.feishu.cn/content/article/7613711414611463386) - 📖 [OpenClaw 官方文档](https://docs.openclaw.ai) - 💬 [OpenClaw 社区 Discord](https://discord.com/invite/clawd) - 🐛 [本项目 Issues(提问 & 反馈)](https://github.com/AlexAnys/openclaw-feishu/issues) - 🔌 [GitHub: openclaw-feishu](https://github.com/AlexAnys/openclaw-feishu)(本项目) --- ## 📈 Star History <a href="https://star-history.com/#AlexAnys/openclaw-feishu&Date"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=AlexAnys/openclaw-feishu&type=Date&theme=dark" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=AlexAnys/openclaw-feishu&type=Date" /> <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=AlexAnys/openclaw-feishu&type=Date" /> </picture> </a> ## License MIT

AI Agents Community & Forums
690 Github Stars
opencrew
Open Source

opencrew

**中文** | [English](README.en.md) # OpenCrew - 高效协同、稳定迭代的Openclaw团队 > 适合所有人易上手的多智能体操作系统。 > 把你的 OpenClaw 变成一支可管理的 AI 团队——领域专家各司其职,经验自动沉淀。 > 支持 **Slack** · **飞书** · **Discord** — 选择你熟悉的平台作为指挥中心。 > > 🤖 **To-Agent 友好**:文档结构经真实部署实测优化,你的 OpenClaw 可直接阅读并自动完成部署——最少人工介入。 [![GitHub](https://img.shields.io/badge/主仓库-GitHub-black?style=flat-square&logo=github)](https://github.com/AlexAnys/opencrew) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE) [![Built on OpenClaw](https://img.shields.io/badge/Built_on-OpenClaw-purple)](https://github.com/openclaw/openclaw) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](#参与贡献) --- ## 📢 重要更新(2026 年 4 月) ### A2A v2:找到了 Agent 间协作的最佳方式 我们解决了 OpenCrew 自诞生以来最大的架构限制:**Agent 之间现在可以真正协作**——不只是单向派任务,而是像同事一样讨论、评审、迭代。 **之前**:所有 Agent 共享一个 Slack bot → bot 不能触发自己 → Agent 之间只能靠 `sessions_send` 单向委派任务,无法讨论。 **现在**:给至少一个关键 Agent 创建独立 Slack App → 拉进任意执行 Agent 的频道 → 频道内高维度对话(方向、评审、共识)+ 基于 Markdown 文件的实际协作 + 用户 review 最终产出。 <table> <tr> <td width="50%"><img src="docs/OpenCrew-A2A-V2.svg" alt="A2A v2 架构"><br><sub><b>架构</b>:编排者(独立 App)进入执行 Agent 频道协作</sub></td> <td width="50%"><img src="assets/screenshots/a2a-v2-discussion-demo.png" alt="A2A v2 实战"><br><sub><b>实战</b>:两个 Agent 在 #ops 协作排查问题(全程无人干预)</sub></td> </tr> </table> **哪些 Agent 适合独立化?** 至少选一个,也可以按需增加多个。参考 [Anthropic Harness Design](https://www.anthropic.com/engineering/harness-design-long-running-apps),有价值的独立协作角色包括: | 角色 | 职责 | 为什么需要独立 | |------|------|-------------| | **CoS(幕僚长)** | 代表用户意图,推进任务 | 需要进入不同 Agent 的频道,确保执行方向与用户目标一致 | | **Planner / Coordinator** | 展开需求为验收标准,控制节奏 | 需要与多个执行 Agent 交互,规划不能由执行者自己做 | | **QA / Evaluator** | 独立审查产出质量 | 同一个 AI 既执行又自检时倾向于宽容自己,质检必须分离 | > 最小方案:选 **一个** Agent 做独立 App(兼顾以上角色),即可开始协作。 **设置只需三步**:创建一个独立 Slack App → 配置多账号 → 把 bot 拉进目标频道。详见 → [Discussion Mode 配置指南](docs/A2A_SETUP_GUIDE.md) > **模型兼容性**:协作纪律(@mention 检查、轮次计数、NO_REPLY)依赖 Prompt 规则,非系统强制。Claude Opus 4.6 实测稳定,其他模型建议先在低风险频道测试。详见 → [已知限制](shared/A2A_PROTOCOL.md#7-已知限制) > 更多技术细节 → [A2A 协议 v2](shared/A2A_PROTOCOL.md) · [核心概念](docs/CONCEPTS.md#4-a2a--agent-之间的原生协作) ### 下一步预告:Agent 蓝图 — 按需 Onboarding 新 Agent 目前作者已通过 OpenCrew 框架 onboarding 了约 10 个新 Agent 处理不同任务。正在开发 **Agent 蓝图仓库**——未来你只需要描述需求 + 在 Slack 里加一个频道,就能自动将新 Agent onboarding 到你的团队中,无需手动配置 workspace 文件。 --- ## 目录 - [这个项目解决什么问题](#这个项目解决什么问题) - [架构一览](#架构一览) - [10 分钟上手](#10-分钟上手) - [核心概念速览](#核心概念速览) - [跑通 A2A 闭环](#跑通-a2a-闭环) - [文档导航](#文档导航) - [已稳定 vs 探索中](#已稳定-vs-探索中) - [常见问题](#常见问题) - [参与贡献](#参与贡献) - [开发历程](#开发历程) --- ## 这个项目解决什么问题 如果你在用 OpenClaw,你大概率已经遇到了这些问题: | 你的痛点 | 根本原因 | OpenCrew 怎么解 | |---------|---------|----------------| | 聊着聊着 Agent 变"迟钝"了 | 一个 Agent 承担所有领域,上下文膨胀 | 多个 Agent 各管各的领域,互不污染 | | 多项目并行,来回切 session | 没有可视化的任务总览 | 频道/群组=岗位,thread=任务,一目了然 | | 每一步都要你确认,累 | Agent 不知道哪些该自主做 | 深度意图对齐 + 自主等级机制 | | 踩过的坑下次还踩 | 经验散落在聊天记录里 | 三层知识沉淀:对话→结构化总结→可复用知识 | | Agent 越用越"跑偏" | 自我调整没人审计 | 专职维护 Agent 负责审计和防漂移 | **一句话总结**:问题不是 OpenClaw 不够强,而是一个 Agent 不够用。你需要的是一支团队。 --- ## 架构一览 > 核心理解:**频道 = 岗位,Thread = 任务,#hq = Slack hq(headquarters)频道 ** ![OpenCrew Architecture](docs/OpenCrew-Architecture-with-slack.png) OpenCrew 分为三层,每层职责清晰: | 层级 | 角色 | 职责 | |------|------|------| | **意图对齐** | 你 + CoS(幕僚长) | 定方向、验收结果。CoS 帮你对齐深层目标,你不在时代为推进。**CoS 不是网关,你想跟谁聊直接进哪个频道。** | | **执行** | CTO / Builder / CIO / Research | CTO 拆解架构,Builder 实现,CIO 是可替换的领域专家(投资/法律/营销),Research 按需调研。 | | **系统维护** | KO + Ops | KO 从产出中提炼可复用知识;Ops 审计变更、防止漂移。不做业务,只维护系统健康。 | > 最小可用:CoS + CTO + Builder(3 个 Agent 就能跑起来)。KO/Ops/CIO/Research 按需添加。 ### 实际运行效果 <table> <tr> <td width="33%"><img src="assets/screenshots/mac-1.jpg" alt="多频道协作总览"><br><sub><b>多频道协作总览</b>:频道=岗位,帖子=session</sub></td> <td width="33%"><img src="assets/screenshots/mac-4-search.jpg" alt="Slack 搜索"><br><sub><b>Slack 搜索</b>:跨对话或指定频道快速搜索</sub></td> <td width="33%"><img src="assets/screenshots/mobile-1.jpg" alt="未读列表(移动端)"><br><sub><b>未读列表</b>:高效处理未读信息(A2A 指派)</sub></td> </tr> </table> > 更多截图 → [截图展示](docs/SCREENSHOTS.md) --- ## 10 分钟上手 > 前提:你已经能正常使用 OpenClaw(`openclaw status` 能跑通),且已接入你选择的平台。 ### 选择你的平台 | 平台 | 接入指南 | Thread(任务隔离) | Agent 独立身份 | 适合谁 | |------|---------|-------------------|---------------|--------| | **Slack** | [Slack 接入指南](docs/SLACK_SETUP.md) | ✅ 完整支持 | — 单 Bot 共享身份 | 最灵活便捷部署体验 | | **飞书** | [飞书接入指南](docs/FEISHU_SETUP.md) | ⚠️ 暂不支持([详情](docs/FEISHU_SETUP.md#与-slack-的关键差异thread话题)) | ✅ 可为每个 Agent 配独立 Bot([进阶](docs/FEISHU_SETUP.md)) | 国内团队 / 飞书用户 | | **Discord** | [Discord 接入指南](docs/DISCORD_SETUP.md) | ✅ 完整支持 | ✅ 独立 Bot 或 Webhook Relay([进阶](docs/DISCORD_SETUP.md)) | 开发者社区 / Discord 用户 | > **默认:单 Bot 模式** — 一个 bot/应用加入多个频道/群组,通过频道路由到不同 Agent。三个平台通用,配置最简单。 > **进阶:独立身份** — 飞书和 Discord 支持为每个 Agent 创建独立 Bot(独立名称、头像、API 配额)。Discord 还支持 Webhook Relay(单 Bot 接收 + 不同身份回复)。详见各平台指南的"进阶"章节。 > > 完成平台接入后,回到下面的 Step 1 继续。以下以 Slack 为例展示完整流程,飞书和 Discord 的操作步骤对等。 ### Step 1:创建频道/群组 + 邀请 bot 在你的 Slack 工作区创建频道,然后在每个频道里 `/invite @你的bot名`: | 频道 | Agent | 说明 | |------|-------|------| | `#hq` | CoS 幕僚长 | 你的主要对话窗口 | | `#cto` | CTO 技术合伙人 | 技术方向和任务拆解 | | `#build` | Builder 执行者 | 具体实现和交付 | > 按需扩展:`#invest`(CIO)`#know`(KO)`#ops`(Ops)`#research`(Research) ### Step 2:让你的 OpenClaw 完成部署 把下面这段话发给你现有的 OpenClaw(替换 `<>` 里的内容): ``` 帮我部署 OpenCrew 多 Agent 团队。 仓库:请 clone https://github.com/AlexAnys/opencrew.git 到 /tmp/opencrew (如果已下载,仓库路径:<你的本地路径>) Slack tokens(请写入配置,不要回显): - Bot Token: <你的 xoxb- token> - App Token: <你的 xapp- token> 我已创建以下频道并邀请了 bot: - #hq → CoS - #cto → CTO - #build → Builder 请读仓库里的 DEPLOY.md,按流程完成部署。 不要改我的 models / auth / gateway 配置,只做 OpenCrew 的增量。 ``` 你的 OpenClaw 会自动完成:备份现有配置 → 复制 Agent 文件 → 获取 Channel ID → 合并配置 → 重启。 <details> <summary>使用飞书?点这里看飞书版部署提示词</summary> ``` 帮我部署 OpenCrew 多 Agent 团队。 仓库:请 clone https://github.com/AlexAnys/opencrew.git 到 /tmp/opencrew (如果已下载,仓库路径:<你的本地路径>) 飞书凭证(请写入配置,不要回显): - App ID: <你的 cli_xxx> - App Secret: <你的 secret> 我已创建以下群组并添加了机器人: - 总部群 → CoS - 技术群 → CTO - 执行群 → Builder 请读仓库里的 DEPLOY.md,按流程完成部署。 不要改我的 models / auth / gateway 配置,只做 OpenCrew 的增量。 ``` </details> <details> <summary>使用 Discord?点这里看 Discord 版部署提示词</summary> ``` 帮我部署 OpenCrew 多 Agent 团队。 仓库:请 clone https://github.com/AlexAnys/opencrew.git 到 /tmp/opencrew (如果已下载,仓库路径:<你的本地路径>) Discord 凭证(请写入配置,不要回显): - Bot Token: <你的 MTxxx... token> 我已创建以下频道并邀请了 bot: - #hq → CoS - #cto → CTO - #build → Builder 请读仓库里的 DEPLOY.md,按流程完成部署。 不要改我的 models / auth / gateway 配置,只做 OpenCrew 的增量。 ``` </details> > 想手动部署?→ [DEPLOY.md](DEPLOY.md) 里有完整的手动命令 ### Step 3:验证 在你的平台里测试: 1. 在 CoS 对应的频道/群组发一句话 → CoS 回复 ✅ 2. 在 CTO 对应的频道/群组发一句话 → CTO 回复 ✅ 3. 让 CTO 派个任务给 Builder → Builder 对应的频道/群组出现回复 ✅ > 详细的分步指南(含常见报错、排查清单)→ [完整上手指南](docs/GETTING_STARTED.md) --- ## 核心概念速览 OpenCrew 的运转靠几个关键机制。下面是 30 秒速览,详细说明见 → [核心概念详解](docs/CONCEPTS.md) **自主等级(Autonomy Ladder)** — Agent 什么时候该自己做,什么时候必须问你 | 等级 | 含义 | 举例 | |------|------|------| | L0 | 只建议,不动手 | — | | L1 | 可逆操作,直接做 | 写草稿、做调研、整理文档 | | L2 | 有影响但可回滚,做完汇报 | 提 PR、改配置、写分析 | | L3 | 不可逆操作,必须你确认 | 发布、交易、删除、对外发送 | **任务分类(QAPS)** — 不同类型的任务,不同的处理规范 | 类型 | 含义 | 需要 Closeout? | |------|------|----------------| | Q | 一次性问题 | 不需要 | | A | 有交付物的小任务 | 需要 | | P | 项目(多步骤、跨天) | 需要 + Checkpoint | | S | 系统变更 | 需要 + Ops 审计 | **A2A 两种模式** — Agent 之间怎么协作 | 模式 | 适用场景 | 机制 | 平台 | |------|---------|------|------| | **Delegation(委派)** | 派具体任务 | `sessions_send` 两步触发 | Slack / Discord / 飞书 | | **Discussion(讨论)** | 多方讨论、评审、协商 | 独立 Bot @mention 对话 | Slack | Delegation 是基础——CTO 给 Builder 派活。Discussion 是增强——编排者走进 CTO 的频道,两个 Agent 直接讨论方案,你在旁边看着。细节见 → [A2A 协议 v2](shared/A2A_PROTOCOL.md) **三层知识沉淀** — 经验怎么从聊天记录变成组织资产 ``` Layer 0: 原始对话(审计用,不直接复用) Layer 1: Closeout(10-15 行结构化总结,压缩比 ~25x) Layer 2: KO 提炼的抽象知识(原则 / 模式 / 踩坑记录) ``` --- ## 让 Agent 之间协作 > 部署完成后,每个 Agent 各自能回复消息 ≠ Agent 之间能协作。 > A2A(Agent-to-Agent)需要额外配置。 ### Discussion Mode(推荐)— 真正的多 Agent 协作 选一个 Agent 做编排者,给它创建独立 Slack App → 拉进执行 Agent 的频道 → 两个 Agent 在频道里直接协作。 **设置只需三步**(人工操作约 5 分钟,剩余由 Agent 完成): 1. **创建独立 Slack App**:[api.slack.com/apps](https://api.slack.com/apps) → From manifest → 用 [A2A_SETUP_GUIDE.md](docs/A2A_SETUP_GUIDE.md) 中的 manifest 2. **让你的 Agent 配置多账号**——把下面这段发给你的任一 Agent: ``` 请帮我配置 Discussion Mode。 参考文档:请读仓库里的 docs/A2A_SETUP_GUIDE.md 新 Bot 信息: - Bot Token: <xoxb-新bot> - App Token: <xapp-新bot> - Account ID(在 openclaw.json 中的标识): <你起的名字,如 coordinator> - 绑定到哪个 Agent: <你选定的 agent id,如 cos> - 目标频道: #cto(让新 bot 可以和 CTO 协作) 请按 A2A_SETUP_GUIDE.md 的步骤配置多账号。 ★ 必须同时声明 accounts.default(用现有 token),否则主 bot 会断连。 不要改我的 models / auth / gateway 其他配置。 ``` 3. **在目标频道邀请 bot**:`/invite @新Bot名` 验证:在 #cto 里 @mention 新 bot → 新 bot 回复 → 在 thread 里 @mention CTO → CTO 也回复 → 两个 Agent 在同一 thread 对话 ✅ > 完整指南(含 manifest、配置模板、踩坑清单、回滚方式)→ [Discussion Mode 配置指南](docs/A2A_SETUP_GUIDE.md) ### Delegation Mode — 单向派任务 不需要 Discussion 的场景,可以用更简单的 Delegation 模式:CTO 在 `#build` 给 Builder 派单 → Builder 分轮执行 → CTO 回到 `#cto` 汇报。全程你只需要看 Slack。 <details> <summary>Delegation 设置(不需要独立 Slack App)</summary> 把下面这段发给你的任一 Agent: ``` 请帮我跑通 A2A Delegation(旧版委派模式)。 参考文档:请读仓库里的 shared/A2A_PROTOCOL.md 附录 C(旧版 Delegation) 当前状态: - OpenCrew 已部署,各 Agent 在自己频道能正常回复 - 我的 Slack 频道:#hq(CoS) #cto(CTO) #build(Builder) 请按附录 C 的说明: 1. 检查并补全 openclaw.json 中的 Delegation 配置(agentToAgent.allow / maxPingPongTurns) 2. 给 CoS、CTO 和 Builder 的 AGENTS.md 追加 Delegation A2A section(最小增量,不要重写) 3. 先验证 CoS→CTO 闭环,再验证 CTO→Builder 闭环 4. 把结果汇报给我 不要改我的 models / auth / gateway 其他配置,只做 A2A 相关的增量。 ``` > ⚠️ 首次设置时 Agent 会补全配置并触发 gateway 重启,所有 Agent 短暂中断后自动恢复。 </details> > 两种模式的完整对比和技术细节 → [A2A 协议 v2](shared/A2A_PROTOCOL.md) --- ## 文档导航 ### 给你(用户)看的 | 文档 | 内容 | 什么时候读 | |------|------|-----------| | **[完整上手指南](docs/GETTING_STARTED.md)** | 从零到跑通的详细步骤 + 常见问题 | 第一次部署 | | **[核心概念详解](docs/CONCEPTS.md)** | 自主等级、QAPS、A2A、知识沉淀的完整说明 | 想深度理解系统 | | **[架构设计](docs/ARCHITECTURE.md)** | 三层架构、设计取舍、为什么这么做 | 想理解设计思路 | | **[A2A 跑通指南](docs/A2A_SETUP_GUIDE.md)** | Delegation + Discussion 配置、多账号设置、验证步骤 | 让 Agent 间能协作 | | **[自定义指南](docs/CUSTOMIZATION.md)** | 增删改 Agent、替换领域专家 | 想调整团队配置 | | **[已知问题](docs/KNOWN_ISSUES.md)** | 系统的真实边界和当前最佳实践 | 遇到奇怪行为时 | | **[开发历程](docs/JOURNEY.md)** | 从一个人的痛点到一支虚拟团队 | 想了解来龙去脉 | | **[常见问题](docs/FAQ.md)** | 高频问答 | 快速查疑 | | **[Slack 接入指南](docs/SLACK_SETUP.md)** | Slack App 创建和配置 | 使用 Slack 时 | | **[飞书接入指南](docs/FEISHU_SETUP.md)** | 飞书自建应用创建和配置 | 使用飞书时 | | **[Discord 接入指南](docs/DISCORD_SETUP.md)** | Discord Bot 创建和配置 | 使用 Discord 时 | ### 给你的 Agent 看的(部署时 Agent 需要理解的) | 文档 | 内容 | 谁读 | |------|------|------| | **[Agent 入职指南](docs/AGENT_ONBOARDING.md)** | Agent 首次启动时应读什么、怎么理解系统 | 新部署的 Agent | | **shared/** 目录下所有文件 | 全局协议和模板(Agent 的"员工手册") | 所有 Agent | | 各 workspace 的 SOUL.md / AGENTS.md | 角色定义和工作流 | 对应 Agent | --- ## 已稳定 vs 探索中 ### ✅ 已稳定运行 - 多 Agent 领域分工 + 频道绑定(Slack / 飞书 / Discord) - A2A Delegation(两步触发:Slack 可见锚点 + `sessions_send`) - A2A Discussion(独立 Bot @mention 协作,Slack 已验证)`NEW` - A2A 闭环(多轮 WAIT 纪律 + 双通道留痕 + 闭环 DoD) - Closeout / Checkpoint 强制结构化产物 - Autonomy Ladder(L0-L3) - Ops Review 治理闭环 - Signal 评分 + KO 知识沉淀 ### 🔄 探索中 - 更好的知识系统(跨 session 语义检索) - 更轻量的架构(v2-lite:7 Agent → 5,9 个 shared 文件 → 3) - Discord Discussion 模式(受 OpenClaw 代码层 bug 阻塞,非平台限制) --- ## 常见问题 **Q:我需要会写代码吗?** 不需要。OpenCrew 由一个经济学/MBA 背景的非技术用户设计和部署。你需要的是能敲几行命令行——或者直接让你现有的 OpenClaw 帮你执行部署命令。 **Q:最少需要几个 Agent?** 3 个:CoS + CTO + Builder。这是最小可用配置。当你发现经验在流失(加 KO)或系统在漂移(加 Ops)时再扩展。 **Q:和 CrewAI / AutoGen 这些框架有什么区别?** 那些是给开发者写代码用的 SDK。OpenCrew 是给决策者管团队用的系统——你通过 Slack 管理 AI 团队,不用写一行代码。它们解决"怎么编排 Agent",OpenCrew 解决"怎么管理一支 AI 团队"。 **Q:支持哪些平台?** 目前支持 **Slack**、**飞书** 和 **Discord**。核心模型"频道/群组=岗位"在三个平台一致。Slack 和 Discord 完整支持 thread 任务隔离;飞书的 thread 支持受限于 OpenClaw 插件,暂不可用([详情](docs/FEISHU_SETUP.md#与-slack-的关键差异thread话题))。选择你团队最常用的即可。 **Q:会不会消耗很多 token?** 会比单 Agent 多,因为每个 Agent 有独立上下文。但 Closeout 机制(25x 压缩比)和领域隔离(每个 Agent 只看自己领域的信息)实际上让单次对话的 token 消耗更少。总量增加,但每个 Agent 的效率更高。 **Q:Slack 免费版够用吗?** 够用。OpenCrew 使用的 Slack API(Socket Mode)在免费版中完全可用。唯一限制是消息历史保留 90 天,但重要信息已经通过 Closeout 和知识库沉淀了。 更多问答 → [FAQ](docs/FAQ.md) --- ## 参与贡献 欢迎提 Issue / PR,尤其欢迎: - 多 Agent 协作架构的改进建议 - 知识系统(检索/索引/记忆)的实践经验 - Slack thread / session 的稳定性优化思路 - 更多平台(Telegram / Lark 等)的适配方案 - 英文文档的改进与扩展([English docs](README.en.md) 已可用) --- ## 开发历程 从最初发现"一个 Agent 承担所有领域时上下文会膨胀",到设计出 7 个 Agent 的协作架构,再到解决 A2A 循环风暴、deliveryContext 漂移等一系列技术挑战——完整的踩坑记录和设计决策见 → [开发历程](docs/JOURNEY.md) **为什么现在开源?** 系统已经在真实使用中跑通并稳定迭代,但仍有未完全解决的边界问题。与其等到"完美",不如先把可用框架公开,让更多使用者一起反馈、共建、进化。 --- ## 目录结构 ``` opencrew/ ├── README.md ← 你在这里 ├── DEPLOY.md ← 部署指南(精简版) ├── LICENSE ← MIT ├── shared/ ← 全局协议和模板(所有 Agent 共享) ├── workspaces/ ← 每个 Agent 的工作空间 ├── docs/ │ ├── GETTING_STARTED.md ← 完整上手指南 │ ├── CONCEPTS.md ← 核心概念详解 │ ├── ARCHITECTURE.md ← 架构设计 │ ├── A2A_SETUP_GUIDE.md ← A2A 跑通指南(给 Agent 读的) │ ├── CUSTOMIZATION.md ← 自定义指南 │ ├── AGENT_ONBOARDING.md ← Agent 入职指南(给 Agent 读的) │ ├── FAQ.md ← 常见问题 │ ├── KNOWN_ISSUES.md ← 已知问题 │ ├── JOURNEY.md ← 开发历程 │ ├── SLACK_SETUP.md ← Slack 接入指南 │ ├── FEISHU_SETUP.md ← 飞书接入指南 │ ├── DISCORD_SETUP.md ← Discord 接入指南 │ └── CONFIG_SNIPPET_2026.2.9.md ← 最小增量配置(Slack) ├── patches/ ← 高级 workaround(不推荐新手) └── v2-lite/ ← 精简版探索方向(实验性) ``` --- ## 相关资源 - [GitHub 主仓库](https://github.com/AlexAnys/opencrew) — 主要开发与讨论在此进行 - [OpenClaw 官方文档](https://docs.openclaw.ai/) - [OpenClaw Slack 集成文档](https://docs.openclaw.ai/zh-CN/channels/slack) - [OpenClaw 飞书集成文档](https://docs.openclaw.ai/channels/feishu) - [OpenClaw Discord 集成文档](https://docs.openclaw.ai/channels/discord) - [OpenClaw Heartbeat 文档](https://docs.openclaw.ai/zh-CN/gateway/heartbeat) --- ## 📈 Star History <a href="https://star-history.com/#AlexAnys/opencrew&Date"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=AlexAnys/opencrew&type=Date&theme=dark" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=AlexAnys/opencrew&type=Date" /> <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=AlexAnys/opencrew&type=Date" /> </picture> </a> ## License MIT

Communication AI Agents Workflow Automation
490 Github Stars