WSL子系统安装OpenClaw保姆级教程(系列1)

在国内安装OpenClaw，最核心的一步是先给 npm (Node.js 的包管理器) 配置上国内镜像源，这样能极大提升下载速度和成功率。下面我为你梳理了两种主流的安装方法，可以根据你的系统和需求来选择。

💡 核心：配置国内镜像源

无论你使用哪种方法，都建议先设置好 npm 的国内镜像源。打开你的终端（命令行工具），输入以下命令：

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

设置完成后，可以通过 npm config get registry 来验证是否成功。

⚙️ 方法一：使用中文社区版

这是一个非常适合国内用户的方法。该版本专门将依赖打包，完美适配国内网络环境，且进行了完整汉化。

- 一句话概括：运行 `npm install -g openclaw-cn@latest`。

- 具体步骤：

1. 环境检查：确保你的电脑已安装 Node.js 22 或更高版本。

2. 执行安装：在终端中运行以下命令进行全局安装：

bash npm install -g openclaw-cn@latest

3. 启动向导：安装完成后，运行初始化命令，它会引导你完成后续的模型选择等配置：

bash openclaw-cn onboard --install-daemon

4. 启动服务：最后，启动网关服务即可：

bash openclaw-cn gateway --port 18789

⚙️ 方法二：使用官方版

如果你想体验原汁原味的官方版本，也可以直接安装 openclaw。这个方法在各类教程中也很常见。

- 一句话概括：运行 `npm install -g openclaw@latest`。

- 具体步骤：

1. 环境检查：同样需要 Node.js 22 或更高版本。

2. 执行安装：在终端中运行：

bash npm install -g openclaw@latest

> 小贴士：如果在安装过程中遇到与 `llama.cpp` 相关的报错，可以尝试添加 `--ignore-scripts` 参数来跳过编译：

> npm install -g openclaw@latest --ignore-scripts

3. 启动向导：运行 `openclaw onboard` 进入配置流程。

4. 启动服务：完成配置后，运行 `openclaw gateway --port 18789` 启动服务。

🚀 安装后快速上手

安装并启动服务后，就可以开始使用啦：

- 访问 Web 管理界面：在浏览器中打开 `http://127.0.0.1:18789/` 。

- 获取访问令牌：首次访问可能需要令牌，可以在终端中用 `openclaw token generate` 命令生成。

- 使用命令行界面：直接在终端输入 `openclaw tui` 就能进入文本交互模式。

💡 常见问题与提示

- 云服务器用户：如果你是在云服务器上安装，记得在云服务商的控制台防火墙设置中放行 `18789` 端口，这样才能从外部访问 Web UI 。

- 免费大模型：在配置向导中，如果选择 Qwen（千问）模型，OpenClaw 官方每天会为文本和视觉模型提供一定次数的免费调用，非常适合入门体验。

希望这些步骤对你有帮助。如果在安装过程中遇到具体的报错信息，随时可以再来问我，我会尽力帮你一起看看～