一、环境与准备（必看，细节补充）

1）系统与硬件要求（明确限制条件）

• 系统：Windows 10 专业版 / 企业版 / 家庭版（64 位，版本号 ≥ 1903）、Windows 11 所有 64 位版本

• 硬件最低配置：2 核物理 CPU（支持 VT-x 虚拟化）、4GB DDR4 内存（建议单通道≥8GB）、10GB NTFS 格式空闲磁盘（机械硬盘可装，NVMe SSD 推荐，读写速度提升 3 倍）

• 硬件推荐配置：4 核 8 线程 CPU（i5/R5 及以上）、8GB + 内存、40GB+ NVMe SSD（避免安装在系统盘 C 盘，防止占用系统资源）

• 额外要求：开启硬件虚拟化（BIOS 中启用 VT-x/AMD-V，笔记本需在 BIOS 的 Security 选项卡中设置）

2）核心依赖安装（分步教学）

• Node.js 安装（关键步骤）

1. 1. 下载地址：https://nodejs.org/dist/v22.3.0/node-v22.3.0-x64.msi（推荐 22.3.0 LTS 版，兼容最佳）

1. 1. 安装步骤：双击安装包 → 勾选「I accept the terms」→ 自定义安装路径（建议 D:\Node.js，纯英文无空格）→ 勾选「Add to PATH」（自动配置环境变量）→ 下一步至安装完成

1. 1. 验证：打开 PowerShell，输入 node -v 和 npm -v，输出版本号（如 v22.3.0、10.8.1）即成功

• Git 安装（可选，源码安装需用）

1. 1. 下载地址：https://git-scm.com/download/win（自动适配 64 位系统）

1. 1. 安装时默认勾选「Use Git from Git Bash only」，其他保持默认，一路下一步

• 大模型 API Key 准备

推荐优先选择 DeepSeek（免费额度高，注册地址：https://www.deepseek.com/），注册后在「API 管理」中创建密钥，复制保存（后续配置需用，切勿泄露）

3）国内网络加速（双重保障）

安装前必须配置镜像，否则易出现下载超时、依赖缺失：

# 1. npm 镜像配置（全局生效）

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

npm config set disturl https://npmmirror.com/dist

npm config set electron_mirror https://npmmirror.com/mirrors/electron/

# 2. 验证镜像是否生效

npm config get registry # 输出 https://registry.npmmirror.com 即成功

# 3. 安装 pnpm（推荐包管理器，速度更快）

npm install -g pnpm

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

二、一键安装（新手首选，5 分钟搞定，补充避坑细节）

1）前置准备（避免安装失败）

• 关闭所有安全软件（360、火绒、Windows Defender 实时防护），需临时关闭「病毒和威胁防护」中的「实时保护」

• 用 管理员身份打开 PowerShell（右键开始菜单 → 选择「Windows PowerShell (管理员)」，Win11 可搜「终端 (管理员)」）

• 解锁脚本执行权限（首次安装必须执行，否则无法运行安装脚本）：

# 输入命令后按 Y 确认，设置执行策略为允许本地脚本

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

2）一键安装命令（国内加速版，附进度说明）

# 国内专属加速脚本，自动拉取国内镜像源，避免卡顿

iwr -useb https://clawd.org.cn/install.ps1 | iex

• 执行后会出现以下步骤，按提示操作：

1. 1. 选择安装路径：默认是 C:\Program Files\OpenClaw，建议修改为 D:\OpenClaw（输入路径后按回车，必须纯英文无空格、无特殊字符）

1. 1. 等待下载依赖：约 3-10 分钟（取决于网络，进度条显示 100% 即完成）

1. 1. 自动配置环境变量：无需手动操作，脚本会自动添加到系统 PATH

1. 1. 安装完成提示：出现「OpenClaw installed successfully!」即成功

3）安装验证（分步确认，避免漏检）

# 1. 验证命令是否可用（任意目录执行）

openclaw --version # 输出版本号如 2026.4.15 即成功

# 2. 验证环境变量是否配置正确

where openclaw # 输出安装路径下的 openclaw.exe 路径即正常

# 3. 验证依赖是否完整

openclaw doctor # 出现「All dependencies are satisfied」即无问题

三、初始化向导（onboarding，2 分钟配置，补充参数说明）

安装完成后必须执行初始化，否则无法启动服务：

# 启动初始化向导，同时安装后台服务（开机自启）

openclaw onboard --install-daemon

• 向导会依次弹出以下配置项，按提示填写：

1. 1. 选择模型厂商：上下键选择「DeepSeek」（推荐，免费额度充足），按回车确认

1. 1. 输入 API Key：粘贴之前准备的 DeepSeek API 密钥（右键粘贴，看不到明文是正常的），按回车

1. 1. 配置网关端口：默认 18789，直接回车即可（若端口被占，会提示修改，建议用 18790 备用）

1. 1. 安装后台服务：输入「yes」（小写），按回车，自动注册为 Windows 服务，支持开机自启

1. 1. 配置管理员账号：设置用户名（默认 admin）和密码（8 位以上，含字母 + 数字），按回车完成初始化

