OpenClaw 多 Agent 统一管理方案:避免重复安装,全局遵守规矩

OpenClaw 多 Agent 统一管理方案

避免重复安装 · 统一管理 · 全局遵守 · 个性保留

一、问题场景

如果你和我一样，配置了多个 OpenClaw Agent（比如大虾、二虾、三虾），可能会遇到这些头疼的问题：

问题	说明	影响
重复安装 skills	每个 Agent 独立安装相同 skill	浪费空间、维护困难
规矩不统一	各 Agent 规矩不一致	行为不可预测
配置分散	配置散落在各 workspace	难以统一管理
更新不同步	更新一个 Agent 忘记更新其他	版本不一致

核心需求：

✅ 共享 skills —— 避免重复安装，统一管理
✅ 全局规矩 —— 所有 Agent 必须共同遵守
✅ 个性保留 —— 各 Agent 仍有专属配置空间
✅ 优先级清晰 —— 全局 > 局部，避免冲突
✅ 易于维护 —— 有同步机制，更新方便

二、当前架构分析

目录结构


12345678910111213~/.openclaw/├── openclaw.json              # 全局配置文件（所有 Agent 共享）├── agents/                    # Agent 配置目录│   ├── main/│   ├── erxia/│   └── sanxia/├── workspace/                 # 主 Agent 工作区│   ├── AGENTS.md, SOUL.md, MEMORY.md│   ├── skills/               # 用户安装的 skills│   └── memory/├── workspace-erxia/           # 二虾工作区└── workspace-sanxia/          # 三虾工作区

当前问题

层级	问题	说明
全局配置	无规矩字段	openclaw.json 没有全局规矩配置
Skills 管理	各自安装	每个 workspace 独立安装 skills
规矩文件	分散独立	各 Agent 规矩文件不互通
同步机制	无	没有自动同步机制

三、完整方案：四层架构


1415161718192021222324252627282930┌─────────────────────────────────────────────────────────┐│  第一层：全局共享配置 (强制遵守)                         ││  ├── openclaw.json (硬性限制)                           ││  └── /opt/openclaw/skills/ (系统级 skills)              │├─────────────────────────────────────────────────────────┤│  第二层：共享规矩文件 (所有 Agent 必须遵守)               ││  ├── GLOBAL_RULES.md (全局规矩)                         ││  ├── GLOBAL_SKILLS.md (共享 skills 清单)                ││  └── 通过 symlink 共享到所有 workspace                   │├─────────────────────────────────────────────────────────┤│  第三层：Agent 专属配置 (个性化)                         ││  ├── AGENTS.md (各 Agent 独立)                          ││  ├── SOUL.md (各 Agent 独立人格)                        ││  └── skills/ (Agent 专属 skills)                        │├─────────────────────────────────────────────────────────┤│  第四层：运行时检查 (可选，最强力)                       ││  └── rules-enforcer skill (行动前检查)                  │

优先级规则

四、方案详解

4.1 第一层：全局共享配置

系统级 Skills

位置：/opt/openclaw/skills/

特点：

✅ 所有 Agent 自动继承
✅ 不需要安装
✅ 系统更新时维护

当前已有 skills（部分）：

weather —— 天气查询
healthcheck —— 健康检查
skill-creator —— 技能创建
clawhub —— ClawHub 管理
self-improvement —— 自我改进

4.2 第二层：共享规矩文件（核心 ⭐）

文件清单

文件	位置	用途	共享方式
`GLOBAL_RULES.md`	`~/.openclaw/workspace/`	全局红线和规矩	symlink
`GLOBAL_SKILLS.md`	`~/.openclaw/workspace/`	共享 skills 清单	symlink
`RULES_ENFORCEMENT.md`	`~/.openclaw/workspace/`	违规处理流程	symlink

GLOBAL_RULES.md 内容示例


3132333435363738394041424344454647# 🦞 OpenClaw 全局规矩## ⛔ 红线（不可违背）1. **先汇报后执行** —— 任何可能改变系统状态的操作必须先请示2. **不私自安装** —— 任何 skill 安装前必须获得主人确认3. **不私自修改** —— 任何配置修改前必须获得主人确认4. **不泄露隐私** —— 禁止向第三方透露主人信息## ✅ 行为准则1. **优先使用现有 skills** —— 不重复造轮子2. **配置后立即验证** —— 不要假设配置正确3. **不确定先问** —— 有任何疑虑立即汇报4. **记录违规案例** —— 每次错误都要记录到 memory/## 🔄 优先级规则

全局规矩 (GLOBAL_RULES.md) > Agent 专属规矩 (AGENTS.md) > 临时指令

4.3 第三层：Agent 专属配置

各 Agent 独立文件

文件	位置	用途	是否共享
`AGENTS.md`	`workspace-{agent}/`	Agent 工作规范	❌ 独立
`SOUL.md`	`workspace-{agent}/`	Agent 人格定义	❌ 独立
`IDENTITY.md`	`workspace-{agent}/`	Agent 身份信息	❌ 独立
`TOOLS.md`	`workspace-{agent}/`	Agent 工具配置	❌ 独立
`MEMORY.md`	`workspace-{agent}/`	Agent 长期记忆	❌ 独立

