openclaw-cn-termux 0.2.0 → 0.2.1-beta.0

package/CHANGELOG.md

@@ -4,6 +4,10 @@ Docs: https://clawd.org.cn/
 
 ## 0.2.0
 
+### Bug 修复
+
+- **修复公网 IP 直连 Control UI 时 WebSocket 断开 (1006)** (#547, thanks @Yogdunana)：通过 `http://<公网IP>:端口` 访问控制台时，浏览器 `Origin` 与 CSWSH 白名单不匹配导致 WebSocket 升级返回 403。修复：`isValidWebSocketOrigin()` 在 `Origin` 与请求头 `Host` 同源时放行；新增 `gateway-host-fix.js` 前置脚本，按需纠正 `localStorage` 中过期的 `gatewayUrl`。
+
 ### 新增功能
 
 - **新增 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

package/README.md

@@ -56,6 +56,12 @@
 curl -fsSL https://clawd.org.cn/install.sh | bash
 ```
 
+**Termux 原生环境（非 proot 环境）：**
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/byteuser1977/termux-install-openclaw/main/scripts/install-termux-native.sh | bash
+```
+
 **Termux（推荐在 Termux 中通过 proot-distro 运行 Ubuntu）：**
 
 ```bash
@@ -96,10 +102,11 @@ pnpm openclaw-termux onboard --install-daemon
 
 **一键安装（推荐）：**
 
-| 环境   | 一键安装命令                                                                                                               |
-| ------ | -------------------------------------------------------------------------------------------------------------------------- |
-| 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` |
+| 环境         | 一键安装命令                                                                                                                 |
+| ------------ | ---------------------------------------------------------------------------------------------------------------------------- |
+| Termux 原生  | `curl -fsSL https://raw.githubusercontent.com/byteuser1977/termux-install-openclaw/main/scripts/install-termux-native.sh \| bash` |
+| Termux (Proot) | `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` |
 
 **手动安装步骤：**
 
@@ -119,7 +126,54 @@ openclaw-termux gateway run
 
 详细文档：[Termux 完整安装手册](https://clawd.org.cn/docs/installation) · [AidLux 安装手册](https://clawd.org.cn/docs/aidlux-installation)
 
-## 🔧 配置
+## � Termux 原生环境安装说明
+
+本项目已支持 Termux 原生环境（非 proot）下的服务注册和管理，使用 Termux 的 runit 服务管理器。
+
+### 安装要求
+
+- Termux 版本 ≥ 0.118.0
+- Node.js ≥ 22
+- `sv` 命令可用（安装 `termux-services` 包）
+
+```bash
+pkg update && pkg install nodejs termux-services
+```
+
+### 服务管理
+
+安装后，网关服务将自动注册为 Termux runit 服务，可通过以下命令管理：
+
+```bash
+# 查看服务状态
+sv status openclaw-gateway
+
+# 启动服务
+sv up openclaw-gateway
+
+# 停止服务
+sv down openclaw-gateway
+
+# 重启服务
+sv restart openclaw-gateway
+
+# 查看服务日志
+svlogd -tt ~/.termux/runit/openclaw-gateway-log
+```
+
+### 与 Proot Termux 的区别
+
+| 特性           | Termux 原生 (runit) | Proot Termux (init.d) |
+| -------------- | ------------------- | --------------------- |
+| 服务管理器     | runit (sv)          | init.d 脚本           |
+| 服务目录       | `~/.termux/runit/`  | `~/.init.d/`          |
+| 日志管理       | svlogd              | nohup + 日志文件      |
+| 系统集成       | 更原生              | 兼容模式              |
+| 推荐场景       | 纯 Termux 环境      | proot-distro 等环境   |
+
+详细文档：[Termux 原生环境安装指南](https://clawd.org.cn/docs/installation/termux-native)
+
+## �🔧 配置
 
 配置文件位于 `~/.openclaw/` 目录（桌面端）或 `~/.openclaw-cn-termux/` 目录（Termux）。
 
@@ -175,6 +229,10 @@ openclaw-termux gateway run
   <a href="https://github.com/yanghua"><img src="https://avatars.githubusercontent.com/yanghua?v=4" width="48" height="48" alt="yanghua" /></a>
   <a href="https://github.com/qqdxyg"><img src="https://avatars.githubusercontent.com/qqdxyg?v=4" width="48" height="48" alt="qqdxyg" /></a>
   <a href="https://github.com/ddupg"><img src="https://avatars.githubusercontent.com/ddupg?v=4" width="48" height="48" alt="ddupg" /></a>
+  <a href="https://github.com/Daiyimo"><img src="https://avatars.githubusercontent.com/Daiyimo?v=4" width="48" height="48" alt="Daiyimo" /></a>
+  <a href="https://github.com/yebohong02"><img src="https://avatars.githubusercontent.com/yebohong02?v=4" width="48" height="48" alt="yebohong02" /></a>
+  <a href="https://github.com/lvjianchaos"><img src="https://avatars.githubusercontent.com/lvjianchaos?v=4" width="48" height="48" alt="lvjianchaos" /></a>
+  <a href="https://github.com/Yogdunana"><img src="https://avatars.githubusercontent.com/Yogdunana?v=4" width="48" height="48" alt="Yogdunana" /></a>
 </p>
 
 ## 📋 开发计划

package/dist/build-info.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.2.0",
-  "commit": "16b959bdea0399a8123c1c5cfdb34dc1b0b993d8",
-  "builtAt": "2026-03-30T08:51:50.004Z"
+  "version": "0.2.1-beta.0",
+  "commit": "ecce42c6abe8070e7c4db6e1655ddf6548aa1c0e",
+  "builtAt": "2026-04-13T10:35:56.588Z"
 }

package/dist/control-ui/gateway-host-fix.js

@@ -0,0 +1,83 @@
+(function () {
+  try {
+    var key = "clawdbot.control.settings.v1";
+    var params = new URLSearchParams(window.location.search);
+    var raw = localStorage.getItem(key);
+    var o = raw ? JSON.parse(raw) : {};
+    var changed = false;
+    var strip = false;
+
+    var tok = params.get("token");
+    if (tok != null) {
+      var tt = tok.trim();
+      if (tt) {
+        o.token = tt;
+        changed = true;
+      }
+      params.delete("token");
+      strip = true;
+    }
+
+    var explicitGatewayFromQuery = false;
+    var gu = params.get("gatewayUrl");
+    if (gu != null) {
+      var gg = gu.trim();
+      if (gg) {
+        // Only accept gatewayUrl that points to the same host (prevent open-redirect to attacker WS)
+        try {
+          var parsed = new URL(gg);
+          if (parsed.hostname === location.hostname) {
+            o.gatewayUrl = gg;
+            explicitGatewayFromQuery = true;
+            changed = true;
+          }
+        } catch (_) { /* ignore malformed URL */ }
+      }
+      params.delete("gatewayUrl");
+      strip = true;
+    }
+
+    var sess = params.get("session");
+    if (sess != null) {
+      var sk = sess.trim();
+      if (sk) {
+        o.sessionKey = sk;
+        o.lastActiveSessionKey = sk;
+        changed = true;
+      }
+      params.delete("session");
+      strip = true;
+    }
+
+    var host = location.hostname;
+    if (!explicitGatewayFromQuery && host !== "localhost" && host !== "127.0.0.1") {
+      var wsUrl = (location.protocol === "https:" ? "wss" : "ws") + "://" + location.host;
+      var g = (o.gatewayUrl && String(o.gatewayUrl).trim()) || "";
+      var needsFix = !g || /127\.0\.0\.1|localhost/.test(g);
+      if (!needsFix && g) {
+        try {
+          needsFix = new URL(g).host !== location.host;
+        } catch {
+          needsFix = true;
+        }
+      }
+      if (needsFix) {
+        o.gatewayUrl = wsUrl;
+        changed = true;
+      }
+    }
+
+    if (changed) {
+      localStorage.setItem(key, JSON.stringify(o));
+    }
+
+    if (strip) {
+      var next = params.toString();
+      var u = new URL(window.location.href);
+      u.search = next;
+      window.history.replaceState({}, "", u.toString());
+    }
+  } catch (e) {
+    console.warn("[gateway-host-fix]", e);
+  }
+})();

package/dist/control-ui/index.html

@@ -2,6 +2,7 @@
 <html lang="en">
   <head>
     <meta charset="UTF-8" />
+    <script src="./gateway-host-fix.js"></script>
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>Clawdbot Control</title>
     <meta name="color-scheme" content="dark light" />

package/dist/daemon/proot.js

@@ -87,10 +87,7 @@ export function isRunningInAidlux() {
     }
     return false;
 }
-export function isRunningInTermux() {
-    if (isRunningInProotDistro() || isRunningInAidlux()) {
-        return true;
-    }
+export function isRunningInPureTermux() {
     const isTermux = Boolean(process.env.TERMUX_VERSION ||
         process.env.TERMUX_MAIN_PACKAGE_FORMAT ||
         process.env.TERMUX_PREFIX ||
@@ -98,3 +95,9 @@ export function isRunningInTermux() {
         process.env.ANDROID_ROOT?.includes("com.termux"));
     return isTermux;
 }
+export function isRunningInTermux() {
+    if (isRunningInProotDistro() || isRunningInAidlux()) {
+        return true;
+    }
+    return isRunningInPureTermux();
+}

package/dist/daemon/service.js

@@ -2,7 +2,8 @@ import { installLaunchAgent, isLaunchAgentLoaded, readLaunchAgentProgramArgument
 import { installScheduledTask, isScheduledTaskInstalled, readScheduledTaskCommand, readScheduledTaskRuntime, restartScheduledTask, stopScheduledTask, uninstallScheduledTask, } from "./schtasks.js";
 import { installSystemdService, isSystemdServiceEnabled, readSystemdServiceExecStart, readSystemdServiceRuntime, restartSystemdService, stopSystemdService, uninstallSystemdService, } from "./systemd.js";
 import { installInitdService, uninstallInitdService, stopInitdService, restartInitdService, isInitdServiceEnabled, readInitdServiceCommand, readInitdServiceRuntime, } from "./initd.js";
-import { isRunningInTermux } from "./proot.js";
+import { installTermuxSvService, uninstallTermuxSvService, stopTermuxSvService, restartTermuxSvService, isTermuxSvServiceEnabled, readTermuxSvServiceCommand, readTermuxSvServiceRuntime, } from "./termux-sv.js";
+import { isRunningInPureTermux, isRunningInTermux } from "./proot.js";
 export function resolveGatewayService() {
     if (process.platform === "darwin") {
         return {
@@ -33,6 +34,34 @@ export function resolveGatewayService() {
         };
     }
     if (process.platform === "linux") {
+        if (isRunningInPureTermux()) {
+            return {
+                label: "termux-sv",
+                loadedText: "installed",
+                notLoadedText: "not installed",
+                install: async (args) => {
+                    await installTermuxSvService(args);
+                },
+                uninstall: async (args) => {
+                    await uninstallTermuxSvService(args);
+                },
+                stop: async (args) => {
+                    await stopTermuxSvService({
+                        stdout: args.stdout,
+                        env: args.env,
+                    });
+                },
+                restart: async (args) => {
+                    await restartTermuxSvService({
+                        stdout: args.stdout,
+                        env: args.env,
+                    });
+                },
+                isLoaded: async (args) => isTermuxSvServiceEnabled(args),
+                readCommand: readTermuxSvServiceCommand,
+                readRuntime: async (env) => await readTermuxSvServiceRuntime(env),
+            };
+        }
         if (isRunningInTermux()) {
             return {
                 label: "initd",

package/dist/daemon/termux-sv.js

@@ -0,0 +1,302 @@
+import { execFile } from "node:child_process";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { colorize, isRich, theme } from "../terminal/theme.js";
+import { formatGatewayServiceDescription } from "./constants.js";
+import { resolveHomeDir } from "./paths.js";
+const toPosixPath = (value) => value.replace(/\\/g, "/");
+const formatLine = (label, value) => {
+    const rich = isRich();
+    return `${colorize(rich, theme.muted, `${label}:`)} ${colorize(rich, theme.command, value)}`;
+};
+function resolveServiceDir(env) {
+    const home = toPosixPath(resolveHomeDir(env));
+    return path.posix.join(home, ".termux", "runit", "openclaw-gateway");
+}
+function resolveServiceLogDir(env) {
+    const home = toPosixPath(resolveHomeDir(env));
+    return path.posix.join(home, ".termux", "runit", "openclaw-gateway-log");
+}
+function buildServiceRunScript({ description, programArguments, workingDirectory, environment, }) {
+    const envVars = Object.entries(environment || {})
+        .map(([key, value]) => `export ${key}="${value || ""}"`)
+        .join("\n");
+    const cmd = programArguments.map((arg) => `"${arg}"`).join(" ");
+    const workDir = workingDirectory || "$(dirname \"$0\")";
+    return `#!/bin/sh
+# OpenClaw Gateway Service (Termux runit)
+# Description: ${description}
+
+cd "${workDir}"
+${envVars}
+exec ${cmd}
+`;
+}
+function buildServiceLogRunScript({ description, logFile, }) {
+    return `#!/bin/sh
+# OpenClaw Gateway Service Log (Termux runit)
+# Description: ${description}
+
+exec svlogd -tt "${logFile}"
+`;
+}
+async function executeCommand(command, args, options) {
+    return new Promise((resolve, reject) => {
+        execFile(command, args, options ?? { encoding: "utf-8" }, (error, stdout) => {
+            if (error) {
+                reject(error);
+            }
+            else {
+                resolve(stdout?.toString() ?? "");
+            }
+        });
+    });
+}
+async function assertRunitAvailable() {
+    try {
+        await executeCommand("sv", ["--version"], {
+            encoding: "utf8",
+        });
+    }
+    catch {
+        throw new Error("Termux runit (sv) is not available. Please install termux-services package.");
+    }
+}
+export async function installTermuxSvService({ env, stdout, programArguments, workingDirectory, environment, description, }) {
+    await assertRunitAvailable();
+    const serviceDir = resolveServiceDir(env);
+    const logDir = resolveServiceLogDir(env);
+    const logFile = path.posix.join(serviceDir, "main", "log");
+    await fs.mkdir(serviceDir, { recursive: true });
+    await fs.mkdir(path.join(serviceDir, "main"), { recursive: true });
+    await fs.mkdir(logDir, { recursive: true });
+    const serviceDescription = description ??
+        formatGatewayServiceDescription({
+            profile: env.OPENCLAW_PROFILE,
+            version: environment?.OPENCLAW_SERVICE_VERSION ?? env.OPENCLAW_SERVICE_VERSION,
+        });
+    const runScript = buildServiceRunScript({
+        description: serviceDescription,
+        programArguments,
+        workingDirectory,
+        environment,
+    });
+    const logRunScript = buildServiceLogRunScript({
+        description: serviceDescription,
+        logFile,
+    });
+    await fs.writeFile(path.join(serviceDir, "run"), runScript, "utf8");
+    await fs.chmod(path.join(serviceDir, "run"), 0o755);
+    await fs.writeFile(path.join(logDir, "run"), logRunScript, "utf8");
+    await fs.chmod(path.join(logDir, "run"), 0o755);
+    stdout.write(`${formatLine("Installed Termux runit service", serviceDir)}\n`);
+    stdout.write(`${formatLine("Log directory", logDir)}\n`);
+    try {
+        await executeCommand("sv", ["enable", "openclaw-gateway"], {
+            encoding: "utf8",
+        });
+        stdout.write(`${formatLine("Enabled service", "openclaw-gateway")}\n`);
+    }
+    catch (error) {
+        stdout.write(`Warning: Failed to enable service via sv: ${String(error)}\n`);
+        stdout.write("You may need to manually link the service to runsvdir\n");
+    }
+    try {
+        await executeCommand("sv", ["up", "openclaw-gateway"], {
+            encoding: "utf8",
+        });
+        stdout.write(`${formatLine("Started service", "openclaw-gateway")}\n`);
+    }
+    catch (error) {
+        stdout.write(`Warning: Failed to start service via sv: ${String(error)}\n`);
+    }
+    return { serviceDir, logDir };
+}
+export async function uninstallTermuxSvService({ env, stdout, }) {
+    await assertRunitAvailable();
+    const serviceDir = resolveServiceDir(env);
+    const logDir = resolveServiceLogDir(env);
+    try {
+        await executeCommand("sv", ["down", "openclaw-gateway"], {
+            encoding: "utf8",
+        });
+        stdout.write(`${formatLine("Stopped service", "openclaw-gateway")}\n`);
+    }
+    catch {
+        stdout.write("Service not running\n");
+    }
+    try {
+        await executeCommand("sv", ["disable", "openclaw-gateway"], {
+            encoding: "utf8",
+        });
+        stdout.write(`${formatLine("Disabled service", "openclaw-gateway")}\n`);
+    }
+    catch {
+        stdout.write("Service not enabled\n");
+    }
+    try {
+        await fs.unlink(path.join(serviceDir, "run"));
+        stdout.write(`${formatLine("Removed service script", path.join(serviceDir, "run"))}\n`);
+    }
+    catch {
+        stdout.write(`Service script not found at ${path.join(serviceDir, "run")}\n`);
+    }
+    try {
+        await fs.rm(serviceDir, { recursive: true });
+        stdout.write(`${formatLine("Removed service directory", serviceDir)}\n`);
+    }
+    catch {
+        stdout.write(`Service directory not found at ${serviceDir}\n`);
+    }
+    try {
+        await fs.unlink(path.join(logDir, "run"));
+        stdout.write(`${formatLine("Removed log script", path.join(logDir, "run"))}\n`);
+    }
+    catch {
+        stdout.write(`Log script not found at ${path.join(logDir, "run")}\n`);
+    }
+    try {
+        await fs.rm(logDir, { recursive: true });
+        stdout.write(`${formatLine("Removed log directory", logDir)}\n`);
+    }
+    catch {
+        stdout.write(`Log directory not found at ${logDir}\n`);
+    }
+}
+export async function stopTermuxSvService({ stdout, env, }) {
+    await assertRunitAvailable();
+    try {
+        const result = await executeCommand("sv", ["down", "openclaw-gateway"], {
+            encoding: "utf8",
+        });
+        stdout.write(`${result}\n`);
+        stdout.write(`${formatLine("Stopped service", "openclaw-gateway")}\n`);
+    }
+    catch (error) {
+        stdout.write(`Failed to stop service: ${String(error)}\n`);
+    }
+}
+export async function restartTermuxSvService({ stdout, env, }) {
+    await assertRunitAvailable();
+    try {
+        const result = await executeCommand("sv", ["restart", "openclaw-gateway"], {
+            encoding: "utf8",
+        });
+        stdout.write(`${result}\n`);
+        stdout.write(`${formatLine("Restarted service", "openclaw-gateway")}\n`);
+    }
+    catch (error) {
+        stdout.write(`Failed to restart service: ${String(error)}\n`);
+    }
+}
+export async function isTermuxSvServiceEnabled(args) {
+    const serviceDir = resolveServiceDir(args.env ?? {});
+    try {
+        await fs.access(path.join(serviceDir, "run"));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function readTermuxSvServiceRuntime(env = process.env) {
+    const serviceDir = resolveServiceDir(env);
+    try {
+        await fs.access(path.join(serviceDir, "run"));
+    }
+    catch {
+        return {
+            status: "stopped",
+            detail: "Termux runit service not found",
+        };
+    }
+    try {
+        const result = await executeCommand("sv", ["status", "openclaw-gateway"], {
+            encoding: "utf8",
+        });
+        const match = result.match(/runsvdir: (.+): .+ \((\d+)\)/);
+        if (match) {
+            const status = match[1].trim();
+            const pid = parseInt(match[2], 10);
+            if (status === "up") {
+                return {
+                    status: "running",
+                    pid,
+                };
+            }
+            else if (status === "down") {
+                return {
+                    status: "stopped",
+                };
+            }
+        }
+        return {
+            status: "unknown",
+            detail: result.trim(),
+        };
+    }
+    catch (error) {
+        return {
+            status: "unknown",
+            detail: String(error),
+        };
+    }
+}
+export async function readTermuxSvServiceCommand(env) {
+    const serviceDir = resolveServiceDir(env);
+    const runScriptPath = path.join(serviceDir, "run");
+    try {
+        const content = await fs.readFile(runScriptPath, "utf8");
+        let cmdLine = "";
+        let workingDirectory = "";
+        const environment = {};
+        for (const rawLine of content.split("\n")) {
+            const line = rawLine.trim();
+            if (line.startsWith("export ")) {
+                const match = line.match(/export (\w+)="(.*)"/);
+                if (match) {
+                    environment[match[1]] = match[2];
+                }
+            }
+            else if (line.startsWith("exec ")) {
+                cmdLine = line.slice("exec ".length).trim();
+            }
+            else if (line.startsWith("cd ")) {
+                workingDirectory = line.slice("cd ".length).trim();
+                workingDirectory = workingDirectory.replace(/^"|"$/g, "");
+            }
+        }
+        if (!cmdLine)
+            return null;
+        const programArguments = [];
+        let currentArg = "";
+        let inQuotes = false;
+        for (let i = 0; i < cmdLine.length; i++) {
+            const char = cmdLine[i];
+            if (char === '"') {
+                inQuotes = !inQuotes;
+            }
+            else if (char === " " && !inQuotes) {
+                if (currentArg) {
+                    programArguments.push(currentArg);
+                    currentArg = "";
+                }
+            }
+            else {
+                currentArg += char;
+            }
+        }
+        if (currentArg) {
+            programArguments.push(currentArg);
+        }
+        return {
+            programArguments,
+            ...(workingDirectory ? { workingDirectory } : {}),
+            ...(Object.keys(environment).length > 0 ? { environment } : {}),
+            sourcePath: runScriptPath,
+        };
+    }
+    catch {
+        return null;
+    }
+}

package/dist/gateway/server-http.js

@@ -351,6 +351,7 @@ export function createGatewayHttpServer(opts) {
  * - Tailscale origins (*.ts.net domains, 100.64.0.0/10 IPv4, fd7a:115c:a1e0::/48 IPv6) are allowed
  * - Null origin (file:// protocol, privacy mode) is allowed for local clients
  * - Empty origin (non-browser clients) is allowed
+ * - Same Host as Origin (e.g. Control UI at http://PUBLIC_IP:18789) is allowed (CSWSH-safe)
  * - All other origins are rejected
  */
 function isValidWebSocketOrigin(req) {
@@ -383,6 +384,21 @@ function isValidWebSocketOrigin(req) {
             return true;
         if (isTailnetIPv6(hostname))
             return true;
+        // Allow Origin matching the request Host header (e.g. Control UI served from
+        // the gateway itself at http://PUBLIC_IP:18789). This is safe against CSWSH
+        // because the browser sets both Origin and Host; an attacker page on a
+        // different origin cannot forge the Host header to match its own Origin.
+        // Note: behind a misconfigured reverse proxy the Host header could be
+        // attacker-controlled — but SECURITY.md already advises against public
+        // exposure without a trusted proxy + gateway auth.
+        const hostHeader = (req.headers.host ?? "").trim();
+        if (hostHeader) {
+            const ol = origin.toLowerCase();
+            const hh = hostHeader.toLowerCase();
+            if (ol === `http://${hh}` || ol === `https://${hh}`) {
+                return true;
+            }
+        }
         return false;
     }
     catch {

package/dist/infra/clipboard-stub.js

@@ -0,0 +1,18 @@
+export const availableFormats = [];
+export const getText = () => Promise.resolve("");
+export const setText = () => Promise.resolve();
+export const hasText = () => Promise.resolve(false);
+export const getImageBinary = () => Promise.resolve(null);
+export const getImageBase64 = () => Promise.resolve("");
+export const setImageBinary = () => Promise.resolve();
+export const setImageBase64 = () => Promise.resolve();
+export const hasImage = () => Promise.resolve(false);
+export const getHtml = () => Promise.resolve("");
+export const setHtml = () => Promise.resolve();
+export const hasHtml = () => Promise.resolve(false);
+export const getRtf = () => Promise.resolve("");
+export const setRtf = () => Promise.resolve();
+export const hasRtf = () => Promise.resolve(false);
+export const clear = () => Promise.resolve();
+export const watch = () => Promise.resolve();
+export const callThreadsafeFunction = () => Promise.resolve();

package/dist/infra/clipboard.js

@@ -1,6 +1,7 @@
 import { runCommandWithTimeout } from "../process/exec.js";
 export async function copyToClipboard(value) {
     const attempts = [
+        { argv: ["termux-clipboard-set"] },
         { argv: ["pbcopy"] },
         { argv: ["xclip", "-selection", "clipboard"] },
         { argv: ["wl-copy"] },

package/dist/logging/logger.js

@@ -5,9 +5,15 @@ import { Logger as TsLogger } from "tslog";
 import { levelToMinLevel, normalizeLogLevel } from "./levels.js";
 import { readLoggingConfig } from "./config.js";
 import { loggingState } from "./state.js";
+import { isRunningInPureTermux } from "../daemon/proot.js";
+import { resolveGatewayStateDir } from "../daemon/paths.js";
 // Pin to /tmp so mac Debug UI and docs match; os.tmpdir() can be a per-user
-// randomized path on macOS which made the “Open log” button a no-op.
-export const DEFAULT_LOG_DIR = "/tmp/clawdbot";
+// randomized path on macOS which made the "Open log" button a no-op.
+// For Termux native, use ~/.openclaw/logs/clawdbot.log instead of /tmp
+const DEFAULT_LOG_DIR_VALUE = isRunningInPureTermux()
+    ? path.join(resolveGatewayStateDir(process.env), "logs")
+    : "/tmp/clawdbot";
+export const DEFAULT_LOG_DIR = DEFAULT_LOG_DIR_VALUE;
 export const DEFAULT_LOG_FILE = path.join(DEFAULT_LOG_DIR, "clawdbot.log"); // legacy single-file path
 const LOG_PREFIX = "clawdbot";
 const LOG_SUFFIX = ".log";

package/dist/wizard/onboarding.finalize.js

@@ -24,16 +24,12 @@ export async function finalizeOnboardingWizard(options) {
             progress.stop(options.doneMessage);
         }
     };
-    const systemdAvailable = 
-    //  process.platform === "linux" ? await isSystemdUserServiceAvailable() : true;
-    //if (process.platform === "linux" && !systemdAvailable) {
-    process.platform === "linux" && !isRunningInTermux()
+    const systemdAvailable = process.platform === "linux" && !isRunningInTermux()
         ? await isSystemdUserServiceAvailable()
         : true;
     if (process.platform === "linux" && !isRunningInTermux() && !systemdAvailable) {
         await prompter.note("Systemd user services are unavailable. Skipping lingering checks and service install.", "Systemd");
     }
-    // if (process.platform === "linux" && systemdAvailable) {
     if (process.platform === "linux" && !isRunningInTermux() && systemdAvailable) {
         const { ensureSystemdUserLingerInteractive } = await import("../commands/systemd-linger.js");
         await ensureSystemdUserLingerInteractive({
@@ -50,7 +46,6 @@ export async function finalizeOnboardingWizard(options) {
     let installDaemon;
     if (explicitInstallDaemon !== undefined) {
         installDaemon = explicitInstallDaemon;
-        //  } else if (process.platform === "linux" && !systemdAvailable) {
     }
     else if (process.platform === "linux" && !isRunningInTermux() && !systemdAvailable) {
         installDaemon = false;
@@ -64,7 +59,6 @@ export async function finalizeOnboardingWizard(options) {
             initialValue: true,
         });
     }
-    //  if (process.platform === "linux" && !systemdAvailable && installDaemon) {
     if (process.platform === "linux" && !isRunningInTermux() && !systemdAvailable && installDaemon) {
         await prompter.note("Systemd user services are unavailable; skipping service install. Use your container supervisor or `docker compose up -d`.", "Gateway service");
         installDaemon = false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-cn-termux",
-  "version": "0.2.0",
+  "version": "0.2.1-beta.0",
   "description": "Openclaw Termux 版本 - WhatsApp gateway CLI (Baileys web) with Pi RPC agent",
   "keywords": [],
   "license": "MIT",
@@ -270,7 +270,8 @@
       "libsignal": "npm:@openclaw-cn/libsignal@2.0.1"
     },
     "patchedDependencies": {
-      "@mariozechner/pi-ai": "patches/@mariozechner__pi-ai.patch"
+      "@mariozechner/pi-ai": "patches/@mariozechner__pi-ai.patch",
+      "@mariozechner/clipboard": "patches/@mariozechner__clipboard.patch"
     }
   },
   "openclawVersion": "2026.3.24",

package/patches/@mariozechner__clipboard.patch

@@ -0,0 +1,58 @@
+/* tslint:disable */
+/* eslint-disable */
+/* prettier-ignore */
+
+/* auto-generated by NAPI-RS */
+
+const { execSync } = require('child_process')
+
+function termuxSetText(value) {
+  try {
+    execSync('termux-clipboard-set', {
+      input: value,
+      stdio: ['pipe', 'pipe', 'pipe'],
+    })
+  } catch {
+    throw new Error('Failed to set clipboard')
+  }
+}
+
+function termuxGetText() {
+  try {
+    return execSync('termux-clipboard-get', {
+      encoding: 'utf8',
+    })
+  } catch {
+    return ''
+  }
+}
+
+function termuxHasText() {
+  try {
+    const text = execSync('termux-clipboard-get', {
+      encoding: 'utf8',
+    })
+    return text.length > 0
+  } catch {
+    return false
+  }
+}
+
+module.exports.availableFormats = () => []
+module.exports.getText = termuxGetText
+module.exports.setText = termuxSetText
+module.exports.hasText = termuxHasText
+module.exports.getImageBinary = () => null
+module.exports.getImageBase64 = () => ''
+module.exports.setImageBinary = () => {}
+module.exports.setImageBase64 = () => {}
+module.exports.hasImage = () => false
+module.exports.getHtml = () => ''
+module.exports.setHtml = () => {}
+module.exports.hasHtml = () => false
+module.exports.getRtf = () => ''
+module.exports.setRtf = () => {}
+module.exports.hasRtf = () => false
+module.exports.clear = () => {}
+module.exports.watch = () => {}
+module.exports.callThreadsafeFunction = () => {}