这是官方推荐的 Windows 部署方式提供最完整的 Linux 环境支持。好消息近期找到个更简单部署方法通过镜像还原方式适合想快速部署或零基础的【《Openclaw小白安装指南不用配环境不报错手把手喂饭级》-哔哩哔哩】 https://b23.tv/qExAzpV准备启用适用于Linux的Windows子系统和虚拟化平台重启电脑。1. 启用 WSL2以管理员身份打开 PowerShell执行# 启用 WSL 功能dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestartdism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart# 设置 WSL 2 为默认版本部分电脑此步可能报错此处暂不理会通过下文中的WSL内核更新解决wsl --set-default-version 22. 安装 Ubuntu方法1 Microsoft Store 安装推荐打开 Microsoft Store搜索「Ubuntu 24.04 LTS」点击「获取」并安装安装完成后会自动打开 Ubuntu 终端按提示设置用户名和密码。方法2 wsl命令安装wsl --install -d Ubuntu-24.04部分电脑报错无法解析服务器的名称或地址解决方案在IPaddress中搜索查看IP打开/C:\Windows\System32\drivers\etc文件添加IP domain的对如图启动Ubuntu 24.04 LTS部分windows安装ubuntu时报错Installing, this may take a few minutes... WslRegisterDistribution failed with error: 0x8007019e Error: 0x8007019e ??????? Linux ? Windows ????这个报错0x8007019e通常是因为在安装 Ubuntu 之前没有先开启 Windows 的“适用于 Linux 的 Windows 子系统 (WSL)”功能。在PowerShell中执行如下命令然后重启电脑即可Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux重启完成后重新打开Ubuntu 24.04 LTS首次启动设置用户名和密码注意在ubuntu中输入密码时没有任何显示直接输入完成回车即可WSL内核更新1. 在PowerShell中管理员身份运行执行wsl --update如果出现wsl --update 卡在 0%问题解决方法1依次执行如下命令# 停止 Windows Update 服务net stop wuauserv# 重新启动服务net start wuauserv解决方法2强制从网络获取最新更新wsl --update --web-download2. 执行版本转换命令现在运行转换命令。同样在 PowerShell 中输入wsl --set-version Ubuntu-24.04 2查看版本wsl -l -v更新 Ubuntu 系统在 Ubuntu 终端中执行# 更新软件包列表sudo apt update sudo apt upgrade -ysudo apt install -y curl git wget build-essential安装 Node.js 22# 添加 NodeSource 仓库curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -# 安装 Node.jssudo apt install -y nodejs# 验证版本必须 ≥ 22.x node -v npm -v安装 OpenClaw一键脚本安装curl -fsSL https://openclaw.ai/install.sh | bash通过左右方向键切换 Yes/No 选项选择 Yes 即表示已了解 OpenClaw 权限相关风险同意继续配置。选择Yes进入 Onboarding mode 选择界面时对于首次配置的用户建议优先选择 QuickStart 模式——该模式以「最小配置最快部署」为目标可跳过非必要配置项快速完成 OpenClaw 基础部署。◆Model/auth provide配置要使用的模型可以在这里直接配置也可以后续通过配置文件处理。因为笔者使用 moonshot 国内模型但是 OpenClaw 的配置是国际的会导致接口地址错误所以笔者先选择Skip for now跳过大模型配置后面再单独设置要使用的模型即可。保持默认选择All providers回车即可Default model进入 Default model 选择界面时可任意选择一个模型临时占位——该配置后续将通过修改配置文件覆盖不影响最终使用效果保持默认选择Keep current回车即可◆Select channel (QuickStart)配置要使用的对话应用如果用飞书按要求填参数即可。这里可选Skip for now先跳过选择后面笔者会单独用一节内容讲解怎么配置。◇ Skills status配置技能可以选No根据提示安装一些常用的工具。按空格选中Skip for now最后查看界面输出的信息将这些信息保存下来。安装完成此时执行openclaw指令提示“openclaw: command not found”依次执行如下指令添加openclaw到系统环境变量mkdir ~/.npm-globalnpm config set prefix ~/.npm-globalecho export PATH~/.npm-global/bin:$PATH ~/.bashrcsource ~/.bashrc查看gateway状态http://127.0.0.1:18789/#tokend3f44d798d67a145cbcb0caa5aa9b02de9fdad623384039c本地模型配置步骤Ollama 默认只监听 127.0.0.1没监听这个虚拟网卡的 IP第一步Windows 上设置环境变量让 Ollama 监听所有接口以管理员身份打开 PowerShell执行setx OLLAMA_HOST 0.0.0.0 /M重启 Ollama任务栏右下角小羊驼图标 → 右键 Quit → 重新从开始菜单启动。在 powershell命令行执行netstat -an | findstr 11434如果看到 0.0.0.0:11434 或 :::11434 处于 LISTENING就成功了。如果只有 127.0.0.1:11434说明没生效重启电脑即可。第二步WSL2 里用正确的宿主机 IP 测试在 WSL2 Ubuntu 中执行这才是你该用的 IP不是 172.24.64.1baship route show | grep default | awk {print $3}这会输出 Windows 宿主机在 WSL2 网络中的真实网关 IP大概率是 172.24.64.1 或类似就是 Windows 的 vEthernet (WSL) 网卡 IP。然后用这个 IP 测试bashcurl http://172.28.240.1:11434/api/tags # 把 IP 换成你上面查到的修改配置建议直接在如下配置基础上修改{ wizard: { lastRunAt: 2026-02-19T08:45:16.629Z, lastRunVersion: 2026.2.17, lastRunCommand: onboard, lastRunMode: local }, agents: { defaults: { model: { primary: ollama/qwen3:8b, fallbacks: [ openai/gpt-5.1-codex ] }, models: { ollama/qwen3:8b: {}, openai/gpt-5.1-codex: { alias: GPT } }, workspace: /home/rgzn/.openclaw/workspace, compaction: { mode: safeguard }, maxConcurrent: 4, subagents: { maxConcurrent: 8 } } }, messages: { ackReactionScope: group-mentions }, commands: { native: auto, nativeSkills: auto }, gateway: { port: 18789, mode: local, bind: loopback, auth: { mode: token, token: d3f44d798d67a145cbcb0caa5aa9b02de9fdad623384039c }, tailscale: { mode: off, resetOnExit: false }, nodes: { denyCommands: [ camera.snap, camera.clip, screen.record, calendar.add, contacts.add, reminders.add ] } }, meta: { lastTouchedVersion: 2026.2.17, lastTouchedAt: 2026-02-19T08:45:16.638Z }, models: { providers: { ollama: { baseUrl: http://172.28.240.1:11434/v1, apiKey: ollama-local, api: openai-completions, models: [ { id: qwen3:8b, name: Qwen3 8B, reasoning: false, input: [text], cost: { input: 0, output: 0 }, contextWindow: 131072, maxTokens: 8192 } ] } } } }如下图将token替换之前截图保存的如下图将workspace的中的rgzn替换成对应的名称命令行前的内容如下图将baseUrl中IP地址修改上面查询到的执行如下命令进入配置文件目录cd ~/.openclaw备份openclaw.json配置文件执行如下指令:mv openclaw.json openclaw.json.bak执行如下命令修改nano openclaw.json如需调用云端deepseek的api配置方式如下nano ~/.openclaw/openclaw.json{ meta: { lastTouchedVersion: 2026.2.9, lastTouchedAt: 2026-02-12T00:45:51.950Z }, wizard: { lastRunAt: 2026-02-12T00:45:51.943Z, lastRunVersion: 2026.2.9, lastRunCommand: configure, lastRunMode: local }, agents: { defaults: { model: { primary: deepseek/deepseek-chat, fallbacks: [ openai/gpt-5.1-codex ] }, models: { deepseek/deepseek-chat: {}, openai/gpt-5.1-codex: { alias: GPT } }, workspace: /home/syh/.openclaw/workspace, compaction: { mode: safeguard }, maxConcurrent: 4, subagents: { maxConcurrent: 8 } } }, messages: { ackReactionScope: group-mentions }, commands: { native: auto, nativeSkills: auto }, gateway: { port: 18789, mode: local, bind: loopback, auth: { mode: token, token: 66682db26fe6f1693570085e2009c52bf8a688901aa542fc }, tailscale: { mode: off, resetOnExit: false }, nodes: { denyCommands: [ camera.snap, camera.clip, screen.record, calendar.add, contacts.add, reminders.add ] } }, skills: { install: { nodeManager: npm } }, tools: { web: { search: { enabled: false }, fetch: { enabled: true } } }, models: { providers: { deepseek: { baseUrl: https://api.deepseek.com/v1, apiKey: 填入你的API KEY, api: openai-completions, models: [ { id: deepseek-chat, name: DeepSeek Chat, reasoning: false, input: [text], cost: { input: 0.14, output: 0.28 }, contextWindow: 128000, maxTokens: 4096 } ] } } } }设置开机自动启动可以运行以下 PowerShell 命令查看 AUMID备用Get-StartApps | Where-Object { $_.Name -like *Ubuntu* }点击创建基本任务任务命名名称随意选择“计算机启动时”默认“启动程序”即可程序或脚本explorer.exe添加参数红色字体替换成前面查到的AUMIDshell:AppsFolder\CanonicalGroupLimited.Ubuntu24.04LTS_79rhkp1fndgsc!ubuntu2404点击完成右键点击任务点击运行应该看到ubuntu窗口打开。设置完成
Windowns系统WSL2 Ubuntu 方式部署Openclaw
发布时间：2026/7/30 7:34:09
这是官方推荐的 Windows 部署方式提供最完整的 Linux 环境支持。好消息近期找到个更简单部署方法通过镜像还原方式适合想快速部署或零基础的【《Openclaw小白安装指南不用配环境不报错手把手喂饭级》-哔哩哔哩】 https://b23.tv/qExAzpV准备启用适用于Linux的Windows子系统和虚拟化平台重启电脑。1. 启用 WSL2以管理员身份打开 PowerShell执行# 启用 WSL 功能dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestartdism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart# 设置 WSL 2 为默认版本部分电脑此步可能报错此处暂不理会通过下文中的WSL内核更新解决wsl --set-default-version 22. 安装 Ubuntu方法1 Microsoft Store 安装推荐打开 Microsoft Store搜索「Ubuntu 24.04 LTS」点击「获取」并安装安装完成后会自动打开 Ubuntu 终端按提示设置用户名和密码。方法2 wsl命令安装wsl --install -d Ubuntu-24.04部分电脑报错无法解析服务器的名称或地址解决方案在IPaddress中搜索查看IP打开/C:\Windows\System32\drivers\etc文件添加IP domain的对如图启动Ubuntu 24.04 LTS部分windows安装ubuntu时报错Installing, this may take a few minutes... WslRegisterDistribution failed with error: 0x8007019e Error: 0x8007019e ??????? Linux ? Windows ????这个报错0x8007019e通常是因为在安装 Ubuntu 之前没有先开启 Windows 的“适用于 Linux 的 Windows 子系统 (WSL)”功能。在PowerShell中执行如下命令然后重启电脑即可Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux重启完成后重新打开Ubuntu 24.04 LTS首次启动设置用户名和密码注意在ubuntu中输入密码时没有任何显示直接输入完成回车即可WSL内核更新1. 在PowerShell中管理员身份运行执行wsl --update如果出现wsl --update 卡在 0%问题解决方法1依次执行如下命令# 停止 Windows Update 服务net stop wuauserv# 重新启动服务net start wuauserv解决方法2强制从网络获取最新更新wsl --update --web-download2. 执行版本转换命令现在运行转换命令。同样在 PowerShell 中输入wsl --set-version Ubuntu-24.04 2查看版本wsl -l -v更新 Ubuntu 系统在 Ubuntu 终端中执行# 更新软件包列表sudo apt update sudo apt upgrade -ysudo apt install -y curl git wget build-essential安装 Node.js 22# 添加 NodeSource 仓库curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -# 安装 Node.jssudo apt install -y nodejs# 验证版本必须 ≥ 22.x node -v npm -v安装 OpenClaw一键脚本安装curl -fsSL https://openclaw.ai/install.sh | bash通过左右方向键切换 Yes/No 选项选择 Yes 即表示已了解 OpenClaw 权限相关风险同意继续配置。选择Yes进入 Onboarding mode 选择界面时对于首次配置的用户建议优先选择 QuickStart 模式——该模式以「最小配置最快部署」为目标可跳过非必要配置项快速完成 OpenClaw 基础部署。◆Model/auth provide配置要使用的模型可以在这里直接配置也可以后续通过配置文件处理。因为笔者使用 moonshot 国内模型但是 OpenClaw 的配置是国际的会导致接口地址错误所以笔者先选择Skip for now跳过大模型配置后面再单独设置要使用的模型即可。保持默认选择All providers回车即可Default model进入 Default model 选择界面时可任意选择一个模型临时占位——该配置后续将通过修改配置文件覆盖不影响最终使用效果保持默认选择Keep current回车即可◆Select channel (QuickStart)配置要使用的对话应用如果用飞书按要求填参数即可。这里可选Skip for now先跳过选择后面笔者会单独用一节内容讲解怎么配置。◇ Skills status配置技能可以选No根据提示安装一些常用的工具。按空格选中Skip for now最后查看界面输出的信息将这些信息保存下来。安装完成此时执行openclaw指令提示“openclaw: command not found”依次执行如下指令添加openclaw到系统环境变量mkdir ~/.npm-globalnpm config set prefix ~/.npm-globalecho export PATH~/.npm-global/bin:$PATH ~/.bashrcsource ~/.bashrc查看gateway状态http://127.0.0.1:18789/#tokend3f44d798d67a145cbcb0caa5aa9b02de9fdad623384039c本地模型配置步骤Ollama 默认只监听 127.0.0.1没监听这个虚拟网卡的 IP第一步Windows 上设置环境变量让 Ollama 监听所有接口以管理员身份打开 PowerShell执行setx OLLAMA_HOST 0.0.0.0 /M重启 Ollama任务栏右下角小羊驼图标 → 右键 Quit → 重新从开始菜单启动。在 powershell命令行执行netstat -an | findstr 11434如果看到 0.0.0.0:11434 或 :::11434 处于 LISTENING就成功了。如果只有 127.0.0.1:11434说明没生效重启电脑即可。第二步WSL2 里用正确的宿主机 IP 测试在 WSL2 Ubuntu 中执行这才是你该用的 IP不是 172.24.64.1baship route show | grep default | awk {print $3}这会输出 Windows 宿主机在 WSL2 网络中的真实网关 IP大概率是 172.24.64.1 或类似就是 Windows 的 vEthernet (WSL) 网卡 IP。然后用这个 IP 测试bashcurl http://172.28.240.1:11434/api/tags # 把 IP 换成你上面查到的修改配置建议直接在如下配置基础上修改{ wizard: { lastRunAt: 2026-02-19T08:45:16.629Z, lastRunVersion: 2026.2.17, lastRunCommand: onboard, lastRunMode: local }, agents: { defaults: { model: { primary: ollama/qwen3:8b, fallbacks: [ openai/gpt-5.1-codex ] }, models: { ollama/qwen3:8b: {}, openai/gpt-5.1-codex: { alias: GPT } }, workspace: /home/rgzn/.openclaw/workspace, compaction: { mode: safeguard }, maxConcurrent: 4, subagents: { maxConcurrent: 8 } } }, messages: { ackReactionScope: group-mentions }, commands: { native: auto, nativeSkills: auto }, gateway: { port: 18789, mode: local, bind: loopback, auth: { mode: token, token: d3f44d798d67a145cbcb0caa5aa9b02de9fdad623384039c }, tailscale: { mode: off, resetOnExit: false }, nodes: { denyCommands: [ camera.snap, camera.clip, screen.record, calendar.add, contacts.add, reminders.add ] } }, meta: { lastTouchedVersion: 2026.2.17, lastTouchedAt: 2026-02-19T08:45:16.638Z }, models: { providers: { ollama: { baseUrl: http://172.28.240.1:11434/v1, apiKey: ollama-local, api: openai-completions, models: [ { id: qwen3:8b, name: Qwen3 8B, reasoning: false, input: [text], cost: { input: 0, output: 0 }, contextWindow: 131072, maxTokens: 8192 } ] } } } }如下图将token替换之前截图保存的如下图将workspace的中的rgzn替换成对应的名称命令行前的内容如下图将baseUrl中IP地址修改上面查询到的执行如下命令进入配置文件目录cd ~/.openclaw备份openclaw.json配置文件执行如下指令:mv openclaw.json openclaw.json.bak执行如下命令修改nano openclaw.json如需调用云端deepseek的api配置方式如下nano ~/.openclaw/openclaw.json{ meta: { lastTouchedVersion: 2026.2.9, lastTouchedAt: 2026-02-12T00:45:51.950Z }, wizard: { lastRunAt: 2026-02-12T00:45:51.943Z, lastRunVersion: 2026.2.9, lastRunCommand: configure, lastRunMode: local }, agents: { defaults: { model: { primary: deepseek/deepseek-chat, fallbacks: [ openai/gpt-5.1-codex ] }, models: { deepseek/deepseek-chat: {}, openai/gpt-5.1-codex: { alias: GPT } }, workspace: /home/syh/.openclaw/workspace, compaction: { mode: safeguard }, maxConcurrent: 4, subagents: { maxConcurrent: 8 } } }, messages: { ackReactionScope: group-mentions }, commands: { native: auto, nativeSkills: auto }, gateway: { port: 18789, mode: local, bind: loopback, auth: { mode: token, token: 66682db26fe6f1693570085e2009c52bf8a688901aa542fc }, tailscale: { mode: off, resetOnExit: false }, nodes: { denyCommands: [ camera.snap, camera.clip, screen.record, calendar.add, contacts.add, reminders.add ] } }, skills: { install: { nodeManager: npm } }, tools: { web: { search: { enabled: false }, fetch: { enabled: true } } }, models: { providers: { deepseek: { baseUrl: https://api.deepseek.com/v1, apiKey: 填入你的API KEY, api: openai-completions, models: [ { id: deepseek-chat, name: DeepSeek Chat, reasoning: false, input: [text], cost: { input: 0.14, output: 0.28 }, contextWindow: 128000, maxTokens: 4096 } ] } } } }设置开机自动启动可以运行以下 PowerShell 命令查看 AUMID备用Get-StartApps | Where-Object { $_.Name -like *Ubuntu* }点击创建基本任务任务命名名称随意选择“计算机启动时”默认“启动程序”即可程序或脚本explorer.exe添加参数红色字体替换成前面查到的AUMIDshell:AppsFolder\CanonicalGroupLimited.Ubuntu24.04LTS_79rhkp1fndgsc!ubuntu2404点击完成右键点击任务点击运行应该看到ubuntu窗口打开。设置完成
从入门到精通：内存共享的终极玩法)
:输入输出 缺省参数 函数重载)
