OpenClaw Windows 安装完整指南

wenxing462

1402人浏览 · 2026-02-28 23:53:54

wenxing462 · 2026-02-28 23:53:54 发布

一、OpenClaw 简介

OpenClaw（曾用名：Clawdbot、Moltbot）是一款可以在本地电脑上运行的"个人AI智能体"。它的核心价值在于从"对话"跨越到"执行"，可以部署在个人电脑上，通过聊天界面执行文件操作、代码编写、网页调研等复杂任务。

核心架构：

Gateway（网关）：连接WhatsApp、飞书、Telegram等聊天平台
Agent（智能体）：接入大语言模型进行思考和推理
Skills（技能）：执行具体操作，如网页调研、访问邮箱、操作浏览器等
Memory（记忆）：通过本地文件记录用户偏好和对话历史

⚠️ 重要安全提示
OpenClaw拥有较高的系统操作权限。为了保护你的主电脑安全，强烈建议使用一台备用机、虚拟机或云服务器（VPS）进行安装和运行。

二、Windows 安装详细步骤

第一阶段：环境准备

1. 安装 nvm for Windows

访问 nvm-windows 发布页下载最新版 nvm-setup.exe
下载地址：https://github.com/coreybutler/nvm-windows/releases
双击运行，一路"Next"完成安装

2. 以管理员身份打开 PowerShell

按 Win 键，输入 PowerShell
右键点击"Windows PowerShell"，选择 "以管理员身份运行"

3. 安装 Node.js

在管理员 PowerShell 中依次执行：

powershell

# 安装Node.js 22.x版本
nvm install 22

# 使用安装好的22.x版本（具体版本号可能略有不同）
nvm use 22

看到类似 Now using node v22.22.0 的提示即表示成功。

第二阶段：安装 OpenClaw

1. 执行一键安装脚本

在管理员 PowerShell 中执行：

powershell

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

2. 解决执行策略问题（如遇报错）

如果遇到执行策略报错，先执行：

powershell

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

然后重新执行一键安装命令。

第三阶段：初始化配置

安装完成后会自动进入配置流程。若未自动启动，可运行：openclad onboard --flow quickstart

配置步骤：

确认风险提示：输入 Yes 并回车
选择并配置模型：按提示选择大模型，输入对应的 API Key
跳过通讯工具配置：直接回车跳过（Windows原生环境建议使用Web控制台）
跳过技能配置：直接回车跳过

4. 完成验证

配置完成后，OpenClaw会自动启动网关，并弹出浏览器打开控制台页面（通常为 http://127.0.0.1:18789/）。若能正常对话，即表示安装成功！

三、常见异常与解决方案

异常现象	可能原因	解决方案
找不到`openclaw`命令	环境变量未刷新	关闭当前PowerShell，重新以管理员身份打开新窗口
安装/插件下载失败	网络问题，无法访问GitHub	配置Git代理： `git config --global http.proxy http://代理IP:端口` `git config --global https.proxy http://代理IP:端口`
权限不足，无法写入C盘	未以管理员运行或目录权限不足	1. 确认以管理员身份运行PowerShell 2. 手动接管权限： `takeown /f "C:\OpenClaw" /r /d y` `icacls "C:\OpenClaw" /grant Administrators:F /t`
飞书插件安装失败	Windows原生环境兼容性问题	推荐：使用Web控制台交互（`http://127.0.0.1:18789/`）进阶：通过WSL2运行OpenClaw
运行卡顿，推理慢	本地模型硬件配置不足	1. 降低模型规格（如7b→4b） 2. 使用云端模型（通过API Key调用）

四、常用维护命令

命令	作用
`openclaw gateway start`	启动网关
`openclaw gateway restart`	重启网关（修改配置后常用）
`openclaw doctor --fix`	诊断并自动修复问题
`openclaw logs follow`	实时查看日志（定位问题）
`openclaw update`	升级OpenClaw
`openclaw tui`	打开终端对话模式

五、快速安装命令汇总

将以下命令按顺序在管理员 PowerShell中执行即可：

powershell

# 1. 安装nvm（需手动下载安装包）
# 访问：https://github.com/coreybutler/nvm-windows/releases

# 2. 安装Node.js
nvm install 22
nvm use 22

# 3. 设置执行策略（如需）
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# 4. 安装OpenClaw
iwr -useb https://openclaw.ai/install.ps1 | iex

# 5. 初始化配置
openclad onboard --flow quickstart