@foxden-app/foxclaw 0.3.5 → 0.3.6

package/README.md

@@ -70,7 +70,7 @@ foxclaw doctor
 foxclaw start
 ```
 
-`foxclaw init` 会创建 `~/.foxclaw/.env`，并在终端里提示填写 Telegram bot token、Telegram 数字用户 ID 和默认工作目录。任何一项都可以直接回车跳过，之后再用 `$EDITOR ~/.foxclaw/.env` 手动修改。
+`foxclaw init` 会创建 `~/.foxclaw/.env`，并在终端里提示填写 Telegram bot token、Telegram 数字用户 ID 和默认工作目录。如果当前 shell 里有 `HTTP_PROXY`、`HTTPS_PROXY`、`ALL_PROXY` 等代理变量，也会询问是否写入 FoxClaw 配置，避免服务启动后 Codex 走不到同一条网络。任何一项都可以直接回车跳过，之后再用 `$EDITOR ~/.foxclaw/.env` 手动修改。
 
 跑 `doctor` 或 `start` 之前先把 `.env` 填好。私聊模式最小配置：
 

package/README_EN.md

@@ -70,7 +70,7 @@ foxclaw doctor
 foxclaw start
 ```
 
-`foxclaw init` creates `~/.foxclaw/.env` and prompts for the Telegram bot token, your numeric Telegram user id, and the default workspace. Press Enter on any field to skip it and edit later with `$EDITOR ~/.foxclaw/.env`.
+`foxclaw init` creates `~/.foxclaw/.env` and prompts for the Telegram bot token, your numeric Telegram user id, and the default workspace. If the current shell has proxy variables such as `HTTP_PROXY`, `HTTPS_PROXY`, or `ALL_PROXY`, it also asks whether to save them into the FoxClaw config so the service uses the same network path as your working Codex CLI. Press Enter on any field to skip it and edit later with `$EDITOR ~/.foxclaw/.env`.
 
 Fill `.env` before running `doctor` or `start`. Minimum private-chat config:
 

package/dist/main.js

@@ -12,6 +12,16 @@ const command = process.argv[2] || 'serve';
 loadEnv();
 const packageRoot = path.dirname(path.dirname(fileURLToPath(import.meta.url)));
 const entryPoint = fileURLToPath(import.meta.url);
