@workclaw/cli 1.0.315 → 1.0.317

package/README.md

@@ -52,12 +52,14 @@ workclaw box
 **适用场景**：个人电脑或需要用户登录的设备
 
 **特点**：
+
 - ✅ 需要用户登录（手机号 + 密码）
 - ✅ 自动获取 appKey 和 appSecret
 - ✅ 支持多账号管理
 - ✅ 自动创建和管理配置
 
 **安装流程**：
+
 1. 用户登录（RSA 加密密码）
 2. 获取绑定配置
 3. 通过手机号补全配置
@@ -69,12 +71,14 @@ workclaw box
 **适用场景**：专用设备或无需用户登录的环境
 
 **特点**：
+
 - ✅ 无需登录（直接使用 appKey + appSecret）
 - ✅ 适合批量部署
 - ✅ 配置文件默认设置为开放策略
 - ✅ 更快的安装速度
 
 **安装流程**：
+
 1. 清理旧版本插件
 2. 下载并安装插件
 3. 更新配置文件（`dmPolicy: "open"`）
@@ -96,25 +100,27 @@ npx @workclaw/cli --help
 
 ### local 命令参数
 
-| 参数               | 说明                                      |
-| --------------- | --------------------------------------- |
-| --phone         | 手机号码（登录账号），未填写时会交互式提示输入         |
-| --user-pass     | 用户密码，未填写时会交互式提示输入                 |
-| --env           | 环境 (test/prod)，默认 test，未填写时会交互式提示选择 |
+| 参数               | 说明                                  |
+| ---------------- | ----------------------------------- |
+| --phone          | 手机号码（登录账号），未填写时会交互式提示输入             |
+| --user-pass      | 用户密码，未填写时会交互式提示输入                   |
+| --env            | 环境 (test/prod/custom)，默认 test，未填写时会交互式提示选择 |
+| --customIp       | 自定义环境后端 IP，仅当 env 为 custom 时使用 |
 | --plugin-version | 插件版本号（默认安装最新版）                      |
-| --openclaw-path | OpenClaw 安装目录（默认 ~/.openclaw）         |
-| --debug         | 开启调试日志                               |
+| --openclaw-path  | OpenClaw 安装目录（默认 \~/.openclaw）      |
+| --debug          | 开启调试日志                              |
 
 ### box 命令参数
 
-| 参数               | 说明                                      |
-| --------------- | --------------------------------------- |
-| --app-key       | App Key，未填写时会交互式提示输入                  |
-| --app-secret    | App Secret，未填写时会交互式提示输入             |
-| --env           | 环境 (test/prod)，默认 test，未填写时会交互式提示选择 |
+| 参数               | 说明                                  |
+| ---------------- | ----------------------------------- |
+| --app-key        | App Key，未填写时会交互式提示输入                |
+| --app-secret     | App Secret，未填写时会交互式提示输入             |
+| --env            | 环境 (test/prod/custom)，默认 test，未填写时会交互式提示选择 |
+| --customIp       | 自定义环境后端 IP，仅当 env 为 custom 时使用 |
 | --plugin-version | 插件版本号（默认安装最新版）                      |
-| --openclaw-path | OpenClaw 安装目录（默认 ~/.openclaw）         |
-| --debug         | 开启调试日志                               |
+| --openclaw-path  | OpenClaw 安装目录（默认 \~/.openclaw）      |
+| --debug          | 开启调试日志                              |
 
 ## 💡 使用示例
 
@@ -125,16 +131,25 @@ npx @workclaw/cli --help
 npx @workclaw/cli local
 
 # 指定手机号和密码
-npx @workclaw/cli local --phone 18111657826 --user-pass yourpassword
+npx @workclaw/cli local --phone your_phone --user-pass your_password
 
 # 指定正式环境
-npx @workclaw/cli local --env prod --phone 18111657826 --user-pass yourpassword
+npx @workclaw/cli local --env prod --phone your_phone --user-pass your_password
 
 # 自定义安装路径
-npx @workclaw/cli local --openclaw-path "C:\CustomPath\OpenClaw" --phone 18111657826 --user-pass yourpassword
+npx @workclaw/cli local --openclaw-path "C:\CustomPath\OpenClaw" --phone your_phone --user-pass your_password
 
 # 开启调试模式
-npx @workclaw/cli local --debug --phone 18111657826 --user-pass yourpassword
+npx @workclaw/cli local --debug --phone your_phone --user-pass your_password
+
+# 自定义环境（使用本地后端服务）
+npx @workclaw/cli local --env custom --phone your_phone --user-pass your_password
+
+# 自定义环境（命令行直接传入 IP）
+npx @workclaw/cli local --env custom --customIp 192.168.1.100:32005 --phone your_phone --user-pass your_password
+
+# 自定义环境（带协议完整地址）
+npx @workclaw/cli local --env custom --customIp http://127.0.0.1:32005 --phone your_phone --user-pass your_password
 ```
 
 ### 盒子设备安装
@@ -154,6 +169,12 @@ npx @workclaw/cli box --openclaw-path "/custom/path" --app-key your-app-key --ap
 
 # 开启调试模式
 npx @workclaw/cli box --debug --app-key your-app-key --app-secret your-app-secret
+
+# 自定义环境（使用本地后端服务）
+npx @workclaw/cli box --env custom --app-key your-app-key --app-secret your-app-secret
+
+# 自定义环境（命令行直接传入 IP）
+npx @workclaw/cli box --env custom --customIp 192.168.1.100:32005 --app-key your-app-key --app-secret your-app-secret
 ```
 
 ## 🔧 技术实现
