2026年OpenClaw 安装指南及浏览器自动化

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

 <svg xmlns="http://www.w3.org/2000/svg" style="display: none;"> <path stroke-linecap="round" d="M5,0 0,2.5 5,5z" id="raphael-marker-block" style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);"></path> </svg>

GPT plus 代充只需 145

Node.js >= 22
操作系统：macOS、Linux 或通过 WSL2 的 Windows
pnpm：仅在从源代码构建时需要

1.1 前置准备

确保已安装 Node.js 22 或更高版本：

讯享网

如果未安装，请从 Node.js 官网下载并安装最新 LTS 版本。

1.2 快速安装（推荐）

使用 PowerShell 安装器脚本：

安装器将自动：

全局安装 openclaw
运行新手引导（onboarding）

1.3 手动安装

如果安装器脚本无法使用，可以手动安装：

讯享网

如果遇到 sharp 相关错误，使用以下命令：

1.4 配置和启动

1.4.1 配置 Windows PATH（重要）

为了确保命令可以在任何 PowerShell 或命令提示符中使用，需要将 npm 全局安装目录添加到系统 PATH 环境变量中。

方法一：使用 PowerShell 命令

讯享网

方法二：手动配置

打开系统属性：右键点击「此电脑」→「属性」→「高级系统设置」→「环境变量」
编辑用户变量：在「用户变量」中找到，点击「编辑」
添加路径：点击「新建」，输入 npm 全局路径（通常是）
保存更改：点击「确定」保存所有窗口
重新打开终端：关闭并重新打开 PowerShell 或命令提示符

1.4.2 启动和验证

1.5 启动 Gateway 网关

讯享网

2.1 前置准备

安装 WSL2

在 PowerShell（管理员）中运行：

在 WSL2 中安装 Node.js

讯享网

2.2 快速安装

2.3 手动安装

讯享网

2.4 配置和启动

2.4.1 配置 WSL2 PATH（重要）

为了确保命令可以在 WSL2 终端中使用，需要将 npm 全局安装目录添加到系统 PATH 环境变量中。

2.4.2 启动和验证

讯享网

2.5 从 Windows 访问 WSL2 服务

在 WSL2 中启动 Gateway 网关后，可以通过以下方式从 Windows 访问：

2.6 配置 SSH 访问

为了更安全地访问 WSL2 中的 OpenClaw 服务，可以配置 SSH 连接。

2.6.1 在 WSL2 中安装和配置 SSH 服务器

讯享网

2.6.2 配置 SSH 服务器

推荐配置修改：

讯享网

保存并退出后，重启 SSH 服务：

2.6.3 获取 WSL2 IP 地址

讯享网

记下显示的 IP 地址（例如：）。

2.6.4 从 Windows 通过 SSH 连接到 WSL2

在 Windows PowerShell 中：

首次连接时会提示确认主机指纹，输入继续，然后输入 WSL2 用户密码。

2.6.5 配置 SSH 隧道访问 OpenClaw Web 界面

通过 SSH 隧道，可以安全地从 Windows 访问 WSL2 中的 OpenClaw Web 界面。

讯享网

建立隧道后，在 Windows 浏览器中访问：

2.6.6 配置 SSH 密钥认证（可选）

为了更安全的访问，可以配置 SSH 密钥认证。

在 Windows 上生成 SSH 密钥对：

讯享网

将公钥复制到 WSL2：

在 WSL2 中设置权限：

讯享网

现在可以使用密钥认证登录：

2.6.7 配置 SSH 配置文件（可选）

在 Windows 上创建 SSH 配置文件以简化连接：

讯享网

添加以下内容：

现在可以使用简化的命令连接：

讯享网

2.6.8 后台运行 SSH 隧道

如果需要 SSH 隧道在后台持续运行：

2.6.9 WSL2 IP 地址变化问题

WSL2 的 IP 地址在每次重启后可能会变化。解决方法：

方法一：使用 Windows 主机名

讯享网

方法二：使用 PowerShell 获取 WSL2 IP

方法三：配置 hosts 文件

在 Windows 中编辑文件：

讯享网

然后使用作为主机名：

2.6.10 使用 Xshell 连接 WSL2

Xshell 是一款强大的 SSH 客户端，支持 Windows 系统。

2.6.10.1 下载和安装 Xshell

访问 Xshell 官网
下载并安装 Xshell（个人/家庭版免费）

2.6.10.2 配置 Xshell 连接

打开 Xshell，点击 →
会话属性设置：
- 名称：WSL2-OpenClaw
- 协议：SSH
- 主机：WSL2 的 IP 地址（如）
- 端口：22
用户身份验证：
- 方法：密码
- 用户名：WSL2 用户名
- 密码：WSL2 用户密码
保存并连接：
- 点击保存会话
- 双击会话名称连接到 WSL2

2.6.10.3 配置 Xshell 端口转发

为了访问 OpenClaw Web 界面，需要配置端口转发：

在 Xshell 中，点击 →
添加端口转发：
- 类型：本地
- 监听端口：18789
- 目标主机：localhost
- 目标端口：18789
保存设置

