中文基础版0.1.9安装配置指南（WSL2 Ubuntu版

  我发这个的程宗旨是想让你和我一样，0编程基础但能够自己动手安装配置openclaw，并感受用中文字符控制开源项目的魅力，整体浏览完后，完全可以跟着我的步骤一步一步进行安装，全程无脑复制代码到终端即可（复制后在终端按鼠标右键即可粘贴）；

 这不是原版的OpenClaw，这是一个基于原版的更适合国内用户使用的openclaw-cn，也更适合小白上手体验，随时可以卸载再安装原版；

  安装前检查电脑是否有谷歌浏览器和WIN系统自带的Edge浏览器，建议用谷歌浏览器打开openclaw的网页对话，用Edge浏览器辅助openclaw进行网页扩展。

  免责声明：本教程仅提供安装配置指导和交流，因OpenClaw 为开源项目，使用请遵守相关协议。API Key 充值请自行保管好账户安全。

一、安装 WSL2 Ubuntu 终端

在 Windows桌面右键开始菜单找到“windowsPowerShell（管理员）”通常在菜单里的任务管理器选项上方。

在打开的PowerShell终端执行以下命令：（所有代码复制后只要点鼠标右键就可以复制到终端界面了）

代码：

wsl --install -d Ubuntu-22.04

输入这段代码后会终端就会全自动安装WSL2 Ubuntu终端，等待PowerShell 终端界面的代码停止后就是完成了，之后重启电脑。

在 PowerShell 中执行：

代码：

wsl -l -v

确保 Ubuntu终端的的版本列为 2（即 WSL2）。

从开始菜单找到并打开 “Ubuntu”终端，按提示输入用户名（英文输入，最好简单点）和密码（输入时什么也不会显示，最好是简单的数字方便你记录）。输入两次密码后直接回车就创建好了你在“Ubuntu”终端里的账户

这一步很重要：为的是你不一直使用 root最高权限用户操作龙虾让你的信息会更安全，创建普通用户后不影响龙虾的基础功能

如果密码输入没弄清楚，直接关闭终端界面重新打开“Ubuntu”终端。

二、在 WSL2 Ubuntu 终端中安装 Node.js

以下所有命令均在普通用户下执行（提示符是绿色的是你上面设置的用户名@...:~$）出现这个就说明你成功创建了“Ubuntu”终端里的账户，并且每次重新打开“Ubuntu”终端确保你能看到用户名@...:~$，如果看到类似root@...:~$，就输入：su - 用户名 然后回车（-前后各一个空格）

代码：

sudo apt update

代码：

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

执行完这条命令后，等待它运行完成，会看到一堆输出，最后出现 * Runsudo apt install -y nodejsto install Node.js 22.x and npm 之类的提示，然后继续。

代码：

sudo apt install -y nodejs

正式安装完成然后验证安装

3.验证安装

代码：

node --version

应显示版本号 v22.x.x

代码：

npm --version

应显示版本号 10.x.x

如果这一步没有显示版本号按照以下步骤排查：

第一步：确认 Node.js 是否已安装：

Ubuntu终端粘贴：

代码：

which node

如果显示的文字里有路径（如 /usr/bin/node），说明已安装。

如果没有看到，说明未安装，需要重新安装安装 Node.js 22.x。

第二步：如果已安装但 node 仍找不到：

代码：

echo $PATH

如果显示的内容没有 /usr/bin

代码：

export PATH=$PATH:/usr/bin:/usr/local/bin

和：

echo 'export PATH=$PATH:/usr/bin:/usr/local/bin' >> ~/.bashrcsource ~/.bashrc

然后回到验证安装步骤看看有没有显示版本号

4. 配置 npm 用户级全局安装目录（避免权限问题）

创建用户级 npm 全局目录（Ubuntu终端粘贴）：

代码：

mkdir -p ~/.npm-global

配置 npm 使用该目录

代码：

npm config set prefix '~/.npm-global'

将该目录添加到 PATH

代码：

echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

验证 PATH 是否生效

代码：

echo $PATH

显示的文字中应该包含/home/你的用户名/.npm-global/bin

然后测试：

代码：

openclaw-cn --version

如果能显示版本号，说明 PATH 配置成功。

如果不显示版本号：确认文件是否存在

代码：

ls -l ~/.npm-global/bin/openclaw-cn

如果显示文件信息（如 -rwxr-xr-x），说明安装成功，继续下一步。

如果显示 No such file or directory，说明安装失败，需要重新安装。

（回到上面的配置 npm 用户级全局安装目录（避免权限问题）重新进行）

三、配置OpenClaw-cn中文社区基础版

1. 设置 npm 国内镜像（加速）（Ubuntu 终端粘贴）

代码：

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

2.配置openclaw-cn

代码：

npm install -g openclaw-cn@latest

安装过程中会出现 npm warn deprecated 警告，属于正常现象，不影响使用。

3. 最后验证安装

代码：

openclaw-cn --version

应显示类似 0.1.8-fix.3 的版本号。说明安装成功

如果不显示版本号：

1.确保目录存在

代码：

mkdir -p ~/.npm-global

2.配置 npm 使用这个目录

代码：

npm config set prefix '~/.npm-global'

3.确认配置生效

代码：

npm config get prefix

看看是不是显示/home/你的用户名/.npm-global

