Windows 装 OpenClaw 踩了多少坑?这篇全说清楚了

❌ 无法自动重启

OpenClaw 的自我重启机制深度依赖 Linux 的 systemd，Windows 的计划任务无法提供等效的服务管理能力，崩了只能手动重启。

❌ PowerShell JSON 转义缺陷

在 PowerShell 中执行某些命令时，JSON 转义会出问题，导致配置无法正确传入。

❌ 更新经常失败

openclaw update 经常遇到进程被占用无法更新的情况，只能手动杀进程。

❌ 后台常驻配置繁琐

对非技术用户来说，让服务开机自启并后台常驻，在 Windows 上需要一堆变通方法，最终往往得不偿失。

✅ 结论：WSL2 提供完整的 Linux 环境，是官方推荐方案，兼容性最佳。一次配置好，后续使用体验和 Linux/Mac 完全一致。

通义千问系列 · 国内访问稳定

推荐模型　qwen3.6-plus

📖 官方文档：help.aliyun.com/zh/model-studio/getting-started/models

GLM 系列 · 新用户有免费额度

推荐模型　glm-5.1 / glm-5-turbo

📖 官方文档：docs.bigmodel.cn/cn/guide/models/text/glm-5.1

M2.7 · 官方支持 OpenClaw 接入

推荐模型　MiniMax-M2.7 / MiniMax-M2.5

📖 官方文档：platform.minimaxi.com/docs/guides/text-generation

wsl –install -d Ubuntu-24.04

# 如果提示找不到发行版本，先装默认版让 WSL 组件更新

wsl –install

wsl –unregister Ubuntu

wsl –install -d Ubuntu-24.04

echo “your_username ALL=(ALL) NOPASSWD: ALL” | sudo tee /etc/sudoers.d/openclaw

sudo chmod 440 /etc/sudoers.d/openclaw

sudo tee /etc/wsl.conf >/dev/null <<‘EOF’

[boot]

systemd=true

EOF

wsl –shutdown

systemctl –user status

# 创建保活脚本

Set-Content -Path “$env:USERPROFILE\KeepWSLAlive.vbs” -Value ‘CreateObject(“WScript.Shell”).Run “wsl.exe -d Ubuntu-24.04 — sleep infinity”, 0, False’

# 注册开机自启计划任务

$vbsPath = “$env:USERPROFILE\KeepWSLAlive.vbs”

$action = New-ScheduledTaskAction -Execute “wscript.exe” -Argument $vbsPath

$trigger = New-ScheduledTaskTrigger -AtLogon

$settings = New-ScheduledTaskSettingsSet -AllowStartIfOnBatteries -DontStopIfGoingOnBatteries -ExecutionTimeLimit ([TimeSpan]::Zero)

Register-ScheduledTask -TaskName “KeepWSLAlive” -Action $action -Trigger $trigger -Settings $settings -Description “保持WSL持续运行” -RunLevel Highest -Force

wsl -l -v

curl -fsSL https://openclaw.ai/install.sh | bash -s — –no-onboard

⚠️ 没有梯子？先配置阿里云镜像：

# 验证版本号

openclaw –version

# 初始化配置

openclaw setup

# 显式设置 Gateway 模式

openclaw config set gateway.mode local

# 检查状态并自动修复

openclaw doctor –fix

{

  “models”: { “providers”: {

    “bailian”: {

      “baseUrl”: “https://dashscope.aliyuncs.com/compatible-mode/v1”,

      “apiKey”: “你的百炼 API Key”,

      “api”: “openai-completions”,

      “models”: [{ “id”: “qwen3.6-plus”, “contextWindow”: 1000000 }]

    }

  }}

}

{

  “models”: { “providers”: {

    “zhipu”: {

      “baseUrl”: “https://open.bigmodel.cn/api/paas/v4/”,

      “apiKey”: “你的智谱 API Key”,

      “api”: “openai-completions”,

      “models”: [{ “id”: “glm-5.1”, “contextWindow”: 200000 }]

    }

  }}

}

{

  “models”: { “providers”: {

    “minimax”: {

      “baseUrl”: “https://api.minimaxi.com/v1”,

      “apiKey”: “你的 MiniMax Token Plan Key”,

      “api”: “openai-completions”,

      “models”: [{ “id”: “MiniMax-M2.7”, “contextWindow”: 204800 }]

    }

  }}

}

npx -y @larksuite/openclaw-lark install

💡 扫码不成功？尝试调整 Ubuntu 终端的字体，中文字体可能导致二维码变形。

npx -y @tencent-weixin/openclaw-weixin-cli@latest install

✅ 支持

文本消息图片/语音/文件/视频扫码登录多账号支持

❌ 不支持

微信群聊朋友圈公众号消息小程序消息