⚡ 中级进阶教程

# ~/.hermes/config.yaml - 完整调度配置
orchestration:
  strategy: adaptive
  
  task_decomposition:
    max_subtasks: 8
    timeout_per_task: 120
    min_subtask_size: 50
    decomposition_model: anthropic/claude-sonnet-4
    allow_re_decompose: true
    
  worker_selection:
    mode: skill-based
    prefer_local: true
    fallback_strategy: round-robin
    max_retries: 3
    health_check_interval: 30
    
  result_aggregation:
    mode: merge
    conflict_resolution: latest
    deduplication: true
    quality_check: true
    
  context_sharing:
    enabled: true
    max_shared_tokens: 32000
    compression_threshold: 0.8
    share_tool_results: true
    share_memory: true

  execution:
    parallel: true
    max_concurrent: 5
    retry_on_failure: true
    retry_max_attempts: 3
    retry_backoff: exponential
    timeout_graceful: true

你的 Worker 是否专业化分工？
├── 是 → Worker 技能差异大吗？
│   ├── 是 → adaptive（智能匹配技能）
│   └── 否 → 任务量波动大吗？
│       ├── 是 → least-loaded（负载优先）
│       └── 否 → round-robin（简单轮询）
└── 否 → Worker 都是同质化的？
    ├── 是 → round-robin（均匀分配）
    └── 否 → 建议重新设计 Worker 专业化分工

# 用户输入
"帮我开发一个博客系统，要有用户注册、文章管理、评论功能"

# Hermes 拆解过程
意图分析: 全栈 Web 应用开发
├── 子任务1: 数据库设计（用户表、文章表、评论表）→ Worker: analyst
├── 子任务2: 后端 API 开发（注册/登录/CRUD）      → Worker: coder
├── 子任务3: 前端页面开发（首页/详情/管理后台）    → Worker: coder
├── 子任务4: API 接口测试                          → Worker: coder (测试技能)
├── 子任务5: 部署配置（Docker + Nginx）            → Worker: operator
└── 依赖关系: 1 → 2 → 3,4 → 5

# 拆解配置影响
max_subtasks: 8     # 最多拆8个子任务（本项目5个，合理）
timeout_per_task: 120  # 每个子任务最多2分钟
allow_re_decompose: true  # 如果子任务还是太复杂，允许二次拆解

