5 分钟搞定 OpenClaw！Windows 安装配置完整指南

胖胖的小明同学
0 阅读7分钟

导读：OpenClaw 是一款开源 AI 工具，支持多模型接入。本文从零开始，手把手教你在 Windows 上完成安装配置，包含环境准备、权限设置、常见问题解决方案。

 

适合人群：Windows 用户、AI 工具爱好者、零基础新手

 

预计耗时：5-10 分钟

一、OpenClaw 是什么？

OpenClaw 是一款开源的 AI 客户端工具，主要特性：

  • 🤖 多模型支持：接入 Moonshot、Kimi-K2.5 等主流 AI 模型

  • 🌐 双界面模式：Web UI + 终端 TUI，按需选择

  • 🔌 平台集成：支持飞书等平台消息对接

  • 🏠 本地部署：数据本地处理，隐私更安全

  • ⚡ 轻量快速：基于 Node.js，占用资源少

适用场景：

  • 个人 AI 助手

  • 团队消息自动化

  • AI 工作流集成

  • 本地模型测试

二、系统要求

| 项目 | 最低要求 | 推荐配置 |

|------|---------|---------|

| 操作系统 | Windows 10 | Windows 11 |

| CPU | 双核 | 四核及以上 |

| 内存 | 2GB | 4GB 以上 |

| 磁盘空间 | 500MB | 1GB 以上 |

| Node.js | 18.x | 22.x LTS |

| Git | 任意版本 | 最新版本 |

三、环境准备

3.1 安装 Git

Git 是代码版本管理工具，OpenClaw 依赖它获取资源。

安装步骤：

  1. 访问官网下载页面：git-scm.com/install/win…

  2. 点击下载 Git-2.x.x-64-bit.exe

  3. 双击运行安装程序

  4. 保持默认设置，连续点击 Next

  5. 完成安装后点击 Finish

验证安装：

打开命令提示符，输入：


git --version

输出示例：


git version 2.53.0.windows.1

3.2 安装 Node.js

Node.js 是 JavaScript 运行时，npm 是其包管理器。

安装步骤：

  1. 访问官网：nodejs.org/en/download

  2. 选择 22.x LTS 版本（长期支持版，更稳定）

  3. 下载 Windows 安装包（.msi）

  4. 双击运行，保持默认设置

  5. 勾选自动安装必要工具（如有提示）

  6. 完成安装

验证安装：


node -v

npm -v

输出示例：


v22.x.x

10.x.x

⚠️ 重要提示：

  • 务必选择 22.x LTS 版本，其他版本可能存在兼容性问题
  • Node.js 安装时会自动配置环境变量，但有时需要手动确认

四、配置环境变量

如果安装后命令无法识别，需要手动配置环境变量。

4.1 打开环境变量设置

方法一：快捷方式

  1. 按 Win + R 打开运行窗口

  2. 输入 sysdm.cpl 并回车

  3. 切换到 "高级" 选项卡

  4. 点击 "环境变量" 按钮

方法二：右键菜单

  1. 右键点击桌面/文件资源管理器中的 "此电脑"

  2. 选择 "属性"

  3. 点击 "高级系统设置"

  4. 点击 "环境变量" 按钮

4.2 添加 Node.js 路径

  1. 在 "系统变量" 区域找到 Path

  2. 选中后点击 "编辑"

  3. 点击 "新建"

  4. 输入以下路径：

   ```

   C:\Program Files\nodejs\

   ```

  1. 继续新建，添加：

   ```

   C:\Program Files\nodejs\node_global\

   ```

  1. 依次点击 "确定" 保存所有设置

4.3 验证配置

关闭并重新打开命令提示符，执行：


node -v

npm -v

git --version

全部显示版本号即配置成功。

五、权限配置

5.1 设置 PowerShell 执行策略

Windows 默认限制脚本执行，需要调整策略。

操作步骤：

  1. 按 Win + X，选择 "Windows PowerShell (管理员)"

  2. 输入以下命令查看当前策略：

   ```powershell

   Get-ExecutionPolicy -List

   ```

  1. 如果显示 Restricted，执行以下命令：

   ```powershell

   Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

   ```

  1. 输入 Y 确认更改

策略说明：

| 策略 | 说明 |

|------|------|

| Restricted | 禁止所有脚本（默认） |

| RemoteSigned | 本地脚本可执行，远程脚本需签名 |

| Unrestricted | 允许所有脚本（不推荐） |

✅ 推荐：使用 RemoteSigned，平衡安全与便利

5.2 处理安全软件

部分安全软件可能拦截 npm 全局安装。

建议操作：

  1. 暂时退出 360 安全卫士

  2. 暂时退出腾讯电脑管家

  3. Windows Defender 添加信任（可选）

安装完成后可重新开启安全软件。

六、安装 OpenClaw

6.1 配置 npm 镜像（可选）

国内用户建议使用国内镜像加速：


npm config set registry https://registry.npmmirror.com

验证配置：


npm config get registry

应输出：https://registry.npmmirror.com

6.2 执行安装

