@yyy9527/openclaw-manager 0.1.2 → 0.2.1

package/README.md

@@ -3,7 +3,7 @@
 面向 macOS 的 OpenClaw 多实例部署与协作编排脚手架，支持：
 
 - 一键环境初始化与非交互安装
-- `npm run` 统一管理
+- `clawctl` 命令统一管理
 - TUI 交互
 - 飞书通知适配
 - 多实例隔离与统一命名规范
@@ -20,53 +20,52 @@
 ## 2. 快速开始
 
 ```bash
+npm i -g @yyy9527/openclaw-manager
 cp config/openclaw.env.example config/openclaw.env
 cp .env.example .env
-npm run setup
-npm run deploy
-npm run status
-npm run help
+clawctl setup
+clawctl deploy
+clawctl status
+clawctl --help
 ```
 
-> 首次执行 `npm run deploy` 需要拉取官方镜像，可能耗时较长（取决于网络）。
+> 首次执行 `clawctl deploy` 需要拉取官方镜像，可能耗时较长（取决于网络）。
 > clawhub 在 macOS 安装后，只有把 skills 安装到 `OPENCLAW_HOME_ROOT` 可见目录并挂载到容器，才能持久化并在容器内生效。
 
 ## 3. 常用命令
 
-- `npm run help`：查看友好的 CLI 帮助
-- `npm run setup`：初始化环境（幂等）
-- `npm run deploy`：按配置启动全部实例
-- `npm run start` / `npm run stop` / `npm run restart`
-- `npm run status`：查看实例状态
-- `npm run list:claw`：列出当前配置的 claw 名称
-- `npm run start:claw -- <name>`：启动指定实例
-- `npm run stop:claw -- <name>`：停止指定实例
-- `npm run status:claw -- <name>`：查看指定实例状态
-- `npm run logs:claw -- <name>`：查看指定实例日志
-- `npm run logs`：查看日志
-- `npm run tui`：进入终端交互界面
-- `npm run tui:claw -- <name>`：进入指定容器内 OpenClaw 的对话 TUI
-- `npm run clawhub:login`：登录 clawhub，避免匿名限流影响 skills 安装
-- `npm run check-env`：检查你是否已补齐关键 `.env` 变量
-- `npm run sync-skills`：创建共享/专属 skills 目录，并优先通过 clawhub 搜索安装
-- `npm run sync-model-configs`：将各实例家目录的 `model.env` 同步到各自 `openclaw.json`
-- `npm run apply-config`：配置变更后统一生效（先同步模型配置，再重启）
-- `npm run bootstrap-models`：显式覆盖为 Ollama（需先开启覆盖开关）
-- `npm run set-model:qwen`：非交互切换到厂商 Qwen（DashScope/OpenAI 兼容）
-- `npm run health-check`：检查 Docker / Gitee 令牌与仓库 / 飞书配置可用性
-- `npm run self-test`：执行基础自测
+- `clawctl --help`：查看友好的 CLI 帮助
+- `clawctl setup`：初始化环境（幂等）
+- `clawctl deploy`：按配置启动全部实例
+- `clawctl start|stop|restart|status`
+- `clawctl list-claw`：列出当前配置的 claw 名称
+- `clawctl start-claw <name>`：启动指定实例
+- `clawctl stop-claw <name>`：停止指定实例
+- `clawctl status-claw <name>`：查看指定实例状态
+- `clawctl logs-claw <name>`：查看指定实例日志
+- `clawctl logs`：查看日志
+- `clawctl tui`：进入终端交互界面
+- `clawctl chat-claw <name>`：进入指定容器内 OpenClaw 的对话 TUI
+- `clawctl check-env`：检查你是否已补齐关键 `.env` 变量
+- `clawctl sync-skills`：创建共享/专属 skills 目录，并优先通过 clawhub 搜索安装
+- `clawctl sync-model-configs`：将各实例家目录的 `model.env` 同步到各自 `openclaw.json`
+- `clawctl apply-config`：配置变更后统一生效（先同步模型配置，再重启）
+- `clawctl bootstrap-models`：显式覆盖为 Ollama（需先开启覆盖开关）
+- `clawctl set-qwen`：非交互切换到厂商 Qwen（DashScope/OpenAI 兼容）
+- `clawctl health-check`：检查 Docker / Gitee 令牌与仓库 / 飞书配置可用性
+- `clawctl self-test`：执行基础自测
 
 ## 3.1 `--help` 与配置文件切换
 
 脚本入口支持统一全局参数：
 
 ```bash
-openclaw-manager --help
-openclaw-manager --config ./config/openclaw.dev.env status
-openclaw-manager --config ./config/openclaw.prod.env --env-file ./.env.prod apply-config
+clawctl --help
+clawctl --config ./config/openclaw.dev.env status
+clawctl --config ./config/openclaw.prod.env --env-file ./.env.prod apply-config
 ```
 
