oh-my-claudecode 实战指南安装配置、Team 流水线编排与魔法关键词深度解析【免费下载链接】oh-my-claudecodeTeams-first Multi-agent orchestration for Claude Code项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-claudecodeoh-my-claudecode简称 OMC是一个面向 Claude Code 的多智能体编排系统核心价值在于让开发者无需记忆复杂命令用一句自然语言即可触发从规划、执行到验证的完整 Agent 协作流程。本文基于仓库根目录的官方主文档README.fr.md为同一 README 的法语版本内容与英文版一致逐节展开并结合 Team 技能定义、关键词检测 Hook 等源码实现帮助读者掌握 OMC 的安装配置、Team 分阶段流水线、魔法关键词与 CLI 工具omc wait、通知 Tags、OpenClaw 集成的完整使用方式。一、OMC 是什么零学习曲线的多 Agent 编排OMC 的定位可以概括为一句话“不用去学 Claude Code直接用 OMC。”它通过插件形式为 Claude Code 注入一组编排能力官方文档列出的核心特性包括无需配置——开箱即用的智能默认值Team 优先team-first的编排——Team 是官方规范的多 Agent 编排面旧的 swarm/ultrapilot 入口只是兼容门面自然语言接口——不记忆命令直接描述想要什么自动并行化——复杂任务被拆分并分发到多个专业 Agent持久执行——在任务未被验证完成之前不放弃成本优化——通过模型智能路由官方称可节省 30%~50% 的 token 消耗经验学习——自动抽取可复用的问题求解模式实时可见性——HUD statusline 展示后台编排指标。智能编排能力官方文档进一步说明其编排层包含三类能力32 个专业 AgentREADME 口径覆盖架构、研究、设计、测试、数据科学等领域。仓库中的 agents/ 目录存放了 analyst、architect、code-reviewer、debugger、designer、planner 等角色定义文档src/agents/ 目录则是这些角色的 TypeScript 实现与提示词模板模型智能路由——简单任务用 Haiku复杂推理用 Opus实现成本与质量的平衡自动委派delegation——“合适的 Agent 做合适的工作”对应 src/features/delegation-enforcer.ts 与 src/features/delegation-routing/ 的实现。二、快速上手三步安装与首次运行步骤 1安装插件/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode /plugin install oh-my-claudecode步骤 2运行初始化配置/oh-my-claudecode:omc-setup一个容易踩坑的场景如果你通过omc --plugin-dir path或claude --plugin-dir path方式运行 OMC需要在omc setup中附加--plugin-dir-mode参数或提前导出OMC_PLUGIN_ROOT环境变量否则 OMC 会重复注入插件本身在运行时已经提供的 skills/agents造成冗余。完整的参数决策矩阵见 docs/REFERENCE.md 中的 “Plugin directory flags” 小节。步骤 3构建点什么autopilot: build a REST API for managing tasks到此为止其余一切自动完成——任务分解、Agent 调度、执行与验证都由 OMC 接管。包名注意项目品牌名是oh-my-claudecode仓库、插件、命令都用这个名字但 npm 上发布的包名是oh-my-claude-sisyphus。这一事实可在 package.json 中直接确认——其name字段为oh-my-claude-sisyphus当前版本为5.0.2并注册了omc、oh-my-claudecode、omc-cli三个 CLI 入口。因此通过 npm/bun 安装 CLI 工具时应使用npm install -g oh-my-claude-sisyphus三、Team 模式v4.1.7 起的规范编排面自v4.1.7起Team成为 OMC 的规范canonical多 Agent 编排面旧的swarm与ultrapilot入口仍然受支持但会在后台重定向到 Team。基本用法/oh-my-claudecode:team 3:executor fix all TypeScript errors分阶段流水线Team 的执行模型是一条分阶段流水线team-plan → team-prd → team-exec → team-verify → team-fix (loop)各阶段的职责与 Agent 分工在 skills/team/SKILL.md 中有完整的“Stage Agent Routing”表摘要如下阶段必选 Agent可选 Agent按任务特征选用team-planexplore(haiku)、planner(opus)analyst(opus)需求不明确时、architect(opus)系统边界复杂时team-prdanalyst(opus)critic(opus)挑战范围时team-execexecutor(sonnet)debugger/designer/writer/test-engineersonnet复杂自主工作用executor(opus)team-verifyverifier(sonnet)test-engineer、security-reviewer、code-reviewer(opus)team-fixexecutor(sonnet)debugger(sonnet)类型/构建错误、executor(opus)多文件复杂修复该文档同时给出了四条路由规则值得特别注意Agent 由 lead 按阶段选择而不是用户指定——用户参数N:agent-type只覆盖team-exec阶段的 worker 类型专家型 Agent 与执行型 Agent 互补分析与审查路由给 architect/criticUI 工作交给 designer成本模式影响模型档位——降级模式下 opus 降为 sonnet、sonnet 降为 haiku但team-verify至少使用 sonnet安全敏感或改动超过 20 个文件时team-verify强制包含security-reviewercode-reviewer(opus)。启用原生 Agent Teams要在 Claude Code 中启用原生 teams 支持在~/.claude/settings.json中加入{ env: { CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: 1 } }若 teams 处于禁用状态OMC 会发出警告并在可能时回退到无 Team 的执行模式。源码层面的印证从源码结构看Team 作为规范面的定位有多处实现证据src/hooks/keyword-detector/index.ts 中team的关键词正则是/(?!x)x/——一个永不匹配的占位符注释明确写着“Team keyword detection disabled — team mode is now explicit-only via /team skill. This prevents infinite spawning when Claude workers receive prompts containing team.” 也就是说 Team 模式被刻意设计为只能通过/team技能显式触发避免 worker 收到含 “team” 字样的提示词时递归派生团队仓库存在专门的 src/alias-retirement/ 模块含 policy、registry、verifier用于管理 swarm/ultrawork 等旧别名向 Team 的退役迁移skills/team/SKILL.md 中也记录了swarm兼容别名在历史 PR 中被移除的演进过程当前 npm 包版本为 5.0.2见 package.json即 README 中“v4.1.7 起 Team 成为规范面”这一说明在后续版本中依然成立旧入口仅作兼容重定向。四、编排模式全景为不同场景选对策略官方文档提供了完整的模式对照表覆盖从重量级 Team 到 token 经济型的各类场景模式描述适用场景Team推荐规范的分阶段流水线team-plan → team-prd → team-exec → team-verify → team-fix协调多个 Agent 在共享任务列表上协作Autopilot自主执行单一 leader Agent端到端功能开发最少仪式Ultrawork最大并行度非 Team无需 Team 时的批量并行修复/重构Ralph带 verify/fix 循环的持久模式必须完全做完的任务不允许静默的部分结果Ecomodetoken 经济型路由预算敏感的迭代Pipeline分步顺序处理有严格顺序依赖的多步变换Swarm / Ultrapilot旧重定向到Team的兼容门面既有工作流与旧文档五、魔法关键词进阶用户的显式控制开关对进阶用户OMC 提供一组魔法关键词作为可选项——不加它们纯自然语言同样工作正常。完整对照表关键词效果示例team规范 Team 编排/oh-my-claudecode:team 3:executor fix all TypeScript errorsautopilot完全自主执行autopilot: build a todo appralph持久模式ralph: refactor authulw最大并行度ulw fix all errorsecotoken 经济型执行eco: migrate databaseplan规划访谈plan the APIralplan迭代式规划共识ralplan this featureswarm旧关键词重定向到 Teamswarm 5 agents: fix lint errorsultrapilot旧关键词重定向到 Teamultrapilot: build a fullstack app两条重要说明原文档 Notesralph 内含 ultrawork激活 ralph 模式时会自动包含 ultrawork 的并行执行能力swarm N agents语法仍被识别并用于提取 Agent 数量但从 v4.1.7 起运行时基于 Team。关键词检测的源码实现关键词检测的完整实现在 src/hooks/keyword-detector/index.ts其中几个设计细节值得了解优先级体系cancel优先级 1、ralph优先级 2、autopilot优先级 3、team4.5、ralplan8依此类推高优先级关键词先命中多语言触发如ralph的模式/\b(ralph)\b(?!-)|(랄프)(?!로렌)|(ラルフ)(?!・?ローレン)/i同时支持英文、韩文、日文且排除了专有名词如 “Ralph Loren”误触发信息性意图豁免当关键词出现在 “what is …”“explain …” 这类询问语境中时不触发模式切换——类似的上下文判断逻辑也见 src/features/magic-keywords.ts 中的isInformationalKeywordContextralplan 优先门ralplan-first gate当提示词含执行类关键词但需求描述不足时检测器会将其重定向到ralplan强制先做规划共识再执行。六、自定义技能一次学习永久复用OMC 会在调试过程中把来之不易的知识抽取为可移植的技能文件并在相关任务出现时自动注入上下文。技能文件分两种作用域项目作用域用户作用域路径.omc/skills/~/.omc/skills/共享范围团队随版本库提交你的所有项目优先级高覆盖用户作用域低回退技能文件示例官方文档中的 YAML frontmatter 格式# .omc/skills/fix-proxy-crash.md --- name: Fix Proxy Crash description: aiohttp proxy crashes on ClientDisconnectedError triggers: [proxy, aiohttp, disconnected] source: extracted --- Enveloppez le handler à server.py:42 dans try/except ClientDisconnectedError...三个使用要点技能管理/skill list | add | remove | edit | search自动学习/skillify按严格质量标准抽取可复用模式对应 skills/skillify/SKILL.md自动注入匹配的技能自动加载进上下文无需手动提醒。仓库中还有约 30 个内置技能位于 skills/ 目录autopilot、ralph、ralplan、plan、deep-interview、omc-setup 等每个技能一个SKILL.md定义文件。七、CLI 实用工具1. 速率限制等待omc wait当 Claude 会话因 rate limit 中断时可在限额重置后自动恢复omc wait # 查看状态获取建议 omc wait --start # 启动自动恢复守护进程 omc wait --stop # 停止守护进程前置要求tmux用于会话检测。2. 通知 TagsTelegram/Discord配置 stop 回调发送会话摘要时 的对象# 定义/替换 tag 列表 omc config-stop-callback telegram --enable --token bot_token --chat chat_id --tag-list alice,bob omc config-stop-callback discord --enable --webhook url --tag-list here,123456789012345678,role:987654321098765432 # 增量更新 omc config-stop-callback telegram --add-tag charlie omc config-stop-callback discord --remove-tag here omc config-stop-callback discord --clear-tagsTags 的行为规则Telegramalice会被规范化为aliceDiscord支持here、everyone、数字用户 ID 和role:id形式file类型的回调忽略 tags 选项。3. OpenClaw 集成把 Claude Code 的会话事件转发到 OpenClaw 网关实现自动化应答与工作流。快速配置推荐/oh-my-claudecode:configure-notifications # → 提示时输入 openclaw → 选择 OpenClaw Gateway手动配置创建~/.claude/omc_config.openclaw.json{ enabled: true, gateways: { my-gateway: { url: https://your-gateway.example.com/wake, headers: { Authorization: Bearer YOUR_TOKEN }, method: POST, timeout: 10000 } }, hooks: { session-start: { gateway: my-gateway, instruction: Session started for {{projectName}}, enabled: true }, stop: { gateway: my-gateway, instruction: Session stopping for {{projectName}}, enabled: true } } }环境变量变量说明OMC_OPENCLAW1启用 OpenClawOMC_OPENCLAW_DEBUG1启用调试日志OMC_OPENCLAW_CONFIG/path/to/config.json指定替代配置文件路径受支持的 hook 事件官方文档标注 bridge.ts 中启用 6 个事件触发时机主要模板变量session-start会话开始{{sessionId}}、{{projectName}}、{{projectPath}}stopClaude 回复结束{{sessionId}}、{{projectName}}keyword-detector每次提交 prompt{{prompt}}、{{sessionId}}ask-user-questionClaude 请求用户输入{{question}}、{{sessionId}}pre-tool-use工具调用前高频{{toolName}}、{{sessionId}}post-tool-use工具调用后高频{{toolName}}、{{sessionId}}响应通道环境变量变量说明OPENCLAW_REPLY_CHANNEL响应通道如discordOPENCLAW_REPLY_TARGET目标通道 IDOPENCLAW_REPLY_THREAD线程 ID仓库中提供了一个参考网关实现 scripts/openclaw-gateway-demo.mjs演示如何将 OpenClaw payload 中继到自定义 HTTPS 自动化端点OpenClaw 的桥接逻辑位于 src/openclaw/ 目录官方文档所述的bridge.ts对应 src/hooks/bridge.ts。八、升级与排障升级 OMC 的完整步骤# 1. 更新插件 /plugin install oh-my-claudecode # 2. 重新运行 setup 以刷新配置 /oh-my-claudecode:omc-setup升级后如遇异常可运行/oh-my-claudecode:omc-doctor清空陈旧的插件缓存并做诊断对应 skills/omc-doctor/SKILL.md 与 commands/omc-doctor.md。另外若绕过omcshim、直接用claude --plugin-dir path启动 Claude Code需导出OMC_PLUGIN_ROOTpath使 HUD bundle 与插件加载器解析到同一份 checkout——参数细节同样见 docs/REFERENCE.md 的 “Plugin directory flags” 小节。九、前置条件与可选的 Multi-AI 编排前置条件Claude Code CLIClaude Max/Pro 订阅或 Anthropic API 密钥。可选项外部 AI 编排。OMC 可以但不必须编排外部 AI 供应商做交叉验证与设计一致性检查——不提供它们时 OMC 功能完整不受影响供应商安装提供的能力Gemini CLInpm install -g google/gemini-cli设计审查、UI 一致性1M token 上下文Codex CLInpm install -g openai/codex架构验证、代码审查交叉验证官方给出的成本口径Claude Gemini ChatGPT 三个 Pro 订阅合计约 60 美元/月即可覆盖全部编排需求。十、延伸阅读仓库中以下文档可与本文相互印证、按需深入docs/REFERENCE.md——完整功能参考docs/PERFORMANCE-MONITORING.md——Agent 追踪、调试与优化docs/MIGRATION.md——从 v2.x 迁移指南docs/ARCHITECTURE.md——底层架构原理skills/team/SKILL.md——Team 技能的完整规范阶段入口/退出条件、Agent 路由、状态管理CONTRIBUTING.md——开发者指南fork、本地 checkout 联调、测试与 PR 流程。OMC 采用 MIT 许可整体设计遵循“零学习曲线、最大能力输出”的原则默认用自然语言即可驱动需要精细控制时用魔法关键词与/team N:agent-type显式语法接管编排细节。【免费下载链接】oh-my-claudecodeTeams-first Multi-agent orchestration for Claude Code项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-claudecode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
oh-my-claudecode 实战指南：安装配置、Team 流水线编排与魔法关键词深度解析
oh-my-claudecode 实战指南安装配置、Team 流水线编排与魔法关键词深度解析【免费下载链接】oh-my-claudecodeTeams-first Multi-agent orchestration for Claude Code项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-claudecodeoh-my-claudecode简称 OMC是一个面向 Claude Code 的多智能体编排系统核心价值在于让开发者无需记忆复杂命令用一句自然语言即可触发从规划、执行到验证的完整 Agent 协作流程。本文基于仓库根目录的官方主文档README.fr.md为同一 README 的法语版本内容与英文版一致逐节展开并结合 Team 技能定义、关键词检测 Hook 等源码实现帮助读者掌握 OMC 的安装配置、Team 分阶段流水线、魔法关键词与 CLI 工具omc wait、通知 Tags、OpenClaw 集成的完整使用方式。一、OMC 是什么零学习曲线的多 Agent 编排OMC 的定位可以概括为一句话“不用去学 Claude Code直接用 OMC。”它通过插件形式为 Claude Code 注入一组编排能力官方文档列出的核心特性包括无需配置——开箱即用的智能默认值Team 优先team-first的编排——Team 是官方规范的多 Agent 编排面旧的 swarm/ultrapilot 入口只是兼容门面自然语言接口——不记忆命令直接描述想要什么自动并行化——复杂任务被拆分并分发到多个专业 Agent持久执行——在任务未被验证完成之前不放弃成本优化——通过模型智能路由官方称可节省 30%~50% 的 token 消耗经验学习——自动抽取可复用的问题求解模式实时可见性——HUD statusline 展示后台编排指标。智能编排能力官方文档进一步说明其编排层包含三类能力32 个专业 AgentREADME 口径覆盖架构、研究、设计、测试、数据科学等领域。仓库中的 agents/ 目录存放了 analyst、architect、code-reviewer、debugger、designer、planner 等角色定义文档src/agents/ 目录则是这些角色的 TypeScript 实现与提示词模板模型智能路由——简单任务用 Haiku复杂推理用 Opus实现成本与质量的平衡自动委派delegation——“合适的 Agent 做合适的工作”对应 src/features/delegation-enforcer.ts 与 src/features/delegation-routing/ 的实现。二、快速上手三步安装与首次运行步骤 1安装插件/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode /plugin install oh-my-claudecode步骤 2运行初始化配置/oh-my-claudecode:omc-setup一个容易踩坑的场景如果你通过omc --plugin-dir path或claude --plugin-dir path方式运行 OMC需要在omc setup中附加--plugin-dir-mode参数或提前导出OMC_PLUGIN_ROOT环境变量否则 OMC 会重复注入插件本身在运行时已经提供的 skills/agents造成冗余。完整的参数决策矩阵见 docs/REFERENCE.md 中的 “Plugin directory flags” 小节。步骤 3构建点什么autopilot: build a REST API for managing tasks到此为止其余一切自动完成——任务分解、Agent 调度、执行与验证都由 OMC 接管。包名注意项目品牌名是oh-my-claudecode仓库、插件、命令都用这个名字但 npm 上发布的包名是oh-my-claude-sisyphus。这一事实可在 package.json 中直接确认——其name字段为oh-my-claude-sisyphus当前版本为5.0.2并注册了omc、oh-my-claudecode、omc-cli三个 CLI 入口。因此通过 npm/bun 安装 CLI 工具时应使用npm install -g oh-my-claude-sisyphus三、Team 模式v4.1.7 起的规范编排面自v4.1.7起Team成为 OMC 的规范canonical多 Agent 编排面旧的swarm与ultrapilot入口仍然受支持但会在后台重定向到 Team。基本用法/oh-my-claudecode:team 3:executor fix all TypeScript errors分阶段流水线Team 的执行模型是一条分阶段流水线team-plan → team-prd → team-exec → team-verify → team-fix (loop)各阶段的职责与 Agent 分工在 skills/team/SKILL.md 中有完整的“Stage Agent Routing”表摘要如下阶段必选 Agent可选 Agent按任务特征选用team-planexplore(haiku)、planner(opus)analyst(opus)需求不明确时、architect(opus)系统边界复杂时team-prdanalyst(opus)critic(opus)挑战范围时team-execexecutor(sonnet)debugger/designer/writer/test-engineersonnet复杂自主工作用executor(opus)team-verifyverifier(sonnet)test-engineer、security-reviewer、code-reviewer(opus)team-fixexecutor(sonnet)debugger(sonnet)类型/构建错误、executor(opus)多文件复杂修复该文档同时给出了四条路由规则值得特别注意Agent 由 lead 按阶段选择而不是用户指定——用户参数N:agent-type只覆盖team-exec阶段的 worker 类型专家型 Agent 与执行型 Agent 互补分析与审查路由给 architect/criticUI 工作交给 designer成本模式影响模型档位——降级模式下 opus 降为 sonnet、sonnet 降为 haiku但team-verify至少使用 sonnet安全敏感或改动超过 20 个文件时team-verify强制包含security-reviewercode-reviewer(opus)。启用原生 Agent Teams要在 Claude Code 中启用原生 teams 支持在~/.claude/settings.json中加入{ env: { CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: 1 } }若 teams 处于禁用状态OMC 会发出警告并在可能时回退到无 Team 的执行模式。源码层面的印证从源码结构看Team 作为规范面的定位有多处实现证据src/hooks/keyword-detector/index.ts 中team的关键词正则是/(?!x)x/——一个永不匹配的占位符注释明确写着“Team keyword detection disabled — team mode is now explicit-only via /team skill. This prevents infinite spawning when Claude workers receive prompts containing team.” 也就是说 Team 模式被刻意设计为只能通过/team技能显式触发避免 worker 收到含 “team” 字样的提示词时递归派生团队仓库存在专门的 src/alias-retirement/ 模块含 policy、registry、verifier用于管理 swarm/ultrawork 等旧别名向 Team 的退役迁移skills/team/SKILL.md 中也记录了swarm兼容别名在历史 PR 中被移除的演进过程当前 npm 包版本为 5.0.2见 package.json即 README 中“v4.1.7 起 Team 成为规范面”这一说明在后续版本中依然成立旧入口仅作兼容重定向。四、编排模式全景为不同场景选对策略官方文档提供了完整的模式对照表覆盖从重量级 Team 到 token 经济型的各类场景模式描述适用场景Team推荐规范的分阶段流水线team-plan → team-prd → team-exec → team-verify → team-fix协调多个 Agent 在共享任务列表上协作Autopilot自主执行单一 leader Agent端到端功能开发最少仪式Ultrawork最大并行度非 Team无需 Team 时的批量并行修复/重构Ralph带 verify/fix 循环的持久模式必须完全做完的任务不允许静默的部分结果Ecomodetoken 经济型路由预算敏感的迭代Pipeline分步顺序处理有严格顺序依赖的多步变换Swarm / Ultrapilot旧重定向到Team的兼容门面既有工作流与旧文档五、魔法关键词进阶用户的显式控制开关对进阶用户OMC 提供一组魔法关键词作为可选项——不加它们纯自然语言同样工作正常。完整对照表关键词效果示例team规范 Team 编排/oh-my-claudecode:team 3:executor fix all TypeScript errorsautopilot完全自主执行autopilot: build a todo appralph持久模式ralph: refactor authulw最大并行度ulw fix all errorsecotoken 经济型执行eco: migrate databaseplan规划访谈plan the APIralplan迭代式规划共识ralplan this featureswarm旧关键词重定向到 Teamswarm 5 agents: fix lint errorsultrapilot旧关键词重定向到 Teamultrapilot: build a fullstack app两条重要说明原文档 Notesralph 内含 ultrawork激活 ralph 模式时会自动包含 ultrawork 的并行执行能力swarm N agents语法仍被识别并用于提取 Agent 数量但从 v4.1.7 起运行时基于 Team。关键词检测的源码实现关键词检测的完整实现在 src/hooks/keyword-detector/index.ts其中几个设计细节值得了解优先级体系cancel优先级 1、ralph优先级 2、autopilot优先级 3、team4.5、ralplan8依此类推高优先级关键词先命中多语言触发如ralph的模式/\b(ralph)\b(?!-)|(랄프)(?!로렌)|(ラルフ)(?!・?ローレン)/i同时支持英文、韩文、日文且排除了专有名词如 “Ralph Loren”误触发信息性意图豁免当关键词出现在 “what is …”“explain …” 这类询问语境中时不触发模式切换——类似的上下文判断逻辑也见 src/features/magic-keywords.ts 中的isInformationalKeywordContextralplan 优先门ralplan-first gate当提示词含执行类关键词但需求描述不足时检测器会将其重定向到ralplan强制先做规划共识再执行。六、自定义技能一次学习永久复用OMC 会在调试过程中把来之不易的知识抽取为可移植的技能文件并在相关任务出现时自动注入上下文。技能文件分两种作用域项目作用域用户作用域路径.omc/skills/~/.omc/skills/共享范围团队随版本库提交你的所有项目优先级高覆盖用户作用域低回退技能文件示例官方文档中的 YAML frontmatter 格式# .omc/skills/fix-proxy-crash.md --- name: Fix Proxy Crash description: aiohttp proxy crashes on ClientDisconnectedError triggers: [proxy, aiohttp, disconnected] source: extracted --- Enveloppez le handler à server.py:42 dans try/except ClientDisconnectedError...三个使用要点技能管理/skill list | add | remove | edit | search自动学习/skillify按严格质量标准抽取可复用模式对应 skills/skillify/SKILL.md自动注入匹配的技能自动加载进上下文无需手动提醒。仓库中还有约 30 个内置技能位于 skills/ 目录autopilot、ralph、ralplan、plan、deep-interview、omc-setup 等每个技能一个SKILL.md定义文件。七、CLI 实用工具1. 速率限制等待omc wait当 Claude 会话因 rate limit 中断时可在限额重置后自动恢复omc wait # 查看状态获取建议 omc wait --start # 启动自动恢复守护进程 omc wait --stop # 停止守护进程前置要求tmux用于会话检测。2. 通知 TagsTelegram/Discord配置 stop 回调发送会话摘要时 的对象# 定义/替换 tag 列表 omc config-stop-callback telegram --enable --token bot_token --chat chat_id --tag-list alice,bob omc config-stop-callback discord --enable --webhook url --tag-list here,123456789012345678,role:987654321098765432 # 增量更新 omc config-stop-callback telegram --add-tag charlie omc config-stop-callback discord --remove-tag here omc config-stop-callback discord --clear-tagsTags 的行为规则Telegramalice会被规范化为aliceDiscord支持here、everyone、数字用户 ID 和role:id形式file类型的回调忽略 tags 选项。3. OpenClaw 集成把 Claude Code 的会话事件转发到 OpenClaw 网关实现自动化应答与工作流。快速配置推荐/oh-my-claudecode:configure-notifications # → 提示时输入 openclaw → 选择 OpenClaw Gateway手动配置创建~/.claude/omc_config.openclaw.json{ enabled: true, gateways: { my-gateway: { url: https://your-gateway.example.com/wake, headers: { Authorization: Bearer YOUR_TOKEN }, method: POST, timeout: 10000 } }, hooks: { session-start: { gateway: my-gateway, instruction: Session started for {{projectName}}, enabled: true }, stop: { gateway: my-gateway, instruction: Session stopping for {{projectName}}, enabled: true } } }环境变量变量说明OMC_OPENCLAW1启用 OpenClawOMC_OPENCLAW_DEBUG1启用调试日志OMC_OPENCLAW_CONFIG/path/to/config.json指定替代配置文件路径受支持的 hook 事件官方文档标注 bridge.ts 中启用 6 个事件触发时机主要模板变量session-start会话开始{{sessionId}}、{{projectName}}、{{projectPath}}stopClaude 回复结束{{sessionId}}、{{projectName}}keyword-detector每次提交 prompt{{prompt}}、{{sessionId}}ask-user-questionClaude 请求用户输入{{question}}、{{sessionId}}pre-tool-use工具调用前高频{{toolName}}、{{sessionId}}post-tool-use工具调用后高频{{toolName}}、{{sessionId}}响应通道环境变量变量说明OPENCLAW_REPLY_CHANNEL响应通道如discordOPENCLAW_REPLY_TARGET目标通道 IDOPENCLAW_REPLY_THREAD线程 ID仓库中提供了一个参考网关实现 scripts/openclaw-gateway-demo.mjs演示如何将 OpenClaw payload 中继到自定义 HTTPS 自动化端点OpenClaw 的桥接逻辑位于 src/openclaw/ 目录官方文档所述的bridge.ts对应 src/hooks/bridge.ts。八、升级与排障升级 OMC 的完整步骤# 1. 更新插件 /plugin install oh-my-claudecode # 2. 重新运行 setup 以刷新配置 /oh-my-claudecode:omc-setup升级后如遇异常可运行/oh-my-claudecode:omc-doctor清空陈旧的插件缓存并做诊断对应 skills/omc-doctor/SKILL.md 与 commands/omc-doctor.md。另外若绕过omcshim、直接用claude --plugin-dir path启动 Claude Code需导出OMC_PLUGIN_ROOTpath使 HUD bundle 与插件加载器解析到同一份 checkout——参数细节同样见 docs/REFERENCE.md 的 “Plugin directory flags” 小节。九、前置条件与可选的 Multi-AI 编排前置条件Claude Code CLIClaude Max/Pro 订阅或 Anthropic API 密钥。可选项外部 AI 编排。OMC 可以但不必须编排外部 AI 供应商做交叉验证与设计一致性检查——不提供它们时 OMC 功能完整不受影响供应商安装提供的能力Gemini CLInpm install -g google/gemini-cli设计审查、UI 一致性1M token 上下文Codex CLInpm install -g openai/codex架构验证、代码审查交叉验证官方给出的成本口径Claude Gemini ChatGPT 三个 Pro 订阅合计约 60 美元/月即可覆盖全部编排需求。十、延伸阅读仓库中以下文档可与本文相互印证、按需深入docs/REFERENCE.md——完整功能参考docs/PERFORMANCE-MONITORING.md——Agent 追踪、调试与优化docs/MIGRATION.md——从 v2.x 迁移指南docs/ARCHITECTURE.md——底层架构原理skills/team/SKILL.md——Team 技能的完整规范阶段入口/退出条件、Agent 路由、状态管理CONTRIBUTING.md——开发者指南fork、本地 checkout 联调、测试与 PR 流程。OMC 采用 MIT 许可整体设计遵循“零学习曲线、最大能力输出”的原则默认用自然语言即可驱动需要精细控制时用魔法关键词与/team N:agent-type显式语法接管编排细节。【免费下载链接】oh-my-claudecodeTeams-first Multi-agent orchestration for Claude Code项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-claudecode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
