OpenClaw详细版配置教程

1. 简介openClaw就是一个开源的AI助手项目接下来介绍一下windows系统的本地部署教程。2. 步骤由于官方推荐在windows系统中使用WSL2运行openclaw。原因是windows也可以运行但某些插件可能出现兼容性不足的问题问题比较多而WSL2是经过官方稳定测试的因此需要先安装一个WSL2。2.1 安装WSL2到D盘0. 以管理员身份打开PowerShell或命令提示符 (CMD)逐条运行以下命令开启WSL2所需的功能。启用WSL功能:powershelldism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart启用虚拟机平台:powershelldism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart设置WSL2为默认版本(Win10用户必须执行Win11通常默认):powershellwsl --set-default-version 2重启电脑使所有更改生效。重启后再次以管理员身份打开 PowerShell开始安装和迁移。安装Ubuntu (默认到C盘):powershellwsl --install -d Ubuntu如果想指定版本例如Ubuntu 20.04可以使用wsl --install -d Ubuntu-20.04。安装过程中系统会提示你创建一个新的用户名和密码请记住它 。关闭所有WSL实例:powershellwsl --shutdown在D盘创建文件夹:在D盘创建一个你喜欢的文件夹用于存放Linux系统文件。例如D:\WSL\Ubuntu。导出系统为镜像文件:powershellwsl --export Ubuntu D:\WSL\Ubuntu\ubuntu.tar注意Ubuntu是你的发行版名称可通过wsl -l -v查看确认。注销并删除C盘的原系统:powershellwsl --unregister Ubuntu执行此命令后C盘空间会被释放 。将系统导入到D盘的新位置:powershellwsl --import Ubuntu D:\WSL\Ubuntu D:\WSL\Ubuntu\ubuntu.tar --version 2这个命令的意思是将发行版Ubuntu安装到D:\WSL\Ubuntu目录数据来源于D:\WSL\Ubuntu\ubuntu.tar并指定使用WSL2版本 。成功后你会在D:\WSL\Ubuntu文件夹里看到一个ext4.vhdx文件这就是你的整个Linux文件系统。启动 Ubuntu 并切换到 Root 用户在 PowerShell 或 CMD 中启动你的 Ubuntu 发行版你现在应该是 root 用户powershellwsl -d Ubuntu-20.04如果启动后不是 root可以先输入su并回车。编辑或创建wsl.conf文件在 Ubuntu 终端内使用下述命令来创建或修改配置文件bashvi /etc/wsl.conf添加配置内容在打开的文件中添加以下内容将xxx替换为你自己的用户名(不会用Linux VI操作的自行百度)[user]default xxx保存并退出编辑器按ESC然后输入:wq保存。输入exit退出登录回到PowerShell。完全重启 WSL 发行版为了让配置生效需要在 Windows 的 PowerShell 中终止该 WSL 实例。这一步非常重要否则配置不会生效powershellwsl --terminate Ubuntu-20.04请确保这里的发行版名称Ubuntu与你导入时使用的名称一致验证配置重新启动 Ubuntupowershellwsl -d Ubuntu此时你应该会看到命令行提示符从root...变成了xxx...说明默认用户已经成功切换为你自己的用户了。2.2 在WSL2中部署openClaw1、首先按住winx选择windows终端(管理员)然后在终端下输入官网推荐的命令如下图curl -fsSL https://openclaw.ai/install.sh | bash在运行上述命令之前一定要确保在WSL2里已安装Cmake版本大于3.9最后输入openclaw --version检验是否安装成功。2、等待安装好之后运行向导输入以下命令openclaw onboard --install-daemon3、敲击回车之后开始运行向导如下图所示4、此处个人选择的是minimax因为注册之后会送TOKEN可以先用来体验一下当然有实力的更推荐Anthropic。接下来按住回车进入下一项选择如下图5、接下来选择第一项即可然后此时会自动跳转到minimax的网页授权即可。然后下一步选择接入平台这里你可以接入飞书等我这里暂时不接入所以选择跳过如下图6、然后选择是否配置skillskill就是封装的一个流程化的工作流这里我先选择跳过有需要可以后边再进行配置如下图7、接下来将下图四个都选择按住空格就可以选择如下图8、下边就是安装网关gateway默认点击即可。最后选择do this later如下图9、接下来运行下述命令openclaw dashboard然后回车此时就会跳转到web界面即开始chat提需求和执行任务了如下图3. 故障排查Q1执行命令wsl --install -d Ubuntu-20.04后出现下述信息Installing, this may take a few minutes... 参考的对象类型不支持尝试的操作。解决方法如下重启 LxssManager 服务以管理员身份打开 PowerShell运行powershellnet stop LxssManagernet start LxssManager重置 Winsock 目录在管理员 PowerShell中运行以下命令然后必须重启电脑powershellnetsh winsock reset重启后再次尝试安装wsl --install -d Ubuntu-20.04。Q2wsl --import Ubuntu D:\WSL\Ubuntu-20.04 D:\WSL\Ubuntu-20.04\Ubuntu-20.04.tar --version 2 WSL 2 执行完上述命令显示需要更新其内核组件。解决方法如下访问内核更新下载安装包在打开的页面中找到“适用于 x64 计算机的 WSL2 Linux 内核更新包”这一部分点击下载.msi格式的安装文件。安装内核下载完成后以管理员身份运行这个.msi安装包按提示完成安装。重启 WSL安装成功后重新打开 PowerShell再次执行你刚才的导入命令powershellwsl --import Ubuntu D:\WSL\Ubuntu-20.04 D:\WSL\Ubuntu-20.04\Ubuntu-20.04.tar --version 2Q3输入openclaw --version命令后返回openclaw: command not found。解决方法在终端中运行以下命令查看全局 npm 包列表npm list -g --depth0 | grep openclaw如果输出类似openclaw2026.2.26说明包已安装但命令不可用问题出在 PATH。1.确定 npm 全局 bin 目录运行以下命令获取 npm 的全局安装根目录bashnpm config get prefix输出可能类似/home/liu/.npm-global或/usr/local。那么 bin 目录就是在这个路径后面加上/bin例如/home/liu/.npm-global/bin或/usr/local/bin。2.将目录添加到 PATH假设你找到的 bin 目录是/home/liu/.npm-global/bin执行bashexport PATH/home/liu/.npm-global/bin:$PATH然后测试bashopenclaw --version3.如果能显示版本号说明成功。然后将其永久添加到~/.bashrcbashecho export PATH/home/liu/.npm-global/bin:$PATH ~/.bashrcsource ~/.bashrcQ4运行openclaw gateway start失败1、先在wsl终端运行sudo vi /etc/wsl.conf加入以下内容[boot] systemdtrue注意[boot]与systemd之间不能有空隙然后保存。2、关闭所有终端重新打开wsl2先运行ystemctl --user status看systemd会话是否成功运行如果显示绿灯则成功。3、最后运行即可# 启动服务 systemctl --user start openclaw-gateway.service4、openclaw接入deepseek步骤1、获取 DeepSeek API 密钥访问 DeepSeek 开放平台 注册/登录。进入控制台 →API Keys→ 创建新的 API Key复制保存以sk-开头。2、 在 OpenClaw 中配置 DeepSeek 模型使用交互式配置向导最稳妥bashopenclaw configure --section model按提示操作模型提供商选择Custom ProviderAPI Base URL输入https://api.deepseek.com不要加/v1API Key粘贴您的sk-xxxEndpoint compatibility选择OpenAI-compatibleModel ID输入deepseek-reasonerR1或deepseek-chat通用验证等待验证成功如遇 402 错误说明余额不足需充值Endpoint ID输入一个标识符例如deepseek-2设置默认模型选择是3、重启网关使配置生效bashsystemctl --user restart openclaw-gateway.service4、验证配置是否成功bashopenclaw models status确认输出中Default显示为您设置的模型如deepseek-2/deepseek-reasonerConfigured models中包含该模型Auth overview中对应 provider 显示有效5、测试聊天bashopenclaw tui输入任意消息例如“你好”观察是否能正常回复。6、在 TUI 中使用可选如果启动 TUI 后仍提示旧模型认证错误如openai-codex可在 TUI 中手动切换模型text/model deepseek-2/deepseek-reasoner或重置会话后重启 TUIbashopenclaw session reset --agent main --session mainopenclaw tui