四、启动与访问（多种启动方式，补充访问故障排查）

1）前台启动（临时测试，适合首次验证）

# 前台启动网关，控制台会显示日志，方便排查问题

openclaw gateway

• 启动成功标志：控制台出现「Gateway started on http://localhost:18789」

• 访问方式：打开浏览器，输入 http://localhost:18789，出现 OpenClaw 登录页面即正常

2）后台运行（长期使用，推荐生产环境）

# 1. 启动后台服务（注册为 Windows 服务，隐藏运行）

openclaw gateway start

# 2. 查看服务状态（确认是否启动成功）

openclaw gateway status # 显示「running」即正常

# 3. 打开管理面板（快速访问网页后台）

openclaw dashboard # 自动跳转至 http://localhost:18789/dashboard

# 4. 停止/重启服务（如需）

openclaw gateway stop # 停止服务

openclaw gateway restart # 重启服务

3）访问故障排查

• 问题 1：浏览器提示「无法访问此网站」

解决：① 检查服务是否启动（openclaw gateway status）；② 关闭防火墙（控制面板 → 系统和安全 → Windows Defender 防火墙 → 关闭）；③ 更换浏览器（推荐 Chrome/Edge，避免国产浏览器兼容问题）

• 问题 2：端口被占用（提示「Port 18789 is in use」）

解决：① 查找占用端口的程序：

netstat -ano | findstr 18789 # 最后一列是 PID

② 打开任务管理器 → 详细信息 → 按 PID 排序 → 结束对应进程；③ 若无法结束，修改端口：

openclaw onboard # 重新初始化，在端口配置时输入 18790

五、常用命令与进阶操作（补充更多实用命令）

1）基础常用命令

openclaw --version          # 查看版本号
openclaw onboard            # 重新初始化配置
openclaw gateway log        # 查看后台服务日志（排查故障用）
openclaw skills list        # 查看已安装的技能
openclaw skills install @openclaw/chat  # 安装聊天技能
openclaw skills uninstall @openclaw/chat  # 卸载技能
openclaw update             # 更新 OpenClaw 到最新版本

2）服务管理进阶（Windows 服务配置）

• 手动查看服务：按 Win+R → 输入「services.msc」→ 找到「OpenClaw Gateway」，可手动启动 / 停止 / 设置启动类型（建议设为「自动延迟启动」，减少开机占用）

• 修复服务：若服务启动失败，执行以下命令重建服务：

openclaw gateway uninstall # 卸载旧服务

openclaw gateway install # 重新安装服务

openclaw gateway start # 启动服务

六、常见坑与解决方案（补充 Windows 专属问题）

1）安装慢 / 超时（国内最常见问题）

• 解决方案：① 确保已配置 npmmirror 镜像（前面的加速步骤）；② 关闭 VPN / 代理（部分代理会拦截国内镜像）；③ 更换网络（用手机热点试一次，排除宽带问题）；④ 手动下载安装包：https://clawd.org.cn/downloads/OpenClaw-Win-x64.zip，解压到 D:\OpenClaw，然后执行：

cd D:\OpenClaw​
pnpm install  # 手动安装依赖

2）权限不足（安装 / 启动失败）

• 解决方案：① 所有命令必须用「管理员 PowerShell」执行（右键开始菜单选择，不要用普通 cmd）；② 安装路径不要选 C 盘（C 盘需要管理员权限，容易受限）；③ 右键 OpenClaw 安装目录 → 属性 → 安全 → 编辑 → 给当前用户授予「完全控制」权限

3）Node.js 版本不对（提示「Node.js version 22.0.0」）

• 解决方案：① 卸载旧版本 Node.js（控制面板 → 程序和功能 → 卸载 Node.js）；② 安装 22.x LTS 版（前面提供的下载地址）；③ 若已安装多个 Node 版本，用 nvm 管理：

# 安装 nvm（Node 版本管理器）

iwr -useb https://raw.githubusercontent.com/coreybutler/nvm-windows/master/nvm-setup.exe | iex

# 安装 Node 22

nvm install 22

nvm use 22

4）启动后日志报错「API Key 无效」

• 解决方案：① 检查 API Key 是否复制完整（无多余空格、符号）；② 登录 DeepSeek 官网，确认 API Key 未过期、有剩余额度；③ 重新执行 openclaw onboard，重新输入 API Key

七、安装成功后的下一步（补充详细操作）

1. 登录管理面板：用 openclaw dashboard 打开网页，输入初始化时设置的用户名和密码

1. 绑定更多模型：在「Models」页面，可添加 Kimi、Minimax 等其他厂商的 API Key，切换使用

1. 安装实用技能：

# 安装工具调用技能（支持联网、文件处理）
openclaw skills install @openclaw/tools
# 安装知识库技能（上传文档构建私有知识库）
openclaw skills install @openclaw/knowledge

1. 测试功能：在聊天界面发送消息，验证模型响应；尝试使用「工具调用」功能（如搜索天气、生成文件）

1. 备份配置：定期备份 D:\OpenClaw\config 目录，避免重装后丢失配置