OpenClaw安装及常见报错解决

1.安装WSL

首先，我们需要在Windows上开启Linux子系统。操作很简单：以管理员身份打开PowderShell，然后输入下面这行命令：

wsl --install

命令执行完毕后，系统会提示你重启电脑。这一步可不能省，重启之后WSL的安装才算真正完成。

2.安装Ubuntu系统

电脑重启后，我们再次以管理员身份进入PowerShell。接下来，安装一个具体的Linux发行版，比如Ubuntu 24.04。输入的命令是：

wsl --install Ubuntu-24.04

安装过程会弹出一个新窗口，引导你完成Ubuntu的初始设置。这里会要求你创建一个用户名，并设置密码。注意了，Linux系统下输入密码时，屏幕上不会有任何显示（比如星号*），这属于正常现象，放心输入并按回车确认即可。

3.在Linux中安装openclaw

准备工作就绪，现在开始安装主角。分两步走：

第一步，进入Linux环境。 在PowerShell里输入 wsl 然后回车。当你看到命令行的提示符变成了 `用户名@主机名` 的格式时，恭喜，你已经成功切换到了Ubuntu子系统内部。

第二步，执行安装。 直接复制粘贴下面这条命令：

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

接下来的工作就交给脚本了，它会自动完成所有依赖项的检查和安装。你只需要泡杯茶，耐心等待进度条走完。

4.配置OpenClaw

安装完成后，第一次使用前需要进行简单的初始化。在刚才的Linux命令行里输入：

openclaw onboard

这个命令会启动一个交互式的配置向导，引导你完成基础设置，让OpenClaw准备就绪。

5.常见报错及解决

安装配置过程偶尔会遇到一些小麻烦，别担心，这里有几个大概率会碰到的坑以及填坑方法。

1）当进行openclaw初始化最后一步时会报系统控制错误：

这个错误通常是因为WSL环境里缺少完整的系统服务管理。一个临时的解决办法是“伪造”一下 systemctl 命令：

sudo ln -s /bin/true /usr/local/bin/systemctl

执行完上面的初始化后，如果你想让环境恢复原状，可以删除这个软链接：

sudo rm /usr/local/bin/systemctl

成功初始化后，你会看到重启Gateway的提示，这就说明第一步配置妥了：

2）手动创建密钥配置文件：

如果配置向导没有自动生成密钥文件，你可能需要参考官方文档，手动创建并填写相关的API密钥配置文件。这一步通常和你要接入的AI服务提供商有关。

3）调用了openclaw未识别的模型

遇到这个报错，意思是配置文件里指定的模型名称OpenClaw不认识。解决方法是打开配置文件，把模型名称更换成它支持的对列表里的一个。用这个命令编辑配置：

nano ~/.openclaw/openclaw.json

找到模型配置的部分，修改并保存即可。

4）对话界面：

全部配置好后，就可以启动服务开始使用了。首先，在Linux终端里启动网关服务：

openclaw gateway

服务启动后，你有两种方式进入对话界面：

方式一，使用终端界面(TUI)。 新开一个Linux终端窗口，输入：

openclaw tui

一个简洁的终端对话界面就会直接打开。

方式二，使用网页界面。 打开你电脑上的浏览器，在地址栏输入：

http://127.0.0.1:18789/chat?session=main

你将看到一个功能更丰富的图形化聊天窗口。