核心设置步骤（通用流程）

openclaw OpenClaw博客 2026-04-09 1

无论哪个版本,设置通常遵循以下路径：

核心设置步骤（通用流程）-第1张图片-OpenClaw 中文站-AI龙虾中文社区

获取与解压
- 从 GitHub Releases 页面下载最新的发布包（通常是 zip 或 tar.gz 格式）。
- 将其解压到您电脑上一个路径没有中文和特殊符号的文件夹中（D:\Tools\openclaw 或 ~/Applications/openclaw）。
配置核心文件
- 在解压后的文件夹中,找到最重要的配置文件，它通常是：
  - config.yaml
  - config.json
  - 或 settings.toml
- 用文本编辑器（如记事本、VS Code、Notepad++）打开这个文件。
- 关键配置项（您必须修改或检查）：
  - 上游服务器地址：server 或 upstream 字段，您需要一个可用的 Clash 或 Clash Meta 内核的订阅链接。
  - 混合端口：mixed-port，通常为 7890，这是系统代理和 HTTP 代理使用的端口。
  - 外部控制：external-controller: 127.0.0.1:9090，这是 GUI 控制内核的端口，必须开启，GUI 依赖它。
  - 规则和策略组：如果您使用订阅链接，这部分通常会自动生成，如果您想自定义规则，可以在此修改。
准备内核（最重要的一步）
- OpenClaw GUI 本身只是一个界面，它需要调用一个名为 Clash 或 Clash.Meta 的核心程序来处理网络流量。
- 您需要根据您的操作系统下载对应的内核,并将其放入 OpenClaw 的目录中。
- 常见做法：
  - 在 OpenClaw 文件夹内，寻找 resources、clash-core 或 bin 子文件夹。
  - 将下载的 Clash 内核（Windows 是 clash-windows-amd64.exe，macOS 是 clash-darwin-amd64）重命名为简单的 clash 或 clash.exe，然后放入上述目录。
  - 很多打包好的 OpenClaw 发布版已经自带了内核，请先检查，如果没有，您需要从 Clash 或 Clash.Meta 的 GitHub 主页下载。
启动与连接
- 运行 OpenClaw 的主程序（OpenClaw.exe）。
- 首次启动时,GUI 可能会要求您选择或导入配置文件，指向您修改好的 config.yaml。
- 在 GUI 界面中，通常有一个 “系统代理” 开关，打开它，系统流量就会通过 Claw 路由。
- 在 “代理” 或 “Proxies” 选项卡中，选择您想要使用的节点策略（如 Global， Rule 或具体节点）。

针对不同操作系统的简要提示

Windows

启动文件：直接双击 OpenClaw.exe。
内核：确保有 clash-windows-amd64.exe 或 clash.exe 在正确目录。
设置系统代理：GUI 内一键开关通常有效，如无效，可手动在 设置 -> 网络 -> 代理 中配置：0.0.1:7890。
常见问题：如果启动失败，请以管理员身份运行，并检查防火墙是否拦截。

macOS

启动文件：打开 OpenClaw.app，如果提示“无法验证的开发者”，请前往 系统设置 -> 隐私与安全性 中允许。
内核：内核需要被放在应用程序包内（OpenClaw.app/Contents/Resources），通常打包时已处理。
设置系统代理：GUI 内开关或使用第三方工具（如 ClashX Pro, Clash Verge 的增强模式）来设置系统代理更稳定，也可以手动在 系统设置 -> 网络 -> 高级 -> 代理 中配置。

Linux

启动：通常为可执行文件或 AppImage，通过终端 ./OpenClaw 运行可能看到更多错误信息。
内核：需要明确指定内核路径，或将其放在 PATH 环境变量中。
设置系统代理：GUI 内开关可能不生效，需要在 系统设置 -> 网络 -> 网络代理 中手动设置，或使用命令行工具如 gsettings（GNOME）或 export http_proxy（临时）。

快速检查清单（遇到问题先看这里）

配置文件格式是否正确？ 用在线 YAML/JSON 校验工具检查 config.yaml。
内核是否存在且有权执行？ 检查核心文件是否在正确位置，并尝试在终端/命令提示符中手动运行它看是否报错。
控制端口是否被占用？ 确保没有其他 Clash 类程序（如 Clash for Windows, ClashX）在运行，它们会占用 9090 或 7890 端口。
订阅链接是否有效？ 手动用浏览器访问一下您的订阅链接，看是否能下载到一个配置文件。
查看日志！ OpenClaw 通常有日志窗口（Logs 或 Console），任何错误信息都会显示在这里，这是解决问题的关键。