文章总结: 本文详细介绍了在Windows系统的WSL2环境中部署开源AI助手OpenClaw的完整流程。内容涵盖WSL2安装、systemd启用、OpenClaw安装配置及常用命令。文章还提供了浏览器访问、局域网端口转发、结合Ollama使用本地模型等进阶技巧,并总结了常见报错排查方案,旨在帮助用户零成本构建具备工具调用与持久记忆的本地AI助手。 综合评分: 90 文章分类: AI安全,安全工具,实战经验

原创
糖果LUA 糖果LUA
AI安全运营
2026年2月27日 12:21 北京
在 Windows 系统下的 WSL2 中安装 OpenClaw 的完整详细教程,OpenClaw 是一个开源的个人 AI 助手(原 Clawdbot / Moltbot),你可以让它运行在自己的电脑上,通过 WhatsApp、Telegram、Discord、Slack 、飞书等你已经在用的聊天软件与它对话。它支持工具调用、持久记忆、多代理工作流等强大功能。为什么推荐在 WSL2 中安装?
- Windows 原生安装 Node 环境兼容性差,技能(skills)和二进制依赖经常出问题。
- WSL2 提供完整的 Linux 环境,运行稳定、性能好、容易做成后台服务。
- 官方文档明确推荐 Windows 用户使用 WSL2 + Ubuntu。
一、前提条件(务必检查)
- Windows 10 版本 2004 或更高 / Windows 11(推荐 Win11)。
- BIOS 已开启 虚拟化(Intel VT-x 或 AMD SVM),可在任务管理器 → 性能 → 虚拟化:已启用。
- 至少 8GB 内存(推荐 16GB+),因为 AI 助手 + LLM 会占用资源。
- 稳定的网络(安装过程中会下载 Node、依赖、模型等)。
二、步骤 1:安装 WSL2 + Ubuntu(只需一次)以管理员身份打开 PowerShell(或终端),依次执行:
安装完成后重启电脑(Windows 会提示)。重启后再次打开 PowerShell,进入 WSL:
更新系统(重要):
三、步骤 2:启用 systemd(必需!否则 daemon 服务装不上)在 WSL 终端中执行:
bash
然后在 Windows PowerShell 中重启 WSL:
powershell
重新进入 WSL,验证 systemd 已启用:
四、步骤 3:安装 OpenClaw(推荐方式)方法 A:使用官方一键安装脚本(最推荐,自动处理 Node 22+)在 WSL 终端中直接运行:
脚本会:
- 自动检测/安装 Node.js 22+
- 全局安装 openclaw@latest
- 启动 onboarding 向导
方法 B:手动 npm 安装(如果你喜欢自己控制)
如果 sharp 编译报错(常见于某些 WSL 环境),加环境变量重试:
五、步骤 4:完成 Onboarding(配置向导)安装完成后,立即运行(强烈建议加 –install-daemon 做成系统服务):
向导会引导你:
- 选择 LLM 提供商(推荐 Anthropic Claude / OpenAI / Grok / Minimax 等,免费额度够用)。
- 输入 API Key(去对应官网申请)。
- 配置主聊天通道(WhatsApp / Telegram / Discord 等)。
- 设置是否开机自启 daemon。
- 完成安全设置(prompt injection 防护等)。
整个过程 3-5 分钟,跟着提示点就行。
六、常用命令(安装后必记)
七、从 Windows 浏览器访问 Dashboard在 WSL 中启动网关后:
- Windows 浏览器直接输入 http://localhost:18789 通常就能访问(WSL2 默认端口转发)。
- 如果无法访问,用以下命令查看 WSL IP:
然后在 Windows 浏览器输入 http://WSL-IP:18789
八、进阶配置(可选)1. 把服务做成开机自启(已通过 –install-daemon 完成)2. 暴露端口给局域网其他设备(手机也能直接聊)在 Windows PowerShell(管理员)中设置端口转发(示例 SSH 22 端口):
并添加防火墙规则。3. 使用 Ollama 本地模型(完全离线)先在 WSL 安装 Ollama:
然后在 OpenClaw onboarding 时选择本地 Ollama 端点。
九、常见问题排查
| 问题 | 解决方法 | | — | — | | openclaw: command not found | export PATH=“(npmprefix−g)/bin:(npmprefix−g)/bin:PATH” 并添加到 ~/.bashrc | | systemd 未启用 | 重复步骤 2,重启 WSL | | daemon 启openclaw 教程动失败 | openclaw doctor + journalctl –user -u openclaw-gateway | | sharp / node-gyp 报错 | SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest | | 访问不了 localhost | 用 WSL IP 或确保网关绑定 0.0.0.0 | | 内存不足 | 给 WSL 分配更多内存(.wslconfig 文件) |
十、后续操作建议
- 进入 Dashboard → Channels 添加你常用的聊天软件。
- 安装官方 Skills(ClawHub)让它能操作电脑、写代码、查邮件等。
- 推荐搭配 Tailscale / ngrok 实现手机远程控制。
- 定期运行 openclaw update 保持最新。
官方文档地址(强烈建议收藏):
- 主文档:https://docs.openclaw.ai/
- WSL2 专用页:https://docs.openclaw.ai/platforms/windows
- GitHub:https://github.com/openclaw/openclaw
免责声明:
本文所载程序、技术方法仅面向合法合规的安全研究与教学场景,旨在提升网络安全防护能力,具有明确的技术研究属性。
任何单位或个人未经授权,将本文内容用于攻击、破坏等非法用途的,由此引发的全部法律责任、民事赔偿及连带责任,均由行为人独立承担,本站不承担任何连带责任。
本站内容均为技术交流与知识分享目的发布,若存在版权侵权或其他异议,请通过邮件联系处理,具体联系方式可点击页面上方的联系我。
本文转载自:AI安全运营 糖果LUA 糖果LUA《Windows 零成本拥有 AI 助手!WSL2 本地部署 OpenClaw 教程》
发布者:Ai探索者,转载请注明出处:https://javaforall.net/251713.html原文链接:https://javaforall.net
