Openclaw本地安装调试

1、启用 WSL2

不少朋友在 Windows 上想运行 Linux 环境，第一步往往卡在配置上。其实没那么复杂，关键是把 WSL2 这个基础打好。

首先，咱们需要以管理员身份打开 PowerShell。方法很简单：右键点击开始菜单，选择“Windows PowerShell (管理员)”就行。

接下来，在打开的 PowerShell 窗口里，依次执行下面三条命令。别担心，这就是在给系统添加必要的功能组件：

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

wsl --set-default-version 2

命令执行完毕后，记得重启电脑，让所有设置生效。这是至关重要的一步，可别跳过。

2、 安装Ubuntu

系统重启后，就该安装 Linux 发行版了。这里以 Ubuntu 22.04 LTS 这个长期支持版为例，稳定又好用。

打开 Microsoft Store，搜索“Ubuntu 22.04.5 LTS”，找到安装程序。当然，你也可以直接通过官方链接进入：

Ubuntu 22.04.5 LTS - Windows官方下载 | 微软应用商店 | Microsoft Store

找到后，点击获取并安装。安装过程基本是自动的，双击运行下载好的安装程序，跟着提示走就行。

3、成功之后设置用户名及密码

安装完成后，首次启动 Ubuntu，会看到一个终端窗口。这里需要你设置一个 UNIX 用户名和密码。注意，这个密码输入时是不显示字符的，正常输入后回车确认即可。

4、更新系统和装依赖

系统装好，第一件事当然是更新软件源并升级已有包，同时安装一些后续常用的基础工具。在 Ubuntu 终端里，执行下面这两条命令：

sudo apt update && sudo apt upgrade -y

sudo apt install -y curl git wget build-essential

5、安装 Node.js

很多现代开发工具都依赖 Node.js 环境。安装起来也很方便，通过官方提供的脚本添加源，然后直接安装即可。

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

sudo apt install -y nodejs

安装完成后，别忘了验证一下版本，确保安装成功：

node -v

npm -v

6、安装 OpenClaw

主角登场。OpenClaw 提供了一个便捷的安装脚本，一行命令就能搞定：

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

如果一切顺利，你会看到安装成功的提示。

7、打开看板链接

安装完成后，OpenClaw 服务会自动启动，并在终端输出一个本地访问链接。直接复制这个链接到浏览器打开就行，例如：

http://localhost:18789/#token=4409e0c09a1885cd81d2e84fe333bc2ece6f1cc8132352d8

打开后，应该就能看到 OpenClaw 的聊天界面，可以进行基础对话了。

8、修改权限

不过先别急，默认设置下部分工具功能可能未启用。为了获得完整体验，我们需要调整一下配置文件。

编辑 OpenClaw 的配置文件，使用 vim 命令：

vim ~/.openclaw/openclaw.json

在配置文件中，找到与工具权限相关的部分，确保其设置正确（具体需根据版本和需求调整）。保存退出后，重启网关服务使配置生效：

openclaw gateway restart

9、登录查看tools的权限全部打开

重启服务后，再次登录 OpenClaw 看板。这时检查工具（Tools）页面，应该能看到所有可用工具的权限都已经被正确打开了。

10、下达控制命令执行

权限配置妥当，就可以试试它的实际控制能力了。例如，尝试一些简单的系统命令或文件操作。

问题解决：

如果在使用模型时遇到授权问题，比如需要接入通义千问，可以使用以下命令进行授权：

openclaw models auth login --provider qwen-portal

执行后，命令行会给出一个授权链接，打开链接并按照页面提示完成登录授权流程即可。