问题现象

skill agent 的 workspace 下有 5 个自定义 skills（ppt-intro、ppt-report、ppt-solution、ppt-tech、ys-collector），但其他 agent（如 xtao）无法使用。

根因分析

原因	说明
工作域隔离	OpenClaw 默认只在各 agent 自己的 workspace 下扫描 skills/ 目录
符号链接不识别	ln -s 创建的软链接会被技能扫描器忽略
配置权限受限	skills.load.extraDirs 属于受保护路径，无法通过 gateway config.patch/apply 热更新

最终方案：全局共享目录 (skills.load.extraDirs)

配置位置： ~/.openclaw/openclaw.json

关键配置：

复制

{
  "skills": {
    "entries": { ... },
    "load": {
      "extraDirs": [
        "/home/linuxbrew/skill/skills"
      ]
    }
  }
}

作用： 指定额外的 skill 扫描根目录，所有 agent 在启动时都会自动加载该目录下的 skills，无需在每个 workspace 单独复制。

---

操作步骤回顾

步骤	命令/操作
1. 备份配置	cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak-xxx
2. 编辑配置	在 skills 同级添加 "load": { "extraDirs": ["/home/linuxbrew/skill/skills"] }
3. 验证 JSON	python3 -m json.tool ~/.openclaw/openclaw.json > /dev/null
4. 重启 Gateway	openclaw gateway restart
5. 验证生效	各 agent 执行 openclaw skills list 查看 Source 为 openclaw-extra

---

各方案对比

方案	可行？	优点	缺点
符号链接 (ln -s)	❌	省空间	OpenClaw 不识别软链接
硬拷贝 (cp -r)	✅	立即生效	各 agent 独立副本，更新需逐个同步
全局 extraDirs	✅✅	一处更新，全局生效	需编辑配置文件并重启

---

验证结果

所有 8 个 agent 现在共享这 5 个 skills：

Skill	用途	状态（各 agent）
ppt-intro	行业介绍PPT生成	✓ ready
ppt-report	工作汇报PPT生成	✓ ready
ppt-solution	解决方案交流PPT生成	✓ ready
ppt-tech	IT技术交流PPT生成	✓ ready
ys-collector	友商产品信息采集器	✓ ready

Source 标识说明：

• openclaw-extra = 来自 extraDirs 全局共享
• openclaw-workspace = agent 本地 workspace 目录
• openclaw-bundled = OpenClaw 内置包

---

后续维护建议

1. 新增 skill：放到 ~/skill/skills/ 下，自动对所有 agent 可见
2. 更新 skill：修改源文件后各 agent 自动获取最新版本（无需逐个同步）
3. 备份配置：~/.openclaw/openclaw.json 现已成为基础设施配置，建议纳入版本控制