无尘阁日记

无尘阁日记

执行自制skills的脚本(mac+windows)
2026-04-02

先回答你最关心的:

一、已有 AGENTS.md 会不会被覆盖

不要直接覆盖。

我给你的两份脚本都做了这件事:

  1. 先备份你当前 workspace 根目录里的 AGENTS.md

  2. 再把“医药根因分析自动执行程序”作为一个受管区块插入进去

  3. 如果这个受管区块以后已经存在,就只更新这一个区块

  4. 你原来写在 AGENTS.md 里的其他规则,保留不动

这样最稳。
因为 OpenClaw 的 agent 会读取 workspace 根目录里的 AGENTS.md,而 workspace 默认是 ~/.openclaw/workspace,但也可以改;如果你用了 --profile,状态目录也会变成 ~/.openclaw-<name> 这一类路径,所以脚本也支持你传入自定义 workspace。(OpenClaw)


二、我已经给你生成好了 3 个文件

Mac 部署脚本:
deploy_openclaw_root_cause_mac.sh

Windows 一键部署脚本:
deploy_openclaw_root_cause_windows.ps1

执行说明:
openclaw_root_cause_script_usage.md

你之前的技能包继续用这个:
openclaw_root_cause_skills_v3.zip


三、怎么执行

Mac 版

先把 zip 解压。
假设你把技能包解压到了:

~/Downloads/openclaw_root_cause_skills_v3

然后运行:

bash ~/Downloads/deploy_openclaw_root_cause_mac.sh ~/Downloads/openclaw_root_cause_skills_v3 ~/.openclaw/workspace

如果你的 workspace 不是默认路径,就把最后一个参数换成你的实际路径。

这个脚本会自动做这些事:

  • 创建 skills/

  • 创建 inbox/root-cause/

  • 创建 reports/root-cause/

  • 创建 logs/root-cause/

  • 部署 5 个 skill

  • 备份并合并 AGENTS.md

  • 尝试重启 gateway

  • 尝试执行 openclaw skills list

OpenClaw 官方文档里,skills 放在 workspace 里是标准做法;AGENTS.md 在 workspace 根目录生效;新 skill 最稳的刷新方式是开新会话或重启 gateway。(OpenClaw)

Windows 版

先把 zip 解压。
然后打开 PowerShell,先执行:

Set-ExecutionPolicy -Scope Process Bypass

再执行:

powershell -ExecutionPolicy Bypass -File C:\path\to\deploy_openclaw_root_cause_windows.ps1 -PackageDir C:\path\to\openclaw_root_cause_skills_v3 -WorkspaceDir $HOME\.openclaw\workspace

把上面的路径替换成你的真实路径即可。


四、部署完成后怎么验证

1)检查 skills 是否加载

openclaw skills list

如果你刚部署完但列表没刷新,先执行:

openclaw gateway restart

因为官方文档明确建议,新 skill 生效时,开新会话或重启 gateway 更稳。(OpenClaw)

2)手动拖文件测试

把一个医药 Excel 扔进 OpenClaw 对话窗口,发这句:

开始根因分析。先做医药行业识别,不是医药文件就直接拒绝;是医药文件就自动完成后续全部分析并保存报告。

3)结果看哪里

报告目录:

<workspace>/reports/root-cause/

日志目录:

<workspace>/logs/root-cause/

待分析文件目录:

<workspace>/inbox/root-cause/

五、后面如果你要加定时任务

OpenClaw 有内置 cron;隔离任务默认会 announce,想只在后台跑、不往主对话推送,可以用 --no-deliver。(OpenClaw)

你部署完成后,可以再加一个定时任务,例如每天早上 8:30 扫目录:

openclaw cron add \
  --name "Pharma Root Cause Scan" \
  --cron "30 8 * * *" \
  --tz "Asia/Shanghai" \
  --session isolated \
  --message "按 AGENTS.md 中的医药根因分析自动执行程序执行:扫描 inbox/root-cause/ 中最新未处理 Excel;先做医药行业识别,若判定为非医药行业则拒绝执行并把原因写入 logs/root-cause/;若通过则完成完整根因分析,并把管理层摘要和完整报告写入 reports/root-cause/。" \
  --no-deliver