我在 Windows 上搭了个 13 人 AI 团队，踩了一路坑（OpenClaw 多 Agent 实战）

不是教程，是真实的踩坑记录。如果你也在 Windows 上玩 OpenClaw Multi-Agent，这篇文章能帮你省 3 小时。

前言

2026 年，AI Agent 从概念走向落地。OpenClaw 作为开源多 Agent 协作平台，让"一群 AI 员工协作干活"成为现实。

但官方文档和社区教程大多基于 Mac/Linux，Windows 用户照着做会遇到一堆问题。本文记录了我在 Windows 10 上从零搭建 13 人 Agent 团队的完整过程，包括每一次踩坑和解决方法。

最终成果

先看结果------13 个专家 Agent，各司其职：

scss 复制代码

┌─────────────────────────────────────────────────┐
│               Jim (调度中心)                      │
│                 default                          │
└────────────────────┬────────────────────────────┘
                     │
      ┌──────────────┼──────────────┐
      │              │              │
  ┌───┴───┐    ┌────┴────┐   ┌────┴────┐
  │ 架构层 │    │  开发层  │   │  质量层  │
  ├────────┤    ├─────────┤   ├─────────┤
  │backend │    │senior   │   │qa       │
  │architect│   │developer│   │engineer │
  │tech    │    │frontend │   │perf     │
  │lead    │    │developer│   │engineer │
  │data    │    │rapid    │   │security │
  │engineer│    │prototyper│  │engineer │
  │ai-ml   │    │         │   │         │
  │engineer│    │         │   │         │
  └───┬───┘    └────┬────┘   └────┬────┘
      │              │              │
  ┌───┴───┐    ┌────┴────┐   ┌────┴────┐
  │ 基础层 │    │  产品层  │   │  文档层  │
  ├────────┤    ├─────────┤   ├─────────┤
  │devops  │    │ui-ux    │   │tech     │
  │automator│   │designer │   │writer   │
  └────────┘    └─────────┘   └─────────┘

调度方式：主 Agent 拆任务 → sessions_spawn 分配给对应 Agent → 并行执行 → 汇总交付。

踩坑实录

坑 1：PowerShell 执行策略

症状： openclaw、npm、clawhub 等命令全部报错 PSSecurityException。

原因： Windows 默认 PowerShell 执行策略为 Restricted，禁止运行任何脚本。

解决： 以管理员身份运行 PowerShell：

powershell 复制代码

Set-ExecutionPolicy RemoteSigned -Scope LocalMachine -Force

💡 RemoteSigned 允许本地脚本运行，远程脚本需数字签名，安全性可接受。

坑 2：Gateway 重启不生效

症状： 通过 OpenClaw 工具触发 gateway restart，弹出 cmd 窗口但 Gateway 没有真正重启。

原因： OpenClaw 的 restart 功能发送 SIGUSR1 信号，这是 Unix 系统的信号机制，Windows 不支持。

解决： 两步法手动重启：

powershell 复制代码

# 1. 找到 Gateway 进程 PID
netstat -ano | findstr "LISTENING" | findstr "19000"

# 2. 杀旧进程
taskkill /PID <PID> /F

# 3. 后台启动新 Gateway（必须用 Start-Process，不能用 exec）
Start-Process -FilePath "C:\Users\ADMIN\.openclaw\gateway.cmd" -WindowStyle Normal

⚠️ 关键：Start-Process 启动的进程独立于当前 shell 存活。如果用 exec 执行 openclaw gateway restart，新进程会随 exec shell 一起死掉。

坑 3：Skills 安装找不到

症状： clawhub install tavily-search 报错 Skill not found。

原因： ClawHub 上的 skill slug 名称和你在 GitHub/文档里看到的不一样。

解决： 先搜索再安装：

powershell 复制代码

clawhub search tavily        # 搜索，看 slug 和评分
clawhub install tavily       # 用搜索到的 slug 安装

坑 4：exec-guard 安全审查

症状： clawhub install exec-guard 提示被标记为安全审查。

原因： ClawHub 对涉及命令执行的 skill 有安全审查机制。

解决： 确认来源可信后强制安装：

powershell 复制代码

clawhub install exec-guard --force

坑 5：Agent 注册后无法调度

症状： 配置文件里加了新 Agent，但 sessions_spawn 报错 not allowed。

原因： 需要在 agents.defaults.subagents.allowAgents 里显式允许。而且当前会话的权限是创建时缓存的，改配置后需要重启 Gateway 才能刷新。

解决： 在 openclaw.json 中配置：

json 复制代码

