OpenClaw Windows+wsl 安装保姆级教程

🦞 OpenClaw Windows 安装保姆级教程（零基础）

OpenClaw 是目前世界上最火的“个人 AI 管家”。和普通的 AI 聊天不同，它能在你的电脑上帮你自动处理任务，并且能够接入你常用的聊天软件（如 WhatsApp、Telegram 等），使得你可以随时随地在远程操控它帮你执行任务。

为了让 OpenClaw 稳定运行，我们需要在你的 Windows 电脑里装一个微软官方提供的“内置微型linux系统”（叫做 WSL）。不要被名字吓到，整个过程只需要输入几行命令。

🎯 我们的安装分为三步：

安装 WSL（为 AI 准备一个运行环境）
安装 Node.js（安装驱动 AI 运行的“驱动”）
安装 OpenClaw（安装你的龙虾）

第一步：安装 WSL（Windows 内置 Linux 系统）

这是微软官方提供的功能，非常安全，不会影响你电脑上原有的任何文件。

打开命令行工具

在电脑屏幕底部的 Windows 搜索栏中，输入 PowerShell。
在搜索结果中找到“Windows PowerShell”，点击右键，选择“以管理员身份运行”。
如果弹出一个窗口问你“是否允许此应用对你的设备进行更改”，请点击“是”。

输入安装命令

在弹出的蓝底或黑底窗口中，复制并粘贴下面这行代码（粘贴后按电脑键盘上的 Enter 回车键）：
```
wsl --install
```
此时电脑会自动下载并安装系统，请耐心等待进度条跑到 100%。

重启电脑

屏幕上提示“操作成功”后，请重启你的电脑。

设置用户名和密码（非常重要！）

电脑重启后，通常会自动弹出一个黑色的窗口（标题可能写着 Ubuntu）。如果没有自动弹出，请在 Windows 开始菜单里搜索 Ubuntu 并打开它。
窗口中会出现 Enter new UNIX username:，意思是让你起个英文名字（比如 tom 或 apple，必须全小写，不能有空格），输入后按回车。
接着会出现 New password:，意思是让你设置一个密码。
⚠️ 超级重点：在输入密码时，屏幕上不会显示任何字符或星号（）*！这是正常的安全机制。你只需要凭感觉在键盘上盲打你的密码，然后按回车。它会让你再输入一次确认，同样盲打并回车。
看到绿色的字出现，就说明系统安装成功了！这个黑框我们以后就叫它 Ubuntu 终端。

第二步：安装 Node.js（OpenClaw 的发动机）

OpenClaw 需要一个叫做 Node.js（版本号必须是 22）的软件才能跑起来。我们继续在刚才那个 Ubuntu 终端 黑色窗口里操作。

下载安装工具 (NVM)

复制下面这串代码，在 Ubuntu 终端里点击鼠标右键即可粘贴。粘贴后按 Enter 回车：
```
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
```
等待屏幕上的文字滚动停止。

让工具生效

继续复制并粘贴下面这行代码，按回车：
```
source ~/.bashrc
```
注意：这一步按回车后可能没有任何提示，这是正常的，说明成功了。

安装 Node.js 24 版本

复制并粘贴下面这行代码，按回车：
```
nvm install 24
```
电脑会自动下载“发动机”，等待几十秒，直到出现类似 Now using node v24... 的提示。

如果第二步安装失败，使用我编写的安装脚本进行一键安装

/bin/bash -c "$(curl -fsSL https://gitee.com/dmy-wang/nvm-install-cn/raw/main/install.sh)"

第三步：安装 OpenClaw

现在房间（WSL）和发动机（Node.js）都准备好了，可以把主角请进来了！

正式安装 OpenClaw

在 Ubuntu 终端里，复制粘贴下面这行代码并回车：

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

或者（亲测第一种速度更快）

npm install -g openclaw@latest

这时屏幕会快速滚动很多代码和进度条，说明正在从网上下载 OpenClaw。稍微等待一到两分钟，直到它停止滚动并回到可以输入命令的状态。

