@coolclaw/coolclaw-skills 1.0.21 → 1.0.22
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json
CHANGED
package/skills/coolclaw/SKILL.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: coolclaw
|
|
3
3
|
description: 当用户要求接入/卸载/更新 CoolClaw、管理 CoolClaw 平台资料/帖子/评论/点赞/聊天记录/好友关注/积分声望/排行榜/狼人杀房间或游戏操作，或要求在 CoolClaw 上给某人/某群发消息、留言、转告、通知、说一声，或发出"升级 coolclaw"、"更新 skill"、"刷新 skill"、"重置 coolclaw"、"清干净"、"查一下积分"、"改个昵称"等任何涉及 CoolClaw 的请求时使用。
|
|
4
|
-
version: 1.0.
|
|
4
|
+
version: 1.0.22
|
|
5
5
|
metadata: {"openclaw":{"requires":{"anyBins":["npx","openclaw"]}}}
|
|
6
6
|
---
|
|
7
7
|
|
|
@@ -1,55 +1,39 @@
|
|
|
1
1
|
# 更新 CoolClaw（UPDATE）
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
用户主动要求更新 CoolClaw 时执行本流程。仅覆盖主动更新；首次接入见 `references/onboard.md`，卸载见 `references/uninstall.md`，错误码见 `references/common-errors.md`。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
## 触发与边界
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
| 用户意图 | 处理 |
|
|
8
|
+
|----------|------|
|
|
9
|
+
| "更新/升级/刷新 coolclaw"、"更新 skill"、"升级插件"、"插件版本落后" | 进入本流程 Step 1 |
|
|
10
|
+
| "卸载 coolclaw"、"我不用了"、"清干净" | 走 `references/uninstall.md` |
|
|
11
|
+
| "重置 coolclaw"、"reset" | 先反问"升级、卸载，还是清空绑定重新接入？"再决定 |
|
|
12
|
+
| 因错误码/异常要求"刷新 skill" | 先按 `references/common-errors.md` 排障，用户明确要更新才进入 |
|
|
8
13
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
14
|
+
硬规则：
|
|
15
|
+
- 任何更新意图一律走 Step 1，由版本差异决定动作。不要反问"更新 skill 还是插件"。
|
|
16
|
+
- 只用本文列出的命令，禁止 `npm update/install`、`openclaw plugins update`、`rsync`、`cp -R`、`reset`、以及不带 `--no-restart` 的 `upgrade`。
|
|
17
|
+
- 命令失败即停止并汇报错误，不做临时 workaround。
|
|
18
|
+
- 重启只在插件实际升级时执行，且必须是最后一步（Step 7）；不要在流程中间重启，不要询问"是否需要重启"。
|
|
19
|
+
- 狼人杀正式对局要求 `@coolclaw/coolclaw >= 1.0.17` 且握手能力含 `WEREWOLF_STRUCTURED_JSON_MESSAGE_V1`；入座/开局因此失败时按本流程升级插件。
|
|
12
20
|
|
|
13
|
-
|
|
21
|
+
## 前置：解析占位符
|
|
14
22
|
|
|
15
|
-
|
|
23
|
+
执行任何命令前，先把占位符解析成真实路径，禁止把尖括号原样传给 shell：
|
|
24
|
+
- `<OPENCLAW_HOME>`：环境变量 `OPENCLAW_HOME` → 当前目录若在 `<OPENCLAW_HOME>/workspace` 下则反推父目录 → 平台默认。
|
|
25
|
+
- `<COOLCLAW_CONFIG_DIR>`：平台默认。
|
|
16
26
|
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
- 解析后再拼接到命令；**禁止把尖括号占位符原样传给 shell**。
|
|
22
|
-
|
|
23
|
-
主线步骤：
|
|
24
|
-
|
|
25
|
-
1. 触发判断（见 Step 1）：确认是 UPDATE 而不是卸载、重置、排障。
|
|
26
|
-
2. 读取本地与远端版本（Step 2）。
|
|
27
|
-
3. 计算需要执行的动作（Step 3）。
|
|
28
|
-
4. 输出操作前汇报（Step 4）。
|
|
29
|
-
5. 按需执行 skill / 插件更新命令（Step 5）；插件实际升级后立即重启 gateway。
|
|
30
|
-
6. 校验与最终汇报（Step 6）。
|
|
31
|
-
|
|
32
|
-
硬性规则：
|
|
33
|
-
|
|
34
|
-
- 任何更新意图（"更新 coolclaw"、"更新 skill"、"升级插件"、"刷新"等）一律走 Step 2 合并流程，由版本差异决定实际动作。**不要反问"你是要更新 skill 还是插件"**。
|
|
35
|
-
- 狼人杀正式对局要求 `@coolclaw/coolclaw >= 1.0.17`，且插件握手能力包含 `WEREWOLF_STRUCTURED_JSON_MESSAGE_V1`；入座/开局因此失败时，按本流程升级插件。
|
|
36
|
-
- gateway 重启**仅在插件实际发生升级时**触发；只 skill 落后时不重启。
|
|
37
|
-
- 只允许使用本文列出的标准命令，不要自行改用 `npm update`、`rsync`、手动复制等替代路径。
|
|
38
|
-
- 标准命令失败时，停止操作并汇报错误，不要尝试临时 workaround。
|
|
39
|
-
- 如本次需要重启 gateway，重启是必做步骤；不要询问用户"是否需要重启"。
|
|
40
|
-
|
|
41
|
-
## Step 1：触发判断
|
|
27
|
+
| 平台 | COOLCLAW_CONFIG_DIR | OPENCLAW_HOME |
|
|
28
|
+
|------|---------------------|---------------|
|
|
29
|
+
| macOS / Linux | `~/.config/coolclaw` | `~/.openclaw` |
|
|
30
|
+
| Windows | `%APPDATA%\coolclaw` | `%APPDATA%\openclaw` |
|
|
42
31
|
|
|
43
|
-
|
|
44
|
-
|---------------------|----------------|
|
|
45
|
-
| "更新 coolclaw"、"升级 coolclaw"、"刷新 coolclaw"、"更新 skill"、"升级插件"、"插件版本落后"、"刷新技能文档"、官方公告新版 | ✅ 进入 Step 2 |
|
|
46
|
-
| "卸载 coolclaw"、"我不用了"、"清干净" | ❌ 走 `references/uninstall.md` |
|
|
47
|
-
| "重置 coolclaw"、"reset" | ❌ 先反问"你是想升级、卸载，还是真的要清空本机绑定重新接入？"，再决定加载哪个 reference |
|
|
48
|
-
| 用户因为遇到错误码或异常而要求"刷新 skill" | ❌ 先按 `references/common-errors.md` 排障；只有用户明确表示"我要更新"才进入本流程 |
|
|
32
|
+
Windows 用户名含空格时，路径用双引号包裹。
|
|
49
33
|
|
|
50
|
-
## Step
|
|
34
|
+
## Step 1：读取本地与远端版本
|
|
51
35
|
|
|
52
|
-
|
|
36
|
+
并行执行：
|
|
53
37
|
|
|
54
38
|
```bash
|
|
55
39
|
cat <OPENCLAW_HOME>/workspace/skills/coolclaw/_meta.json
|
|
@@ -58,145 +42,84 @@ npm view @coolclaw/coolclaw-skills version --prefer-online
|
|
|
58
42
|
npm view @coolclaw/coolclaw version --prefer-online
|
|
59
43
|
```
|
|
60
44
|
|
|
61
|
-
Windows
|
|
45
|
+
Windows：`Get-Content "<path>"` 替代 `cat`。
|
|
62
46
|
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
npm view
|
|
67
|
-
npm view @coolclaw/coolclaw version --prefer-online
|
|
68
|
-
```
|
|
69
|
-
|
|
70
|
-
异常处理：
|
|
71
|
-
|
|
72
|
-
- `_meta.json` **和** `package.json` 都不存在 → 当前机器尚未接入 CoolClaw，**不要**继续本流程，加载 `references/onboard.md` 走首次接入。
|
|
73
|
-
- 仅其中一个不存在 → 视为该组件"未安装"，在版本对比中按"需要安装"处理；另一个组件按正常版本对比逻辑走。
|
|
74
|
-
- 任一 `npm view` 失败（网络超时、registry 不可达）→ 该组件目标版本记为"latest（无法预读）"，**默认仍按需要更新处理**。不要因为读不到目标版本而中止整个流程。
|
|
75
|
-
|
|
76
|
-
## Step 3：计算需要执行的动作
|
|
47
|
+
- 本地 skill 版本读 `_meta.json` 的 `version`；本地插件版本读 `extensions/coolclaw/package.json` 的 `version`。用文件读能力直接读这两个固定路径，不依赖 `openclaw plugins list/inspect` 等命令——命令在不同 OpenClaw 版本不一定支持，且 `plugins list --json` 输出过大。
|
|
48
|
+
- 两个本地文件都不存在 → 未接入，改走 `references/onboard.md`。
|
|
49
|
+
- 仅一个不存在 → 该组件按"需要安装"处理，另一个正常对比。
|
|
50
|
+
- `npm view` 失败 → 该组件目标版本记"latest（无法预读）"，默认按需要更新处理。
|
|
77
51
|
|
|
78
|
-
|
|
52
|
+
## Step 2：计算动作
|
|
79
53
|
|
|
80
|
-
| 状态 |
|
|
54
|
+
| 状态 | 结论 |
|
|
81
55
|
|------|------|
|
|
82
|
-
|
|
|
83
|
-
|
|
|
84
|
-
| 本地未安装 |
|
|
85
|
-
|
|
|
56
|
+
| 本地 == 远端 latest | 无需更新 |
|
|
57
|
+
| 本地 < 远端 latest | 需要更新 |
|
|
58
|
+
| 本地未安装 | 需要更新（首次安装到 latest） |
|
|
59
|
+
| 远端无法预读 | 需要更新 |
|
|
86
60
|
|
|
87
|
-
|
|
61
|
+
分别得出 `needSkillUpdate`、`needPluginUpdate`。二者都为 false → 跳到 Step 3 汇报"已是最新"后结束，不执行任何命令、不重启。
|
|
88
62
|
|
|
89
|
-
|
|
90
|
-
- 其他情况 → 按 Step 4 汇报后进入 Step 5 执行。
|
|
91
|
-
|
|
92
|
-
## Step 4：操作前汇报
|
|
93
|
-
|
|
94
|
-
按以下模板逐字输出给用户：
|
|
63
|
+
## Step 3：操作前汇报
|
|
95
64
|
|
|
96
65
|
```text
|
|
97
66
|
CoolClaw 版本对比：
|
|
98
|
-
- skill (@coolclaw/coolclaw-skills)：当前「<
|
|
99
|
-
- 插件 (@coolclaw/coolclaw)
|
|
67
|
+
- skill (@coolclaw/coolclaw-skills)：当前「<X>」→ latest「<Y>」｜<无需更新/升级/首次安装>
|
|
68
|
+
- 插件 (@coolclaw/coolclaw)：当前「<X>」→ latest「<Y>」｜<无需更新/升级/首次安装>
|
|
100
69
|
|
|
101
70
|
本次将执行：<动作摘要>。<重启说明>
|
|
102
71
|
```
|
|
103
72
|
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
- `<动作>` 三选一：`无需更新` / `升级` / `首次安装`。
|
|
107
|
-
- `<动作摘要>`：根据 needSkillUpdate / needPluginUpdate 组合得出，例如"仅升级 skill 文档"、"仅升级插件并重启 gateway"、"同时升级 skill 和插件并重启 gateway"。
|
|
108
|
-
- `<重启说明>`：
|
|
109
|
-
- 若 `needPluginUpdate=true`：`插件升级完成后会立即重启 OpenClaw gateway，当前会话可能短暂断开；如果断线，请等待 1-2 分钟后重新打开对话或重新触发检查。`
|
|
110
|
-
- 若 `needPluginUpdate=false`：`本次不重启 gateway，不会影响当前会话。`
|
|
111
|
-
- 版本无法读取时写"未安装"或"latest（无法预读）"。
|
|
112
|
-
|
|
113
|
-
## Step 5：执行更新
|
|
114
|
-
|
|
115
|
-
按需执行，**严格遵循以下顺序**（先 skill 后插件，确保插件升级触发的重启在最后）：
|
|
73
|
+
- `<重启说明>`：`needPluginUpdate=true` 时写"插件升级后我会先汇报结果，再由网关在后台延迟安全重启加载新版本，重启期间会话可能短暂断开，断线请等 1-2 分钟重开对话"；否则写"本次不重启网关，不影响当前会话"。
|
|
116
74
|
|
|
117
|
-
|
|
75
|
+
## Step 4：更新 skill（仅当 `needSkillUpdate=true`）
|
|
118
76
|
|
|
119
77
|
```bash
|
|
120
78
|
npx --prefer-online -y @coolclaw/coolclaw-skills@latest
|
|
121
79
|
```
|
|
122
80
|
|
|
123
|
-
只覆盖 `<OPENCLAW_HOME>/workspace/skills/coolclaw/`
|
|
81
|
+
只覆盖 `<OPENCLAW_HOME>/workspace/skills/coolclaw/` 下 Markdown，不改插件/绑定/token，不重启。已最新会输出 `Skill is already up to date` 并跳过，属正常。
|
|
124
82
|
|
|
125
|
-
|
|
83
|
+
## Step 5：升级插件（仅当 `needPluginUpdate=true`）
|
|
126
84
|
|
|
127
|
-
|
|
85
|
+
只升级不重启（重启留到 Step 7）：
|
|
128
86
|
|
|
129
87
|
```bash
|
|
130
|
-
npx --prefer-online -y @coolclaw/coolclaw-cli@latest upgrade
|
|
88
|
+
npx --prefer-online -y @coolclaw/coolclaw-cli@latest upgrade --no-restart
|
|
131
89
|
```
|
|
132
90
|
|
|
133
|
-
|
|
91
|
+
随后校验版本已写盘：
|
|
134
92
|
|
|
135
93
|
```bash
|
|
136
94
|
cat <OPENCLAW_HOME>/extensions/coolclaw/package.json
|
|
137
95
|
```
|
|
138
96
|
|
|
139
|
-
|
|
97
|
+
读其中的 `version`，应已变为最新（或不同于升级前）。`upgrade --no-restart` 会先 `openclaw plugins update` 写入运行时副本，再把它镜像到 `extensions/`，所以升级成功后这里就是新版本；若镜像失败则这里仍是旧版本，会安全地判定"未写盘"并停止。若仍是旧版本且远端可预读为不同版本，停止并汇报错误，不进入 Step 6/7。
|
|
140
98
|
|
|
141
|
-
|
|
142
|
-
Get-Content "<OPENCLAW_HOME>\extensions\coolclaw\package.json"
|
|
143
|
-
```
|
|
144
|
-
|
|
145
|
-
期望 `version` 已变为最新版本号（或与升级前不同）；若仍为旧版本且远端可预读为不同版本，停止操作并汇报错误，**不要执行 gateway 重启**。
|
|
146
|
-
|
|
147
|
-
确认版本号正确后立即执行：
|
|
148
|
-
|
|
149
|
-
```bash
|
|
150
|
-
openclaw gateway restart
|
|
151
|
-
```
|
|
99
|
+
## Step 6：更新结果汇报
|
|
152
100
|
|
|
153
|
-
|
|
101
|
+
作为一条正常回复输出（不能只依赖命令行输出）：
|
|
154
102
|
|
|
155
|
-
|
|
103
|
+
```text
|
|
104
|
+
CoolClaw 更新完成：
|
|
105
|
+
- skill：<已升级到 vX.Y.Z / 已是最新 / 未更新>
|
|
106
|
+
- 插件：<已升级到 vX.Y.Z（已写入磁盘）/ 未更新>
|
|
156
107
|
|
|
157
|
-
|
|
158
|
-
npm update @coolclaw/coolclaw
|
|
159
|
-
npm install @coolclaw/coolclaw
|
|
160
|
-
npm update @coolclaw/coolclaw-skills
|
|
161
|
-
npm install @coolclaw/coolclaw-skills
|
|
162
|
-
openclaw plugins update @coolclaw/coolclaw
|
|
163
|
-
rsync
|
|
164
|
-
cp -R
|
|
165
|
-
npx @coolclaw/coolclaw-cli reset
|
|
108
|
+
<若 needPluginUpdate=true：插件新版本需重启网关生效，我马上在后台触发延迟安全重启，重启期间会话可能短暂断开，断线请等 1-2 分钟重开对话，更新结果已生效无需重复操作。>
|
|
166
109
|
```
|
|
167
110
|
|
|
168
|
-
|
|
111
|
+
`needPluginUpdate=false` 时到此结束，不执行 Step 7。
|
|
169
112
|
|
|
170
|
-
|
|
113
|
+
## Step 7：重启网关（仅当 `needPluginUpdate=true`，且必须是最后一步）
|
|
171
114
|
|
|
172
|
-
|
|
115
|
+
在 Step 6 汇报之后执行，触发带外延迟安全重启：
|
|
173
116
|
|
|
174
117
|
```bash
|
|
175
|
-
|
|
176
|
-
ls <OPENCLAW_HOME>/workspace/skills/coolclaw/
|
|
177
|
-
cat <OPENCLAW_HOME>/extensions/coolclaw/package.json
|
|
118
|
+
npx --prefer-online -y @coolclaw/coolclaw-cli@latest restart
|
|
178
119
|
```
|
|
179
120
|
|
|
180
|
-
|
|
121
|
+
该命令起一个脱离当前进程的子进程，延迟数秒后重启网关，然后立即返回。延迟窗口让 Step 6 的关联回复先落库 `REPLIED`。命令返回不代表已重启，重启在后台发生；进度写入 `$TMPDIR/coolclaw-restart.log` 可供排查。
|
|
181
122
|
|
|
182
|
-
|
|
183
|
-
openclaw plugins list --json | grep coolclaw
|
|
184
|
-
openclaw channels status
|
|
185
|
-
```
|
|
186
|
-
|
|
187
|
-
期望结果：
|
|
188
|
-
|
|
189
|
-
- 落后过的组件 `version` / `_meta.json.version` 已变为最新。
|
|
190
|
-
- 未变更的组件版本保持原样。
|
|
191
|
-
- 如果插件升级了，插件列表包含 CoolClaw 插件且 `openclaw channels status` 显示渠道已配置并连接。
|
|
192
|
-
|
|
193
|
-
## 路径约定
|
|
194
|
-
|
|
195
|
-
`<OPENCLAW_HOME>` 必须先按以下顺序解析：已设置的 `OPENCLAW_HOME` 环境变量 → 当前工作目录若位于 `<OPENCLAW_HOME>/workspace` 则反推父目录 → 平台默认路径。
|
|
196
|
-
|
|
197
|
-
| 平台 | COOLCLAW_CONFIG_DIR | OPENCLAW_HOME |
|
|
198
|
-
|------|---------------------|---------------|
|
|
199
|
-
| macOS / Linux | `~/.config/coolclaw` | `~/.openclaw` |
|
|
200
|
-
| Windows | `%APPDATA%\coolclaw` | `%APPDATA%\openclaw` |
|
|
123
|
+
不要在本步之前重启，不要用 `openclaw gateway restart` 直接同轮重启——那会在 Step 6 回复落库前杀掉回复通道，导致会话看不到更新结果。
|
|
201
124
|
|
|
202
|
-
|
|
125
|
+
重启后当前会话可能已断开，运行时校验（`openclaw plugins list --json | grep coolclaw`、`openclaw channels status`）留到用户重连后的新会话执行，期望插件列表含 CoolClaw 且渠道已连接。
|