{
  "agents": {
    "defaults": {
      "subagents": {
        "allowAgents": [
          "senior-developer",
          "backend-architect",
          "frontend-developer",
          "qa-engineer",
          "security-engineer"
        ]
      }
    }
  }
}

然后重启 Gateway（用上面的两步法）。

完整搭建步骤

Step 1：环境准备

powershell 复制代码

# 确认 Node.js 版本
node -v  # 需要 v22+

# 安装 ClawHub CLI
npm install -g clawhub

# 设置 PowerShell 执行策略（管理员）
Set-ExecutionPolicy RemoteSigned -Scope LocalMachine -Force

Step 2：安装安全类 Skills（必装）

powershell 复制代码

clawhub install skill-vetter       # Skill 安全扫描
clawhub install exec-guard --force # 命令执行限制

🔒 不装这两个，别装其他 Skill。社区有过恶意插件事件。

Step 3：安装核心 Skills

powershell 复制代码

clawhub install tavily              # 联网搜索
clawhub install self-improving-agent # 自我进化
clawhub install openclaw-find-skills # 技能发现
clawhub install clawdbot-agent-browser # 浏览器自动化
clawhub install multi-search-engine # 多引擎搜索

Step 4：安装编程增强 Skills

powershell 复制代码

clawhub install superpowers    # 开发流程约束
clawhub install coding         # 通用编码
clawhub install code-review    # 代码审查
clawhub install debugging      # 系统化调试

Step 5：创建 Agent 工作区

每个 Agent 需要一个独立的工作区目录，里面放 SOUL.md 定义人格。

powershell 复制代码

# 创建目录
mkdir C:\Users\ADMIN\.openclaw\agents\senior-developer
mkdir C:\Users\ADMIN\.openclaw\agents\backend-architect
# ... 其他 Agent 同理

SOUL.md 示例（以 Senior Developer 为例）：

markdown 复制代码

# SOUL.md - Senior Developer

## 身份
你是 **Senior Developer**，全栈高级开发工程师。

## 核心能力
- 全栈开发：React/Vue + Node/Python/Go
- 测试驱动开发（TDD）
- API 设计（REST/GraphQL）

## 工作原则
1. 代码即文档
2. 测试先行
3. 安全内置

Step 6：注册 Agent 到配置文件

编辑 openclaw.json：

json 复制代码

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "mimo/mimo-v2.5-pro"
      },
      "subagents": {
        "allowAgents": ["senior-developer", "backend-architect", "..."]
      }
    },
    "list": [
      {
        "id": "default",
        "name": "default",
        "model": { "primary": "mimo/mimo-v2.5-pro" }
      },
      {
        "id": "senior-developer",
        "name": "Senior Developer",
        "model": { "primary": "mimo/mimo-v2.5-pro" },
        "workspace": "C:\\Users\\ADMIN\\.openclaw\\agents\\senior-developer"
      }
    ]
  }
}

Step 7：重启 Gateway 并验证

powershell 复制代码

# 杀旧进程
taskkill /PID <PID> /F

# 启动新 Gateway
Start-Process -FilePath "C:\Users\ADMIN\.openclaw\gateway.cmd" -WindowStyle Normal

验证 Agent 注册成功：

bash 复制代码

# 在 OpenClaw 对话中
/agents  # 应该看到所有注册的 Agent

实战演示：让 Agent 团队协作

搭建完成后，你可以这样调度 Agent 团队：

markdown 复制代码

你：帮我搭一个带用户认证的 SaaS 后台

Jim（主 Agent）会自动：
1. 分析需求，拆解任务
2. 调度 backend-architect 设计 API 架构
3. 调度 frontend-developer 开发页面
4. 调度 security-engineer 设计认证方案
5. 调度 qa-engineer 编写测试
6. 汇总结果，统一交付

每个 Agent 独立运行，互不干扰，由主 Agent 统筹协调。

工具清单

类别	工具	用途
安全	skill-vetter	Skill 代码扫描
安全	exec-guard	命令执行限制
核心	tavily	AI 优化搜索
核心	self-improving-agent	自我进化
核心	clawdbot-agent-browser	浏览器自动化
编程	superpowers	开发流程约束
编程	code-review	代码审查
编程	debugging	系统化调试

总结

Windows 上搭建 OpenClaw 多 Agent 系统会遇到一些平台特有的坑，但解决后体验很好。关键是：

先装安全 Skills，再装其他
Gateway 重启用两步法，不要用内置 restart
Agent 权限要显式配置，改完重启生效
Skills 安装先搜索，slug 名称可能不一样

13 个 Agent 协作的效率确实比单个 AI 高很多，尤其是复杂项目。值得一试。