OpenClaw 多 Agent 共享 Skills 和规矩管理方案

🦞 OpenClaw 多 Agent 共享 Skills 和规矩管理方案

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

版本：v1.0 | 创建时间：2026-03-13

一、背景与需求

为什么需要这个方案？

在多 Agent 环境中（如大虾、二虾、三虾），我们遇到了这些问题：

重复安装 skills —— 每个 Agent 独立安装相同 skill，浪费空间、维护困难

规矩不统一 —— 各 Agent 规矩不一致，行为不可预测

配置分散 —— 配置散落在各 workspace，难以统一管理

更新不同步 —— 更新一个 Agent 忘记更新其他，版本不一致

核心需求

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

二、完整方案：四层架构

我们设计了四层架构来管理多 Agent 的 Skills 和规矩：

第一层：全局共享配置（强制遵守）

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 行动前检查

优先级规则

第一层（全局配置）大于第二层（共享规矩）大于第三层（Agent 专属）大于临时指令

三、方案详解

第一层：全局共享配置

系统级 Skills 位置： /opt/openclaw/skills/

特点：

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

当前已有 skills（部分）：

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

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

文件清单：

GLOBAL_RULES.md 位于 ~/.openclaw/workspace/，用于全局红线和规矩，通过 symlink 共享
GLOBAL_SKILLS.md 位于 ~/.openclaw/workspace/，用于共享 skills 清单，通过 symlink 共享
RULES_ENFORCEMENT.md 位于 ~/.openclaw/workspace/，用于违规处理流程，通过 symlink 共享

GLOBAL_RULES.md 核心内容：

红线（不可违背）：

先汇报后执行 —— 任何可能改变系统状态的操作必须先请示
不私自安装 —— 任何 skill 安装前必须获得主人确认
不私自修改 —— 任何配置修改前必须获得主人确认
不泄露隐私 —— 禁止向第三方透露主人信息

行为准则：

优先使用现有 skills —— 不重复造轮子
配置后立即验证 —— 不要假设配置正确
不确定先问 —— 有任何疑虑立即汇报
记录违规案例 —— 每次错误都要记录到 memory/

GLOBAL_SKILLS.md 核心内容：

共享 Skills 列表分为三类：

通信类：

qqbot-cron 位于 ~/.openclaw/workspace/skills/qqbot-cron，用于 QQ 定时任务
qqbot-media 位于 ~/.openclaw/workspace/skills/qqbot-media，用于 QQ 媒体发送
telegram-utils 位于 ~/.openclaw/workspace/skills/telegram-utils，用于 Telegram 工具

工具类：

searxng 位于 ~/.openclaw/workspace/skills/searxng，用于隐私搜索
weather 位于 /opt/openclaw/skills/weather，天气查询，系统内置
healthcheck 位于 /opt/openclaw/skills/healthcheck，健康检查，系统内置

内容类：

proactive-agent 位于 ~/.openclaw/workspace/skills/proactive-agent，用于主动代理
self-improvement 位于 /opt/openclaw/skills/self-improvement，自我改进，系统内置

安装和管理方法：

安装共享 skill（仅主 workspace）：

cd ~/.openclaw/workspace
clawhub install

验证 symlink：

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

更新共享 skill：

在主 workspace 更新
cd ~/.openclaw/workspace
clawhub update
symlink 自动生效，无需额外操作

注意事项：

只安装一次 —— 在主 workspace 安装即可
不要重复安装 —— 各 Agent workspace 不要重复安装相同 skill
更新统一 —— 更新时只更新主 workspace，symlink 自动生效
专属 skills —— Agent 专属 skills 放在各自 workspace/skills/ 目录

Skills 分类说明：

系统内置：/opt/openclaw/skills/，所有 Agent 自动可用，例如 weather、healthcheck

共享用户：~/.openclaw/workspace/skills/，symlink 共享，例如 qqbot-*、searxng

Agent 专属：~/.openclaw/workspace-{agent}/skills/，仅该 Agent 可用，例如 feishu-custom

第三层：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 长期记忆，不共享
memory/ 位于 workspace-{agent}/，Agent 日常记忆，不共享
skills/ 位于 workspace-{agent}/，Agent 专属 skills，不共享

AGENTS.md 模板（添加全局引用）：