@@ -164,11 +185,9 @@ npx @workclaw/cli box --debug --app-key your-app-key --app-secret your-app-secre
    - 使用 `npm pack` 从 npm 镜像源下载插件包
    - 默认使用腾讯云 npm 镜像：`https://mirrors.tencent.com/npm/`
    - 支持重试机制（最多 3 次）
-
 2. **文件解压**
    - 使用 `tar.extract()` 解压到目标目录
    - 自动创建必要的目录结构
-
 3. **依赖安装**
    - 使用 `npm install --omit=dev` 安装生产依赖
    - 自动跳过开发依赖，减小安装体积
@@ -190,6 +209,7 @@ npx @workclaw/cli box --debug --app-key your-app-key --app-secret your-app-secre
 ### 路径验证
 
 工具会自动验证用户输入的 `--openclaw-path` 参数：
+
 - ✅ 必须是绝对路径
 - ✅ 不能包含非法字符：`< > : " | ? *`
 
@@ -198,35 +218,52 @@ npx @workclaw/cli box --debug --app-key your-app-key --app-secret your-app-secre
 ### Q: 安装失败，提示"网络错误"？
 
 **A**: 检查网络连接，可以尝试：
+
 - 使用代理或 VPN
 - 配置 npm 镜像源：`npm config set registry https://registry.npmmirror.com`
 
 ### Q: 提示"路径必须是绝对路径"？
 
 **A**: `--openclaw-path` 需要使用绝对路径，例如：
+
 - Windows: `C:\OpenClaw` 或 `C:/OpenClaw`
 - Linux/macOS: `/opt/openclaw`
 
 ### Q: 如何查看详细日志？
 
 **A**: 使用 `--debug` 参数：
+
 ```bash
-npx @workclaw/cli local --debug --phone 18111657826 --user-pass yourpassword
+npx @workclaw/cli local --debug --phone your_phone --user-pass your_password
 ```
 
 ### Q: 如何指定插件版本？
 
 **A**: 使用 `--plugin-version` 参数：
+
 ```bash
-npx @workclaw/cli local --plugin-version 1.0.100 --phone 18111657826 --user-pass yourpassword
+npx @workclaw/cli local --plugin-version 1.0.100 --phone your_phone --user-pass your_password
 ```
 
 ### Q: local 和 box 命令有什么区别？
 
-**A**: 
+**A**:
+
 - **local**: 需要用户登录，适合个人设备，支持多账号
 - **box**: 无需登录，直接使用 appKey+appSecret，适合专用设备
 
+### Q: 什么是自定义环境（custom）？
+
+**A**:
+
+自定义环境允许你连接到自己本地或私有部署的后端服务，适合前后端联调测试场景。使用方式：
+
+1. 选择 `custom` 环境
+2. 输入你的后端 IP 地址（支持 `192.168.1.100:32005` 或 `http://127.0.0.1:32005` 格式）
+3. 工具会自动适配协议和路径
+
+`MODEL_BASE_URL` 始终保持为固定值，不会随自定义环境改变。
+
 ## 🛠 开发
 
 ### 项目结构
@@ -267,6 +304,14 @@ pnpm lint:fix
 
 ## 📝 更新日志
 
+### v1.0.314 (2026-04-27)
+
+- ✨ 新增自定义环境（custom）- 支持连接私有部署后端服务
+- 🔧 新增 `--customIp` 参数 - 命令行直接传入自定义后端 IP
+- 🎨 优化交互体验 - 仅选择 custom 环境时才提示输入 IP
+- 📝 更新文档 - 添加自定义环境使用说明和示例
+- 🔒 `MODEL_BASE_URL` 保持固定，不随自定义环境改变
+
 ### v1.0.313 (2026-04-23)
 
 - ✨ 新增 `--openclaw-path` 参数 - 支持自定义安装路径