+const PROXY_ENV_KEYS = [
+    'HTTP_PROXY',
+    'HTTPS_PROXY',
+    'ALL_PROXY',
+    'NO_PROXY',
+    'http_proxy',
+    'https_proxy',
+    'all_proxy',
+    'no_proxy',
+];
 async function main() {
     if (command === 'init') {
         await initConfig();
@@ -160,6 +170,7 @@ async function initConfig() {
         console.log(`Created ${envPath}`);
     }
     if (!canPromptForInit()) {
+        printProxyEnvHint(envPath);
         console.log(`Edit it manually, then run: foxclaw doctor`);
         return;
     }
@@ -174,6 +185,7 @@ async function configureEnvInteractively(envPath, existed) {
         if (existed) {
             const updateExisting = (await rl.question('Update Telegram/workspace setup fields now? [y/N]: ')).trim().toLowerCase();
             if (updateExisting !== 'y' && updateExisting !== 'yes') {
+                await maybeSaveProxyEnvFromShell(rl, envPath);
                 console.log(`Edit it manually, then run: foxclaw doctor`);
                 return;
             }
@@ -184,6 +196,7 @@ async function configureEnvInteractively(envPath, existed) {
         const updates = {};
         const skipped = [];
         const warnings = [];
+        Object.assign(updates, await maybeSaveProxyEnvFromShell(rl, envPath));
         const token = sanitizeEnvInput(await rl.question('Telegram bot token (TG_BOT_TOKEN): '));
         if (token) {
             updates.TG_BOT_TOKEN = token;
@@ -307,6 +320,64 @@ function writeEnvUpdates(envPath, updates) {
     }
     fs.writeFileSync(envPath, text);
 }
+async function maybeSaveProxyEnvFromShell(rl, envPath) {
+    const proxyUpdates = detectMissingProxyEnv(envPath);
+    const keys = Object.keys(proxyUpdates);
+    if (keys.length === 0) {
+        return {};
+    }
+    console.log(`Detected proxy env in this shell: ${keys.join(', ')}`);
+    const answer = (await rl.question('Save these proxy settings to FoxClaw .env for service use? [Y/n]: ')).trim().toLowerCase();
+    if (answer === 'n' || answer === 'no') {
+        console.log(`Skipped proxy env. Add it to ${envPath} if ChatGPT access needs a proxy.`);
+        return {};
+    }
+    writeEnvUpdates(envPath, proxyUpdates);
+    console.log(`Saved ${keys.join(', ')} to ${envPath}`);
+    return proxyUpdates;
+}
+function printProxyEnvHint(envPath) {
+    const proxyUpdates = detectMissingProxyEnv(envPath);
+    const keys = Object.keys(proxyUpdates);
+    if (keys.length === 0) {
+        return;
+    }
+    console.log(`[WARN] Proxy env detected in this shell but missing from ${envPath}: ${keys.join(', ')}`);
+    console.log(`[WARN] Add those proxy variables to ${envPath} if ChatGPT/Codex needs a proxy.`);
+}
+function detectMissingProxyEnv(envPath) {
+    const existing = readEnvFileKeys(envPath);
+    const existingCanonical = new Set(Array.from(existing, canonicalProxyEnvKey));
+    const updates = {};
+    for (const key of PROXY_ENV_KEYS) {
+        const value = process.env[key]?.trim();
+        if (!value || existing.has(key) || existingCanonical.has(canonicalProxyEnvKey(key))) {
+            continue;
+        }
+        updates[key] = value;
+    }
+    return updates;
+}
+function canonicalProxyEnvKey(key) {
+    return key.toUpperCase();
+}
+function readEnvFileKeys(envPath) {
+    const keys = new Set();
+    let text = '';
+    try {
+        text = fs.readFileSync(envPath, 'utf8');
+    }
+    catch {
+        return keys;
+    }
+    for (const line of text.split(/\r?\n/)) {
+        const match = line.match(/^\s*([A-Za-z_][A-Za-z0-9_]*)\s*=/);
+        if (match?.[1]) {
+            keys.add(match[1]);
+        }
+    }
+    return keys;
+}
 function formatEnvValue(value) {
     const cleaned = value.replace(/[\r\n]/g, '').trim();
     if (!/[\s#"\\]/.test(cleaned))
@@ -376,8 +447,52 @@ function runDoctorChecks() {
         console.log(`[FAIL] default cwd missing: ${cwd}`);
         passed = false;
     }
+    warnIfProxyEnvMissingFromLoadedEnv();
+    warnIfInstalledServiceNodeLooksWrong();
     return passed;
 }
+function warnIfProxyEnvMissingFromLoadedEnv() {
+    const envPath = serviceEnvPath();
+    const proxyUpdates = detectMissingProxyEnv(envPath);
+    const keys = Object.keys(proxyUpdates);
+    if (keys.length === 0) {
+        return;
+    }
+    console.log(`[WARN] proxy env is present in this shell but missing from ${envPath}: ${keys.join(', ')}`);
+    console.log(`[WARN] systemd/launchd services do not inherit your shell; add those variables to the FoxClaw env file if Codex needs a proxy.`);
+}
+function warnIfInstalledServiceNodeLooksWrong() {
+    if (process.platform !== 'linux') {
+        return;
+    }
+    const unitPath = path.join(process.env.XDG_CONFIG_HOME || path.join(process.env.HOME || '', '.config'), 'systemd', 'user', 'foxclaw.service');
+    let text = '';
+    try {
+        text = fs.readFileSync(unitPath, 'utf8');
+    }
+    catch {
+        return;
+    }
+    const execStart = text.match(/^ExecStart=(.+)$/m)?.[1]?.trim();
+    const nodePath = execStart ? systemdUnescape(execStart.split(/\s+/)[0] ?? '') : '';
+    if (!nodePath) {
+        return;
+    }
+    if (!fs.existsSync(nodePath)) {
+        console.log(`[WARN] installed service node is missing: ${nodePath}`);
+        console.log('[WARN] Run foxclaw start from a Node 24 shell to refresh the service unit.');
+        return;
+    }
+    const result = spawnSync(nodePath, ['-p', 'process.versions.node'], { encoding: 'utf8' });
+    const version = result.status === 0 ? result.stdout.trim() : '';
+    const major = Number.parseInt(version.split('.')[0] ?? '', 10);
+    if (Number.isFinite(major) && major >= 24) {
+        console.log(`[OK] service node >= 24: ${nodePath}`);
+        return;
+    }
+    console.log(`[WARN] installed service node is older than 24: ${nodePath}${version ? ` (${version})` : ''}`);
+    console.log('[WARN] Run foxclaw start from a Node 24 shell to refresh the service unit.');
+}
 function installSystemd() {
     if (!hasCommand('systemctl')) {
         console.error('systemctl not found (need systemd)');
@@ -543,6 +658,9 @@ function spawnChecked(commandName, args) {
 function systemdEscape(value) {
     return value.replace(/\\/g, '\\\\').replace(/ /g, '\\x20');
 }
+function systemdUnescape(value) {
+    return value.replace(/\\x20/g, ' ').replace(/\\\\/g, '\\');
+}
 function xmlEscape(value) {
     return value
         .replace(/&/g, '&')

package/docs/troubleshooting.md

@@ -192,6 +192,8 @@ A common cause is that your shell or project `.env` has proxy variables, while t
 systemctl --user cat foxclaw.service
 ```
 
+`foxclaw init` detects proxy environment variables in the current shell and asks whether to save them into the FoxClaw `.env`. If you skipped that step, `foxclaw doctor` warns when it sees proxy variables in the shell but not in the FoxClaw env file.
+
 Make sure the file referenced by `Environment=FOXCLAW_ENV=...` contains your proxy variables, for example:
 
 ```dotenv
@@ -209,7 +211,9 @@ foxclaw restart
 
 ## Service Starts With The Wrong Node Version
 
-The systemd installer captures the `node` binary from your current PATH. If you installed the service from a shell using Node 22 or older, reinstall it from a Node 24 shell:
+The systemd installer records the absolute path of the Node process that is currently running FoxClaw. It does not rely on systemd loading `nvm.sh`. If you manage multiple Node versions with nvm, run `foxclaw start` from a Node 24 shell and the service will keep using that Node 24 path.
+
+If you installed the service from a shell using Node 22 or older, reinstall it from a Node 24 shell:
 
 ```bash
 nvm use 24
@@ -217,7 +221,7 @@ foxclaw start
 systemctl --user status foxclaw.service
 ```
 
-The status output should show a Node 24 path in `ExecStart`.
+The status output should show a Node 24 path in `ExecStart`. `foxclaw doctor` also checks the installed service Node path and warns if it is missing or older than 24.
 
 ## Does It Run After Reboot?
 

package/docs/user-manual.md

@@ -100,7 +100,7 @@ Both install the same published npm package. Use one global package manager cons
 
 ### 1.6 Fill In The Config
 
-`foxclaw init` creates the default config file at `~/.foxclaw/.env` and prompts for the Telegram bot token, your numeric Telegram user id, and the default workspace. Press Enter on any field to skip it, then edit manually if needed:
+`foxclaw init` creates the default config file at `~/.foxclaw/.env` and prompts for the Telegram bot token, your numeric Telegram user id, and the default workspace. If the current shell has proxy variables such as `HTTP_PROXY`, `HTTPS_PROXY`, or `ALL_PROXY`, it also asks whether to save them into the FoxClaw config so the service-side Codex app-server uses the same network. Press Enter on any field to skip it, then edit manually if needed:
 
 ```bash
 $EDITOR ~/.foxclaw/.env

package/docs/zh/troubleshooting.md

@@ -193,6 +193,8 @@ tail -f ~/.foxclaw/logs/service.log
 systemctl --user cat foxclaw.service
 ```
 
+`foxclaw init` 会检测当前 shell 里的代理环境变量，并询问是否保存到 FoxClaw `.env`。如果你跳过了这一步，`foxclaw doctor` 会在发现“shell 有代理，但 FoxClaw env 没有代理”时给出 `[WARN]`。
+
 确认 `Environment=FOXCLAW_ENV=...` 指向的文件里有你的代理配置，例如：
 
 ```dotenv
@@ -210,7 +212,9 @@ foxclaw restart
 
 ## 服务用了错误的 Node 版本
 
-systemd 安装脚本会记录当时 PATH 里的 `node`。如果你从 Node 22 或更旧版本的 shell 里安装过服务，请从 Node 24 的 shell 重新安装：
+systemd 安装脚本会记录当时正在运行的 Node 绝对路径，不依赖 systemd 去加载 `nvm.sh`。如果你用 nvm 管多个 Node 版本，原则是：从 Node 24 的 shell 里执行 `foxclaw start`，服务之后就固定使用这个 Node 24 路径。
+
+如果你从 Node 22 或更旧版本的 shell 里安装过服务，请从 Node 24 的 shell 重新安装：
 
 ```bash
 nvm use 24
@@ -218,7 +222,7 @@ foxclaw start
 systemctl --user status foxclaw.service
 ```
 
-状态输出里应该能看到 Node 24 的路径。
+状态输出里应该能看到 Node 24 的路径。`foxclaw doctor` 也会检查已安装服务里的 Node 路径，如果发现路径不存在或版本低于 24，会提示重新运行 `foxclaw start`。
 
 ## 重启后是否会自动运行
 

package/docs/zh/user-manual.md

@@ -100,7 +100,7 @@ foxclaw init
 
 ### 1.6 填写配置
 
-`foxclaw init` 会创建默认配置文件 `~/.foxclaw/.env`，并提示填写 Telegram bot token、Telegram 数字用户 ID 和默认工作目录。任何一项都可以直接回车跳过，之后再手动编辑：
+`foxclaw init` 会创建默认配置文件 `~/.foxclaw/.env`，并提示填写 Telegram bot token、Telegram 数字用户 ID 和默认工作目录。如果当前 shell 里有 `HTTP_PROXY`、`HTTPS_PROXY`、`ALL_PROXY` 等代理变量，它也会询问是否写入 FoxClaw 配置，让服务里的 Codex app-server 使用同样的网络。任何一项都可以直接回车跳过，之后再手动编辑：
 
 ```bash
 $EDITOR ~/.foxclaw/.env

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foxden-app/foxclaw",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "description": "Foxden local execution claw for controlling Codex from trusted chat interfaces.",
   "type": "module",
   "main": "dist/main.js",