【保姆级教程】15分钟OpenClaw安装指南【保姆级教程】15分钟OpenClaw安装指南：从零到可用作者： Luc

【保姆级教程】15分钟OpenClaw安装指南：从零到可用

作者： Lucky
日期： 2026-03-22
标签： #OpenClaw #AI工具 #效率工具 #Windows #教程

前言

最近在公司推广OpenClaw，发现很多同事卡在安装这一步。作为一个帮100+人成功安装的老司机，我把这套标准化流程整理出来，希望能帮到你。

预计耗时： 15分钟
适用系统： Windows 10/11
难度等级： ⭐⭐（有手就会）

环境准备

系统要求

项目	最低要求	推荐配置
操作系统	Windows 10 1903+	Windows 11
内存	4GB	8GB+
磁盘空间	1GB 可用空间	5GB+
网络	能访问国内网站	稳定宽带

前置检查

打开 PowerShell（管理员），执行：

# 检查系统版本
[Environment]::OSVersion.Version

# 检查是否管理员
([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)

返回 True 表示是管理员权限，可以继续。

安装步骤

Step 1：安装 Node.js

下载地址： nodejs.org/

选择 LTS 版本（长期支持版），目前推荐 v22.x。

安装选项：

Automatically install the necessary tools
Add to PATH

验证安装：

# 重启 PowerShell 后执行
node -v  # v22.x.x
npm -v   # 10.x.x

Step 2：配置 PowerShell 执行策略

问题现象：

无法加载文件...因为在此系统上禁止运行脚本

解决方案：

# 以管理员身份运行
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine -Force

# 验证
Get-ExecutionPolicy  # RemoteSigned

常见错误：

不加 -Scope LocalMachine → 只改当前用户，系统级还是不行
不以管理员身份运行 → 权限不足

Step 3：安装 Git

下载地址： git-scm.com/download/wi…

关键配置：

安装到 "Adjusting your PATH environment" 时，选择：

☑ Git from the command line and also from 3rd-party software

配置 HTTPS 替代 SSH（解决国内网络问题）：

git config --global url."https://github.com/".insteadOf "ssh://git@github.com/"

验证：

git --version  # git version 2.x.x

Step 4：安装 OpenClaw

npm install -g openclaw

安装时长： 1-3分钟（取决于网络）

常见问题：

Q：安装卡住不动？ A：正常现象，npm 在下载依赖。如果超过 5 分钟，按 Ctrl+C 取消重试。

Q：报错 EACCES？ A：权限问题，确保是管理员 PowerShell。

验证安装：

openclaw --version  # 2026.3.x

Step 5：初始化配置

openclaw onboard

模型选择：

推荐选择 2 - Moonshot AI（Kimi）

为什么不选 OpenAI？

OpenAI API 在国内不稳定
Kimi 是国内大模型，延迟低
效果不输 GPT-4

获取 API Key：

访问 platform.moonshot.cn/
注册/登录
创建 API Key
复制粘贴到终端

配置完成标志：

openclaw status
# Gateway: reachable

Step 6：启动 Web UI

openclaw gateway start

访问地址： http://127.0.0.1:18789/

获取 Token：

openclaw config get gateway.token

故障排查

问题1：`openclaw` 命令找不到

原因： npm 全局路径未加入环境变量

解决：

# 方法1：重启 PowerShell
# 方法2：重启电脑
# 方法3：使用完整路径
& "$env:APPDATA\npm\openclaw.cmd" --version

问题2：Gateway 启动失败

检查端口占用：

netstat -ano | findstr 18789

结束占用进程：

taskkill /PID <进程ID> /F

问题3：AI 请求 timeout

原因： 模型配置错误

检查配置：

openclaw config list

切换模型：

openclaw config set default_model moonshot/kimi-k2-5

进阶配置

配置开机自启动

编辑配置文件 %USERPROFILE%\.openclaw\config.json：

{
  "gateway": {
    "autostart": true,
    "port": 18789
  }
}

配置 Web 搜索

安装技能：

openclaw skill install web_search

配置 Brave Search API：

{
  "skills": {
    "web_search": {
      "provider": "brave",
      "api_key": "你的API Key"
    }
  }
}

总结

通过本文，你应该能在 15 分钟内完成 OpenClaw 的安装和基础配置。

核心要点：

按顺序执行，不要跳过步骤
注意管理员权限
推荐用 Kimi，别折腾 OpenAI

遇到问题？

评论区提问
私信交流
参考官方文档

关于作者

Lucky，一个热爱效率工具的开发者。已帮助 100+ 用户完成 OpenClaw 安装，总结出这套标准化流程。

GitHub： github.com/lucky
公众号： 效率工具指南

如果本文对你有帮助，点个赞 👍 支持下

【保姆级教程】15分钟OpenClaw安装指南