现在可以在浏览器中访问：

2.6.11 使用 FinalShell 连接 WSL2

FinalShell 是一款功能丰富的 SSH 客户端，支持 Windows、macOS 和 Linux。

2.6.11.1 下载和安装 FinalShell

访问 FinalShell 官网
下载并安装对应系统的版本

2.6.11.2 配置 FinalShell 连接

打开 FinalShell，点击左上角的按钮
新建连接：
- 连接类型：SSH
- 名称：WSL2-OpenClaw
- 主机：WSL2 的 IP 地址（如）
- 端口：22
- 用户名：WSL2 用户名
- 密码：WSL2 用户密码
保存并连接：
- 点击保存连接
- 双击连接名称连接到 WSL2

2.6.11.3 配置 FinalShell 端口转发

在 FinalShell 中，右键点击连接 →
端口转发：
- 点击
- 名称：OpenClaw Web
- 类型：本地
- 本地端口：18789
- 目标主机：localhost
- 目标端口：18789
保存设置

现在可以在浏览器中访问：

3.1 前置准备

安装 Node.js

使用 Homebrew 安装：

讯享网

或从 Node.js 官网下载安装包。

3.2 快速安装（推荐）

3.3 手动安装

讯享网

如果已全局安装 libvips（通过 Homebrew），可能需要：

3.4 配置和启动

3.4.1 配置 macOS PATH（重要）

为了确保命令可以在任何终端中使用，需要将 npm 全局安装目录添加到系统 PATH 环境变量中。

对于 Bash 用户：

讯享网

对于 Zsh 用户（macOS 默认）：

3.4.2 启动和验证

讯享网

3.5 使用 pnpm 安装（可选）

4.1 前置准备

安装 Node.js

Ubuntu/Debian:

讯享网

CentOS/RHEL:

Arch Linux:

讯享网

4.2 快速安装（推荐）

4.3 手动安装

讯享网

4.4 配置和启动

4.5 配置全局 PATH（重要）

为了确保命令可以在任何终端中使用，需要将 npm 全局安装目录添加到系统 PATH 环境变量中。

4.5.1 检查当前配置

讯享网

4.5.2 永久配置 PATH

对于 Bash 用户：

对于 Zsh 用户：

讯享网

4.5.3 立即生效（临时）

如果需要立即使用命令而不想重新启动终端：

4.5.4 验证配置

讯享网

5.1 默认 Web 界面

OpenClaw Gateway 网关启动后，会自动提供一个浏览器控制界面：

本地默认地址：
功能：查看会话、配置渠道、监控健康状态等

5.2 配置 Web 界面

配置文件位于：

配置选项：

: 是否启用 Web 界面（默认：true）
: 可选的 URL 路径前缀

5.3 远程访问配置

5.3.1 绑定到局域网接口

如果 OpenClaw 安装在 WSL2 或远程服务器中，可以通过以下命令将 Gateway 绑定到局域网接口，以便从其他设备访问：

讯享网

这样配置后，Gateway 网关会监听所有网络接口，允许从局域网内的其他设备访问 Web 界面。

5.3.2 使用 Tailscale（推荐）

集成 Serve 模式：

启动 Gateway 网关后，通过 Tailscale Magic DNS 访问：

Tailnet 绑定模式：

讯享网

访问地址：

使用公共互联网（Funnel）

5.4 认证配置

Gateway 网关默认需要认证。可以通过以下方式配置：

令牌认证：

讯享网

密码认证：

也可以通过环境变量设置：

讯享网

5.5 打开 Web 界面

或在浏览器中直接访问：

本地：
远程：根据配置的访问方式

5.6 完整配置文件示例

以下是一个完整的配置文件示例，包含了主要配置项的说明：

讯享网

配置文件主要配置项说明

配置项说明 Gateway 网关端口，默认 18789 绑定地址：（本地）、（局域网）、（Tailscale）认证模式：（令牌）或（密码）访问令牌 AI 模型提供商配置默认使用的 AI 模型备用模型列表是否启用浏览器扩展支持

使用配置文件命令

5.7 切换默认 AI 模型示例

5.7.1 切换到 Claude Sonnet 模型

讯享网

5.7.2 切换到百炼模型

6.1 找不到 openclaw 命令

症状： 运行时提示 “command not found”

解决方案：

讯享网

6.2 sharp 安装失败

症状： 安装时出现 sharp 相关错误

解决方案：

6.3 Gateway 网关无法启动

症状： 运行时出错

解决方案：

讯享网

6.4 Web 界面无法访问

症状： 浏览器无法打开

解决方案：

7.1 更新

讯享网

7.2 卸载

8.1 安装方式选择

讯享网

8.2 其他常用选项

8.3 环境变量

讯享网

OpenClaw 支持通过 Chrome 扩展控制 Windows 浏览器，本章节将详细介绍如何在 WSL2 环境中配置和使用此功能。

8.1 整体架构说明

8.2 环境准备

8.2.1 检查现有环境

Windows 端检查：

