乐于分享
好东西不私藏

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

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

OpenClaw 多 Agent 统一管理方案

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


一、问题场景

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

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

核心需求:

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

二、当前架构分析

目录结构

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.mdworkspace-{agent}/
Agent 工作规范
❌ 独立
SOUL.mdworkspace-{agent}/
Agent 人格定义
❌ 独立
IDENTITY.mdworkspace-{agent}/
Agent 身份信息
❌ 独立
TOOLS.mdworkspace-{agent}/
Agent 工具配置
❌ 独立
MEMORY.mdworkspace-{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

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

触发条件:

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

五、实施步骤

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 和规矩统一管理:

  1. 第一层
    :全局配置(硬性限制)
  2. 第二层
    :共享规矩(核心约束)
  3. 第三层
    :Agent 专属(个性化)
  4. 第四层
    :运行时检查(可选增强)

核心价值:

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

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