【保姆级教程】2026 最新！Windows 本地安装爆火 AI 智能体 OpenClaw 全图文指南

最近在 GitHub 上狂揽超 30 万 Star，甚至超越 Linux 和 React 霸榜的现象级开源 AI 项目 OpenClaw（原名 Moltbot / Clawdbot），可以说是目前地表最强的个人 AI 智能体网关。它可以接入本地模型（如 Ollama）或云端大模型，并无缝集成到微信、Telegram、Discord 等日常聊天软件中。

本文将为你提供一份务必简洁明了的 Windows 环境本地安装避坑指南。

 核心避坑提示（必读） 强烈不建议在 Windows 下直接使用 PowerShell 原生安装（极易产生依赖报错）。最佳且最稳定的实践是使用 WSL2 (Ubuntu) 进行安装。本教程将基于此最佳实践展开。

---

🛠️ 第一阶段：环境准备 (安装 WSL2)

1. 以管理员身份运行 PowerShell 右键点击开始菜单，选择“Windows PowerShell (管理员)”或“终端 (管理员)”。

2. 执行一键安装命令

   PowerShell

   wsl --install
   

   (提示：如果你的电脑已经配置过 WSL2，可直接跳过此步。)

3. 重启电脑 重启后，Ubuntu 终端会自动弹出，按提示设置 UNIX 用户名和密码。

4. 启用 systemd（关键配置！） OpenClaw 需要依赖 systemd 来运行后台守护进程。在 Ubuntu 终端中执行以下命令写入配置：

   sudo tee /etc/wsl.conf >/dev/null <<'EOF'
   [boot]
   systemd=true
   EOF
   

   完成后，回到 Windows PowerShell 执行 wsl --shutdown 关闭当前实例，然后从开始菜单重新打开 Ubuntu 终端。

---

🚀 第二阶段：一键安装 OpenClaw

进入 Ubuntu 终端，执行官方提供的一键安装脚本。该脚本会自动检测并为你安装所需的 Node.js (22+) 运行环境。

1. 运行官方安装脚本

   curl -fsSL https://openclaw.ai/install.sh | bash
   

   (注：国内网络环境拉取 GitHub 资源可能较慢，建议提前在 WSL 中配置好科学上网环境，或为 npm 配置淘宝镜像源。)

2. 初始化与配置 (Onboarding) 安装结束后，运行以下命令启动配置向导并安装守护进程：

   openclaw onboard --install-daemon
   

   跟着终端的向导提示走：

   • 选择你要配置的大模型 API（推荐使用本地的 Ollama 零成本运行，或输入 Anthropic / OpenAI 的 API Key）。

   • 选择你要启用的消息接收渠道（如 WebChat、WhatsApp 等）。

3. 检查运行状态

   openclaw gateway status
   openclaw dashboard
   

   如果终端返回 Gateway is running 并且能在浏览器打开 Dashboard 面板，恭喜你，安装成功！🎉

---

🛡️ 第三阶段：进阶安全加固 (高阶必看)

OpenClaw 是一个具备工具调用能力的 Agent，这意味着它可以读写文件。为了防止 AI 在执行复杂任务时误删你的 Windows 宿主机文件，强烈建议隔离 WSL 对 Windows C/D 盘的默认访问权限。

1. 在 Ubuntu 终端中编辑 wsl.conf 文件：

   sudo nano /etc/wsl.conf
   

2. 在文件末尾添加以下拦截规则：

   Ini, TOML

   [automount]
   enabled = false
   mountFsTab = false
   

3. 保存退出 (Ctrl+O保存 -> Enter确认 -> Ctrl+X退出)。

4. 在 PowerShell 中执行 wsl --shutdown 重启系统。此时你的 AI 助理将在一个绝对安全的“沙盒”中为你工作！

---

❓ 常见排错 FAQ

• Q: Web 控制台配置时一直卡在“配对中”怎么办？

  • 解决：通常是握手状态卡死。在终端停止服务，删除缓存文件 rm ~/.openclaw/gateway/pending.json，然后重启网关，刷新浏览器重新配对即可。

• Q: 安装脚本提示缺少 node-gyp 或 sharp 编译失败？

  • 解决：你的系统缺少基础编译环境。在 Ubuntu 中执行 sudo apt update && sudo apt install build-essential 安装 C++ 构建工具后重试即可。

写在最后：把 AI 真正养在自己的电脑里，不仅数据隐私 100% 安全，还能零成本享受顶级生产力。赶紧动手试试吧！如果有任何报错，欢迎在评论区贴出你的截图，博主在线解答~