讯享网

WSL2 端检查：

8.2.2 所需软件清单

软件版本要求下载链接用途 VcXsrv ≥ 1.20 SourceForge X Server，显示 GUI Google Chrome 最新版官网被控制的浏览器 OpenClaw 2026.2.4+ npm install -g openclaw 自动化框架 WSL2 Ubuntu 22.04+ Microsoft Store Linux 子系统

8.3 Windows 端 VcXsrv 安装与配置

8.3.1 下载与安装

访问 VcXsrv 下载页面
下载最新版本（如 vcxsrv-64.1.20.14.0.installer.exe）
运行安装程序，使用默认设置完成安装

8.3.2 创建启动脚本（关键步骤）

在 VcXsrv 安装目录（通常是 C:Program FilesVcXsrv）创建启动脚本：

创建文件：

讯享网

8.3.3 防火墙配置

方法一：通过入站规则（推荐）

方法二：图形界面配置

打开 Windows Defender 防火墙 → 高级设置
入站规则 → 新建规则
选择端口 → TCP → 特定本地端口 6000 → 允许连接
重复步骤，选择程序 → 指向 vcxsrv.exe

8.3.4 启动 VcXsrv

首次启动（推荐）：

右键点击 start_vcxsrv.bat，选择 “以管理员身份运行”

设置开机自启（可选）：

按 Win + R，输入 shell:startup 打开启动文件夹
将 start_vcxsrv.bat 的快捷方式放入该文件夹

✅ 验证：任务栏右下角应出现 VcXsrv 图标（一个白色的 X）

8.4 WSL2 环境配置

8.4.1 安装必要的依赖包

讯享网

8.4.2 配置 DISPLAY 环境变量

方法一：使用本地回环地址（推荐，最稳定）

方法二：使用 WSL2 IP 地址

讯享网

8.4.3 验证 X Server 连接

✅ 成功标志：Windows 桌面弹出图形窗口，鼠标移动时眼睛跟随

8.4.4 故障时快速诊断脚本

讯享网

8.5 OpenClaw Chrome 扩展安装

8.5.1 安装扩展文件

8.5.2 在 Chrome 中加载扩展

在 Windows 中打开 Chrome 浏览器
访问扩展管理页面：chrome://extensions/
开启开发者模式（右上角开关）
加载已解压的扩展程序：
- 点击左上角 “加载已解压的扩展程序”
- 在地址栏输入 WSL 路径（根据你的用户名调整）：
```
讯享网
```
- 选择 chrome-extension 文件夹
固定扩展：点击工具栏拼图图标，找到 “OpenClaw Browser Relay”，点击图钉固定

8.5.3 验证扩展安装

8.6 OpenClaw 配置文件设置

8.6.1 查看当前配置

讯享网

8.6.2 创建或修改配置

确保包含以下核心配置（注意 JSON 格式正确）：

讯享网

8.6.3 重启服务

8.7 验证与测试

8.7.1 基本测试

讯享网

8.7.2 高级测试

创建测试脚本：

8.8 日常使用指南

8.8.1 常用命令

讯享网

8.8.2 配置多个浏览器

添加多个浏览器配置：

讯享网

8.9 故障排查手册

8.9.1 常见问题及解决方案

问题症状解决方案 X Server 连接失败运行 xeyes 无响应检查 VcXsrv 是否运行，防火墙是否放行端口 6000 浏览器扩展无法加载 Chrome 提示扩展无效确保使用正确的 WSL 路径格式，检查扩展文件权限浏览器控制无响应命令执行后无反应检查 DISPLAY 环境变量设置，重启浏览器服务端口冲突启动服务时提示端口被占用检查端口 18792 是否被其他进程占用，修改配置文件中的端口

8.9.2 日志查看

安装完成后，您可以：

配置聊天渠道：设置 WhatsApp、Telegram、Discord 等渠道
配置模型提供商：连接到 AI 模型服务
使用 Web 界面：通过浏览器管理和监控 OpenClaw
配置自动化：设置定时任务和自动化流程

详细文档请访问：https://docs.openclaw.ai/zh-CN

Q: OpenClaw 支持哪些操作系统？

A: OpenClaw 支持 macOS、Linux 和通过 WSL2 的 Windows。

Q: 是否需要付费？

A: OpenClaw 是开源项目，可以免费使用。但使用某些 AI 模型服务可能需要付费。

Q: 可以同时运行多个渠道吗？

A: 是的，OpenClaw 支持同时运行多个渠道，如 WhatsApp、Telegram、Discord 等。

Q: 如何保护我的隐私？

A: OpenClaw 支持本地部署，所有数据都在您的机器上处理。远程访问可以通过 Tailscale 等安全方式配置。

Q: Web 界面默认开启吗？

A: 是的，当资源存在时，Control UI 默认启用。您可以通过配置文件禁用它。

官方文档：https://docs.openclaw.ai/zh-CN
GitHub 仓库：https://github.com/openclaw/openclaw
问题反馈：在 GitHub Issues 中提交问题

祝您使用愉快！ 🚀