启动配置向导（唤醒管家）

复制粘贴最后一行代码并回车：
```
openclaw onboard --install-daemon
```

🎉 恭喜你！到这里所有的代码安装工作已经全部结束了！

第四步：跟着向导配置你的 AI 管家

运行了最后一行命令后，屏幕上会出现 OpenClaw 的交互式配置向导（Wizard）。这是一个问答式的界面，你只需要按照它的提示，一步步选择即可：

为了方便您管理 OpenClaw 的配置与 onboarding 流程，我将安装过程中的关键决策点整理为一份配置向导问答表。

您可以对照此表进行安装或排错。

请在执行 openclaw onboard --install-daemon 时根据以下选项进行配置：

第一部分：基础设置与安全

问题	选项/操作	说明
是否确认继续？	`Yes`	确认已知晓 OpenClaw 为个人代理，多用户使用需自行加固。
选择模式	`QuickStart`	推荐初学者使用，自动配置基础网关。
Gateway 配置	`Use existing values`	除非端口冲突，否则使用默认的 18789 端口。

第二部分：模型提供商配置 (重要)

提示：在使用此部分前，请务必前往火山引擎 (Ark) 或阿里云 (DashScope) 购买相应的 API Key。

问题	选项/操作	说明
Model/Auth Provider	`Custom Provider`	选择自定义以适配火山/阿里云接口。
API Base URL	`https://ark.cn-beijing.volces.com/api/coding/v3`	火山引擎 Ark 的官方 API 入口。
API Key	`[您购买的密钥]`	请勿泄露，在此处输入您的真实 Key。
Endpoint compatibility	`OpenAI-compatible`	此处选择 OpenAI 兼容协议。
Model ID	`ark-code-latest`	填写您在云控制台部署的模型名称。

第三部分：渠道 (Channels) 与功能配置

问题	选项/操作	说明
Select channel	`Skip for now`	建议先跑通 TUI，后期再通过 `openclaw channels` 添加。
Web search	`Skip for now`	若需搜索功能，后续需单独获取 Tavily 或 Google 的 API Key。
Configure skills	`No`	初始阶段建议跳过，避免配置过于复杂。
Enable hooks	`Skip for now`	高级自动化功能，初次安装建议先保持默认。

第四部分：启动运行

问题	选项/操作	说明
Gateway service	`Restart`	确保配置生效并重启后台服务。
How to hatch?	`Hatch in TUI`	推荐。直接进入交互界面测试配置是否成功。

💡 安装后的常见问题自查

Q: 启动 TUI 时提示 No API key found for provider？

A: 您的 API Key 未被正确注入到特定的 Agent 配置文件中。
解决方法:

运行 openclaw agents add main 手动关联。
或者将 ~/.openclaw/agents/main/agent/auth-profiles.json 中的字段补全。

Q: 如何获取并更新 API Key？

火山引擎: 进入火山引擎 Ark 控制台，创建推理节点并获取 API Key。
阿里云: 进入阿里云 DashScope 控制台获取。

Q: 我想在安装后重新修改配置？

A: 重新执行 openclaw onboard。

注：OpenClaw 处于 Beta 阶段，强烈建议在配置完成后运行 openclaw doctor 检查是否正常运行。

💡 给新手的防坑小贴士：

复制粘贴技巧：在 Windows 的 Linux 黑框框里，千万不要用 Ctrl + V 来粘贴，直接在窗口里点击“鼠标右键” 就可以把复制好的代码粘贴进去了。
关掉黑框也没关系：一切设置好之后，你可以直接点击右上角的 X 关掉那个黑色的 Ubuntu 窗口。OpenClaw 已经在你电脑的后台默默为你工作了。
隐私警告：OpenClaw 运行在你自己电脑上，拥有很高的权限。绝对不要把你的 API 密钥或者密码截图发给陌生人！

*下一篇将说明如何将飞书接入openclaw，以便于在手机与openclaw对话