引言

“教程寫(xiě)的都是 Mac 命令，Windows 上怎么搞？”

“換了 Linux 服務(wù)器，同樣的 YAML 配置就是跑不通……”

“從 Windows 換到 Mac，代理突然不生效了，環(huán)境變量寫(xiě)法不一樣？”

如果你在多臺(tái)設(shè)備上部署 OpenClaw，你一定遇到過(guò)這種“跨平臺(tái)水土不服”的問(wèn)題。不同操作系統(tǒng)的終端環(huán)境不同，命令語(yǔ)法不同，甚至環(huán)境變量的生效方式也不同。

今天這篇文章，就幫你一次性搞定 Windows、Mac、Linux 三大平臺(tái)下 OpenClaw 的代理配置，手把手帶你把站大爺隧道代理跑通。

一、為什么跨平臺(tái)配置容易“翻車(chē)”？

核心原因有兩個(gè)：

第一，不同平臺(tái)的終端語(yǔ)法不同。

Windows 的 CMD 和 PowerShell 用 set 或 $env:，Linux/Mac 用 export。搞混了就會(huì)報(bào)錯(cuò)。

第二，配置的生效范圍不同。

最穩(wěn)妥的策略是統(tǒng)一用 環(huán)境變量配置法——這是 OpenClaw 官方文檔認(rèn)可的“最快檢查”方式。它通過(guò) Node.js 原生機(jī)制處理代理請(qǐng)求，能徹底繞開(kāi) YAML 配置在跨平臺(tái)環(huán)境下可能出現(xiàn)的協(xié)議混淆問(wèn)題。

二、Windows 系統(tǒng)配置

Windows 下主要有兩種終端：PowerShell（推薦）和 CMD。

方法一：PowerShell（推薦，功能最強(qiáng)）

PowerShell 是微軟新一代跨平臺(tái) Shell，對(duì) OpenClaw 的兼容性最好。

臨時(shí)生效（當(dāng)前窗口）：

$env:HTTP_PROXY="http://隧道ID:密碼@tps.zdaye.com:8080"
$env:HTTPS_PROXY="http://隧道ID:密碼@tps.zdaye.com:8080"
openclaw gateway start

永久生效（推薦）：

[Environment]::SetEnvironmentVariable("HTTP_PROXY", "http://隧道ID:密碼@tps.zdaye.com:8080", "User")
[Environment]::SetEnvironmentVariable("HTTPS_PROXY", "http://隧道ID:密碼@tps.zdaye.com:8080", "User")

完成后需要 重啟終端 才能生效。

方法二：CMD（命令提示符，兼容舊腳本）

臨時(shí)生效：

set HTTP_PROXY=http://隧道ID:密碼@tps.zdaye.com:8080
set HTTPS_PROXY=http://隧道ID:密碼@tps.zdaye.com:8080
openclaw gateway start

永久生效：

setx HTTP_PROXY "http://隧道ID:密碼@tps.zdaye.com:8080"
setx HTTPS_PROXY "http://隧道ID:密碼@tps.zdaye.com:8080"

使用 setx 后，新打開(kāi)的命令行窗口會(huì)生效，當(dāng)前窗口不會(huì)。

踩坑提醒：PowerShell 和 CMD 的環(huán)境變量不互通。在 PowerShell 里 $env:HTTP_PROXY=... 設(shè)的變量，在 CMD 里用 echo %HTTP_PROXY% 是看不到的。建議全程使用同一個(gè)終端。

Windows 永久生效（圖形界面方式）

1. 按 Win + R，輸入 sysdm.cpl
2. 點(diǎn)擊“高級(jí)” → “環(huán)境變量”
3. 在“系統(tǒng)變量”或“用戶變量”中點(diǎn)擊“新建”
4. 變量名：HTTP_PROXY，變量值：http://隧道ID:密碼@tps.zdaye.com:8080
5. 同樣添加 HTTPS_PROXY
6. 重啟電腦或重新打開(kāi)終端后生效

三、Mac 系統(tǒng)配置

Mac 使用 Zsh（macOS Catalina 后默認(rèn)）或 Bash（舊版本）。

臨時(shí)生效（當(dāng)前終端）

export HTTP_PROXY="http://隧道ID:密碼@tps.zdaye.com:8080"
export HTTPS_PROXY="http://隧道ID:密碼@tps.zdaye.com:8080"
openclaw gateway start

永久生效（推薦）

確認(rèn)你用的是哪種 Shell：

echo $SHELL
# /bin/zsh → Zsh
# /bin/bash → Bash

如果是 Zsh（macOS 默認(rèn)），編輯 ~/.zshrc：

