AI教程全部资源软件电子书影音福利
OpenClaw 教程Windows 安装AI Agent

OpenClaw Windows 安装教程:从 PowerShell 安装到控制台可用

这页专门服务搜“OpenClaw Windows 安装教程”“OpenClaw 本地部署”“OpenClaw 怎么装”的用户,目标是帮你在 Windows 上先把 OpenClaw 跑起来,再进入后续的飞书、Telegram 等消息渠道接入。

官方 Getting Started 和 Install 文档给出的主路径很明确:推荐使用安装脚本完成安装与 onboarding,Windows 环境用 PowerShell 命令即可开始;如果你只想先确认环境是否跑通,可以先完成安装、网关状态检查和控制台访问这三步。

官方推荐安装脚本Node 24 推荐Windows 场景建议配合 WSL2

先装好,再接渠道

不要一开始就追着微信、飞书、Telegram 配置跑。先让 OpenClaw CLI、网关和控制台都正常,再接后面的消息渠道,成功率会高很多。

官方安装路径很直接

Windows 可以直接使用 PowerShell 安装脚本;安装结束后继续跑 onboarding,OpenClaw 会把基础配置、网关和首轮检查串起来。

安装后先做三件事

依次检查 openclaw 是否可执行、网关是否在线、控制台是否能打开。只要这三项通了,后面的渠道接入就会轻松很多。

安装前先确认这几个前提

官方 Getting Started 文档目前建议 Node 24,Node 22 LTS 22.16+ 仍然兼容。Install 文档同时说明 OpenClaw 支持 Windows,但在 Windows 上强烈建议配合 WSL2 使用。

  • 准备一个可以执行 PowerShell 命令的 Windows 环境;如果你已经长期做本地开发,优先考虑把 OpenClaw 放到 WSL2 里跑。
  • 确认本机有可用的 Node 版本;如果你不想自己手动管 Node,安装脚本会帮你做检测。
  • 先想清楚你后面要接的渠道和模型供应商,避免安装完成后又回头重做配置。
如果你只是想尽快验证 OpenClaw 能不能跑起来,优先完成安装、onboard、gateway status 和 dashboard 这四步就够了。

最短安装流程

官方文档给的 Windows 快速起步命令可以直接用。这里按更适合搜索用户的顺序整理成四步。

  1. 在 PowerShell 里执行官方安装脚本:iwr -useb https://openclaw.ai/install.ps1 | iex
  2. 安装完成后继续运行 onboarding 向导:openclaw onboard --install-daemon
  3. 检查网关状态:openclaw gateway status
  4. 打开控制台确认交互正常:openclaw dashboard,然后在浏览器访问本地控制界面。

安装后先做哪些检查

Install 文档把安装后的自检路径也写得很清楚,适合直接拿来当你的第一轮排查清单。

  • 执行 openclaw doctor,优先排掉配置缺失或路径问题。
  • 执行 openclaw statusopenclaw gateway status,确认网关确实在线。
  • 执行 openclaw dashboard,确认浏览器控制台能打开;如果控制台能用,说明你的本地安装已经具备继续接渠道的条件。

Windows 安装最常见的卡点

大多数失败不是 OpenClaw 本身坏了,而是环境路径或安装顺序没理顺。

  • 如果提示 openclaw not found,优先检查全局 npm 路径是否已经进了 PATH。官方 Install 文档明确提到 Windows 需要把 npm prefix -g 的输出目录加入 PATH。
  • 如果网关状态不正常,先不要急着装插件,先看 openclaw logs --followopenclaw doctor 的输出。
  • 如果你计划在 Windows 上长期跑桌面自动化或多渠道接入,优先把运行环境稳定下来,再继续做飞书或 Telegram 配置。