问题现象
skillagent 的 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 内置包
后续维护建议
- 新增 skill：放到
~/skill/skills/下，自动对所有 agent 可见 - 更新 skill：修改源文件后各 agent 自动获取最新版本（无需逐个同步）
- 备份配置：
~/.openclaw/openclaw.json现已成为基础设施配置，建议纳入版本控制
 agent和组件)