本文针对当前主流的OpenClaw（开源本地 AI 智能体，昵称 “小龙虾”，原项目名 Clawdbot/Moltbot），上一篇介绍了在docker下部署小龙虾，安全是极其安全了，但是对于我这种懒人真的很不友好，如果喜欢的朋友可以去看看。https://blog.csdn.net/Kmoyic/article/details/158735953?spm=1011.2415.3001.10575&sharefrom=mp_manage_link

今天我准备减少一层在wsl-Ubuntu部署OpenClaw

一、安装前必读与前置准备

1. 核心说明

OpenClaw 是一款开源、本地优先的 AI 智能体网关，本身不内置大模型，需要对接大模型 API 作为 “大脑”，可通过飞书、Telegram、钉钉等聊天软件下发指令，操控本地电脑执行文件管理、代码编写、自动化操作等各类任务。

2. 系统与环境要求

表格

项目	最低要求	推荐配置	说明
操作系统	Windows 10 2004+ / Windows 11	Windows 11 22H2+	需支持 WSL2，原生 PowerShell 兼容有限
运行环境	Node.js ≥ 22.0.0	Node.js 22.x LTS	核心依赖，低版本会直接安装失败
硬件配置	1GB 内存、500MB 磁盘空间	4GB + 内存、2GB + 磁盘	运行本地大模型需 16GB + 内存
网络要求	可访问国内镜像源	境外 VPN	访问 GitHub、国外大模型 API 必须使用境外 VPN

3. 前置软件官方下载地址

表格

软件	官方下载地址	必选 / 可选
Node.js	https://nodejs.org/	必选，必须下载≥22.x 的 LTS 版本
Git	https://git-scm.com/download/win	可选，建议安装，用于插件安装和源码拉取

4. 前置软件安装与验证

1. 安装 Node.js：下载对应 Windows 64 位安装包，双击运行，全程默认下一步，务必勾选 “Automatically install the necessary tools”，自动安装配套依赖。
2. 验证安装：以管理员身份打开 Windows PowerShell（Windows 11 可打开终端 (管理员)），执行以下命令，输出版本号即安装成功：

   powershell

   node -v
   npm -v
   

3. （可选）国内网络优化：切换 npm 为国内镜像源，提升下载速度，无需 VPN 即可安装核心程序：

   powershell

   npm config set registry https://registry.npmmirror.com

注意：因为 Windows PowerShell 的默认脚本执行策略（Execution Policy）限制了脚本运行，导致 npm 无法正常调用。解决方法非常简单，按以下步骤操作即可：

解决npm 无法正常调用步骤（3 步搞定）

1. 以管理员身份打开 PowerShell

你当前已经是 Administrator 用户，直接保持当前 PowerShell 窗口即可（如果不是管理员，右键点击 PowerShell 选择「以管理员身份运行」）。

2. 修改脚本执行策略

执行以下命令，将执行策略临时修改为 RemoteSigned（仅对当前用户生效，安全且够用）：

powershell

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

执行后会提示确认，输入 Y 然后按回车即可。

3. 验证 npm 是否恢复正常

再次执行版本检查命令，确认问题解决：

powershell

npm -v
node -v

如果能正常输出版本号（例如 10.x.x 和 v22.x.x），说明问题已解决！

二、Windows 详细安装步骤

提供 3 种安装方式，新手优先选方式一，追求稳定性选方式二，开发者选方式三。

方式一：PowerShell 一键安装（新手首选，Windows 原生）

1. 以管理员身份打开 Windows PowerShell / 终端
2. 临时放开脚本执行权限（避免系统拦截安装脚本），提示确认时输入 Y 回车：

   powershell

   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
   

3. 执行官方一键安装脚本：

   powershell

   iwr -useb https://openclaw.ai/install.ps1 | iex
   

   关键提示：若脚本下载失败、连接超时，必须开启境外 VPN后重试；国内用户可先完成 npm 镜像源切换，提升成功率。

4. 等待脚本自动执行：全程无需手动操作，脚本会自动完成环境检测、OpenClaw CLI 工具安装、基础环境配置。
5. 终端输出 OpenClaw 欢迎信息，即核心程序安装完成。

方式二：WSL2 环境安装（官方推荐，兼容性最佳）

Windows 原生环境存在权限和兼容性限制，官方强烈推荐在 WSL2 中安装 OpenClaw。

1. 一键安装 WSL2：以管理员身份打开 PowerShell，执行以下命令，执行完成后重启电脑：

   powershell

   wsl --install
   

2. 重启后系统会自动完成 Ubuntu 子系统配置，按提示设置 Ubuntu 的用户名和密码。
3. 打开终端，选择 Ubuntu 进入子系统环境，执行以下命令安装 Node.js 22+：

   bash

   运行

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
   source ~/.bashrc
   nvm install 22
   nvm use 22
   