-如果通过 `npm run` 使用，也可以把参数透传给底层脚本（注意 `--`）：
+如果在仓库开发态通过 `npm run` 使用，也可以把参数透传给底层脚本（注意 `--`）：
 
 ```bash
 npm run ctl -- --config ./config/openclaw.dev.env status
@@ -97,9 +96,9 @@ npm run ctl -- --config ./config/openclaw.prod.env --env-file ./.env.prod apply-
 
 > `clawhub` 通过 `pnpm` 安装（`pnpm add -g clawhub`）。  
 > `sync-skills` 会先尝试安装 `find-skills`，再按检索词搜索最佳匹配并安装；遇到超时会自动重试。
-> 若出现 `Rate limit exceeded`，请先执行 `npm run clawhub:login` 再重试 `npm run sync-skills`。
-> 如果 TUI 报 `No API key found for provider "anthropic"`，先执行 `npm run apply-config`。该命令会重启容器并引导默认模型到 `ollama/qwen3.5:27b`。
-> 如果 TUI 报 `not connected to gateway`，通常是网关刚重启尚未就绪；`tui:claw` 现已内置等待逻辑，超时可执行 `npm run apply-config` 后重试。
+> 若出现 `Rate limit exceeded`，请先执行 `clawhub login` 再重试 `clawctl sync-skills`。
+> 如果 TUI 报 `No API key found for provider "anthropic"`，先执行 `clawctl apply-config`。
+> 如果 TUI 报 `not connected to gateway`，通常是网关刚重启尚未就绪；`chat-claw` 内置等待逻辑，超时可执行 `clawctl apply-config` 后重试。
 
 ### 非交互切换到厂商 Qwen
 
@@ -110,11 +109,11 @@ npm run ctl -- --config ./config/openclaw.prod.env --env-file ./.env.prod apply-
 2. 执行：
 
 ```bash
-npm run set-model:qwen
+clawctl set-qwen
 ```
 
 该命令会自动为每个实例写入 `~/openclaws/{instance}/model.env`，再同步到家目录 `openclaw.json`。  
-最终通过 `npm run apply-config` 重启生效，无需交互式 `openclaw configure`。
+最终通过 `clawctl apply-config` 重启生效，无需交互式 `openclaw configure`。
 
 你也可以按实例准备模板（可选）：
 
@@ -192,4 +191,4 @@ npm login
 npm publish --access public
 ```
 
-> 当前建议包名：`@yyy9527/openclaw-manager`。若需组织统一命名，可改为你的团队 scope。
+> 当前包名：`@yyy9527/openclaw-manager`。CLI 主命令为 `clawctl`。

package/package.json

@@ -1,12 +1,11 @@
 {
   "name": "@yyy9527/openclaw-manager",
-  "version": "0.1.2",
+  "version": "0.2.1",
   "description": "OpenClaw multi-instance manager for macOS with docker, TUI, and collaboration workflow.",
   "private": false,
   "license": "MIT",
   "type": "module",
   "bin": {
-    "openclaw-manager": "./scripts/openclaw_ctl.sh",
     "clawctl": "./scripts/openclaw_ctl.sh"
   },
   "files": [

package/scripts/openclaw_ctl.sh

@@ -14,7 +14,7 @@ usage() {
 OpenClaw Manager CLI（多实例运维入口）
 
 用法:
-  openclaw-manager [--config <path>] [--env-file <path>] <command> [args]
+  clawctl [--config <path>] [--env-file <path>] <command> [args]
 
 全局参数:
   -h, --help             显示帮助
@@ -40,8 +40,8 @@ OpenClaw Manager CLI（多实例运维入口）
   self-test
 
 示例:
-  openclaw-manager --config ./config/openclaw.dev.env status
-  openclaw-manager --env-file ./.env.prod start-claw master
+  clawctl --config ./config/openclaw.dev.env status
+  clawctl --env-file ./.env.prod start-claw master
 EOF
 }
 
@@ -122,7 +122,7 @@ chat_with_claw() {
   local running_service
   running_service="$(run_compose_for_instance "${claw_name}" ps --status running --services 2>/dev/null | awk 'NF{print $1; exit}')"
   if [ "${running_service}" != "openclaw" ]; then
-    echo "实例 ${claw_name} 当前未运行，请先执行: npm run start-claw -- ${claw_name}" >&2
+    echo "实例 ${claw_name} 当前未运行，请先执行: clawctl start-claw ${claw_name}" >&2
     exit 1
   fi
 
@@ -131,7 +131,7 @@ chat_with_claw() {
   until run_compose_for_instance "${claw_name}" exec -T openclaw sh -lc 'openclaw health >/dev/null 2>&1'; do
     waited=$((waited + 2))
     if [ "${waited}" -ge "${max_wait}" ]; then
-      echo "实例 ${claw_name} 网关尚未就绪（等待 ${max_wait}s 超时）。可先执行: npm run apply-config" >&2
+      echo "实例 ${claw_name} 网关尚未就绪（等待 ${max_wait}s 超时）。可先执行: clawctl apply-config" >&2
       exit 1
     fi
     sleep 2
@@ -269,7 +269,7 @@ case "${command}" in
     ;;
   chat-claw)
     claw_name="${2:-}"
-    [ -n "${claw_name}" ] || { echo "用法: openclaw-manager chat-claw <name>" >&2; exit 1; }
+    [ -n "${claw_name}" ] || { echo "用法: clawctl chat-claw <name>" >&2; exit 1; }
     chat_with_claw "${claw_name}"
     ;;
   status-claw)