OpenClaw + ClashX 代理配置指南:本地 AI Agent 在中国如何稳定运行

什么是 OpenClaw

OpenClaw 是 2026 年 3 月 GitHub 上增长最快的开源项目,上线不到半年已超过 21 万 Stars。它由奥地利开发者 Peter Steinberger(PSPDFKit 创始人)在 2025 年底作为个人项目创建,2026 年 2 月被 OpenAI 收购,目前正转型为独立的 OpenClaw 基金会运营。

和 ChatGPT 网页版不同,OpenClaw 是一个本地运行的自主 AI Agent。它装在你自己的电脑上,连接你已有的聊天工具(WhatsApp、Telegram、Discord、Slack、Signal、iMessage),然后真正替你执行任务——管理邮件、安排日历、操作文件、执行终端命令、自动化浏览器,7×24 小时不间断。

OpenClaw 支持对接任意 LLM 后端:OpenAI GPT、Anthropic Claude、本地模型(Llama、Phi)、DeepSeek 等。你的数据默认留在本地,除非你主动发送 API 请求。

🔥
中国市场现象

OpenClaw 在中国引发了 Mac Mini 抢购潮——大量用户购买 Mac Mini 作为 24 小时 AI Agent 服务器。「养龙虾」(指持续运行 OpenClaw)已成为中文互联网热词。腾讯、阿里、字节跳动分别推出了基于 OpenClaw 的定制版本(QClaw、ArkClaw、JVS Claw)。

为什么在中国使用 OpenClaw 需要代理

OpenClaw 本身运行在本地,但它的功能依赖外部服务连接。以下是中国用户面临的网络限制:

LLM API 访问受限

  • OpenAI API(api.openai.com)— 完全屏蔽中国 IP,无法调用 GPT 模型
  • Anthropic API(api.anthropic.com)— 同样屏蔽中国 IP,Claude 模型不可用
  • Google AI(generativelanguage.googleapis.com)— Gemini API 受地区限制
  • DeepSeek API(api.deepseek.com)— 中国公司,可直连,不需要代理

消息平台全部被墙

OpenClaw 的核心体验是通过聊天工具下达指令。但这些平台在中国大陆全部无法直接访问:

  • WhatsApp — web.whatsapp.com、*.whatsapp.net
  • Telegram — *.telegram.org、*.t.me
  • Signal — *.signal.org
  • Discord — *.discord.com、*.discord.gg

安装依赖受影响

  • GitHub — 下载速度极慢或超时(github.com、raw.githubusercontent.com)
  • npm — registry.npmjs.org 可能连接不稳定

结论:如果你用 OpenAI/Anthropic 模型 + 任何被墙的聊天平台,ClashX 代理是刚需。如果你只用 DeepSeek 本地模型且不连接消息平台,可以不用代理。

ClashX + OpenClaw 代理分流规则配置

首先确保已 下载安装 ClashX 并导入可用的机场订阅。以下配置将 OpenClaw 相关流量精确分流。

💡
嫌手动编辑 YAML 麻烦?试试 ClashFX

ClashX 基础版没有可视化配置编辑器,所有规则修改都需要手动打开 config.yaml 文件编辑,对新手不太友好。我们推出的 ClashFX 提供了可视化规则编辑界面,添加节点组、分流规则只需点击操作,不用手写 YAML。如果你不熟悉配置文件格式,建议先 下载 ClashFX 体验

1. 创建 AI Agent 专用节点组

OpenClaw 的 API 调用和消息平台连接需要长时间稳定运行,建议创建独立的节点组,与日常浏览分开:

proxy-groups:
  # OpenClaw 专用节点组 — 自动选择延迟最低的节点
  - name: "🤖 AI Agent"
    type: url-test
    url: http://www.gstatic.com/generate_204
    interval: 600
    tolerance: 200
    proxies:
      - 🇺🇸 美国-住宅IP
      - 🇯🇵 日本-独享节点
      - 🇺🇸 美国-独享节点

  # 手动切换备用
  - name: "🤖 AI手动"
    type: select
    proxies:
      - 🤖 AI Agent
      - 🇺🇸 美国-住宅IP
      - 🇯🇵 日本-独享节点
      - DIRECT
💡
为什么 interval 设为 600、tolerance 设为 200?

OpenClaw 是长时间运行的 Agent,频繁切换节点会导致 API 连接中断。600 秒检测间隔 + 200ms 容差可以减少不必要的节点切换,保持连接稳定。这和普通浏览上网的配置(interval: 300, tolerance: 50)有本质区别。

2. AI 平台 API 分流规则

