🛠️ Windows 安装 OpenClaw 踩坑实操经历
💡 前言:第一次尝试在 Windows 上安装 OpenClaw,之前听说是很难,会遇到很多问题。确实过程不容易,差点就想放弃了。
──────────────────────────────────────────────────
📌 第一步:Windows 10 系统升级
·遇到的问题:Windows 10 版本太老,需要升级才能安装 Node.js。
·怎么升级找了半天没找到在系统哪里可以升级
·还是问了豆包,下载了升级工具:Windows10Upgrade9252.exe
·⏰ 升级时间很长,等待了几个小时
·系统重启了好多次,Windows 的尿性大家都懂的 😅
──────────────────────────────────────────────────
📌 第二步:安装 Ubuntu (WSL)
遇到的问题:WSL 命令不太好执行,国内环境复杂,没科学上网。
1.解决方案:
·切换国内源 - 豆包可以告诉你怎么切换
·重新安装应用商店 - 之前卸载了,得装回来
·手工下载安装包:CanonicalGroupLimited.Ubuntu22.04LTS...AppxBundle(600 多 MB)
──────────────────────────────────────────────────
📌 第三步:安装 OpenClaw
核心要点:一样要切换到国内源!
·各种命令执行不了,或者超级慢
·升级了 WSL 版本,下载了 wsl_update_x64.msi 安装包
·🕐 安装了好久,晚上让电脑在那里安装了一夜
──────────────────────────────────────────────────
📌 第四步:OpenClaw 初始化
⚠️ 重点注意:因为用的阿里百炼的 Coding Plan,中间步骤的大模型供应商记得选阿里的,别选 Qwen 的!
🐛 踩坑记录:API Key 复制问题
问题 | 原因 | 解决方案 |
剪贴板被监控 | 复制 Key 再粘贴会随机变掉 | 分段复制粘贴 |
HTTP 401 错误 | invalid access token or token expired | 重新配置 API Key |
──────────────────────────────────────────────────
📌 第五步:安装微信插件
最近微信推出 ClawBot 插件,直接在环境里面执行命令就自动安装,挺方便的。
🐛 二维码显示问题
·现象:生成的二维码扫描不了,生成了白框的黑块
·原因:终端的字符集显示问题
·解决:在 PowerShell 里输入 wsl 打开 → 正常显示二维码
──────────────────────────────────────────────────
📝 总结与经验
1️⃣ 关于 AI 辅助(豆包)
✅ 有用的地方:基本安装过程的大部分问题,把错误信息给豆包让它分析解决,还是能解决大部分问题的。
⚠️ 需要注意:还是要有自己的判断,否则豆包会让你走向死胡同。
经典案例:
·分析 HTTP 401 错误时走了很多弯路
·ls 命令都执行报错,豆包说 WSL 环境损坏需要重装
·实际原因:C 盘没空间了,清理掉之前升级 Windows 的备份文件就可以了
2️⃣ OpenClaw 的自愈能力
✨ OpenClaw 本身是可以帮你处理环境问题的!(前提是能启动起来)
3️⃣ 本地安装 vs 云服务器
本地安装 | 云服务器 |
✅ 省去服务器费用 | ✅ 一键安装简单 |
✅ 内网也能用(飞书/微信打通) | ✅ 可远程管理 |
✅ 飞书用主动长连接,不用内网穿透 | ❌ 需要付费 |
❌ 坏了要亲自去电脑操作 | |
❌ 没法远程重启 |
4️⃣ 万能重启大法 🔄
有时候碰到问题可以先重启电脑试试,其实重启 WSL 也可以: wsl --shutdown 再运行 wsl
5️⃣ 给普通人的建议 ⚠️
🚨 普通人没有服务器运维基础的还是别尝试了! 还是云服务器一键安装简单多了 ✨
──────────────────────────────────────────────────
💬 有问题的欢迎交流! 记录于 2026 年 3 月 23 日
夜雨聆风