echo 'export HTTP_PROXY="http://隧道ID:密碼@tps.zdaye.com:8080"' >> ~/.zshrc
echo 'export HTTPS_PROXY="http://隧道ID:密碼@tps.zdaye.com:8080"' >> ~/.zshrc
source ~/.zshrc

如果是 Bash，編輯 ~/.bash_profile 或 ~/.bashrc：

echo 'export HTTP_PROXY="http://隧道ID:密碼@tps.zdaye.com:8080"' >> ~/.bash_profile
echo 'export HTTPS_PROXY="http://隧道ID:密碼@tps.zdaye.com:8080"' >> ~/.bash_profile
source ~/.bash_profile

小提示：Mac 用戶如果使用 LaunchAgent 實(shí)現(xiàn)開(kāi)機(jī)自啟，可以創(chuàng)建 ~/Library/LaunchAgents/ai.openclaw.ssh-tunnel.plist 持久化隧道服務(wù)。

臨時(shí)關(guān)閉代理

unset HTTP_PROXY HTTPS_PROXY

四、Linux 系統(tǒng)配置

Linux 服務(wù)器通常使用 Bash，配置方式與 Mac 類似，但注意區(qū)分桌面版和服務(wù)器的環(huán)境差異。

臨時(shí)生效（當(dāng)前會(huì)話）

export HTTP_PROXY="http://隧道ID:密碼@tps.zdaye.com:8080"
export HTTPS_PROXY="http://隧道ID:密碼@tps.zdaye.com:8080"
openclaw gateway start

永久生效（系統(tǒng)級(jí)）

將以下內(nèi)容添加到 ~/.bashrc（用戶級(jí)，推薦）：

echo 'export HTTP_PROXY="http://隧道ID:密碼@tps.zdaye.com:8080"' >> ~/.bashrc
echo 'export HTTPS_PROXY="http://隧道ID:密碼@tps.zdaye.com:8080"' >> ~/.bashrc
source ~/.bashrc

如果是系統(tǒng)級(jí)配置（所有用戶生效），編輯 /etc/environment：

HTTP_PROXY="http://隧道ID:密碼@tps.zdaye.com:8080"
HTTPS_PROXY="http://隧道ID:密碼@tps.zdaye.com:8080"

修改后需要 注銷重新登錄 或重啟系統(tǒng)。

服務(wù)器運(yùn)維小技巧

在生產(chǎn)環(huán)境，建議配合 PM2 實(shí)現(xiàn)開(kāi)機(jī)自啟和崩潰重啟：

npm install -g pm2
pm2 start openclaw --name openclaw-gateway -- gateway run
pm2 save && pm2 startup

五、Docker 環(huán)境配置（跨平臺(tái)一致）

無(wú)論在 Windows、Mac 還是 Linux 上跑 Docker，配置方式完全一致——通過(guò) docker-compose.yml 的 environment 字段傳遞環(huán)境變量：

services:
  openclaw:
    image: openclaw/openclaw:latest
    environment:
      - HTTP_PROXY=http://隧道ID:密碼@tps.zdaye.com:8080
      - HTTPS_PROXY=http://隧道ID:密碼@tps.zdaye.com:8080
      - NO_PROXY=localhost,127.0.0.1
    ports:
      - "18789:18789"
    restart: unless-stopped

關(guān)鍵提醒：容器內(nèi)不要手動(dòng) export，環(huán)境變量必須在 docker run 或 compose 中傳遞，否則重啟會(huì)丟失。

六、跨平臺(tái)配置速查表

七、驗(yàn)證代理是否生效

配置完成后，用 OpenClaw 的測(cè)試指令驗(yàn)證：

請(qǐng)?jiān)L問(wèn) https://httpbin.org/ip，告訴我返回的IP地址是什么

如果返回的 IP 不是你的本機(jī)IP，說(shuō)明配置成功。等 1-2 分鐘再問(wèn)一次，如果 IP 變了，說(shuō)明站大爺隧道代理的自動(dòng)輪換功能也在正常工作。

總結(jié)

跨平臺(tái)配置 OpenClaw 代理，核心就一件事：用環(huán)境變量，別折騰 YAML。

三句話記住全部要點(diǎn)：

Windows 用 PowerShell：$env:HTTP_PROXY=...，永久生效用 [Environment]::SetEnvironmentVariable

Mac 用 Zsh：export 寫(xiě)入 ~/.zshrc，source 后生效

Linux 用 Bash：export 寫(xiě)入 ~/.bashrc，source 后生效

Docker 全平臺(tái)一致：在 docker-compose.yml 的 environment 中配置，不用管宿主機(jī)是什么系統(tǒng)。

以上就是Windows/Mac/Linux下OpenClaw代理配置差異與實(shí)操指南的詳細(xì)內(nèi)容，更多關(guān)于Windows/Mac/Linux下OpenClaw代理配置的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論