OpenClaw Windows 从零安装完全指南（2026版）

---

什么是 OpenClaw？

OpenClaw（开源智能体，昵称龙虾）是一款强大的 AI 机器人框架，支持多模型接入和插件扩展。它可以在本地运行，也可以部署到服务器上 24 小时在线。

简单来说，OpenClaw = 你的私人 AI 助手框架，可以接入你的聊天软件（QQ、Telegram、Discord 等），根据你的需求定制功能。

---

准备工作

硬件要求

• CPU：双核及以上（推荐 4 核）
• 内存：4GB 以上
• 磁盘：10GB 可用空间
• 系统：Windows 10/11 64位

需要下载

1. Node.js：https://nodejs.org/ — 下载 LTS 版本（推荐 v22.x）
2. Git：https://git-scm.com/ — 用于拉取源码
3. OpenClaw 源码：GitHub 仓库

---

第一步：安装 Node.js

1. 打开 Node.js 官网，下载 Windows 版本的 LTS 安装包。

2. 双击运行安装程序，一路 Next 即可。注意勾选 Add to PATH（添加到环境变量）。

3. 安装完成后，打开命令提示符（CMD）或 PowerShell，输入以下命令验证：

node --version
npm --version

如果显示版本号（如 v22.x.x、v10.x.x），说明安装成功。

---

第二步：安装 Git

1. 打开 Git 官网，下载 Windows 版本。

2. 运行安装程序，大部分设置保持默认即可。注意在 Choosing the default editor 步骤可以选择你习惯的编辑器。

3. 验证安装：

git --version

---

第三步：下载 OpenClaw

打开命令提示符或 PowerShell，执行：

git clone https://github.com/openclaw/openclaw.git
cd openclaw

或者直接从 GitHub Release 页面下载最新的 ZIP 压缩包，解压到你想要的位置。

---

第四步：安装依赖

在 OpenClaw 目录下执行：

npm install

这个过程会下载 OpenClaw 所需的所有依赖包。根据网络情况可能需要几分钟。

如果遇到网络问题，可以尝试使用国内镜像：

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

---

第五步：配置 OpenClaw

1. 复制配置文件模板：

copy .env.example .env

2. 用记事本或任意文本编辑器打开 .env 文件，根据需要修改配置：

• PORT：运行端口（默认 3000）
• LOG_LEVEL：日志级别（debug/info/warn/error）
• DATA_DIR：数据存储目录（默认 ./data）

3. 如果你需要接入聊天平台，还需要配置对应的 API Key 和 Token（后续章节会详细说明）

---

第六步：启动 OpenClaw

npm start

看到类似以下输出说明启动成功：

[INFO] OpenClaw server started on port 3000
[INFO] Web interface: http://localhost:3000

打开浏览器访问 http://localhost:3000 即可看到 OpenClaw 的 Web 控制面板。

---

第七步：配置聊天平台（以 QQ 为例）

OpenClaw 支持接入多个聊天平台。以下以 QQ 机器人为例：

1. 前往 QQ 开放平台 注册机器人账号。

2. 创建机器人应用，获取 AppID 和 Token。

3. 在 OpenClaw 的 .env 文件中添加：

QQBOT_APPID=你的AppID
QQBOT_TOKEN=你的Token

4. 重启 OpenClaw 即可生效。

---

常见问题

Q：启动时报错 “port 3000 already in use”

A：端口被占用，修改 .env 中的 PORT 为其他值（如 8080）。

Q：npm install 很慢或失败

A：切换为国内镜像源：npm config set registry https://registry.npmmirror.com

Q：如何更新 OpenClaw？

A：在 OpenClaw 目录下执行 git pull 拉取最新代码，然后 npm install 更新依赖，最后重启即可。

Q：如何开机自启？

A：推荐使用 PM2：npm install -g pm2，然后在 OpenClaw 目录下执行 pm2 start npm --name openclaw -- start，再执行 pm2 save 保存进程列表。

---

结语

以上就是 OpenClaw 在 Windows 系统上的完整安装教程。如果你有 AI 模型的 API Key，可以直接在配置文件中添加，让 OpenClaw 成为一个真正的智能助手。

遇到问题可以前往 GitHub Issues 提问。