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

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

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

🎯 我们的安装分为三步：

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

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

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

1. 打开命令行工具

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

2. 输入安装命令

• 在弹出的蓝底或黑底窗口中，复制并粘贴下面这行代码（粘贴后按电脑键盘上的 Enter 回车键）：

  wsl --install

• 此时电脑会自动下载并安装系统，请耐心等待进度条跑到 100%。

3. 重启电脑

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

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

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

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

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

1. 下载安装工具 (NVM)

• 复制下面这串代码，在 Ubuntu 终端里点击鼠标右键即可粘贴。粘贴后按 Enter 回车：

  curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

• 等待屏幕上的文字滚动停止。

2. 让工具生效

• 继续复制并粘贴下面这行代码，按回车：

  source ~/.bashrc

• 注意：这一步按回车后可能没有任何提示，这是正常的，说明成功了。

3. 安装 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）都准备好了，可以把主角请进来了！

1. 正式安装 OpenClaw
• 在 Ubuntu 终端里，复制粘贴下面这行代码并回车：

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

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

npm install -g openclaw@latest

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

1. 启动配置向导（唤醒管家）
• 复制粘贴最后一行代码并回车：

  openclaw onboard --install-daemon

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

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

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

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

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

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

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

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

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

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

第四部分：启动运行

💡 安装后的常见问题自查

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

• A: 您的 API Key 未被正确注入到特定的 Agent 配置文件中。
• 解决方法:
1. 运行 openclaw agents add main 手动关联。
2. 或者将 ~/.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对话