openclaw-cn-termux 0.1.9-beta.8 → 0.2.0

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 Docs: https://clawd.org.cn/
 
+## 0.2.0
+
+### 新增功能
+
+- **新增 ePhone AI 模型供应商**：在模型配置向导中新增 [ePhone AI](https://platform.ephone.ai) 聚合平台，置顶为默认推荐供应商。兼容 OpenAI 协议（`https://api.ephone.ai/v1`），预设 claude-sonnet-4-6、claude-opus-4-6、MiniMax-M2.7、gpt-5.4、kimi-k2.5 五个可选模型，同时支持手动输入任意模型 ID。配置文档：https://clawd.org.cn/providers/ephone.html
+
+- **模型配置向导支持动态模型发现**：配置模型供应商时，自动从供应商 API（`/v1/models`）获取可用模型列表并展示在选择界面中。支持的供应商：ePhone AI、MiniMax、Moonshot（国际/.cn）、DeepSeek、阿里云百炼（DashScope）、硅基流动（SiliconFlow）、火山引擎（ARK + Coding Plan）、Z.AI（智谱）、小米 MiMo。API 不可达时自动降级到静态模型列表
+
+- **重新排列供应商选择顺序**：配置向导中供应商列表按区域分组：国内模型厂商（MiniMax、Moonshot、DeepSeek、阿里云百炼、硅基流动、火山引擎、Z.AI、小米、通义千问）优先展示，国际厂商和通用选项排在后面
+
+- **修复多个供应商配置后多余的模型选择步骤**：Moonshot、Z.AI、小米、火山引擎、MiniMax 等供应商在配置流程中已内置模型选择，但之前配置完成后仍会弹出通用的 `promptModelAllowlist` 步骤。现已将这些供应商加入 early-return 列表，避免重复选择
+
+### bug修复
+
+- **修复 Windows 全局安装后 CLI 启动报 `Cannot find package 'strip-ansi'`**（#538）：上游依赖 `@mariozechner/pi-coding-agent` 的 `bash-executor.js` 中直接 `import stripAnsi from "strip-ansi"`，但未将 `strip-ansi` 声明为 `dependencies`（幽灵依赖）。pnpm 工作区下因提升机制可正常解析，但通过 `npm install -g openclaw-cn` 全局安装时 npm 的扁平化 `node_modules` 不会安装未声明的传递依赖，导致运行时 `ERR_MODULE_NOT_FOUND`。修复方案：在 `package.json` 中将 `strip-ansi` 添加为直接依赖，确保全局安装时始终可用。感谢 @bolong2016 🙏
+- **修复对话页面输入区渐变产生深色蒙层**（#537）：`.chat-compose` 的背景渐变使用 CSS `transparent`（等同于 `rgba(0,0,0,0)` 即透明黑色），浏览器在 sRGB 空间从透明黑色插值到浅色背景时会经过半透明灰色，产生可见的深色条带覆盖对话内容。修复方案：新增 `--bg-transparent` / `--bg-content-transparent` CSS 变量（与背景色同色但 alpha 为 0），替换所有渐变中的 `transparent` 关键字，确保插值始终在同一色相内过渡。感谢 @hyydmmhy 🙏
+- **修复 Tailscale 直连网关时 WebSocket 断开 (1006)**（#527）：当网关配置 `bind: "tailnet"` 绑定到 Tailscale IP（如 `100.x.x.x`）时，浏览器访问控制台页面后 WebSocket 升级请求的 Origin 为 Tailscale IP，但 `isValidWebSocketOrigin()` 的 CSWSH 白名单仅包含 localhost/127.x/\*.ts.net，导致返回 403 + socket.destroy()，浏览器收到 1006 异常关闭。修复方案：在 Origin 白名单中新增 Tailscale IP 范围（100.64.0.0/10 IPv4 + fd7a:115c:a1e0::/48 IPv6）。感谢 @crossgg 🙏
+
 ## 0.1.9
 
 ### 文档

package/README.md

@@ -21,6 +21,19 @@
 
 ---
 
+## 💎 赞助商
+
+<p align="center">
+  <a href="https://platform.ephone.ai">
+    <img src="https://platform.ephone.ai/logo-e.png" alt="ePhone AI" height="48">
+  </a>
+</p>
+<p align="center">
+  <a href="https://platform.ephone.ai"><b>ePhone AI</b></a> — 统一接入，极速集成；支持 Claude、GPT 等主流模型
+</p>
+
+---
+
 ## ✨ 特性
 
 - **📱 Termux + AidLux 优化** — 专为 Android Termux 和 AidLux 环境设计，移动端也能运行 AI 助手
@@ -33,33 +46,41 @@
 
 ## 🚀 快速开始
 
-**环境要求：** Node.js ≥ 22，推荐在 Android Termux 或 AidLux 环境中运行
+**环境要求：** Node.js ≥ 22
+
+### 一键安装（推荐）
+
+**macOS / Linux：**
 
 ```bash
-# 安装
-npm install -g openclaw-cn-termux@latest
+curl -fsSL https://clawd.org.cn/install.sh | bash
+```
 
-# 运行安装向导
-openclaw-termux onboard --install-daemon
+**Termux（推荐在 Termux 中通过 proot-distro 运行 Ubuntu）：**
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/byteuser1977/termux-install-openclaw/main/scripts/install-ubuntu.sh | bash
+```
+
+**AidLux：**
 
-# 启动网关
-openclaw-termux gateway --port 18789 --verbose
+```bash
+curl -fsSL https://raw.githubusercontent.com/byteuser1977/termux-install-openclaw/main/scripts/install-aidlux.sh | bash
 ```
 
-## 📦 安装方式
+安装脚本会自动处理 Node 检测、安装和初始配置。
 
-### npm（推荐）
+### npm 安装
 
 ```bash
 npm install -g openclaw-cn-termux@latest
-# 或
-pnpm add -g openclaw-cn-termux@latest
+openclaw-termux onboard --install-daemon
 ```
 
 ### 从源码构建
 
 ```bash
-git clone https://github.com/byteuser1977/openclaw-cn-termux.git
+git clone https://github.com/byteuser977/openclaw-cn-termux.git
 cd openclaw-cn-termux
 
 pnpm install
@@ -69,9 +90,40 @@ pnpm build
 pnpm openclaw-termux onboard --install-daemon
 ```
 
+### Termux/AidLux 移动端安装
+
+本项目专为 Android Termux 和 AidLux 环境优化，已将所有 GitHub 依赖构建为 npm 包，国内用户可使用淘宝镜像源快速安装。
+
+**一键安装（推荐）：**
+
+| 环境   | 一键安装命令                                                                                                               |
+| ------ | -------------------------------------------------------------------------------------------------------------------------- |
+| Termux | `curl -fsSL https://raw.githubusercontent.com/byteuser1977/termux-install-openclaw/main/scripts/install-ubuntu.sh \| bash` |
+| AidLux | `curl -fsSL https://raw.githubusercontent.com/byteuser1977/termux-install-openclaw/main/scripts/install-aidlux.sh \| bash` |
+
+**手动安装步骤：**
+
+```bash
+# 1. 安装 Node.js 22+
+pkg update && pkg install nodejs
+
+# 2. 使用淘宝镜像安装（国内推荐）
+npm install -g openclaw-cn-termux@latest --registry=https://registry.npmmirror.com
+
+# 3. 运行初始配置
+openclaw-termux onboard
+
+# 4. 启动网关
+openclaw-termux gateway run
+```
+
+详细文档：[Termux 完整安装手册](https://clawd.org.cn/docs/installation) · [AidLux 安装手册](https://clawd.org.cn/docs/aidlux-installation)
+
 ## 🔧 配置
 
-最小配置 `~/.openclaw-cn-termux/openclaw.json`：
+配置文件位于 `~/.openclaw/` 目录（桌面端）或 `~/.openclaw-cn-termux/` 目录（Termux）。
+
+最小配置示例：
 
 ```json
 {
@@ -81,14 +133,26 @@ pnpm openclaw-termux onboard --install-daemon
 }
 ```
 
-## 📚 文档
+详细配置请参考：[网关配置文档](https://clawd.org.cn/docs/gateway/configuration)
 
-参考 `https://clawd.org.cn/docs/` 文档。
+## 📚 文档
 
-- `https://clawd.org.cn/docs/start/getting-started`
-- `https://clawd.org.cn/docs/gateway/configuration`
-- `https://clawd.org.cn/docs/channels`
-- `https://clawd.org.cn/docs/tools/skills`
+详细安装和配置文档：`https://clawd.org.cn/docs/`
+
+### 常用文档链接
+
+| 文档                                                        | 说明                     |
+| ----------------------------------------------------------- | ------------------------ |
+| [快速入门](https://clawd.org.cn/docs/start/getting-started) | 首次使用指南             |
+| [安装脚本详解](https://clawd.org.cn/docs/install/installer) | install.sh 参数和自动化  |
+| [Node.js 安装](https://clawd.org.cn/docs/install/node)      | PATH 问题排查            |
+| [npm/pnpm 安装](https://clawd.org.cn/docs/install)          | npm/pnpm 方式安装        |
+| [从源码构建](https://clawd.org.cn/docs/install)             | 开发者构建指南           |
+| [更新 OpenClaw](https://clawd.org.cn/docs/install/updating) | 更新和回滚策略           |
+| [卸载](https://clawd.org.cn/docs/install/uninstall)         | 完全卸载指南             |
+| [网关配置](https://clawd.org.cn/docs/gateway/configuration) | 网关配置参考             |
+| [渠道配置](https://clawd.org.cn/docs/channels)              | WhatsApp/Telegram 等配置 |
+| [技能扩展](https://clawd.org.cn/docs/tools/skills)          | 技能系统说明             |
 
 ## 🔄 版本同步
 

package/dist/agents/model-auth.js

@@ -226,6 +226,7 @@ export function resolveEnvApiKey(provider) {
         venice: "VENICE_API_KEY",
         mistral: "MISTRAL_API_KEY",
         opencode: "OPENCODE_API_KEY",
+        ephone: "EPHONE_API_KEY",
         // 新增：OpenAI兼容供应商环境变量映射
         siliconflow: "SILICONFLOW_API_KEY",
         dashscope: "DASHSCOPE_API_KEY",

package/dist/agents/model-compat.js

@@ -4,7 +4,7 @@ function isOpenAiCompletionsModel(model) {
 /**
  * Ensures the model has an `input` field to prevent crashes in upstream SDK.
  * The SDK uses `model.input.includes("image")` without null checking.
- * @see https://github.com/jiulingyun/openclaw-cn/issues/32
+ * @see https://github.com/byteuser977/openclaw-cn-termux/issues/32
  */
 function ensureModelInput(model) {
     if (model.input && Array.isArray(model.input))

package/dist/agents/models-config.providers.js

@@ -60,6 +60,16 @@ const OLLAMA_DEFAULT_COST = {
     cacheRead: 0,
     cacheWrite: 0,
 };
+const EPHONE_BASE_URL = "https://api.ephone.ai/v1";
+const EPHONE_DEFAULT_MODEL_ID = "claude-sonnet-4-6";
+const EPHONE_DEFAULT_CONTEXT_WINDOW = 200000;
+const EPHONE_DEFAULT_MAX_TOKENS = 8192;
+const EPHONE_DEFAULT_COST = {
+    input: 0,
+    output: 0,
+    cacheRead: 0,
+    cacheWrite: 0,
+};
 // 新增：OpenAI兼容供应商（硅基流动、阿里云百炼、DeepSeek）默认配置
 const SILICONFLOW_BASE_URL = "https://api.siliconflow.cn/v1";
 // 采用在中文环境中更常见且可用的Qwen 2.5指令模型作为默认
@@ -427,6 +437,23 @@ export function buildXiaomiProvider() {
         ],
     };
 }
+function buildEphoneProvider() {
+    return {
+        baseUrl: EPHONE_BASE_URL,
+        api: "openai-completions",
+        models: [
+            {
+                id: EPHONE_DEFAULT_MODEL_ID,
+                name: "Claude Sonnet 4.6",
+                reasoning: false,
+                input: ["text"],
+                cost: EPHONE_DEFAULT_COST,
+                contextWindow: EPHONE_DEFAULT_CONTEXT_WINDOW,
+                maxTokens: EPHONE_DEFAULT_MAX_TOKENS,
+            },
+        ],
+    };
+}
 function buildSiliconflowProvider() {
     return {
         baseUrl: SILICONFLOW_BASE_URL,
@@ -570,6 +597,11 @@ export async function resolveImplicitProviders(params) {
     if (veniceKey) {
         providers.venice = { ...(await buildVeniceProvider()), apiKey: veniceKey };
     }
+    const ephoneKey = resolveEnvApiKeyVarName("ephone") ??
+        resolveApiKeyFromProfiles({ provider: "ephone", store: authStore });
+    if (ephoneKey) {
+        providers.ephone = { ...buildEphoneProvider(), apiKey: ephoneKey };
+    }
     const siliconKey = resolveEnvApiKeyVarName("siliconflow") ??
         resolveApiKeyFromProfiles({ provider: "siliconflow", store: authStore });
     if (siliconKey) {

package/dist/agents/openai-models-discovery.js

@@ -0,0 +1,82 @@
+const DEFAULT_TIMEOUT_MS = 8_000;
+const DEFAULT_CONTEXT_WINDOW = 128_000;
+const DEFAULT_MAX_TOKENS = 8192;
+const ZERO_COST = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 };
+/**
+ * Fetch available models from any OpenAI-compatible `/v1/models` endpoint.
+ * Returns null on failure so callers can fall back to static lists.
+ */
+export async function discoverOpenAICompatibleModels(params) {
+    if (process.env.VITEST === "true" || process.env.NODE_ENV === "test") {
+        return null;
+    }
+    const { baseUrl, apiKey, timeoutMs = DEFAULT_TIMEOUT_MS, filter } = params;
+    const url = baseUrl.replace(/\/+$/, "");
+    const modelsUrl = url.endsWith("/models") ? url : `${url}/models`;
+    try {
+        const headers = { Accept: "application/json" };
+        if (apiKey?.trim()) {
+            headers.Authorization = `Bearer ${apiKey.trim()}`;
+        }
+        const response = await fetch(modelsUrl, {
+            method: "GET",
+            headers,
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+        if (!response.ok) {
+            return null;
+        }
+        const body = (await response.json());
+        const data = body?.data;
+        if (!Array.isArray(data) || data.length === 0) {
+            return null;
+        }
+        const seen = new Set();
+        const models = [];
+        for (const entry of data) {
+            const id = typeof entry?.id === "string" ? entry.id.trim() : "";
+            if (!id || seen.has(id))
+                continue;
+            if (filter && !filter(entry))
+                continue;
+            seen.add(id);
+            models.push({
+                id,
+                name: id,
+                reasoning: false,
+                input: ["text"],
+                cost: ZERO_COST,
+                contextWindow: DEFAULT_CONTEXT_WINDOW,
+                maxTokens: DEFAULT_MAX_TOKENS,
+            });
+        }
+        return models.length > 0 ? models : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Build select options from discovered models for the configure wizard.
+ * Prepends pinned models at the top (preserving order), appends a "custom" entry.
+ */
+export function buildDiscoveredModelOptions(params) {
+    const { discovered, pinnedIds = [], customLabel = "手动输入模型 ID" } = params;
+    const idSet = new Set(discovered.map((m) => m.id));
+    const options = [];
+    const added = new Set();
+    for (const id of pinnedIds) {
+        if (idSet.has(id) && !added.has(id)) {
+            added.add(id);
+            options.push({ value: id, label: id });
+        }
+    }
+    for (const model of discovered) {
+        if (!added.has(model.id)) {
+            added.add(model.id);
+            options.push({ value: model.id, label: model.id });
+        }
+    }
+    options.push({ value: "custom", label: customLabel });
+    return options;
+}

package/dist/build-info.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.1.9-beta.8",
-  "commit": "1002b7b73e1aed78bbed3a401c1ffa3f8dc4776d",
-  "builtAt": "2026-03-26T11:30:24.263Z"
+  "version": "0.2.0",
+  "commit": "16b959bdea0399a8123c1c5cfdb34dc1b0b993d8",
+  "builtAt": "2026-03-30T08:51:50.004Z"
 }

package/dist/commands/auth-choice-options.js

@@ -1,20 +1,16 @@
 const AUTH_CHOICE_GROUP_DEFS = [
+    // ── 赞助商（始终第一）──
     {
-        value: "openai",
-        label: "OpenAI",
-        hint: "Codex OAuth + API key",
-        choices: ["openai-codex", "openai-api-key"],
-    },
-    {
-        value: "anthropic",
-        label: "Anthropic",
-        hint: "setup-token + API key",
-        choices: ["token", "apiKey"],
+        value: "ephone",
+        label: "ePhone AI",
+        hint: "支持Claude等主流模型，官方优惠",
+        choices: ["ephone-api-key"],
     },
+    // ── 国内模型厂商 ──
     {
         value: "minimax",
         label: "MiniMax",
-        hint: "M2.5 (recommended)",
+        hint: "M2.5（推荐）",
         choices: ["minimax-portal", "minimax-api-key"],
     },
     {
@@ -29,40 +25,71 @@ const AUTH_CHOICE_GROUP_DEFS = [
         ],
     },
     {
-        value: "ollama",
-        label: "Ollama (本地)",
-        hint: "本地运行的 Ollama 服务",
-        choices: ["ollama-local"],
+        value: "deepseek",
+        label: "DeepSeek",
+        hint: "OpenAI兼容 · API key",
+        choices: ["deepseek-api-key"],
     },
     {
-        value: "custom",
-        label: "自定义模型 (兼容 OpenAI/Anthropic)",
-        hint: "Bring your own model",
-        choices: ["custom-provider-api-key"],
+        value: "dashscope",
+        label: "阿里云百炼 (DashScope)",
+        hint: "OpenAI兼容 · API key",
+        choices: ["dashscope-api-key", "dashscope-coding-plan-api-key"],
     },
     {
-        value: "google",
-        label: "Google",
-        hint: "Gemini API key + OAuth",
-        choices: ["gemini-api-key", "google-antigravity", "google-gemini-cli"],
+        value: "siliconflow",
+        label: "硅基流动 (SiliconFlow)",
+        hint: "OpenAI兼容 · API key",
+        choices: ["siliconflow-api-key"],
     },
     {
-        value: "openrouter",
-        label: "OpenRouter",
+        value: "volcengine",
+        label: "火山引擎 (VolcanoEngine)",
+        hint: "ARK API key + Coding Plan",
+        choices: ["volcengine-api-key", "volcengine-coding-plan-api-key"],
+    },
+    {
+        value: "zai",
+        label: "Z.AI (GLM-5)",
         hint: "API key",
-        choices: ["openrouter-api-key"],
+        choices: ["zai-api-key"],
+    },
+    {
+        value: "xiaomi",
+        label: "Xiaomi (MiMo)",
+        hint: "API key",
+        choices: ["xiaomi-api-key"],
     },
     {
         value: "qwen",
-        label: "Qwen",
+        label: "Qwen (通义千问)",
         hint: "OAuth",
         choices: ["qwen-portal"],
     },
+    // ── 国际厂商 ──
     {
-        value: "zai",
-        label: "Z.AI (GLM-5)",
+        value: "openai",
+        label: "OpenAI",
+        hint: "Codex OAuth + API key",
+        choices: ["openai-codex", "openai-api-key"],
+    },
+    {
+        value: "anthropic",
+        label: "Anthropic",
+        hint: "setup-token + API key",
+        choices: ["token", "apiKey"],
+    },
+    {
+        value: "google",
+        label: "Google",
+        hint: "Gemini API key + OAuth",
+        choices: ["gemini-api-key", "google-antigravity", "google-gemini-cli"],
+    },
+    {
+        value: "openrouter",
+        label: "OpenRouter",
         hint: "API key",
-        choices: ["zai-api-key"],
+        choices: ["openrouter-api-key"],
     },
     {
         value: "copilot",
@@ -70,6 +97,19 @@ const AUTH_CHOICE_GROUP_DEFS = [
         hint: "GitHub + local proxy",
         choices: ["github-copilot", "copilot-proxy"],
     },
+    // ── 通用 / 其他 ──
+    {
+        value: "ollama",
+        label: "Ollama (本地)",
+        hint: "本地运行的 Ollama 服务",
+        choices: ["ollama-local"],
+    },
+    {
+        value: "custom",
+        label: "自定义模型 (兼容 OpenAI/Anthropic)",
+        hint: "Bring your own model",
+        choices: ["custom-provider-api-key"],
+    },
     {
         value: "ai-gateway",
         label: "Vercel AI Gateway",
@@ -82,12 +122,6 @@ const AUTH_CHOICE_GROUP_DEFS = [
         hint: "API key",
         choices: ["opencode-zen"],
     },
-    {
-        value: "xiaomi",
-        label: "Xiaomi",
-        hint: "API key",
-        choices: ["xiaomi-api-key"],
-    },
     {
         value: "synthetic",
         label: "Synthetic",
@@ -106,34 +140,15 @@ const AUTH_CHOICE_GROUP_DEFS = [
         hint: "Account ID + Gateway ID + API key",
         choices: ["cloudflare-ai-gateway-api-key"],
     },
-    {
-        value: "siliconflow",
-        label: "硅基流动 (SiliconFlow)",
-        hint: "OpenAI兼容 · API key",
-        choices: ["siliconflow-api-key"],
-    },
-    {
-        value: "dashscope",
-        label: "阿里云百炼 (DashScope)",
-        hint: "OpenAI兼容 · API key",
-        choices: ["dashscope-api-key", "dashscope-coding-plan-api-key"],
-    },
-    {
-        value: "deepseek",
-        label: "DeepSeek",
-        hint: "OpenAI兼容 · API key",
-        choices: ["deepseek-api-key"],
-    },
-    {
-        value: "volcengine",
-        label: "火山引擎 (VolcanoEngine)",
-        hint: "ARK API key + Coding Plan",
-        choices: ["volcengine-api-key", "volcengine-coding-plan-api-key"],
-    },
 ];
 export function buildAuthChoiceOptions(params) {
     void params.store;
     const options = [];
+    options.push({
+        value: "ephone-api-key",
+        label: "ePhone AI API key",
+        hint: "模型聚合平台 · 支持 Claude / GPT / MiniMax 等",
+    });
     options.push({
         value: "token",
         label: "Anthropic token (paste setup-token)",