rules:
  # === OpenAI ===
  - DOMAIN-SUFFIX,openai.com,🤖 AI Agent
  - DOMAIN-SUFFIX,oaiusercontent.com,🤖 AI Agent
  - DOMAIN-SUFFIX,oaistatic.com,🤖 AI Agent
  - DOMAIN-SUFFIX,chatgpt.com,🤖 AI Agent

  # === Anthropic (Claude) ===
  - DOMAIN-SUFFIX,anthropic.com,🤖 AI Agent
  - DOMAIN-SUFFIX,claude.ai,🤖 AI Agent

  # === Google AI ===
  - DOMAIN-SUFFIX,generativelanguage.googleapis.com,🤖 AI Agent
  - DOMAIN-SUFFIX,aistudio.google.com,🤖 AI Agent

  # === DeepSeek(中国直连)===
  - DOMAIN-SUFFIX,deepseek.com,DIRECT

  # === 消息平台 ===
  # WhatsApp
  - DOMAIN-SUFFIX,whatsapp.com,🤖 AI Agent
  - DOMAIN-SUFFIX,whatsapp.net,🤖 AI Agent

  # Telegram
  - DOMAIN-SUFFIX,telegram.org,🤖 AI Agent
  - DOMAIN-SUFFIX,t.me,🤖 AI Agent
  - DOMAIN-SUFFIX,telegra.ph,🤖 AI Agent
  - IP-CIDR,91.108.0.0/16,🤖 AI Agent,no-resolve
  - IP-CIDR,149.154.160.0/20,🤖 AI Agent,no-resolve

  # Signal
  - DOMAIN-SUFFIX,signal.org,🤖 AI Agent
  - DOMAIN-SUFFIX,whispersystems.org,🤖 AI Agent

  # Discord
  - DOMAIN-SUFFIX,discord.com,🤖 AI Agent
  - DOMAIN-SUFFIX,discord.gg,🤖 AI Agent
  - DOMAIN-SUFFIX,discordapp.com,🤖 AI Agent
  - DOMAIN-SUFFIX,discord.media,🤖 AI Agent

  # Slack
  - DOMAIN-SUFFIX,slack.com,🤖 AI Agent
  - DOMAIN-SUFFIX,slack-edge.com,🤖 AI Agent

  # === 开发工具(安装/更新)===
  - DOMAIN-SUFFIX,github.com,🤖 AI Agent
  - DOMAIN-SUFFIX,githubusercontent.com,🤖 AI Agent
  - DOMAIN-SUFFIX,npmjs.org,🤖 AI Agent
  - DOMAIN-SUFFIX,npmjs.com,🤖 AI Agent

  # === 其他流量直连 ===
  - MATCH,DIRECT

3. 已有 AI 分流规则的用户

如果你已经按照我们的 AI 工具代理分流教程 配置了 OpenAI/Anthropic 的规则,只需在现有规则基础上追加消息平台域名即可,不需要重复配置 API 域名。

Mac Mini 24 小时挂机方案

OpenClaw 最大的价值在于 7×24 小时持续运行。很多用户专门买了 Mac Mini 作为 AI Agent 服务器。以下是保证稳定运行的关键配置。

1. 阻止系统睡眠

Mac 默认会在不活动时进入睡眠,这会导致 OpenClaw 断线和 ClashX 代理中断。

# 方法一:使用 caffeinate 阻止睡眠(推荐)
# -s 阻止系统睡眠,-d 阻止显示器睡眠
caffeinate -s -d &

# 方法二:通过系统设置
# 系统设置 > 节能 > 取消勾选以下选项:
#   - 如果可能,让硬盘进入睡眠
#   - 在电池供电时启用 Power Nap
# 将「在不活动后关闭显示器」设为「永不」

2. ClashX 开机自启

确保断电重启后 ClashX 自动恢复代理:

  • ClashX 菜单栏 → 偏好设置 → 勾选「登录时启动」
  • 勾选「设置为系统代理」自动开启
  • 如果使用 TUN 模式,确保已授予 ClashX 辅助功能权限

3. 代理稳定性配置

24 小时运行对代理稳定性要求很高。以下参数针对长期运行优化:

# 全局 DNS 配置 — 避免 DNS 泄露影响 Agent
dns:
  enable: true
  enhanced-mode: fake-ip
  fake-ip-range: 198.18.0.1/16
  nameserver:
    - 223.5.5.5
    - 119.29.29.29
  fallback:
    - tls://8.8.8.8:853
    - tls://1.1.1.1:853
  fallback-filter:
    geoip: true
    geoip-code: CN

# 连接保活设置
keep-alive-interval: 30
tcp-concurrent: true

4. 监控与自动恢复

为防止长期运行中代理或 Agent 意外中断,建议配置简单的健康检查脚本:

#!/bin/bash
# 保存为 ~/check-openclaw.sh,添加到 crontab 每 5 分钟执行

# 检查 ClashX 代理是否可用
if ! curl -s --proxy http://127.0.0.1:7890 \
     --connect-timeout 5 \
     https://api.openai.com/v1/models > /dev/null 2>&1; then
    osascript -e 'display notification "ClashX 代理连接异常,请检查" with title "OpenClaw 监控"'
