baozang-activator 1.2.2 → 1.2.3

package/OPENCLAW.md

@@ -0,0 +1,170 @@
+# OpenClaw 使用说明（baozang-activator）
+
+本文档专门说明 `baozang-activator` 对 OpenClaw 的安装、配置、验证、卸载与常见问题处理。
+
+## 1) 快速开始（推荐）
+
+```bash
+# 一键安装 + 配置 OpenClaw（生产环境）
+npx -y baozang-activator@latest -t openclaw <你的key或卡密>
+```
+
+执行后会自动完成：
+- 安装 OpenClaw（调用官方安装脚本）
+- 配置 provider / key / model（`gpt5.4`）
+- 启动网关并校验状态
+- 打开浏览器（自动使用带 token 的 Dashboard 链接）
+- 预装常见 skills（默认开启）
+
+## 2) 平台安装脚本（官方）
+
+`baozang-activator` 内部按平台调用官方安装方式：
+
+### macOS / Linux
+```bash
+curl -fsSL https://openclaw.ai/install.sh | bash
+```
+
+### Windows CMD
+```cmd
+curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
+```
+
+### Windows PowerShell
+```powershell
+iwr -useb https://openclaw.ai/install.ps1 | iex
+```
+
+## 3) 配置写入规则（重点）
+
+默认接入参数：
+- provider: `https://www.baozangaizhongzhuan.net/`
+- OpenAI 兼容 endpoint: `https://www.baozangaizhongzhuan.net/v1`
+- model: `gpt5.4`
+
+配置时会通过 `openclaw config set` 修改 OpenClaw 配置，关键字段：
+- `models.providers.baozang`
+- `agents.defaults.model.primary = "baozang/gpt5.4"`
+- `gateway.mode = "local"`
+
+配置完成后执行：
+- `openclaw config validate --json`
+- `openclaw gateway start`（必要时安装/重启网关服务）
+
+查看当前配置文件路径：
+
+```bash
+openclaw config file
+```
+
+## 4) Dashboard token 与浏览器跳转
+
+新版本会优先执行：
+
+```bash
+openclaw dashboard --no-open
+```
+
+并从输出中提取带 `#token=...` 的 URL 去打开浏览器，避免出现：
+
+`unauthorized: gateway token missing`
+
+如果你手动打开浏览器，建议使用：
+
+```bash
+openclaw dashboard
+```
+
+或
+
+```bash
+openclaw dashboard --no-open
+```
+
+复制输出的完整 URL（带 `#token=`）访问。
+
+## 5) 预装 skills（默认）
+
+默认会预装：
+- `xiaohongshu`
+- `zhihu`
+- `wechat-official`
+- `douyin-script`
+
+如需跳过预装：
+
+```bash
+npx -y baozang-activator@latest -t openclaw <key> --openclaw-skip-skills
+```
+
+## 6) 干净卸载（含 CLI 命令）
+
+### 交互式（会询问）
+```bash
+npx -y baozang-activator@latest --openclaw-uninstall
+```
+
+### 非交互一条命令
+```bash
+npx -y baozang-activator@latest --openclaw-uninstall -y --openclaw-remove-workspace --openclaw-remove-config --openclaw-remove-cli
+```
+
+说明：
+- `--openclaw-remove-workspace`：删除工作区
+- `--openclaw-remove-config`：删除配置/状态
+- `--openclaw-remove-cli`：删除全局 `openclaw` 命令
+
+卸载后会自动校验：
+- 若要求删除 CLI，则校验 `openclaw` 命令已不存在
+- 否则校验网关已停止
+
+## 7) 常见问题
+
+### Q1: `baozang-activator：未找到命令`
+你执行了 `npm install baozang-activator-test@x.y.z`（本地安装），不会创建全局命令。  
+请改用：
+
+```bash
+npx -y baozang-activator@latest --help
+```
+
+或全局安装：
+
+```bash
+npm i -g baozang-activator@latest
+baozang-activator --help
+```
+
+### Q2: 卸载后为什么 `openclaw` 还能用？
+通常是机器上有多个安装来源（如 npm / pnpm / yarn / 其他路径）。先定位：
+
+```bash
+which -a openclaw
+```
+
+Windows：
+
+```powershell
+where openclaw
+```
+
+逐个路径清理后再验证。
+
+### Q3: 安装后提示 PATH 缺失
+如果提示 npm 全局 bin 不在 PATH，重开终端后仍不生效时，请把对应路径加入 shell 配置（如 `~/.bashrc` / `~/.zshrc`），再 `source` 生效。
+
+## 8) 验证清单
+
+安装后建议至少执行一次：
+
+```bash
+openclaw --version
+openclaw gateway status
+openclaw dashboard --no-open
+```
+
+卸载后建议验证：
+
+```bash
+command -v openclaw || echo "openclaw removed"
+```

package/README.md

@@ -35,7 +35,7 @@ npm i -g baozang-activator@latest
 ```bash
 baozang-activator -v
 ```
-应显示：`1.2.1`（或更高）
+应显示：`1.2.3`（或更高）
 
 ### 3) 重新执行激活（会刷新本地 auth.json）
 ```bash
@@ -230,6 +230,9 @@ npx baozang-activator --openclaw-uninstall --openclaw-remove-workspace --opencla
 
 卸载完成后会自动校验网关状态，并打开浏览器到卸载说明页面。
 
+OpenClaw 详细说明与常见问题：
+- `./OPENCLAW.md`
+
 ## 命令行选项
 
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "baozang-activator",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "description": "API 激活工具 (生产环境 - baozangaizhongzhuan.net)",
   "main": "lib/index.js",
   "bin": {