// ~/.openclaw/agents/agents.json - 完整多 Worker 配置
{
  "agents": {
    "default": {
      "id": "default",
      "name": "默认助手",
      "model": { "primary": "anthropic/claude-sonnet-4" }
    },
    "list": [
      {
        "id": "coder",
        "name": "代码工程师",
        "emoji": "💻",
        "model": {
          "primary": "anthropic/claude-sonnet-4",
          "fallbacks": [
            "openai/gpt-5.1",
            "google/gemini-2.5-flash"
          ],
          "retry": {
            "max_attempts": 3,
            "backoff": "exponential",
            "initial_delay_ms": 1000
          }
        },
        "skills": [
          "code-generation",
          "code-review",
          "debugging",
          "refactoring",
          "git-operations"
        ],
        "system_prompt": "你是一个专业的全栈工程师。编写高质量、可维护的代码。遵循 SOLID 原则和设计模式。代码必须包含错误处理和日志记录。",
        "tools": {
          "allow": ["file_read", "file_write", "file_edit", "code_execute", "git"],
          "deny": ["system_admin", "network_access"]
        },
        "limits": {
          "max_tokens": 8192,
          "timeout": 180,
          "max_retries": 3
        },
        "description": "专注于代码编写、审查和调试"
      },
      {
        "id": "analyst",
        "name": "数据分析师",
        "emoji": "📊",
        "model": {
          "primary": "openai/gpt-5.1",
          "fallbacks": ["anthropic/claude-sonnet-4"]
        },
        "skills": [
          "data-analysis",
          "visualization",
          "sql-query",
          "report-generation",
          "statistics"
        ],
        "system_prompt": "你是一个数据分析专家。擅长 SQL 查询、数据可视化、统计分析和报告生成。分析结果必须包含数据支撑和可视化建议。",
        "tools": {
          "allow": ["file_read", "database_query", "code_execute"],
          "deny": ["file_write", "system_admin"]
        },
        "limits": {
          "max_tokens": 8192,
          "timeout": 120
        },
        "description": "专注于数据分析和可视化"
      },
      {
        "id": "operator",
        "name": "运维工程师",
        "emoji": "🔧",
        "model": {
          "primary": "google/gemini-2.5-flash",
          "fallbacks": ["anthropic/claude-sonnet-4"]
        },
        "skills": [
          "file-ops",
          "api-calls",
          "monitoring",
          "deployment",
          "docker"
        ],
        "system_prompt": "你是一个 DevOps 工程师。擅长部署、监控、API 调用和文件操作。操作前必须确认安全性，关键操作需要二次确认。",
        "tools": {
          "allow": ["file_read", "file_write", "api_call", "code_execute", "docker"],
          "deny": ["system_admin"]
        },
        "limits": {
          "max_tokens": 4096,
          "timeout": 60
        },
        "description": "专注于文件操作、API调用和运维"
      },
      {
        "id": "reviewer",
        "name": "审查专家",
        "emoji": "🔍",
        "model": {
          "primary": "anthropic/claude-opus-4",
          "fallbacks": ["anthropic/claude-sonnet-4"]
        },
        "skills": [
          "code-review",
          "security-audit",
          "performance-analysis",
          "architecture-review"
        ],
        "system_prompt": "你是一个资深技术审查专家。审查代码质量、安全漏洞、性能瓶颈和架构合理性。给出具体的改进建议和优先级。",
        "tools": {
          "allow": ["file_read", "code_execute"],
          "deny": ["file_write", "system_admin", "network_access"]
        },
        "limits": {
          "max_tokens": 8192,
          "timeout": 180
        },
        "description": "专注于代码审查和安全审计"
      }
    ]
  }
}

# 方式一：逐个启动（适合调试）
# 启动代码工程师 Worker（端口 18789）
OPENCLAW_AGENT=coder openclaw gateway start --port 18789

# 启动数据分析师 Worker（端口 18790）
OPENCLAW_AGENT=analyst openclaw gateway start --port 18790

# 启动运维工程师 Worker（端口 18791）
OPENCLAW_AGENT=operator openclaw gateway start --port 18791

# 启动审查专家 Worker（端口 18792）
OPENCLAW_AGENT=reviewer openclaw gateway start --port 18792

# 方式二：批量启动脚本
cat > start-workers.sh << 'SCRIPT'
#!/bin/bash
WORKERS=("coder:18789" "analyst:18790" "operator:18791" "reviewer:18792")

for worker in "${WORKERS[@]}"; do
  IFS=':' read -r id port <<< "$worker"
  echo "启动 Worker: $id (端口: $port)"
  OPENCLAW_AGENT=$id openclaw gateway start --port $port --daemon
  sleep 2
done

echo "所有 Worker 已启动"
openclaw gateway status --all
SCRIPT

chmod +x start-workers.sh
./start-workers.sh

# ~/.hermes/config.yaml - Worker 健康管理
workers:
  health_check:
    enabled: true
    interval: 30s
    timeout: 5s
    unhealthy_threshold: 3
    
  auto_recovery:
    enabled: true
    max_restart_attempts: 5
    restart_cooldown: 60s
    notify_on_failure: true
    
  load_balancing:
    max_queue_per_worker: 10
    overflow_strategy: reject  # reject | queue | redirect
    
  registration:
    auto_discover: true
    discover_interval: 60s

"model": {
  "primary": "anthropic/claude-sonnet-4",
  "fallbacks": [
    "openai/gpt-5.1",
    "google/gemini-2.5-flash"
  ],
  "retry": {
    "max_attempts": 3,
    "backoff": "exponential",
    "initial_delay_ms": 1000,
    "max_delay_ms": 30000,
    "retryable_errors": [
      "rate_limit",
      "timeout",
      "server_error",
      "connection_reset"
    ],
    "non_retryable_errors": [
      "invalid_api_key",
      "model_not_found",
      "context_length_exceeded"
    ]
  },
  "circuit_breaker": {
    "enabled": true,
    "failure_threshold": 5,
    "recovery_timeout": 60s,
    "half_open_requests": 3
  }
}