在命令提示符或 PowerShell 中执行：


npm install -g openclaw@latest

参数说明：

  • -g：全局安装，可在任意目录使用

  • @latest：安装最新版本

安装成功标志：


+ openclaw@x.x.x

added xx packages in xxs

6.3 验证安装


openclaw --version

显示版本号即安装成功。

七、初始化配置

7.1 启动配置向导


openclaw onboard --daemon

参数说明：

  • onboard：启动初始化向导

  • --daemon：后台运行模式

7.2 配置 API Key

向导会提示选择配置方式：

选项 1：使用现有配置


Keep current (moonshot/kimi-k2.5)

选择此项使用默认的 Moonshot/Kimi 模型。

选项 2：跳过配置


Skip for now

可后续再配置。

选项 3：自定义配置

根据提示输入：

  • AppID

  • Secret

  • 其他平台凭证

7.3 确认启动

当提示确认时，输入 Yes 完成初始化。

八、启动使用

8.1 Web 界面（推荐）

启动服务：


openclaw start

访问地址：

浏览器打开：


http://127.0.0.1:18789

或：


http://localhost:18789

8.2 终端界面

喜欢命令行的用户可使用 TUI 模式：


openclaw tui

8.3 查看运行状态


openclaw gateway status

正常输出：


Gateway: Running

Port: 18789

Uptime: xx minutes

8.4 停止服务


openclaw stop

九、进阶配置

9.1 修改端口

如果 18789 端口被占用，可修改配置：

  1. 找到配置文件（通常在用户目录）

  2. 修改 port 字段

  3. 重启服务

9.2 飞书集成

OpenClaw 支持飞书机器人集成：

配置步骤：

  1. 飞书开放平台创建应用

  2. 获取 AppID 和 Secret

  3. 在 OpenClaw 配置中填写凭证

  4. 订阅所需事件（消息、审批等）

权限要求：

  • im:message - 消息读写

  • im:chat - 会话管理

  • contact:readonly - 通讯录读取

  • docs - 文档访问

  • bitable - 多维表格

9.3 多模型切换

在 Web UI 中可选择不同模型：

  • Moonshot

  • Kimi-K2.5

  • 其他接入的模型

十、常见问题 FAQ

Q1: npm 安装失败，报错 EACCES

错误信息：


npm ERR! EACCES: permission denied

解决方案：

  1. 以管理员身份运行命令提示符

  2. 或修改 npm 全局目录：

   ```bash

   npm config set prefix "%APPDATA%\npm"

   ```

  1. 重新安装

Q2: 命令无法识别 'openclaw'

解决方案：

  1. 确认环境变量已配置（见第四节）

  2. 关闭并重新打开命令行窗口

  3. 执行 echo %PATH% 确认路径包含

  4. 重新安装：

   ```bash

   npm uninstall -g openclaw

   npm install -g openclaw@latest

   ```

Q3: PowerShell 执行报错

错误信息：


cannot be loaded because running scripts is disabled

解决方案：


Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

Q4: 端口 18789 被占用

解决方案：

  1. 查找占用进程：

   ```bash

   netstat -ano | findstr 18789

   ```

  1. 结束进程或修改配置端口

  2. 重启服务

Q5: Web 界面无法访问

排查步骤：

  1. 确认服务已启动：openclaw gateway status

  2. 检查防火墙设置

  3. 尝试 http://localhost:18789

  4. 查看日志文件定位问题

Q6: API Key 配置后仍报错

解决方案：

  1. 确认 Key 格式正确（无多余空格）

  2. 检查账户余额/配额

  3. 测试 API 连通性

  4. 查看官方文档确认权限

Q7: 安装过程被安全软件拦截

解决方案：

  1. 暂时退出安全软件

  2. 添加 npm 和 Node.js 到信任列表

  3. 重新执行安装命令

十一、参考资源

官方链接

下载链接

社区支持

  • 掘金社区：搜索 OpenClaw 相关话题

  • GitHub Issues：问题反馈

总结

恭喜完成 OpenClaw 的安装配置！

关键步骤回顾：

| 步骤 | 操作 | 耗时 |

|------|------|------|

| 1 | 安装 Git | 2 分钟 |

| 2 | 安装 Node.js 22.x | 2 分钟 |

| 3 | 配置环境变量 | 1 分钟 |

| 4 | 设置 PowerShell 权限 | 1 分钟 |

| 5 | npm 安装 OpenClaw | 2 分钟 |

| 6 | 初始化配置 | 2 分钟 |

| 总计 | | 约 10 分钟 |

下一步建议：

  • 📖 阅读官方文档了解功能

  • 🔑 配置 API Key 开始使用

  • 🤖 尝试飞书等平台集成

  • 💡 探索自动化工作流

如果本文对你有帮助：

👍 点赞 | ⭐ 收藏 | ➕ 关注

遇到问题欢迎在评论区留言交流！

最后更新：2026 年 3 月 11 日

适用版本：OpenClaw latest / Windows 10/11

avatar
文章
阅读
粉丝