fi

环境变量与代理设置

安装 OpenClaw

OpenClaw 通过 npm 安装,需要先确保终端走代理:

# 设置终端代理(ClashX 默认端口 7890)
export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890

# 安装 OpenClaw
npx openclaw init

# 验证安装
openclaw --version

持久化代理环境变量

将代理设置写入 shell 配置文件,避免每次开终端都要手动设置:

# 编辑 ~/.zshrc(macOS 默认 shell)
# 添加以下内容:

# ClashX 代理
export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
export no_proxy=localhost,127.0.0.1,deepseek.com,*.deepseek.com

# 保存后执行
source ~/.zshrc
💡
no_proxy 的作用

将 deepseek.com 加入 no_proxy 列表,这样 OpenClaw 调用 DeepSeek 模型时直连而不走代理,减少延迟和代理流量消耗。如果你使用其他中国可直连的服务,也可以加入此列表。

TUN 模式(推荐)

如果不想手动配置环境变量,可以开启 ClashX 的 TUN 模式。TUN 模式在系统网络层接管所有流量,OpenClaw 的所有网络请求都会自动走 ClashX 分流规则,无需额外设置。

开启方式:ClashX 菜单栏 → Config → Enable TUN Mode。详细教程参见 ClashX TUN 模式设置教程

安全注意事项

OpenClaw 拥有操作系统级别的权限——它可以读写文件、执行终端命令、访问浏览器。这意味着代理链路的安全性直接影响你的系统安全。

必须做的

  • 使用加密代理协议 — 确保你的机场节点支持 TLS 加密(Trojan、VLESS+TLS、Shadowsocks AEAD)。API Key 会通过代理传输,明文协议有泄露风险
  • 不要使用免费/公共节点 — 免费节点的运营者可以截获你的 API 请求,窃取 OpenAI/Anthropic API Key
  • 开启 DNS 防泄露 — 使用 fake-ip 模式或加密 DNS,防止 DNS 查询暴露你访问了哪些 AI 平台
  • 定期轮换 API Key — 即使使用可信代理,也建议每 1-2 个月更换一次 API Key

数据隐私

OpenClaw 的架构设计是隐私优先——所有数据存储在本地,不经过 OpenClaw 的服务器。但你发送给 LLM 的 prompt 和上下文会通过代理节点传输到 API 端点。确保你信任代理节点的运营方。如果处理敏感数据,建议使用完全本地的模型(如 Llama 4 Lite 或 Phi-4),这样数据完全不离开你的机器。

常见问题 FAQ

Q: OpenClaw 安装时 npm 超时怎么办?

A: 先确认 ClashX 正在运行,然后在终端设置代理:export https_proxy=http://127.0.0.1:7890。如果仍然超时,尝试切换 npm 镜像源:npm config set registry https://registry.npmmirror.com(注意:OpenClaw 本身的某些依赖可能仍需从原始 registry 下载)。

Q: OpenClaw 连接 API 报错 Connection refused?

A: 检查以下几点:1)ClashX 是否已开启系统代理或 TUN 模式;2)代理端口是否正确(默认 7890);3)在 ClashX 连接面板中确认 api.openai.com 走的是代理节点而非 DIRECT;4)节点是否可用(在 ClashX 中手动测试延迟)。

Q: 使用本地模型(如 Llama)还需要代理吗?

A: 模型推理本身不需要——本地模型直接在你的 Mac 上运行。但如果 OpenClaw 同时连接了 Telegram、WhatsApp 等消息平台来接收指令,这些平台在中国被封锁,仍然需要 ClashX 代理。如果你只通过本地终端和 OpenClaw 交互且只用本地模型,则完全不需要代理。

Q: Mac Mini 睡眠后 OpenClaw 断线怎么办?

A: 在终端运行 caffeinate -s -d & 阻止系统睡眠。同时在系统设置 > 节能中将所有睡眠选项关闭。如果用的是 Mac Mini 通过网线连接,还要确保「唤醒以供网络访问」已勾选。

Q: OpenClaw 和已有的 ClashX AI 分流规则冲突吗?

A: 不冲突。如果你已按照 AI 工具代理分流教程 配置了 OpenAI/Anthropic 的规则,OpenClaw 的 API 请求会自动匹配这些规则走代理。你只需额外添加消息平台(Telegram/WhatsApp/Discord)的域名规则即可。

Q: DeepSeek 在中国能直连吗?

A: 可以。DeepSeek 是中国公司(深度求索),api.deepseek.com 在中国大陆可以直接访问。在 ClashX 规则中将 DOMAIN-SUFFIX,deepseek.com,DIRECT 放在 AI 规则之前,这样 OpenClaw 调用 DeepSeek 时走直连,省流量也减少延迟。