# ~/.hermes/config.yaml - Worker 间通信
communication:
  protocol: mcp
  
  message_queue:
    type: redis
    host: localhost
    port: 6379
    db: 0
    
  event_bus:
    enabled: true
    topics:
      - task.assigned
      - task.completed
      - task.failed
      - worker.health
      
  shared_state:
    enabled: true
    backend: redis
    ttl: 3600
    key_prefix: "hermes:state:"

# docker-compose.yml
version: '3.8'

services:
  redis:
    image: redis:7-alpine
    ports:
      - "6379:6379"
    volumes:
      - redis-data:/data
    restart: unless-stopped

  hermes:
    image: hermes-agent:latest
    build:
      context: .
      dockerfile: Dockerfile.hermes
    ports:
      - "18788:18788"
    environment:
      - OPENAI_API_KEY=${XIDAO_API_KEY}
      - OPENAI_BASE_URL=https://api.xidao.online/v1
      - REDIS_URL=redis://redis:6379
    volumes:
      - ./hermes-config:/root/.hermes
      - ./workspace:/workspace
    depends_on:
      - redis
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:18788/health"]
      interval: 30s
      timeout: 10s
      retries: 3

  worker-coder:
    image: openclaw:latest
    build:
      context: .
      dockerfile: Dockerfile.openclaw
    environment:
      - OPENCLAW_AGENT=coder
      - OPENAI_API_KEY=${XIDAO_API_KEY}
      - OPENAI_BASE_URL=https://api.xidao.online/v1
    ports:
      - "18789:18789"
    volumes:
      - ./workspace:/workspace
      - ./openclaw-config:/root/.openclaw
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:18789/health"]
      interval: 30s
      timeout: 10s
      retries: 3

  worker-analyst:
    image: openclaw:latest
    environment:
      - OPENCLAW_AGENT=analyst
      - OPENAI_API_KEY=${XIDAO_API_KEY}
      - OPENAI_BASE_URL=https://api.xidao.online/v1
    ports:
      - "18790:18790"
    volumes:
      - ./workspace:/workspace
      - ./openclaw-config:/root/.openclaw
    restart: unless-stopped

  worker-operator:
    image: openclaw:latest
    environment:
      - OPENCLAW_AGENT=operator
      - OPENAI_API_KEY=${XIDAO_API_KEY}
      - OPENAI_BASE_URL=https://api.xidao.online/v1
    ports:
      - "18791:18791"
    volumes:
      - ./workspace:/workspace
      - ./openclaw-config:/root/.openclaw
      - /var/run/docker.sock:/var/run/docker.sock
    restart: unless-stopped

volumes:
  redis-data:

# .env 文件（不要提交到 Git！）
XIDAO_API_KEY=sk-your-api-key-here

# Docker Compose 启动
docker compose up -d

# 查看所有服务状态
docker compose ps

# 查看日志
docker compose logs -f hermes
docker compose logs -f worker-coder

# 扩展 Worker 数量
docker compose up -d --scale worker-coder=3

# 重启单个服务
docker compose restart worker-coder

# 停止所有服务
docker compose down

# Dockerfile.openclaw
FROM node:20-slim

