位置：AI门户网
> AI应用 > AI智能体 > WSL2环境OpenClaw安装部署指南
在当今AI工具层出不穷的时代，一个能够真正理解指令并直接帮你操作电脑的智能体，无疑具有巨大的吸引力。OpenClaw，这个因其红色龙虾图标而被昵称为“龙虾”的开源项目，正是这样一位能干的数字助手。它不同于那些只会对话的聊天机器人，而是能直接执行文件整理、邮件发送、数据监控等具体任务的智能体。对于Windows用户而言，官方强烈推荐通过WSL2来运行OpenClaw，以获得最佳的兼容性和稳定性。今天，我们就来手把手地、一步一步地，完成在WSL2中部署OpenClaw的全过程。
你可能会有疑问：既然有Windows原生的一键安装脚本，为什么还要折腾WSL2呢？这确实是个好问题。根据官方文档和大量社区实践，原因主要有三点：
1.完整的Linux兼容性：OpenClaw的整个工具链，包括Node.js生态、系统守护进程（systemd）等，都深深植根于Linux环境。WSL2提供了一个几乎原生的Linux内核，完美避免了在Windows PowerShell中可能遇到的各种依赖库和路径兼容性问题。
2.卓越的运行性能：WSL2使用了真正的Linux内核，相比早期的WSL1或模拟环境，在文件I/O和系统调用方面性能大幅提升，这对于需要持续运行并快速响应的AI网关服务至关重要。
3.一致的开发体验：许多为OpenClaw开发的“技能”（Skills）和社区工具都默认面向Linux环境。在WSL2中运行，意味着你可以无缝使用这些生态资源，无需为Windows做额外适配。
所以，虽然初期配置看起来多了一步，但这条路能为你后续的稳定使用省去无数麻烦，可以说是“磨刀不误砍柴工”。
万事开头难，但准备工作做得好，后面就顺风顺水。我们需要确保两件事：一个可用的WSL2环境，以及其中的Ubuntu系统。
第一步：启用WSL2并安装Ubuntu
这个过程其实微软已经做得非常简化了。以管理员身份打开PowerShell或Windows终端，然后输入下面这个“魔法”命令：
```powershell
wsl --install
```
这个命令会自动启用所需的Windows功能、下载Linux内核并安装默认的Linux发行版（通常是Ubuntu）。完成后，重启电脑。重启后，首次启动Ubuntu，系统会提示你创建新的用户名和密码，这个账号将用于后续所有操作。
第二步（关键！）：启用systemd
这是很多教程会忽略，但却是OpenClaw网关服务能正常安装为后台守护进程的核心前提。WSL2默认并不启用systemd。我们需要手动配置一下。
在Ubuntu终端中，编辑WSL的配置文件：
```bash
sudo nano /etc/wsl.conf
```
将以下内容粘贴进去：
```
[boot]
systemd=true
```
保存并退出（按`Ctrl+O`，回车，再按`Ctrl+X`）。然后关闭所有Ubuntu窗口和PowerShell窗口。在Windows开始菜单搜索“PowerShell”，以管理员身份运行，执行：
```powershell
wsl --shutdown
```
等待几秒后，重新打开Ubuntu终端。现在，验证systemd是否成功启用：
```bash
ps -p 1 -o comm=
```
如果返回的是 `systemd` 而不是 `init`，那么恭喜你，最难的一关已经过了。
环境准备好了，现在可以正式邀请OpenClaw入驻了。官方提供了几种安装方式，为了最省心，我们直接采用推荐的一键安装脚本。
在Ubuntu终端中，只需输入一条命令：
```bash
curl -fsSL https://openclaw.ai/install.sh | bash
```
这个脚本非常智能，它会自动检测你的系统是否已安装Node.js（版本要求22或更高），如果没有则会帮你安装，然后自动下载并设置OpenClaw命令行工具（CLI）。整个过程可能需要几分钟，取决于你的网络速度，期间可能会下载不少依赖包，请耐心等待。
安装脚本运行完毕后，它很可能会自动启动一个名为“onboarding”的配置向导。如果它没有自动启动，或者你想稍后再配置，任何时候都可以通过以下命令手动启动这个核心向导：
```bash
openclaw onboard --install-daemon
```
注意，这里的 `--install-daemon` 参数至关重要，它告诉系统将OpenClaw网关（Gateway）注册为一个systemd用户服务，这样它就能在后台持续运行，即使你关闭了终端窗口。
安装只是赋予了它身体，配置才是赋予它灵魂和能力的步骤。跟着`onboarding`向导的指引，你需要做出几个关键选择：
1.运行模式：通常选择`local`（本地模式）即可。
2.模型与授权：这是核心。你需要为OpenClaw连接一个大脑——也就是大语言模型。它支持多种供应商，如OpenAI的ChatGPT、Anthropic的Claude，也支持本地部署的模型如Ollama。官方建议，为了获得最佳体验和更低的提示词注入风险，应使用你能获取到的最新一代强模型。你可以选择使用OAuth授权（如ChatGPT订阅）或直接输入API密钥。
3.网关设置：网关是OpenClaw的核心服务，负责协调一切。端口一般用默认的`18789`就行。
4.通道配置：这里你可以连接它到日常使用的通讯软件，比如Telegram、Discord、飞书等，这样以后就能直接在聊天软件里给它派任务了。初次安装可以先跳过，后续再添加。
务必注意：向导的每一步都请明确选择或确认，不要随意跳过，否则可能导致配置不完整，向导陷入循环引导。
配置完成后，网关服务应该已经作为后台守护进程运行起来了。我们可以用几个命令来检查一下它的状态：
```bash
systemctl --user status openclaw-gateway.service
```
如果看到“active (running)”的字样，说明服务运行正常。
更直观的方式是打开它的控制面板（Dashboard）。在你的Windows浏览器中，直接访问：
```
http://127.0.0.1:18789
```
如果一切顺利，你将看到OpenClaw的Web控制界面。首次打开，可能需要你输入网关令牌（Token）。这个令牌通常已经在配置过程中自动生成并保存了，你可以在终端里用以下命令查看：
```bash
cat ~/.openclaw/openclaw.json | grep token
```
将查看到的令牌填入Web页面的对应输入框，点击“连接”。当控制台右上角显示“健康状况：正常”时，就大功告成了！
从Windows访问WSL中的服务
因为WSL2有自己的虚拟网络，为了让Windows上的浏览器或其他应用能方便地访问运行在WSL里的OpenClaw网关（端口18789），通常不需要额外设置，localhost回环地址是互通的。但如果遇到无法访问的情况，可以检查一下WSL的`.wslconfig`文件，确保网络模式设置为`mirrored=true`，这能简化网络配置。
安装后的功能拓展
OpenClaw的真正威力在于其“技能”（Skills）系统。你可以从官方的ClawHub安装各种技能，让它具备操作电脑文件、编写代码、管理邮件等能力。在Dashboard或通过CLI都可以方便地管理技能。
常见问题速查表
为了帮你快速定位问题，这里整理了一个简易排错表格：
| 问题现象 | 可能原因 | 解决方法 |
|---|---|---|
| :--- | :--- | :--- |
| `onboarding`向导循环启动 | 之前的配置步骤被跳过或不完整。 | 重新运行`openclawonboard`，确保每一步都完成确认。 |
| Dashboard无法连接/Token无效 | 网关服务未启动，或Token未正确配对。 | 1.检查服务状态：`systemctl--userstatusopenclaw-gateway.service` 2.手动重启服务：`openclawgatewayrestart` 3.在Dashboard页面手动填入正确的Token并连接。 |
| `sharp`等Node原生模块安装失败 | WSL环境中缺少编译依赖或与全局库冲突。 | 尝试在安装时设置环境变量：`SHARP_IGNORE_GLOBAL_LIBVIPS=1npminstall-gopenclaw@latest`。 |
| 网关服务启动失败 | 最可能的原因是systemd未启用。 | 务必按照前文“启用systemd”的步骤进行检查和配置，并重启WSL。 |
至此，你的个人AI助手已经在WSL2中成功安家。它静静地运行在后台，等待着你的指令。无论是通过Web聊天界面，还是未来接入到你熟悉的Telegram、微信等通讯工具，你都可以随时让它帮你整理文件、查询信息、甚至编写代码。
回顾整个过程，核心其实就是三步：搭建好WSL2环境（尤其别忘启用systemd）、用官方脚本安装OpenClaw、跟着引导完成配置。OpenClaw的魅力在于其开源和可扩展性，这意味着它的能力边界将由你和社区共同定义。安装只是开始，接下来探索各种技能，将它融入你的工作流，才能真正释放这个“龙虾助手”的潜力，让你从繁琐的重复操作中解放出来，体验AI从“动口”到“动手”的变革性力量。
版权说明：