所有 Agent 的 AGENTS.md 开头添加：

全局规矩优先

本 Agent 必须遵守以下全局规矩（优先级最高）：

GLOBAL_RULES.md —— 全局红线和行为准则
GLOBAL_SKILLS.md —— 共享 skills 清单

全局规矩大于本 Agent 专属规矩

违反全局规矩的行为将被记录并报告主人

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

rules-enforcer Skill 位置： ~/.openclaw/workspace/skills/rules-enforcer/SKILL.md

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

触发条件：

以下操作前必须检查：

安装/卸载 skill（clawhub install/uninstall）
修改配置文件（openclaw config set）
删除文件（rm, trash）
发送外部消息（message, email）
执行系统命令（exec）

检查流程：

读取 GLOBAL_RULES.md
检查操作是否在 requireApprovalFor 列表中
如需要审批，检查是否有主人确认
记录检查日志到 memory/violations.md
如违规，阻止操作并报告主人

四、实施步骤

步骤 1：创建全局规矩文件

创建 GLOBAL_RULES.md
创建 GLOBAL_SKILLS.md
创建 RULES_ENFORCEMENT.md（可选）

步骤 2：整理共享 skills

确认主 workspace 的 skills 目录
ls ~/.openclaw/workspace/skills/
识别哪些应该共享（如 qqbot-*、searxng 等）
记录到 GLOBAL_SKILLS.md

步骤 3：创建 symlink

方式 1：手动创建

ln -sf ~/.openclaw/workspace/skills ~/.openclaw/workspace-erxia/skills
ln -sf ~/.openclaw/workspace/skills ~/.openclaw/workspace-sanxia/skills
ln -sf ~/.openclaw/workspace/GLOBAL_RULES.md ~/.openclaw/workspace-erxia/GLOBAL_RULES.md
ln -sf ~/.openclaw/workspace/GLOBAL_RULES.md ~/.openclaw/workspace-sanxia/GLOBAL_RULES.md

方式 2：使用同步脚本

~/.openclaw/scripts/sync-shared-skills.sh

步骤 4：更新各 Agent 的 AGENTS.md

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

步骤 5：（可选）创建 rules-enforcer skill

创建自动检查 skill

步骤 6：（可选）更新 openclaw.json

添加全局配置字段
openclaw config set agents.defaults.globalRulesPath "/home/admin/.openclaw/workspace/GLOBAL_RULES.md"
openclaw config set agents.defaults.sharedSkillsPath "/home/admin/.openclaw/workspace/skills"

五、实施清单

完整清单

步骤 1：创建 GLOBAL_RULES.md，优先级高，预计 10 分钟

步骤 2：创建 GLOBAL_SKILLS.md，优先级高，预计 15 分钟

步骤 3：整理共享 skills 清单，优先级高，预计 10 分钟

步骤 4：创建 symlink（skills + 规矩文件），优先级高，预计 5 分钟

步骤 5：更新所有 AGENTS.md（添加全局引用），优先级高，预计 15 分钟

步骤 6：创建 sync-shared-skills.sh 脚本，优先级中，预计 10 分钟

步骤 7：（可选）创建 rules-enforcer skill，优先级低，预计 20 分钟

步骤 8：（可选）更新 openclaw.json，优先级中，预计 5 分钟

总计：约 90 分钟（核心功能 55 分钟）

核心功能（立即执行）

创建 GLOBAL_RULES.md
创建 GLOBAL_SKILLS.md
创建 symlink
更新所有 AGENTS.md

优化功能（后续执行）

创建同步脚本
创建 rules-enforcer skill
更新 openclaw.json

六、架构优势

管理优势

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

技术优势

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

运维优势

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

七、常用命令

查看 symlink：

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

验证全局文件：

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

执行同步脚本：

~/.openclaw/scripts/sync-shared-skills.sh

查看 skills 列表：

ls ~/.openclaw/workspace/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-skills.sh
违规日志：~/.openclaw/workspace/memory/violations.md

十、总结

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

第一层：全局配置（硬性限制）

第二层：共享规矩（核心约束）

第三层：Agent 专属（个性化）

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

核心价值：

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

文档版本：v1.0创建时间：2026-03-13作者：松遥的大虾审核：待主人确认