RUN apt-get update && apt-get install -y \
    python3 python3-pip git curl \
    && rm -rf /var/lib/apt/lists/*

RUN npm install -g openclaw

WORKDIR /workspace

EXPOSE 18789

CMD ["openclaw", "gateway", "start", "--host", "0.0.0.0"]

# ~/.hermes/config.yaml - MCP 服务器完整配置
mcp_servers:
  # === 文件系统 ===
  filesystem:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-filesystem", "/workspace"]
    transport: stdio
    disabled: false
    
  # === GitHub ===
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: ${GITHUB_TOKEN}
    transport: stdio
    disabled: false
    
  # === 数据库 ===
  postgres:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-postgres", "postgresql://user:pass@localhost/mydb"]
    transport: stdio
    disabled: false
    
  sqlite:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-sqlite", "/workspace/data.db"]
    transport: stdio
    disabled: false
    
  # === 浏览器自动化 ===
  puppeteer:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-puppeteer"]
    transport: stdio
    disabled: false
    
  # === 搜索 ===
  brave-search:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-brave-search"]
    env:
      BRAVE_API_KEY: ${BRAVE_API_KEY}
    transport: stdio
    disabled: false
    
  # === 远程 MCP 服务 ===
  remote-analytics:
    url: https://mcp.example.com/sse
    transport: sse
    headers:
      Authorization: Bearer ${MCP_AUTH_TOKEN}
    disabled: false
    
  # === 内存服务 ===
  memory:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-memory"]
    transport: stdio
    disabled: false

# MCP 全局配置
mcp:
  connection_timeout: 30s
  request_timeout: 60s
  max_concurrent_servers: 10
  retry_on_failure: true
  retry_max_attempts: 3
  log_level: info

// ~/.openclaw/mcp/servers.json
{
  "mcp": {
    "servers": {
      "filesystem": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-filesystem", "/workspace"],
        "transport": "stdio",
        "disabled": false
      },
      "github": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-github"],
        "env": {
          "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
        },
        "transport": "stdio"
      },
      "remote-api": {
        "url": "https://mcp.example.com/sse",
        "transport": "sse",
        "headers": {
          "Authorization": "Bearer ${MCP_AUTH_TOKEN}"
        }
      }
    },
    "global": {
      "connection_timeout": 30,
      "request_timeout": 60,
      "max_retries": 3
    }
  }
}

# ~/.hermes/.env - MCP 相关环境变量
GITHUB_TOKEN=ghp_your_github_token
BRAVE_API_KEY=bsa_your_brave_key
MCP_AUTH_TOKEN=your_mcp_auth_token
DATABASE_URL=postgresql://user:pass@localhost/mydb

# 设置文件权限
chmod 600 ~/.hermes/.env

# 在配置中使用 ${VAR_NAME} 引用
# Hermes 会自动从 .env 文件读取并替换

# 列出所有已配置的 MCP 服务器
hermes mcp list

# 测试 MCP 服务器连接
hermes mcp test filesystem
hermes mcp test github

# 查看 MCP 服务器提供的工具
hermes mcp tools filesystem
hermes mcp tools github

# 查看 MCP 服务器提供的资源
hermes mcp resources postgres

# 启用/禁用 MCP 服务器
hermes mcp enable github
hermes mcp disable puppeteer

# 查看 MCP 通信日志
hermes mcp logs --verbose

# 重启 MCP 服务器
hermes mcp restart filesystem

# 搜索可用技能
openclaw skills search code-review
openclaw skills search --category testing

# 安装技能
openclaw skills install code-review
openclaw skills install data-analysis
openclaw skills install web-scraper
openclaw skills install api-testing
openclaw skills install security-audit

# 安装指定版本
openclaw skills install code-review@2.1.0

# 查看已安装技能
openclaw skills list
openclaw skills list --verbose  # 详细信息

# 更新技能
openclaw skills update code-review
openclaw skills update --all    # 更新全部

# 卸载技能
openclaw skills uninstall web-scraper

# 查看技能详情
openclaw skills info code-review

// ~/.openclaw/agents/agents.json - Skills 绑定配置
{
  "agents": {
    "list": [
      {
        "id": "coder",
        "name": "代码工程师",
        "skills": [
          {
            "name": "code-generation",
            "priority": 1,
            "config": {
              "language": "typescript",
              "framework": "nextjs",
              "style": "functional"
            }
          },
          {
            "name": "code-review",
            "priority": 2,
            "config": {
              "severity": "strict",
              "check_security": true,
              "check_performance": true,
              "max_file_lines": 500
            }
          },
          {
            "name": "debugging",
            "priority": 3,
            "config": {
              "auto_fix": false,
              "max_iterations": 5
            }
          }
        ]
      },
      {
        "id": "analyst",
        "name": "数据分析师",
        "skills": [
          {
            "name": "data-analysis",
            "priority": 1,
            "config": {
              "default_format": "markdown",
              "include_visualization": true,
              "statistical_tests": true
            }
          },
          {
            "name": "sql-query",
            "priority": 2,
            "config": {
              "dialect": "postgresql",
              "max_rows": 1000,
              "read_only": true
            }
          }
        ]
      }
    ]
  }
}

// ~/.openclaw/config.json - Skills 冲突配置
{
  "skills": {
    "conflict_resolution": "priority",
    "default_priority": 10,
    "overrides": {
      "code-review": {
        "priority": 1,
        "exclusive": false
      },
      "security-audit": {
        "priority": 0,
        "exclusive": true
      }
    },
    "compatibility": {
      "code-review+security-audit": "sequential",
      "code-generation+testing": "parallel"
    }
  }
}

# Hermes 查看所有 Worker 的技能
hermes skills list --all-workers

# 查看特定 Worker 的技能
hermes skills list --worker coder

# 为 Worker 动态添加技能
hermes skills assign coder api-testing

# 移除 Worker 的技能
hermes skills unassign coder web-scraper

# 查看技能使用统计
hermes skills stats

# ~/.hermes/config.yaml - 上下文共享
context_sharing:
  enabled: true
  
  workspace:
    path: /workspace
    shared_with: [coder, analyst, operator]
    file_permissions: rw
    auto_sync: true
    
  memory:
    type: mcp-memory
    shared_entities: true
    namespace: "project-alpha"
    
  message_bus:
    type: redis
    channels:
      - "hermes:task:results"
      - "hermes:worker:status"
      - "hermes:context:updates"
      
  context_injection:
    mode: auto
    max_injected_tokens: 4000
    include:
      - project_structure
      - recent_changes
      - active_branch
      - dependencies

# 查看共享记忆
hermes memory list --shared

# 添加共享知识
hermes memory add "项目使用 Next.js 15 + TypeScript" --scope shared

# 查看特定 Worker 的记忆
hermes memory list --worker coder

# 清除过期记忆
hermes memory cleanup --older-than 7d

# 导出记忆
hermes memory export --format json > project-memory.json

# 导入记忆
hermes memory import project-memory.json

# Hermes 日志
hermes logs --tail 50
hermes logs --level debug
hermes logs --worker coder
hermes logs --since "2025-01-01"

# OpenClaw 日志
openclaw logs --tail 50
openclaw logs --level debug
openclaw logs --agent coder

# Docker 日志
docker compose logs -f hermes
docker compose logs -f worker-coder --since 1h

# MCP 通信日志
hermes mcp logs --verbose
hermes mcp logs --server github

# 查看当前任务状态
hermes tasks list
hermes tasks list --status running
hermes tasks list --worker coder

# 查看任务详情
hermes tasks show task-abc123

# 查看任务执行时间线
hermes tasks timeline task-abc123

# 取消正在执行的任务
hermes tasks cancel task-abc123

# 查看历史任务统计
hermes tasks stats --last 7d

# 查看所有 Worker 状态
openclaw gateway status --all

# 输出示例:
# WORKER     STATUS    PORT    MODEL               QUEUE  UPTIME
# coder      healthy   18789   claude-sonnet-4      2/10   3d 12h
# analyst    healthy   18790   gpt-5.1              0/10   3d 12h
# operator   healthy   18791   gemini-2.5-flash     1/10   3d 12h
# reviewer   warning   18792   claude-opus-4        5/10   3d 12h

# 查看特定 Worker 详情
openclaw gateway status --worker coder --verbose

# 检查 Worker 健康状态
curl http://localhost:18789/health
curl http://localhost:18790/health

# API 调用统计
hermes stats api --last 24h

# Token 使用统计
hermes stats tokens --last 7d

# Worker 性能指标
hermes stats workers --last 24h

# 输出示例:
# WORKER     REQUESTS  AVG_TIME  SUCCESS_RATE  TOKENS_USED
# coder      156       12.3s     98.7%         1.2M
# analyst    89        8.7s      99.1%         0.8M
# operator   234       3.2s      99.5%         0.3M
# reviewer   45        15.6s     97.8%         0.9M