引言

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

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

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

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

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

一、為什么跨平臺配置容易“翻車”？

核心原因有兩個：

第一，不同平臺的終端語法不同。

Windows 的 CMD 和 PowerShell 用 set 或 $env:，Linux/Mac 用 export。搞混了就會報錯。

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

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

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

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

方法一：PowerShell（推薦，功能最強）

PowerShell 是微軟新一代跨平臺 Shell，對 OpenClaw 的兼容性最好。

臨時生效（當(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（命令提示符，兼容舊腳本）

臨時生效：

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 后，新打開的命令行窗口會生效，當(dāng)前窗口不會。

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

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

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

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

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

臨時生效（當(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 實現(xiàn)開機自啟，可以創(chuàng)建 ~/Library/LaunchAgents/ai.openclaw.ssh-tunnel.plist 持久化隧道服務(wù)。

臨時關(guān)閉代理

unset HTTP_PROXY HTTPS_PROXY

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

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

臨時生效（當(dāng)前會話）

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

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

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

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)級配置（所有用戶生效），編輯 /etc/environment：

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

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

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

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

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

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

無論在 Windows、Mac 還是 Linux 上跑 Docker，配置方式完全一致——通過 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)不要手動 export，環(huán)境變量必須在 docker run 或 compose 中傳遞，否則重啟會丟失。

六、跨平臺配置速查表

七、驗證代理是否生效

配置完成后，用 OpenClaw 的測試指令驗證：

請訪問 https://httpbin.org/ip，告訴我返回的IP地址是什么

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

總結(jié)

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

三句話記住全部要點：

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

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

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

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

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

最新評論