@@ -306,3 +351,4 @@ MIT License
 - [ora](https://github.com/sindresorhus/ora) - 加载动画
 - [axios](https://github.com/axios/axios) - HTTP 客户端
 - [tar](https://github.com/isaacs/node-tar) - tar 文件解压
+

package/dist/box/error/index.d.ts

@@ -11,6 +11,7 @@ export declare const ERROR_CODES: {
     readonly CONFIG_WRITE_FAILED: "CONFIG_WRITE_FAILED";
     readonly PLUGIN_EXTRACT_FAILED: "PLUGIN_EXTRACT_FAILED";
     readonly INVALID_OPENCLAW_PATH: "INVALID_OPENCLAW_PATH";
+    readonly INVALID_ARGUMENT: "INVALID_ARGUMENT";
 };
 export type ErrorCode = keyof typeof ERROR_CODES;
 /**

package/dist/box/error/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/box/error/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;CAUd,CAAA;AAEV,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,WAAW,CAAA;AAEhD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAUpD,CAAA;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IAExB,IAAI,EAAE,SAAS;gBAAf,IAAI,EAAE,SAAS,EACtB,OAAO,EAAE,MAAM;CAKlB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUlD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/box/error/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;CAWd,CAAA;AAEV,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,WAAW,CAAA;AAEhD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAWpD,CAAA;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IAExB,IAAI,EAAE,SAAS;gBAAf,IAAI,EAAE,SAAS,EACtB,OAAO,EAAE,MAAM;CAKlB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUlD"}

package/dist/box/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/box/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGxC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAUvD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/box/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGxC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAYvD"}

package/dist/box/installer/installer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../../src/box/installer/installer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAgB,MAAM,UAAU,CAAA;AAqDhE,qBAAa,YAAY;IAIX,OAAO,CAAC,MAAM;IAH1B,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,UAAU,CAAa;gBAEX,MAAM,EAAE,kBAAkB;IAI9C,cAAc,IAAI,IAAI;IAatB,OAAO,CAAC,QAAQ;IAiChB,OAAO,CAAC,aAAa;IAMrB,aAAa,IAAI,MAAM;IAIvB,OAAO,CAAC,cAAc;IAOhB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YA0BhB,eAAe;YA0Bf,iBAAiB;YAoHjB,cAAc;CAiR7B"}
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../../src/box/installer/installer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAgB,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAsDhE,qBAAa,YAAY;IAIX,OAAO,CAAC,MAAM;IAH1B,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,UAAU,CAAa;gBAEX,MAAM,EAAE,kBAAkB;IAI9C,cAAc,IAAI,IAAI;IAyBtB,OAAO,CAAC,QAAQ;IAkChB,OAAO,CAAC,aAAa;IAMrB,aAAa,IAAI,MAAM;IAIvB,OAAO,CAAC,cAAc;IAOhB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YA0BhB,eAAe;YA0Bf,iBAAiB;YAoHjB,cAAc;CAiR7B"}

package/dist/box/src/box.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"box.d.ts","sourceRoot":"","sources":["../../../src/box/src/box.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAgC1C,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAuHzE"}
+{"version":3,"file":"box.d.ts","sourceRoot":"","sources":["../../../src/box/src/box.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAgC1C,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAoJzE"}

package/dist/box/types/index.d.ts

@@ -3,13 +3,15 @@ export interface BoxOptions {
     env?: string;
     appKey?: string;
     appSecret?: string;
+    customIp?: string;
+    wsUrl?: string;
     pluginVersion?: string;
     openclawPath?: string;
     debug?: boolean;
 }
 export interface BoxInstallerConfig {
     env: Environment;
-    baseUrl?: string;
+    customIp?: string;
     wsUrl?: string;
     appKey: string;
     appSecret: string;

package/dist/box/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/box/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAElD,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,WAAW,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;CACb"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/box/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAElD,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,WAAW,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;CACb"}

package/dist/{index-CkTwizLH.js → index-B5TYzGeQ.js}

@@ -8,6 +8,7 @@ import boxen from "boxen";
 import chalk from "chalk";
 import inquirer from "inquirer";
 import semver from "semver";
+import { z as z$1 } from "zod";
 import fs from "node:fs/promises";
 import tar from "tar";
 import ora from "ora";
@@ -34,13 +35,17 @@ function validateOpenclawPath(openclawPath) {
   }
   debugLog(`[路径验证] 通过: ${openclawPath}`);
 }
+const ipv4Schema = z$1.ipv4({
+  message: "请输入正确的 IP 地址格式，例如: 192.168.1.100"
+});
 const ERROR_CODES$1 = {
   APP_KEY_REQUIRED: "APP_KEY_REQUIRED",
   APP_SECRET_REQUIRED: "APP_SECRET_REQUIRED",
   NODE_VERSION_LOW: "NODE_VERSION_LOW",
   NPM_NOT_FOUND: "NPM_NOT_FOUND",
   NPM_INSTALL_FAILED: "NPM_INSTALL_FAILED",
-  INVALID_OPENCLAW_PATH: "INVALID_OPENCLAW_PATH"
+  INVALID_OPENCLAW_PATH: "INVALID_OPENCLAW_PATH",
+  INVALID_ARGUMENT: "INVALID_ARGUMENT"
 };
 let AppError$1 = class AppError extends Error {
   constructor(code, message) {
@@ -89,8 +94,27 @@ const TEST_CONFIG = {
     TIMEOUT: 1e4
   }
 };
-function getConfig(env) {
-  return env === "test" ? TEST_CONFIG : CONFIG;
+function getConfig(env, customIp) {
+  if (env === "test") {
+    return TEST_CONFIG;
+  }
+  if (env === "custom") {
+    if (!customIp) {
+      throw new Error("自定义环境必须提供 customIp");
+    }
+    const replaceIp = (url) => url.replace("172.168.80.30", customIp);
+    return {
+      ...TEST_CONFIG,
+      DEFAULT_BASE_URL: replaceIp(TEST_CONFIG.DEFAULT_BASE_URL),
+      DEFAULT_WS_URL: replaceIp(TEST_CONFIG.DEFAULT_WS_URL),
+      API: {
+        ...TEST_CONFIG.API,
+        TUZAI_BASE_URL: replaceIp(TEST_CONFIG.API.TUZAI_BASE_URL),
+        BASE_URL: replaceIp(TEST_CONFIG.API.BASE_URL)
+      }
+    };
+  }
+  return CONFIG;
 }
 function getHomeDir$1() {
   return process$1.env.HOME || process$1.env.USERPROFILE || "";
@@ -135,10 +159,22 @@ class BoxInstaller {
     if (!this.config.appSecret) {
       throw new AppError$1(ERROR_CODES$1.APP_SECRET_REQUIRED, "AppSecret 不能为空，请使用 --app-secret 参数");
     }
+    if (this.config.env === "custom") {
+      debugLog("[验证配置] 检查自定义环境 IP...");
+      if (!this.config.customIp) {
+        throw new AppError$1(ERROR_CODES$1.INVALID_ARGUMENT, "自定义环境必须提供 --customIp 参数");
+      }
+      const result = ipv4Schema.safeParse(this.config.customIp);
+      if (!result.success) {
+        throw new AppError$1(ERROR_CODES$1.INVALID_ARGUMENT, result.error.issues[0].message);
+      }
+      debugLog("[验证配置] 自定义环境 IP 验证通过");
+    }
     debugLog("[验证配置] 配置检查通过");
   }
   getPaths() {
-    const config = getConfig(this.config.env);
+    const env = this.config.env || "test";
+    const config = getConfig(env, this.config.customIp);
     let baseDir;
     if (this.config.openclawPath) {
       debugLog(`[路径验证] 验证自定义路径: ${this.config.openclawPath}`);
@@ -473,7 +509,7 @@ class BoxInstaller {
           // 应用密钥
           appSecret: this.config.appSecret,
           // API 基础 URL
-          baseUrl: this.config.baseUrl || config.DEFAULT_BASE_URL,
+          baseUrl: this.config.customIp || config.DEFAULT_BASE_URL,
           // WebSocket URL
           websocketUrl: this.config.wsUrl || config.DEFAULT_WS_URL,
           // 允许不安全的 TLS 连接
@@ -594,13 +630,14 @@ function checkEnv$1() {
 async function createBoxCommand(options) {
   setDebug(!!options.debug);
   debugLog("[盒子安装] 开始处理...");
-  debugLog(`[盒子安装] 参数: env=${options.env}, appKey=${options.appKey ? "***" : "未提供"}, debug=${options.debug}`);
+  debugLog(`[盒子安装] 参数: env=${options.env}, appKey=${options.appKey ? "***" : "未提供"}, customIp=${options.customIp}, debug=${options.debug}`);
   checkEnv$1();
   debugLog("[盒子安装] 环境检查通过");
   try {
     let env = options.env;
     let appKey = options.appKey;
     let appSecret = options.appSecret;
+    let customIp = options.customIp;
     const questions = [];
     if (!env) {
       debugLog("[盒子安装] 需要选择环境");
@@ -611,7 +648,8 @@ async function createBoxCommand(options) {
         default: "test",
         choices: [
           { name: `${chalk.green("测试环境")} ${chalk.dim("(test)")}`, value: "test" },
-          { name: `${chalk.red("正式环境")} ${chalk.dim("(prod)")}`, value: "prod" }
+          { name: `${chalk.red("正式环境")} ${chalk.dim("(prod)")}`, value: "prod" },
+          { name: `${chalk.yellow("自定义环境")} ${chalk.dim("(custom) - 需要输入后端 IP")}`, value: "custom" }
         ]
       });
     } else {
@@ -657,12 +695,37 @@ async function createBoxCommand(options) {
       appKey = appKey || answers.appKey;
       appSecret = appSecret || answers.appSecret;
     }
-    debugLog(`[盒子安装] 最终参数: env=${env}, openclawPath=${options.openclawPath}`);
+    if (env === "custom" && !customIp) {
+      debugLog("[盒子安装] 自定义环境需要输入后端 IP");
+      const answer = await inquirer.prompt([{
+        type: "input",
+        name: "customIp",
+        message: chalk.cyan("请输入后端 IP:"),
+        default: "127.0.0.1",
+        validate: (value) => {
+          if (!value || value.trim() === "") {
+            return chalk.red("后端 IP 不能为空");
+          }
+          const result = ipv4Schema.safeParse(value);
+          if (!result.success) {
+            return chalk.yellow(result.error.issues[0].message);
+          }
+          return true;
+        }
+      }]);
+      customIp = answer.customIp;
+      debugLog("[盒子安装] 获取自定义 customIp");
+    } else if (env === "custom" && customIp) {
+      debugLog(`[盒子安装] 使用命令行参数: customIp=${customIp}`);
+    }
+    debugLog(`[盒子安装] 最终参数: env=${env}, customIp=${customIp}, openclawPath=${options.openclawPath}`);
     debugLog("[盒子安装] 创建 BoxInstaller 实例...");
     const installer = new BoxInstaller({
       appKey,
       appSecret,
       env,
+      customIp,
+      wsUrl: options.wsUrl,
       pluginVersion: options.pluginVersion,
       openclawPath: options.openclawPath
     });
@@ -699,7 +762,7 @@ async function createBoxCommand(options) {
   }
 }
 function registerCommands$1(program2) {
-  program2.command("box").description("盒子设备安装（无需登录）").option("-e, --env <env>", "环境 (test/prod)").option("--app-key <appKey>", "App Key").option("--app-secret <appSecret>", "App Secret").option("--plugin-version <plugin-version>", "插件版本号（默认最新版）").option("--openclaw-path <path>", "OpenClaw 安装目录路径（默认 ~/.openclaw）").option("--debug", "开启调试日志").action(createBoxCommand);
+  program2.command("box").description("盒子设备安装（无需登录）").option("-e, --env <env>", "环境 (test/prod/custom)").option("--app-key <appKey>", "App Key").option("--app-secret <appSecret>", "App Secret").option("--base-url <url>", "自定义后端基础 URL（仅 custom 环境生效）").option("--ws-url <url>", "自定义 WebSocket URL（仅 custom 环境生效，默认自动从 base-url 转换）").option("--plugin-version <plugin-version>", "插件版本号（默认最新版）").option("--openclaw-path <path>", "OpenClaw 安装目录路径（默认 ~/.openclaw）").option("--debug", "开启调试日志").action(createBoxCommand);
 }
 const ERROR_CODES = {
   PHONE_REQUIRED: "PHONE_REQUIRED",
@@ -713,7 +776,8 @@ const ERROR_CODES = {
   CONFIG_WRITE_FAILED: "CONFIG_WRITE_FAILED",
   HTTP_ERROR: "HTTP_ERROR",
   NETWORK_ERROR: "NETWORK_ERROR",
-  INVALID_OPENCLAW_PATH: "INVALID_OPENCLAW_PATH"
+  INVALID_OPENCLAW_PATH: "INVALID_OPENCLAW_PATH",
+  INVALID_ARGUMENT: "INVALID_ARGUMENT"
 };
 class AppError2 extends Error {
   constructor(code, message) {
@@ -4778,6 +4842,17 @@ class LocalInstaller {
     if (!this.config.userPass) {
       throw new AppError2(ERROR_CODES.USER_PASS_REQUIRED, "用户密码不能为空，请使用 --user-pass 参数");
     }
+    if (this.config.env === "custom") {
+      debugLog("[验证配置] 检查自定义环境 IP...");
+      if (!this.config.customIp) {
+        throw new AppError2(ERROR_CODES.INVALID_ARGUMENT, "自定义环境必须提供 --customIp 参数");
+      }
+      const result = ipv4Schema.safeParse(this.config.customIp);
+      if (!result.success) {
+        throw new AppError2(ERROR_CODES.INVALID_ARGUMENT, result.error.issues[0].message);
+      }
+      debugLog("[验证配置] 自定义环境 IP 验证通过");
+    }
     debugLog("[验证配置] 配置验证通过");
   }
   async install() {
@@ -4785,7 +4860,7 @@ class LocalInstaller {
       debugLog("[安装开始]");
       this.validateConfig();
       const env = this.config.env || "test";
-      const config = getConfig(env);
+      const config = getConfig(env, this.config.customIp);
       let baseDir;
       if (this.config.openclawPath) {
         debugLog(`[路径验证] 验证自定义路径: ${this.config.openclawPath}`);
@@ -4813,8 +4888,8 @@ class LocalInstaller {
       debugLog(`[路径配置] target=${paths.target}`);
       debugLog(`[路径配置] config=${paths.config}`);
       debugLog(`[路径配置] workspace=${paths.workspace}`);
-      const token = await this.doLogin(env);
-      const boundConfig = await this.doFetchBoundConfig(env, token);
+      const token = await this.doLogin();
+      const boundConfig = await this.doFetchBoundConfig(token);
       await this.doCleanOldFiles(paths.target);
       await this.doDownloadFromNpm(paths);
       await this.doUpdateConfig(paths, boundConfig, env);
@@ -4833,7 +4908,8 @@ class LocalInstaller {
     }
     return PLUGIN_PACKAGE_NAME;
   }
-  async doLogin(env) {
+  async doLogin() {
+    const env = this.config.env || "test";
     this.spinner.prefixText = this.prefixText;
     this.spinner.text = chalk.cyan("正在验证账号...");
     debugLog(`[用户登录] 手机号: ${this.config.phone}`);
@@ -4850,7 +4926,8 @@ class LocalInstaller {
     debugLog("[用户登录] 登录成功");
     return token;
   }
-  async doFetchBoundConfig(env, token) {
+  async doFetchBoundConfig(token) {
+    const env = this.config.env || "test";
     this.spinner.prefixText = this.prefixText;
     this.spinner.text = chalk.cyan("正在获取绑定信息...");
     debugLog("[获取配置] 调用绑定配置接口...");
@@ -4988,7 +5065,7 @@ class LocalInstaller {
     } catch {
       debugLog("[更新配置] 无原有配置");
     }
-    const config = getConfig(env);
+    const config = getConfig(env, this.config.customIp);
     const newConfig = {
       // diagnostics: 诊断配置
       diagnostics: {
@@ -5084,7 +5161,7 @@ class LocalInstaller {
           connectionMode: "websocket",
           appKey: boundConfig.appKey,
           appSecret: boundConfig.appSecret,
-          baseUrl: this.config.baseUrl || config.DEFAULT_BASE_URL,
+          baseUrl: this.config.customIp || config.DEFAULT_BASE_URL,
           websocketUrl: this.config.wsUrl || config.DEFAULT_WS_URL,
           allowInsecureTls: true,
           allowRawJsonPayload: true,
@@ -5180,13 +5257,14 @@ function checkEnv() {
 async function createLocalCommand(options) {
   setDebug(!!options.debug);
   debugLog("[初始化] 开始处理...");
-  debugLog(`[初始化] 参数: env=${options.env}, phone=${options.phone}, debug=${options.debug}`);
+  debugLog(`[初始化] 参数: env=${options.env}, phone=${options.phone}, customIp=${options.customIp}, debug=${options.debug}`);
   checkEnv();
   debugLog("[初始化] 环境检查通过");
   try {
     let env = options.env;
     let phone = options.phone;
     let userPass = options.userPass;
+    let customIp = options.customIp;
     const questions = [];
     if (!env) {
       debugLog("[初始化] 需要选择环境");
@@ -5197,7 +5275,8 @@ async function createLocalCommand(options) {
         default: "test",
         choices: [
           { name: `${chalk.green("测试环境")} ${chalk.dim("(test)")}`, value: "test" },
-          { name: `${chalk.red("正式环境")} ${chalk.dim("(prod)")}`, value: "prod" }
+          { name: `${chalk.red("正式环境")} ${chalk.dim("(prod)")}`, value: "prod" },
+          { name: `${chalk.yellow("自定义环境")} ${chalk.dim("(custom) - 需要输入后端 IP")}`, value: "custom" }
         ]
       });
     } else {
@@ -5246,12 +5325,37 @@ async function createLocalCommand(options) {
       phone = phone || answers.phone;
       userPass = userPass || answers.userPass;
     }
-    debugLog(`[初始化] 最终参数: env=${env}, phone=${phone}, pluginVersion=${options.pluginVersion}, openclawPath=${options.openclawPath}`);
+    if (env === "custom" && !customIp) {
+      debugLog("[初始化] 自定义环境需要输入后端 IP");
+      const answer = await inquirer.prompt([{
+        type: "input",
+        name: "customIp",
+        message: chalk.cyan("请输入后端 IP:"),
+        default: "127.0.0.1",
+        validate: (value) => {
+          if (!value || value.trim() === "") {
+            return chalk.red("后端 IP 不能为空");
+          }
+          const result = ipv4Schema.safeParse(value);
+          if (!result.success) {
+            return chalk.yellow(result.error.issues[0].message);
+          }
+          return true;
+        }
+      }]);
+      customIp = answer.customIp;
+      debugLog("[初始化] 获取自定义 customIp");
+    } else if (env === "custom" && customIp) {
+      debugLog(`[初始化] 使用命令行参数: customIp=${customIp}`);
+    }
+    debugLog(`[初始化] 最终参数: env=${env}, phone=${phone}, customIp=${customIp}, pluginVersion=${options.pluginVersion}, openclawPath=${options.openclawPath}`);
     debugLog("[初始化] 创建 LocalInstaller 实例...");
     const installer = new LocalInstaller({
       phone,
       userPass,
       env,
+      customIp,
+      wsUrl: options.wsUrl,
       pluginVersion: options.pluginVersion,
       openclawPath: options.openclawPath
     });
@@ -5288,7 +5392,7 @@ async function createLocalCommand(options) {
   }
 }
 function registerCommands(program2) {
-  program2.command("local").description("本地账户安装（需要登录）").option("-e, --env <env>", "环境 (test/prod)").option("--phone <phone>", "手机号码").option("--user-pass <userPass>", "用户密码").option("--plugin-version <plugin-version>", "插件版本号（默认最新版）").option("--openclaw-path <path>", "OpenClaw 安装目录路径（默认 ~/.openclaw）").option("--debug", "开启调试日志").action(createLocalCommand);
+  program2.command("local").description("本地账户安装（需要登录）").option("-e, --env <env>", "环境 (test/prod/custom)").option("--phone <phone>", "手机号码").option("--user-pass <userPass>", "用户密码").option("--base-url <url>", "自定义后端基础 URL（仅 custom 环境生效）").option("--ws-url <url>", "自定义 WebSocket URL（仅 custom 环境生效，默认自动从 base-url 转换）").option("--plugin-version <plugin-version>", "插件版本号（默认最新版）").option("--openclaw-path <path>", "OpenClaw 安装目录路径（默认 ~/.openclaw）").option("--debug", "开启调试日志").action(createLocalCommand);
 }
 const __filename$1 = fileURLToPath(import.meta.url);
 const __dirname$1 = dirname(__filename$1);

package/dist/index.js

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import("./index-CkTwizLH.js").then((cli) => {
+import("./index-B5TYzGeQ.js").then((cli) => {
   cli.default();
 });

package/dist/local/error/index.d.ts

@@ -14,6 +14,7 @@ export declare const ERROR_CODES: {
     readonly HTTP_ERROR: "HTTP_ERROR";
     readonly NETWORK_ERROR: "NETWORK_ERROR";
     readonly INVALID_OPENCLAW_PATH: "INVALID_OPENCLAW_PATH";
+    readonly INVALID_ARGUMENT: "INVALID_ARGUMENT";
 };
 export type ErrorCode = keyof typeof ERROR_CODES;
 /**

package/dist/local/error/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/local/error/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;CAad,CAAA;AAEV,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,WAAW,CAAA;AAEhD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAapD,CAAA;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IAExB,IAAI,EAAE,SAAS;gBAAf,IAAI,EAAE,SAAS,EACtB,OAAO,EAAE,MAAM;CAKlB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUlD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/local/error/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;CAcd,CAAA;AAEV,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,WAAW,CAAA;AAEhD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAcpD,CAAA;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IAExB,IAAI,EAAE,SAAS;gBAAf,IAAI,EAAE,SAAS,EACtB,OAAO,EAAE,MAAM;CAKlB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUlD"}

package/dist/local/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/local/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGxC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAUvD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/local/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGxC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAYvD"}

package/dist/local/installer/installer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../../src/local/installer/installer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAA6B,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAuD/E,qBAAa,cAAc;IAIb,OAAO,CAAC,MAAM;IAH1B,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,UAAU,CAAa;gBAEX,MAAM,EAAE,oBAAoB;IAIhD,cAAc,IAAI,IAAI;IAYhB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkD9B,aAAa,IAAI,MAAM;IAIvB,OAAO,CAAC,cAAc;YAOR,OAAO;YAoBP,kBAAkB;YAalB,eAAe;YAmBf,iBAAiB;YAmHjB,cAAc;CA+M7B"}
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../../src/local/installer/installer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAA6B,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAuD/E,qBAAa,cAAc;IAIb,OAAO,CAAC,MAAM;IAH1B,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,UAAU,CAAa;gBAEX,MAAM,EAAE,oBAAoB;IAIhD,cAAc,IAAI,IAAI;IAyBhB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkD9B,aAAa,IAAI,MAAM;IAIvB,OAAO,CAAC,cAAc;YAOR,OAAO;YAqBP,kBAAkB;YAclB,eAAe;YAmBf,iBAAiB;YAmHjB,cAAc;CA+M7B"}

package/dist/local/src/local.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../../src/local/src/local.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAgC5C,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAuH7E"}
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../../src/local/src/local.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAgC5C,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAoJ7E"}

package/dist/local/types/index.d.ts

@@ -3,13 +3,15 @@ export interface LocalOptions {
     env?: string;
     phone?: string;
     userPass?: string;
+    customIp?: string;
+    wsUrl?: string;
     pluginVersion?: string;
     openclawPath?: string;
     debug?: boolean;
 }
 export interface LocalInstallerConfig {
     env?: Environment;
-    baseUrl?: string;
+    customIp?: string;
     wsUrl?: string;
     phone: string;
     userPass: string;

package/dist/local/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/local/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAElD,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,EAAE,WAAW,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;CACb"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/local/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAElD,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,EAAE,WAAW,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;CACb"}

package/dist/shared/config/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * 环境类型
  */
-export type Environment = 'test' | 'prod';
+export type Environment = 'test' | 'prod' | 'custom';
 /**
  * 配置接口
  */
@@ -44,6 +44,8 @@ export declare const CONFIG: ConfigInterface;
 export declare const TEST_CONFIG: ConfigInterface;
 /**
  * 根据环境获取配置
+ * @param env - 环境
+ * @param customIp - 自定义环境的 IP 地址，仅当 env 为 custom 时使用
  */
-export declare function getConfig(env: Environment): ConfigInterface;
+export declare function getConfig(env: Environment, customIp?: string): ConfigInterface;
 //# sourceMappingURL=index.d.ts.map

package/dist/shared/config/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/config/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,CAAA;AAEzC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW;IACX,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe;IACf,gBAAgB,EAAE,MAAM,CAAA;IACxB,oBAAoB;IACpB,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe;IACf,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW;IACX,IAAI,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAA;QAChB,UAAU,EAAE,MAAM,CAAA;QAClB,OAAO,EAAE,MAAM,CAAA;QACf,WAAW,EAAE,MAAM,CAAA;QACnB,SAAS,EAAE,MAAM,CAAA;QACjB,IAAI,EAAE,MAAM,CAAA;KACb,CAAA;IACD,WAAW;IACX,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,aAAa;IACb,GAAG,EAAE;QACH,cAAc,EAAE,MAAM,CAAA;QACtB,QAAQ,EAAE,MAAM,CAAA;QAChB,OAAO,EAAE,MAAM,CAAA;KAChB,CAAA;CACF;AAED;;;GAGG;AACH,eAAO,MAAM,MAAM,EAAE,eAmBpB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,eAmBzB,CAAA;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,WAAW,GAAG,eAAe,CAE3D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/config/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAA;AAEpD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW;IACX,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe;IACf,gBAAgB,EAAE,MAAM,CAAA;IACxB,oBAAoB;IACpB,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe;IACf,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW;IACX,IAAI,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAA;QAChB,UAAU,EAAE,MAAM,CAAA;QAClB,OAAO,EAAE,MAAM,CAAA;QACf,WAAW,EAAE,MAAM,CAAA;QACnB,SAAS,EAAE,MAAM,CAAA;QACjB,IAAI,EAAE,MAAM,CAAA;KACb,CAAA;IACD,WAAW;IACX,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,aAAa;IACb,GAAG,EAAE;QACH,cAAc,EAAE,MAAM,CAAA;QACtB,QAAQ,EAAE,MAAM,CAAA;QAChB,OAAO,EAAE,MAAM,CAAA;KAChB,CAAA;CACF;AAED;;;GAGG;AACH,eAAO,MAAM,MAAM,EAAE,eAmBpB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,eAmBzB,CAAA;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,eAAe,CAuB9E"}

package/dist/shared/utils/index.d.ts

@@ -2,4 +2,5 @@ export { debugLog, isDebugMode, setDebug } from './debug';
 export { createLogger, logger } from './logger';
 export type { Logger } from './logger';
 export { validateOpenclawPath } from './path';
+export { ipv4Schema } from './validate';
 //# sourceMappingURL=index.d.ts.map

package/dist/shared/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAC/C,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAC/C,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA"}

package/dist/shared/utils/validate.d.ts

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+/**
+ * IPv4 地址 schema
+ */
+export declare const ipv4Schema: z.ZodIPv4;
+//# sourceMappingURL=validate.d.ts.map

package/dist/shared/utils/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;GAEG;AACH,eAAO,MAAM,UAAU,WAErB,CAAA"}

package/dist/utils/error.d.ts

@@ -7,6 +7,8 @@ export declare const ERROR_CODES: {
     readonly MISSING_AGENT_ID: 2003;
     readonly MISSING_APP_KEY: 2004;
     readonly MISSING_APP_SECRET: 2005;
+    readonly INVALID_ARGUMENT: 2006;
+    readonly INVALID_OPENCLAW_PATH: 2007;
     readonly LOGIN_FAILED: 3001;
     readonly GET_BOUND_CONFIG_FAILED: 3002;
     readonly FETCH_CONFIG_FAILED: 3003;

package/dist/utils/error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/utils/error.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;CAyBd,CAAA;AAEV,MAAM,MAAM,SAAS,GAAG,OAAO,WAAW,CAAC,MAAM,OAAO,WAAW,CAAC,CAAA;AAEpE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,qBAAa,QAAS,SAAQ,KAAK;IACjC,IAAI,EAAE,SAAS,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;gBAEL,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;IAO/D,MAAM,IAAI,YAAY;IAQtB,QAAQ,IAAI,MAAM;CAGnB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUlD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAEzF"}
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/utils/error.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;CA2Bd,CAAA;AAEV,MAAM,MAAM,SAAS,GAAG,OAAO,WAAW,CAAC,MAAM,OAAO,WAAW,CAAC,CAAA;AAEpE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,qBAAa,QAAS,SAAQ,KAAK;IACjC,IAAI,EAAE,SAAS,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;gBAEL,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;IAO/D,MAAM,IAAI,YAAY;IAQtB,QAAQ,IAAI,MAAM;CAGnB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUlD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAEzF"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@workclaw/cli",
   "type": "module",
-  "version": "1.0.315",
+  "version": "1.0.317",
   "description": "WorkClaw CLI 工具 - 用于初始化和配置 WorkClaw 插件",
   "license": "MIT",
   "keywords": [
@@ -36,6 +36,7 @@
     "jsencrypt": "^3.5.4",
     "ora": "^8.2.0",
     "semver": "^7.7.1",
-    "tar": "^6.2.1"
+    "tar": "^6.2.1",
+    "zod": "^4.3.6"
   }
 }