乐于分享
好东西不私藏
夜雨聆风 > > 办公文件 > OpenClaw 完全指南 (1):Windows 环境安装部署全攻略

OpenClaw 完全指南 (1):Windows 环境安装部署全攻略

当前时间： 2026-08-17 16:57:29 分类：办公文件 评论(0)
OpenClaw 完全指南 (1):Windows 环境安装部署全攻略

# OpenClaw 完全指南 (1)：Windows 环境安装部署全攻略


导语：OpenClaw 是一个强大的本地化 AI 助手框架，能让你在本地运行、控制和管理 AI 代理。本文将手把手教你在 Windows 系统上完成 OpenClaw 的完整安装与部署，从环境准备到首次对话，全程只需 5 分钟。




---


📋 前置准备


在开始之前，请确保你的 Windows 电脑满足以下要求：


1. Node.js 环境

OpenClaw 依赖 Node.js 运行，推荐使用 Node 24 版本（Node 22.14+ 也支持）。


检查 Node 版本：

node --version

如果未安装 Node.js：

  • 访问 [Node.js 官网](https://nodejs.org/) 下载 LTS 版本
  • 或使用包管理器：`winget install OpenJS.NodeJS.LTS`

💡 提示：Windows 用户既可以使用原生 Windows 环境，也可以使用 WSL2（Windows Subsystem for Linux）。推荐 WSL2，稳定性更好，更接近原生 Linux 体验。

2. API Key

你需要一个 AI 模型提供商的 API Key（如 Anthropic、OpenAI、Google 等）。安装过程中会提示你输入。


---


🚀 快速安装步骤


步骤 1：安装 OpenClaw


打开 PowerShell（以管理员身份运行），执行以下命令：


iwr -useb https://openclaw.ai/install.ps1 | iex

命令解析：

  • `iwr`：Invoke-WebRequest，PowerShell 的下载命令
  • `-useb`：Use Basic，使用基本模式下载
  • `| iex`：管道传递给 Invoke-Expression 执行

安装过程会自动下载最新版本的 OpenClaw 并配置到系统路径。




⚠️ 注意：如果 PowerShell 执行策略限制脚本运行，请先执行：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

步骤 2：运行初始配置向导


安装完成后，执行：


openclaw onboard --install-daemon

向导流程：

1. 选择模型提供商：从列表中选择你拥有的 API Key 对应的服务商

2. 输入 API Key：粘贴你的密钥（输入时不会显示，正常即可）

3. 配置 Gateway：自动设置本地服务监听端口（默认 18789）


整个过程约需 2 分钟。




步骤 3：验证 Gateway 状态


检查 OpenClaw 网关服务是否正常运行：


openclaw gateway status

成功标志：

  • 看到 `Gateway is running` 状态
  • 监听端口显示为 `18789`



步骤 4：打开控制面板


启动 Web 控制面板：


openclaw dashboard

系统会自动在默认浏览器中打开 OpenClaw 控制界面。如果页面正常加载，说明一切就绪！




步骤 5：发送第一条消息


在控制台的聊天框中输入任意消息（如"你好"），等待 AI 回复。


成功标志：

  • 收到 AI 的正常回复
  • 无错误提示

---


🛠️ 常见问题排查


Q1: PowerShell 脚本执行被阻止？

解决：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Q2: Node.js 版本过低？

解决：

winget install OpenJS.NodeJS.LTS

然后重启 PowerShell 再试。


Q3: Gateway 无法启动？

检查：

1. 端口 18789 是否被占用：netstat -ano | findstr 18789

2. 防火墙是否阻止：在 Windows 防火墙中允许 node.exe

3. 查看日志：openclaw gateway logs


Q4: API Key 无效？

解决：

  • 确认 Key 格式正确（无多余空格）
  • 检查对应服务商的账单状态
  • 尝试重新生成 Key

---


📚 下一步做什么？


安装完成后，你可以探索以下功能：


  • 连接通讯渠道：绑定 Telegram、WhatsApp、Discord 等 (`openclaw channels`)
  • 配置安全策略：设置谁能与你的 AI 对话 ([配对与安全](https://docs.openclaw.ai/channels/pairing))
  • 自定义 Gateway：调整模型、工具、沙箱设置 ([配置文档](https://docs.openclaw.ai/gateway/configuration))
  • 探索工具集：浏览器、执行、搜索、技能等 ([工具列表](https://docs.openclaw.ai/tools))


---


📝 技术细节：环境变量


高级用户可自定义以下环境变量：


  • `OPENCLAW_HOME`：内部路径解析的主目录 (`~/.openclaw`)
  • `OPENCLAW_STATE_DIR`：状态目录覆盖 (`~/.openclaw/state`)
  • `OPENCLAW_CONFIG_PATH`：配置文件路径覆盖 (`~/.openclaw/config.json`)


---


🎯 总结


恭喜你！现在你已经成功在 Windows 上部署了 OpenClaw。


你已完成：

  • ✅ 安装 Node.js 环境
  • ✅ 部署 OpenClaw 核心服务
  • ✅ 配置 AI 模型 API Key
  • ✅ 启动 Gateway 并验证状态
  • ✅ 完成首次对话测试

下一步建议：

  • 阅读 [Telegram 频道配置](https://docs.openclaw.ai/channels/telegram) 实现手机随时对话
  • 探索 [技能系统](https://docs.openclaw.ai/skills) 扩展 AI 能力
  • 加入 [社区 Discord](https://discord.com/invite/clawd) 获取最新资讯