openclawsetup 2.5.4 → 2.8.1
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/README.md +74 -0
- package/bin/cli.mjs +1402 -280
- package/package.json +1 -1
- package//344/275/277/347/224/250/350/257/264/346/230/216.md +73 -1
package/README.md
CHANGED
|
@@ -70,11 +70,85 @@ npx openclawsetup@latest --auto
|
|
|
70
70
|
| `--auto` | 强制自动模式（不可用则退出） |
|
|
71
71
|
| `--with-model` | 检测到模型配置时暂停自动选择 |
|
|
72
72
|
| `--with-channel` | 检测到渠道配置时暂停自动选择 |
|
|
73
|
+
| `--optimize-token` | 一键优化输入 token（记忆/召回瘦身） |
|
|
74
|
+
| `--strong` | 与 `--check/--fix` 组合，启用强力检查策略 |
|
|
75
|
+
| `--strong-fix` | 直接执行强力检查修复（多轮深度修复） |
|
|
76
|
+
| `--collect-evidence` / `--evidence` | 一键导出脱敏排障证据包（给技术支持） |
|
|
77
|
+
| `--evidence-quick` | 快速证据包（跳过深度检查） |
|
|
73
78
|
| `--update` | 检查并更新已安装的 OpenClaw |
|
|
74
79
|
| `--reinstall` | 卸载后重新安装（清除配置） |
|
|
75
80
|
| `--uninstall` | 卸载 OpenClaw |
|
|
76
81
|
| `--help, -h` | 显示帮助信息 |
|
|
77
82
|
|
|
83
|
+
## 强力修复模式（极致检查/修复）
|
|
84
|
+
|
|
85
|
+
```bash
|
|
86
|
+
# 一步进入强力修复（推荐）
|
|
87
|
+
npx openclawsetup@latest --strong-fix
|
|
88
|
+
|
|
89
|
+
# 或在常规命令上叠加强力策略
|
|
90
|
+
npx openclawsetup@latest --fix --strong
|
|
91
|
+
npx openclawsetup@latest --check --strong
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
强力模式会额外执行：
|
|
95
|
+
- 多轮检查修复（最多 3 轮）
|
|
96
|
+
- CLI 命令损坏自动恢复（含重装、重试、多源 registry）
|
|
97
|
+
- 配置文件损坏自动备份并重建
|
|
98
|
+
- 端口冲突自动寻找可用端口并切换
|
|
99
|
+
- Gateway 启停链路强恢复（start/restart/stop+start）
|
|
100
|
+
- 官方 `doctor --fix` + onboard 深度回收
|
|
101
|
+
- 模型连通性探测（检测到异常会给出明确修复入口）
|
|
102
|
+
|
|
103
|
+
管理菜单也提供 `3. 强力检查修复`。
|
|
104
|
+
|
|
105
|
+
## Token 优化（降低每次输入 token）
|
|
106
|
+
|
|
107
|
+
```bash
|
|
108
|
+
# 命令行直接执行
|
|
109
|
+
npx openclawsetup@latest --optimize-token
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
也可在菜单里显式选择：
|
|
113
|
+
- `4. Token 优化（降低输入 token）`
|
|
114
|
+
|
|
115
|
+
默认会自动优化：
|
|
116
|
+
- `memory.collections.conversations.retention_days = 14`
|
|
117
|
+
- `memory.collections.conversations.max_entries = 2000`
|
|
118
|
+
- `memory.collections.conversations.summarize_threshold = 25`
|
|
119
|
+
- `memory.retrieval.default_limit = 4`
|
|
120
|
+
- `memory.retrieval.similarity_threshold = 0.82`
|
|
121
|
+
|
|
122
|
+
脚本会先备份原配置，再写入新配置并尝试重启 Gateway。
|
|
123
|
+
|
|
124
|
+
## 给小白用户的一键取证（推荐客服话术）
|
|
125
|
+
|
|
126
|
+
可直接复制发送给用户：
|
|
127
|
+
|
|
128
|
+
```text
|
|
129
|
+
请复制执行：npx openclawsetup@latest --collect-evidence，完成后把桌面上 openclaw-evidence-... 文件夹或 .tar.gz 发给我即可。
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
让用户只执行一条命令：
|
|
133
|
+
|
|
134
|
+
```bash
|
|
135
|
+
npx openclawsetup@latest --collect-evidence
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
脚本会自动：
|
|
139
|
+
- 收集环境、状态、端口、health、doctor、gateway logs
|
|
140
|
+
- 自动脱敏 token / apiKey / bearer / URL token 参数
|
|
141
|
+
- 生成证据目录（默认在桌面）
|
|
142
|
+
- 自动打包为 `.tar.gz`（macOS/Linux）
|
|
143
|
+
|
|
144
|
+
你只需要让用户把生成的目录或压缩包发回来即可。
|
|
145
|
+
|
|
146
|
+
若用户机器性能较弱，可用快速模式：
|
|
147
|
+
|
|
148
|
+
```bash
|
|
149
|
+
npx openclawsetup@latest --evidence-quick
|
|
150
|
+
```
|
|
151
|
+
|
|
78
152
|
## 使用示例
|
|
79
153
|
|
|
80
154
|
### 默认安装（智能模式）
|