{"skill":{"slug":"master-agent-workflow-global","displayName":"Master Agent Workflow Global","summary":"支持跨平台的一键安装全局主控代理工作流，具备多级代理调度、错误处理、配置迁移和模板管理能力。","description":"# 🏗️ master-agent-workflow-global - 全局可迁移的主控代理工作流技能\n\n## 🎯 技能概述\n\n`master-agent-workflow-global` 是一个完善的主控代理工作流技能，专为需要并行任务调度、代理层级控制和完整错误处理的场景设计。这是原始 `master-agent-workflow` 技能的全局可迁移版本，支持一键安装、配置迁移和跨平台使用。\n\n### ✨ 核心特性\n\n- **✅ 全局可迁移**: 在任何OpenClaw实例中安装即可使用\n- **✅ 一键安装**: 通过安装脚本或ClawdHub快速安装\n- **✅ 配置迁移**: 支持导出/导入配置和模板\n- **✅ 模板系统**: 预定义任务模板，快速启动\n- **✅ 跨平台兼容**: Windows/Linux/macOS全支持\n- **✅ 版本管理**: 语义化版本，支持升级和回滚\n\n## 🚀 快速开始\n\n### 安装方式\n\n#### 方法1：使用安装脚本（推荐）\n```bash\n# 下载并安装\ncd master-agent-workflow-global\n./install.sh\n```\n\n#### 方法2：通过ClawdHub\n```bash\n# 发布后可用\nclawdhub install master-agent-workflow-global\n```\n\n#### 方法3：手动安装\n```bash\n# 复制到全局技能目录\ncp -r master-agent-workflow-global ~/.openclaw/global-skills/\n# 激活技能\n~/.openclaw/global-skills/master-agent-workflow/scripts/activator.sh\n```\n\n### 基本使用\n\n```bash\n# 使用默认配置执行任务\n使用 master-agent-workflow-global execute \"处理我的任务\"\n\n# 快捷命令\nmaw \"处理我的任务\"\n\n# 指定并行数和超时\nmaw \"批量处理\" --max-workers 10 --timeout 2h\n```\n\n## 📋 功能详解\n\n### 1. 代理层级架构\n```\n主代理 (Main) → 主控代理 (Master) → 工作代理 (Worker) × N\n```\n- 清晰的权限边界\n- 正确的工具使用限制\n- 自动清理机制\n\n### 2. 智能调度算法\n- 动态任务队列管理\n- 并行度控制（可配置）\n- 工作代理状态监控\n- 自动重试和失败处理\n\n### 3. 安全退出机制\n- 超时退出（可配置时间）\n- 卡住检测（无进展退出）\n- 失败过多退出\n- 工作代理超时终止\n\n### 4. 工具安全规范\n- 禁止使用系统命令（timeout、ping、sleep等）\n- 只使用OpenClaw安全工具\n- 正确的消息发送格式\n- 完善的错误处理\n\n## ⚙️ 配置管理\n\n### 配置文件位置\n```\n~/.openclaw/global-skills/master-agent-workflow/config/\n├── default.json          # 默认配置\n├── production.json       # 生产环境配置\n├── development.json      # 开发环境配置\n└── custom-config.json    # 自定义配置\n```\n\n### 配置参数\n\n| 参数 | 类型 | 默认值 | 说明 |\n|------|------|--------|------|\n| max_workers | number | 5 | 最大并行工作代理数 |\n| timeout_hours | number | 3 | 主控代理超时时间（小时） |\n| worker_timeout_minutes | number | 30 | 工作代理超时时间（分钟） |\n| stuck_threshold_minutes | number | 15 | 卡住检测阈值（分钟） |\n| fail_threshold | number | 10 | 失败阈值（超过则退出） |\n| auto_cleanup | boolean | true | 是否自动清理完成的工作代理 |\n| report_channel | string | \"feishu\" | 进度报告渠道 |\n\n### 配置命令\n\n```bash\n# 保存自定义配置\nmaw configure save high-performance --max-workers 20 --timeout 4h\n\n# 使用特定配置\nmaw execute \"任务\" --config high-performance\n\n# 列出所有配置\nmaw configure list\n```\n\n## 🎨 模板系统\n\n### 预定义模板\n\n#### 文件处理模板\n```bash\nmaw execute \"处理文件\" --template file_processing\n```\n- 最大并行数: 5\n- 工作代理超时: 45分钟\n- 适合: 批量文件处理\n\n#### API调用模板\n```bash\nmaw execute \"调用API\" --template api_calling\n```\n- 最大并行数: 3\n- 工作代理超时: 60分钟\n- 失败阈值: 3\n- 适合: 批量API调用\n\n#### 数据处理模板\n```bash\nmaw execute \"处理数据\" --template data_processing\n```\n- 最大并行数: 10\n- 工作代理超时: 30分钟\n- 适合: 批量数据处理\n\n### 自定义模板\n1. 创建模板文件 `my-template.json`:\n```json\n{\n  \"name\": \"my_template\",\n  \"description\": \"我的自定义模板\",\n  \"config\": {\n    \"max_workers\": 8,\n    \"timeout_hours\": 2\n  }\n}\n```\n\n2. 复制到模板目录:\n```bash\ncp my-template.json ~/.openclaw/global-skills/master-agent-workflow/templates/\n```\n\n3. 使用模板:\n```bash\nmaw execute \"任务\" --template my_template\n```\n\n## 🔄 迁移功能\n\n### 导出配置\n```bash\n# 导出所有配置和模板\nmaw migrate export --output maw-backup.json\n\n# 导出包含运行状态\nmaw migrate export --include-state --output maw-full-backup.tar.gz\n```\n\n### 导入配置\n```bash\n# 导入配置\nmaw migrate import maw-backup.json\n\n# 从其他系统导入\nscp user@remote:~/maw-backup.json .\nmaw migrate import maw-backup.json\n```\n\n### 备份和恢复\n```bash\n# 创建完整备份\nmaw migrate backup\n\n# 列出备份\nmaw migrate list\n\n# 清理旧备份（30天前）\nmaw migrate clean 30\n```\n\n## 🖥️ 跨平台支持\n\n### Windows\n```bash\n# 安装后会自动创建批处理文件\nmaw.bat \"执行任务\"\n\n# 环境变量\nset MAW_HOME=%USERPROFILE%\\.openclaw\\global-skills\\master-agent-workflow\n```\n\n### Linux/macOS\n```bash\n# 安装后会自动创建shell脚本\nmaw \"执行任务\"\n\n# 环境变量\nexport MAW_HOME=~/.openclaw/global-skills/master-agent-workflow\n```\n\n### 路径处理\n技能自动处理不同操作系统的路径差异：\n- Windows: 使用 `%USERPROFILE%`\n- Linux/macOS: 使用 `~`\n- 自动检测和转换路径格式\n\n## 📊 监控和报告\n\n### 进度报告\n- 定期发送进度报告（每10分钟）\n- 报告渠道可配置（feishu、telegram、console等）\n- 包含任务统计和性能指标\n\n### 执行日志\n```\n~/.openclaw/global-skills/master-agent-workflow/logs/\n├── execution-20260327-0930.log\n├── error-20260327-0935.log\n└── performance-20260327-0940.log\n```\n\n### 性能指标\n- 任务完成率\n- 平均执行时间\n- 并行效率\n- 资源利用率\n\n## 🔧 高级用法\n\n### 环境变量覆盖\n```bash\n# 使用环境变量设置配置\nexport MAW_MAX_WORKERS=20\nexport MAW_TIMEOUT_HOURS=4\nmaw \"任务\"\n```\n\n### 脚本集成\n```bash\n#!/bin/bash\n# 自动化脚本示例\n\n# 加载配置\nCONFIG=\"--config production\"\n\n# 执行任务\nmaw \"每日备份任务\" $CONFIG --max-workers 8 --timeout 2h\n\n# 检查结果\nif [ $? -eq 0 ]; then\n    echo \"✅ 任务成功\"\nelse\n    echo \"❌ 任务失败\"\n    exit 1\nfi\n```\n\n### 与cron集成\n```bash\n# 每日凌晨2点执行\n0 2 * * * /usr/bin/maw \"每日任务\" --config production\n```\n\n## 🐛 故障排除\n\n### 常见问题\n\n#### Q1: 安装失败\n**原因**: 权限问题或依赖缺失\n**解决**:\n```bash\n# 检查权限\nls -la ~/.openclaw/\n\n# 重新安装\n./install.sh --force\n```\n\n#### Q2: 命令未找到\n**原因**: 环境变量未生效\n**解决**:\n```bash\n# 重新加载shell配置\nsource ~/.bashrc  # 或 source ~/.zshrc\n\n# 或直接使用完整路径\n~/.openclaw/global-skills/master-agent-workflow/scripts/maw.sh\n```\n\n#### Q3: 配置导入失败\n**原因**: 版本不兼容或文件损坏\n**解决**:\n```bash\n# 检查文件格式\nfile backup.json\n\n# 使用兼容模式\nmaw migrate import backup.json --force\n```\n\n### 调试模式\n```bash\n# 启用详细日志\nexport MAW_DEBUG=true\nmaw \"任务\" --dry-run\n\n# 查看日志\ncat ~/.openclaw/global-skills/master-agent-workflow/logs/debug.log\n```\n\n## 📈 性能优化\n\n### 并行度优化\n- **I/O密集型任务**: 增加并行数（5-10）\n- **CPU密集型任务**: 减少并行数（2-3）\n- **网络密集型任务**: 中等并行数（3-5）\n\n### 内存优化\n- 及时清理完成的工作代理\n- 使用流式处理大文件\n- 避免在内存中保存大量数据\n\n### 网络优化\n- 批量发送进度报告\n- 使用压缩传输大数据\n- 减少不必要的网络请求\n\n## 🔄 从v1.0.0迁移\n\n### 迁移步骤\n1. **备份当前配置**\n   ```bash\n   cd ~/.openclaw/workspace/skills/master-agent-workflow\n   cp -r . ~/maw-v1-backup/\n   ```\n\n2. **安装v2.0.0**\n   ```bash\n   cd master-agent-workflow-global\n   ./install.sh\n   ```\n\n3. **迁移配置**\n   ```bash\n   maw migrate import ~/maw-v1-backup/skill.json\n   ```\n\n4. **验证迁移**\n   ```bash\n   maw --version\n   maw execute \"测试任务\" --dry-run\n   ```\n\n### 兼容性说明\n- **完全兼容**: v2.0.0完全兼容v1.0.0的配置格式\n- **新增功能**: 模板系统、迁移工具、全局安装\n- **向后兼容**: 所有v1.0.0功能在v2.0.0中可用\n\n## 📚 参考资源\n\n### 文档目录\n- `SKILL.md` - 本文件，主技能文档\n- `references/examples.md` - 使用示例\n- `references/openclaw-integration.md` - OpenClaw集成指南\n- `migration-guide.md` - 迁移指南\n\n### 脚本目录\n- `scripts/activator.sh` - 激活脚本\n- `scripts/migrate.sh` - 迁移工具\n- `scripts/maw.sh` - 快捷命令\n\n### 模板目录\n- `templates/file_processing.json` - 文件处理模板\n- `templates/api_calling.json` - API调用模板\n- `templates/data_processing.json` - 数据处理模板\n\n## 🆘 支持与帮助\n\n### 获取帮助\n```bash\n# 查看帮助\nmaw help\n\n# 查看版本\nmaw --version\n\n# 查看技能状态\nmaw status\n```\n\n### 报告问题\n```bash\n# 生成诊断报告\nmaw diagnose --output diagnosis.json\n\n# 查看日志\ncat ~/.openclaw/global-skills/master-agent-workflow/logs/error.log\n```\n\n### 联系支持\n- **GitHub**: https://github.com/xiaolong-ai/master-agent-workflow\n- **ClawdHub**: https://clawhub.com/skills/master-agent-workflow-global\n- **问题反馈**: 通过GitHub Issues或ClawdHub反馈\n\n## 📄 许可证\n\nMIT License - 详见LICENSE文件\n\n---\n\n**技能名称**: master-agent-workflow-global  \n**版本**: 2.0.0  \n**创建时间**: 2026年3月25日  \n**全局版本发布时间**: 2026年3月27日  \n**作者**: 小龙  \n**状态**: ✅ 生产就绪  \n**兼容性**: OpenClaw >= 1.0.0  \n\n**更新日志**:\n- v2.0.0 (2026-03-27): 全局可迁移版本，添加模板系统和迁移工具\n- v1.0.0 (2026-03-25): 初始版本，基本的主控代理工作流功能","tags":{"latest":"2.0.0"},"stats":{"comments":0,"downloads":372,"installsAllTime":0,"installsCurrent":0,"stars":1,"versions":4},"createdAt":1774580706470,"updatedAt":1778492228204},"latestVersion":{"version":"2.0.0","createdAt":1774580706470,"changelog":"全局可迁移的主控代理工作流技能","license":"MIT-0"},"metadata":null,"owner":{"handle":"shujianming","userId":"s17bax8pd2rqn5cnm9pycd5q1983q266","displayName":"shujianming","image":"https://avatars.githubusercontent.com/u/32048731?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780090144900}}