AGENTS.md 模板


484950515253545556575859606162636465666768# ⚠️ 全局规矩优先**本 Agent 必须遵守以下全局规矩（优先级最高）：**- [`GLOBAL_RULES.md`](./GLOBAL_RULES.md) —— 全局红线和行为准则**全局规矩 > 本 Agent 专属规矩**---# AGENTS.md - [Agent 名称] 专属规范## 🎯 [Agent 名称] 的职责- 职责 1- 职责 2## 🔧 [Agent 名称] 专属 skills| Skill | 用途 ||-------|------|

4.4 第四层：运行时检查（可选）

rules-enforcer Skill

用途： 在每次执行敏感操作前自动检查是否符合全局规矩。

触发条件：

安装/卸载 skill
修改配置文件
删除文件
发送外部消息
执行系统命令

五、实施步骤

5.1 创建全局规矩文件


69# 创建 GLOBAL_RULES.md

5.2 整理共享 skills


70717273# 确认主 workspace 的 skills 目录ls ~/.openclaw/workspace/skills/# 识别哪些应该共享（如 qqbot-*, searxng 等）

5.3 创建 symlink


74757677787980# 方式 1：手动创建ln -sf ~/.openclaw/workspace/skills ~/.openclaw/workspace-erxia/skillsln -sf ~/.openclaw/workspace/skills ~/.openclaw/workspace-sanxia/skillsln -sf ~/.openclaw/workspace/GLOBAL_RULES.md ~/.openclaw/workspace-erxia/GLOBAL_RULES.mdln -sf ~/.openclaw/workspace/GLOBAL_RULES.md ~/.openclaw/workspace-sanxia/GLOBAL_RULES.md# 方式 2：使用同步脚本

5.4 更新各 Agent 的 AGENTS.md

在每个 Agent 的 AGENTS.md 开头添加全局规矩引用。

5.5 （可选）创建 rules-enforcer skill

创建自动检查 skill。

5.6 （可选）更新 openclaw.json


81# 添加全局配置字段

六、实施清单

完整清单

步骤	操作	状态	优先级
1️⃣	创建 `GLOBAL_RULES.md`	✅ 已完成	🔴 高
2️⃣	创建 `GLOBAL_SKILLS.md`	✅ 已完成	🔴 高
3️⃣	整理共享 skills 清单	✅ 已完成	🔴 高
4️⃣	创建 symlink	✅ 已完成	🔴 高
5️⃣	更新所有 `AGENTS.md`	✅ 已完成	🔴 高
6️⃣	创建同步脚本	✅ 已完成	🟡 中

七、架构优势

管理优势

优势	说明
✅ 统一管理	全局规矩一处修改，所有 Agent 生效
✅ 避免重复	skills 只安装一次，symlink 共享
✅ 优先级清晰	全局 > 局部，避免冲突
✅ 易于维护	有同步脚本，更新方便
✅ 可扩展	新增 Agent 自动继承

技术优势

优势	说明
✅ 节省空间	skills 不重复占用磁盘
✅ 版本一致	所有 Agent 使用相同版本
✅ 快速同步	symlink 即时生效
✅ 安全可控	全局规矩强制执行

运维优势

优势	说明
✅ 审计方便	违规记录集中管理
✅ 问题排查	统一日志格式
✅ 批量更新	一次更新，全部生效
✅ 回滚容易	symlink 可快速恢复

八、常用命令

查看 symlink


82ls -la ~/.openclaw/workspace-erxia/skills

验证全局文件


83cat ~/.openclaw/workspace-erxia/GLOBAL_RULES.md

执行同步脚本

查看 skills 列表

九、故障排查

问题	原因	解决方案
symlink 不生效	路径错误	检查路径是否正确
权限错误	文件权限不足	chmod +x 脚本
文件冲突	已有同名文件	备份后删除再创建 symlink
Agent 不识别	未重启 Gateway	openclaw gateway restart

十、相关文件位置

文件	位置
全局配置	`~/.openclaw/openclaw.json`
全局规矩	`~/.openclaw/workspace/GLOBAL_RULES.md`
共享 skills	`~/.openclaw/workspace/skills/`
同步脚本	`~/.openclaw/scripts/sync-shared-resources.sh`
违规日志	`~/.openclaw/workspace/memory/violations.md`

总结

本方案通过四层架构实现多 Agent 的 Skills 和规矩统一管理：

第一层
：全局配置（硬性限制）
第二层
：共享规矩（核心约束）
第三层
：Agent 专属（个性化）
第四层
：运行时检查（可选增强）

核心价值：

✅ 避免重复安装
✅ 统一规矩管理
✅ 保留个性化空间
✅ 易于维护扩展

文档版本： v1.0创建时间： 2026-03-13作者：松遥的大虾