OpenClaw WSL安装配置教程（亲测有效，避坑指南）

本文全程基于实际操作流程编写，解决WSL环境下OpenClaw安装卡死、命令报错、无法访问等问题，步骤简洁可复制，新手也能快速上手。

一、前置准备

• 环境要求：WSL2 Ubuntu 子系统（确保Windows与WSL网络互通）

• 依赖要求：已安装 Node.js（v20+），无需额外配置

• 必备密钥：提前在 DeepSeek开放平台 申请API Key（sk-开头，确保账号有余额）

二、核心安装步骤（避免卡死，亲测有效）

打开WSL终端（Ubuntu），执行以下命令，跳过编译脚本，避免安装卡死：

npm install -g openclaw --registry=https://registry.npmmirror.com --ignore-scripts --no-fund

关键说明：

• –registry：国内源，下载速度翻倍，避免海外源卡顿

• –ignore-scripts：跳过所有编译脚本，彻底解决WSL安装卡死问题

• 等待安装完成，无需手动干预

三、验证安装成功

执行以下命令，输出版本号即代表安装成功：

openclaw --version

成功输出示例：OpenClaw 2026.4.0（版本号可不同，正常）

四、初始化配置（必做）

执行初始化命令，按提示完成配置：

openclaw onboard

配置步骤（全程按提示操作，无需额外修改）：

1. 安全提示确认：选「Yes」（按方向键切换，回车确认）

2. 模型选择：保持默认「DeepSeek」，回车确认

3. 输入API Key：粘贴提前准备的DeepSeek API Key（sk-开头）

4. 后续配置：全部选「Skip」或默认选项，无需额外操作

五、启动与访问（核心步骤）

新版OpenClaw无start命令，启动方式如下，全程不要关闭终端：

openclaw dashboard

执行后会生成带Token的访问链接，示例：

Dashboard URL: http://127.0.0.1:1878/#token=xxxxxxx

操作要点：

• 复制终端输出的完整链接，在Windows浏览器打开

• 无需修改IP，WSL会自动映射端口，直接访问即可

• 关闭服务：按「Ctrl+C」终止终端进程即可

六、常用命令速查（避坑版）

命令

作用

说明

openclaw dashboard

启动服务+打开面板

唯一有效启动命令，不要用start/run

openclaw onboard

重新初始化配置

API Key错误时，用此命令重新配置

openclaw status

查看服务运行状态

排查服务是否正常运行

七、常见问题及解决方案（亲测有效）

1. 安装卡死/报错

问题：执行安装命令时，终端卡住不动

解决：按「Ctrl+C」终止当前进程，重新执行本文第二步的安装命令（带–ignore-scripts）

2. 提示“unknown command: start/run”

问题：新版OpenClaw已废弃start/run命令，属于正常现象

解决：用「openclaw dashboard」替代，启动服务

3. 浏览器无法访问面板

问题：端口占用或网络映射异常

解决：重新执行「openclaw dashboard」，复制终端输出的新链接，直接访问

4. 401认证失败

问题：API Key错误或余额不足

解决：重新执行「openclaw onboard」，输入正确的API Key，确保账号有可用余额

八、总结

本教程全程基于实际操作，避开所有坑点：

• 安装用国内源±-ignore-scripts，避免卡死

• 启动用「openclaw dashboard」，替代废弃的start/run命令

• 配置全程默认/skip，无需额外操作，新手也能快速上手

按照步骤操作，即可顺利使用OpenClaw，有其他报错可直接留言~