4.把这个目录加到 PATH

代码：

export PATH="$HOME/.npm-global/bin:$PATH"echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrcsource ~/.bashrc

5.清理可能残留的错误安装

代码：

npm uninstall -g openclaw-cn 2>/dev/nullnpm cache clean --force

代码：

npm install -g openclaw-cn@latest

代码：

openclaw-cn --version

应显示类似 0.1.8-fix.3 的版本号。

四、配置 OpenClaw 网关

1. 运行配置向导

代码：

openclaw-cn onboard

向导会依次询问，请按以下建议选择（方向键加回车）：

安全警告：Yes

安装引导模式：手动

您想要设置什么？：本地网关（此机器）

工作区目录：默认 ~/.openclaw/workspace

模型提供商：DeepSeek（请先跳到本文末尾【❤获取 DeepSeek API Key❤】部分，获取 Key 后再继续）默认模型：deepseek/deepseek-chatGateway port：8086（或 8000–9999 之间任意）Gateway bind：LAN (0.0.0.0)（重要：选这个才能从 Windows 访问）Gateway auth：Password，设置密码（请牢记后面网页会用到）Tailscale exposure：Off技能安装：Yes，后选择npm钩子：暂时跳过（方向键加空格选择后回车）

没有方向键同Tab 键进行选择（键盘Q左边这个）

2. 启动网关

代码：

openclaw-cn gateway start

3.（可选）如果提示端口被占用，更换端口：

代码：

openclaw-cn config set gateway.port 8087

openclaw-cn gateway restart

4. 打开网页控制面板

代码：

openclaw-cn dashboard

浏览器会自动打开 http://127.0.0.1:（8086或你设置的端口8000–9999 之间的数字）。

如果没有自动打开网页

直接手动打开网页后输入http://127.0.0.1:（8086或你设置的端口8000–9999 之间的数字）

首次登录：

在浏览器网页左侧找到 “概览” 标签

在 “网关访问” 区域输入你设置的密码

右边状态变为 “已连接” 后，即可在 “对话” 界面开始使用

进入终端对话界面（Ubuntu 终端粘贴）：openclaw-cn tui网页对话：浏览器粘贴http://127.0.0.1:（8086或你设置的端口）

❤获取 DeepSeek API Key❤

这里建议使用deepseek模型提供商，亲测是Token最省的且最好用的大模型

而且界面简洁明了：

deepseek API TOKEN界面

网页打开https://platform.deepseek.com/进入后先登陆，之后按顺序点击→API keys→创建API Keys→输入名称（随便填方便记忆就好）→看到出现的key以后直接复制粘贴到模型提供商：DeepSeek这一步里，千万不要关闭对话框，粘贴完再关闭，如果不小心关闭了，就删除刚才创建的API Keys 重新生成，这个过程不花钱，然后在用量信息里点击去充值，建议就冲10快钱先试试，10快够用很多很多次对话了，如果无法充值，看看是不是没有实名制。获取并复制 API Key 后，回到 Ubuntu 终端继续配置向导。如果向导已退出，重新执行：openclaw-cn onboard

最后测试：

1.openclaw-cn --version显示版本号

2.openclaw-cn gateway status显示 running

3.浏览器能打开网页控制面板并登录

4.能发送一条测试消息并收到回复

5.后续更新命令：npm update -g openclaw-cn

网页对话启动成功的界面

如果你看到一个这样的网页界面和终端界面，那么就恭喜你成功安装opeclaw-cn了

WSL内的openclaw-cn卸载：

打开WSL 终端（Ubuntu），依次执行：

停止网关：

代码：

openclaw-cn gateway stop

卸载网关服务（如果存在）

代码：

openclaw-cn gateway uninstall

删除所有相关的 PM2 进程（如果你用过）

代码：

pm2 delete claw-relay 2>/dev/null

pm2 kill

第二步：删除 OpenClaw 相关文件和配置

删除配置和技能目录

代码：

rm -rf ~/.openclaw

（这里正常什么也不显示）

删除 npm 全局安装的 openclaw-cn

代码：

npm uninstall -g openclaw-cn

（显示这个就已经说明openclaw-cn已经卸载了）

清理 npm 缓存（可选

代码：

npm cache clean --force

验证卸载

代码：

which openclaw-cn

应该显示 "openclaw-cn not found"或者什么也没有

检查配置目录：

代码：

ls ~/.openclaw

看到有： No such file or directory，说明配置路径已卸载

第三步：删除可能残留的 node_modules（可选）

如果你在 WSL 里还装过其他 Node.js 工具，可以一并清理：

删除用户级的 npm 全局目录

代码：

rm -rf ~/.npm-global

清理 PATH 配置（如果之前添加过）

（没有就什么也不会显示）

验证是否删除成功：

代码：

ls ~/.npm-global

（如果看到有： No such file or directory，说明配置路径已卸载）

以上流程让openclaw-cn在WSL内应该就彻底清理干净了

查看已安装的 WSL 发行版

代码：

wsl -l -v

注销 Ubuntu（会删除所有数据）

代码：

wsl --unregister Ubuntu-22.04

如果需要，可以重新安装一个全新的 Ubuntu

代码：

wsl --install -d Ubuntu-22.04

注意：这个操作会删除整个 Ubuntu 环境，包括你之前在WSL 里做的所有事情。