4. 验证 Node.js 安装：

   bash

   运行

   node -v
   npm -v
   

5. 执行官方一键安装脚本（网络不佳时需开启境外 VPN）：

   bash

   运行

   curl -fsSL https://openclaw.ai/install.sh | bash
   

6. 终端输出欢迎信息，即安装完成。

方式三：npm 手动全局安装（适合开发者）

1. 以管理员身份打开 PowerShell/WSL2 终端
2. 执行全局安装命令，拉取最新稳定版：

   powershell

   npm install -g openclaw@latest
   

3. 命令执行无报错，即核心程序安装成功。

三、初始化配置向导（核心必做步骤）

安装完成后，必须执行初始化配置，才能正常使用 OpenClaw。

1. 终端执行以下命令，启动引导式配置向导：

   powershell

   # 基础配置向导
   openclaw onboard
   # 推荐：配置向导+安装系统守护进程（开机自启，后台持续运行）
   openclaw onboard --install-daemon
   

2. 核心配置步骤详解：
   1. 风险确认：向导会提示 OpenClaw 具备系统命令执行、文件读写权限，输入 yes 回车继续。
   2. 配置模式：新手选择 QuickStart 快速配置模式。
   3. 大模型选择：
      • 选择 OpenAI/Claude/Gemini 等国外模型，必须全程开启境外 VPN，并输入对应 API Key。
      • 国内用户优先选择通义千问（Qwen）、智谱 GLM、DeepSeek 等国内大模型，无需 VPN，输入对应平台的 API Key 即可。
   4. 技能包选择：新手默认全选官方推荐技能包即可。
   5. 网关配置：选择安装 Gateway 网关，配置为开机自启，向导会自动完成配置。
   6. 聊天渠道对接：按需选择飞书、Telegram、钉钉等聊天平台，按向导提示完成对接。
3. 配置完成后，向导会输出 Web UI 管理地址，默认地址为 http://127.0.0.1:18789。

四、功能测试与验证方法

完成安装配置后，按以下步骤逐层测试 OpenClaw 是否正常运行：

1. 基础运行状态测试

终端执行以下命令，验证核心程序状态：

powershell

# 验证CLI工具是否正常安装
openclaw --version
# 验证Gateway网关运行状态
openclaw gateway status

• 正常结果：输出版本号，网关状态显示 running。

2. Web UI 访问测试

打开浏览器，访问默认地址 http://127.0.0.1:18789，能正常打开 OpenClaw 管理界面，即 Web 服务正常。

3. 核心功能测试

在 Web UI 聊天框或已对接的聊天平台，发送以下指令，验证功能完整性：

1. 系统命令测试：请告诉我当前电脑的系统时间
   • 正常响应：返回当前系统准确时间，说明系统命令调用权限正常。
2. 文件操作测试：请在桌面创建一个名为openclaw_test.txt的文本文件，内容为“OpenClaw安装测试成功”
   • 正常响应：执行完成后，桌面出现对应文件，内容与要求一致，说明文件读写权限正常。
3. 大模型对接测试：写一段100字的春日随笔
   • 正常响应：大模型返回通顺、符合要求的文本，说明 API 对接正常，推理功能可用。

4. 守护进程测试

重启电脑后，终端执行 openclaw gateway status，若网关仍为 running 状态，说明开机自启配置成功。

五、关键提示与常见问题解决

1. VPN 相关提示

• 访问 GitHub、官方安装脚本、国外大模型 API 时，必须使用境外 VPN，否则会出现下载失败、连接超时、API 无响应等问题。
• 国内用户全程使用国内大模型 API+npm 国内镜像源，可无需 VPN 完成安装和基础使用。

2. 常见报错解决

• 报错 “npm 不是内部或外部命令”：Node.js 未正确添加到系统 PATH，重启终端或重新安装 Node.js，确保勾选添加到系统 PATH 选项。
• 报错 “权限不足”：必须以管理员身份运行 PowerShell / 终端，重新执行命令。
• 脚本执行被拦截：重新执行 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser 命令，放开脚本执行权限。
• 网关启动失败：检查 18789 端口是否被占用，执行 netstat -ano | findstr :18789 查看占用进程，结束进程后重试。
• 2026.3.13版的小龙虾 Web UI中我没有找到API Key配置位置，所以使用的是openclaw configure进行的配置。

3. 安全风险提示

• OpenClaw 具备系统级操作权限，请勿随意安装未知来源的第三方技能包，避免恶意代码执行风险。
• 不要将 OpenClaw 的网关端口暴露到公网，仅在本地可信环境使用，避免被远程攻击。
• 建议使用低权限用户运行 OpenClaw，不要长期以管理员 /root 权限运行，降低安全风险。

官方资源地址

• 项目官网：https://openclaw.ai/
• 官方 GitHub 仓库：https://github.com/openclaw/openclaw