纯小白可直接照抄，全程零门槛

---

🌟 前言：OpenClaw 是什么？

OpenClaw 是 GitHub 史上增长最快的开源项目之一（Star 26.2w+），不是普通聊天机器人，而是能直接操作电脑的 AI 数字管家。它打破了 “AI 只会动嘴” 的局限，能真正落地执行任务：

• 自动整理下载文件夹、按类型 / 日期归档文件
• 读取论文 / 文档并生成结构化摘要
• 配置定时任务，自动推送每日资讯 / 消息
• 接入飞书、Telegram、Discord 等多平台聊天工具

一句话总结：别的 AI 教你怎么做，OpenClaw 直接帮你做完，解放双手的本地 AI 工具。

---

📌 一、必须先懂的 4 个基础概念

搞懂这 4 个概念，能少走 90% 的弯路，避免安装时一脸懵。

表格

概念	通俗解释	核心作用
终端 / PowerShell	Win+R 输入 powershell 打开的黑窗口	给电脑发送指令的 “指挥台”，所有安装命令都在这里执行
Node.js	OpenClaw 的运行 “地基”，要求版本 ≥22	让电脑能读懂 OpenClaw 的代码，相当于 “翻译官”，自带 npm（应用商店）
API Key	调用 AI 模型的 “身份凭证”	像健身房会员卡，让 OpenClaw 能连接 MiniMax 等模型的 “大脑”，无 Key 无法运行
WARN / ERROR	终端日志的两种状态	黄色 WARN = 小提醒，不用管；红色 ERROR = 真实报错，需优先处理

---

🚀 二、整体安装流程（5 步核心）

无论选择哪种部署方式，核心流程都一致，先记牢这 5 步：

1. 安装运行环境（Node.js，WSL2 需额外配置 Linux 系统）
2. 安装 OpenClaw 主程序
3. 运行配置向导（选择模型、填写 API Key）
4. 申请 MiniMax API Key（国内最稳方案）
5. 启动网关，进入控制台验证使用

---

💻 三、Windows 原生部署（推荐新手首选）

无需额外安装虚拟机，直接在 Windows 系统部署，步骤简单、上手快。

1. 安装 Node.js（核心依赖）

1. 打开下载官网：https://nodejs.org/en/download
2. 选择 Windows Installer (.msi) 64-bit 版本，确保版本号 ≥22（如 v22.14.0 LTS，LTS 为长期稳定版，优先选）
3. 双击下载好的安装包，一路点击 Next，有 2 个关键注意点：
   • 许可协议页：勾选「I accept」，继续 Next
   • 自定义设置页：必须勾选 Add to PATH（系统能找到 node 命令，不然后面全白装）
4. 安装完成后，验证是否成功：
   • 按 Win+R，输入 powershell 打开终端
   • 输入以下命令，分别显示版本号即为成功：

   powershell

   node -v  # 验证 Node.js
   npm -v   # 验证包管理器
   

2. 安装 OpenClaw 主程序

1. 以管理员身份打开 PowerShell（关键！普通权限可能安装失败）：
   • 左下角搜索「PowerShell」，右键点击选择「以管理员身份运行」
2. 执行一键安装命令：

   powershell

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

   • 解释：iwr 是下载命令，iex 是执行下载的脚本，一行搞定安装
3. 若提示「禁止运行脚本」（红色报错），先执行以下命令解除限制：

   powershell

   Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
   

   • 输入 Y 确认，再重新执行上面的安装命令
4. 验证安装：

   powershell

   openclaw-cn --version
   

   • 显示版本号，说明 OpenClaw 安装成功

3. 运行通用配置向导（Mac/Windows 通用）

在管理员 PowerShell 中执行配置命令：

powershell

openclaw-cn onboard --install-daemon

向导步骤逐行照填，不懂就选默认，默认值是开发团队推荐的最优配置：

1. 工作区路径：直接回车，使用默认路径（存储 OpenClaw 配置、聊天记录等）
2. 选择 AI 模型提供商：方向键上下选择 MiniMax，回车（国内直连、性价比最高）
3. 输入 API Key：暂时跳过，后面会教你申请，粘贴后回车
4. 网关端口：默认 18789，直接回车（基本不会被占用）
5. 聊天平台接入：选「Skip 跳过」（先跑通主程序，避免多配置冲突）
6. 安装守护进程：输入 Y，回车（让 OpenClaw 后台运行，开机自启，方便使用）
7. 确认配置摘要：查看无错误后，回车完成配置

4. 申请 MiniMax API Key（国内最稳方案）

OpenClaw 本身免费，但需要 AI 模型 “大脑”，MiniMax 是国内用户的最优选择（直连、无需代理、Coding Plan 专门适配高频任务）。

1. 打开 MiniMax 开发者平台：https://platform.minimaxi.com/
2. 手机号注册账号，完成实名认证（3 分钟内搞定，必须实名才能使用）
3. 登录后，左侧菜单进入 API Keys（或右上角头像 → 账号设置 → API Keys）
4. 点击「创建新的 API Key」，名称填 OpenClaw（方便识别），点击确认
5. 关键操作：复制生成的 Key（只显示一次！关闭页面后无法再查看），粘贴到备忘录 / 记事本妥善保存
6. 回到配置向导，右键粘贴 Key，回车（终端不显示 Key，属于正常安全机制）

5. 首次运行 & 验证成功

1. 启动 OpenClaw 网关服务：

   powershell

   openclaw-cn gateway --port 18789
   

2. 看到终端显示 Gateway is running on port 18789 即为启动成功（不要关闭这个终端，关了服务就停了）
3. 打开浏览器，访问本地控制台：

   plaintext

   http://127.0.0.1:18789/
   

4. 在输入框发送指令：你好，介绍一下你自己
   • 收到 AI 正常回复 = 部署完全成功！
   • 若页面无法加载，检查是否开启防火墙权限（见下文排错）

---

⚠️ 四、Windows 原生部署高频问题排查

安装时遇到红色报错不用慌，这 4 个问题 90% 的新手都会遇到，直接照抄解决：

1. 问题 1：脚本禁止运行

   • 报错：无法加载文件，禁止运行脚本
   • 解决：执行解除策略命令后重装

   powershell

   Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
   # 输入 Y 确认，再重新执行安装命令
   iwr -useb https://clawd.org.cn/install.ps1 | iex
   

2. 问题 2：'openclaw-cn' 不是内部或外部命令

   • 原因：安装后环境变量未刷新
   • 解决：关闭当前 PowerShell，重新以管理员身份打开，再验证命令

3. 问题 3：端口 18789 被占用

   • 报错：端口被占用，无法启动网关
   • 解决：查看占用进程并强制结束

   powershell

   # 查看 18789 端口的进程 PID
   netstat -ano | findstr 18789
   # 强制结束进程，替换 <PID号> 为查到的数字
   taskkill /PID <PID号> /F
   

4. 问题 4：浏览器访问 127.0.0.1:18789 打不开

   • 原因：Windows 防火墙拦截了 Node.js 网络通信
   • 解决：
     1. 打开「控制面板 → Windows Defender 防火墙 → 允许应用通过防火墙」
     2. 点击「更改设置」，找到 Node.js，勾选「专用」和「公用」
     3. 若找不到 Node.js，点击「允许其他应用」，手动添加路径：C:\Program Files\nodejs\node.exe

---

🧩 五、WSL2 部署流程（进阶稳定版）

适合追求更稳定的 Linux 运行环境、避免 Windows 原生权限 / 兼容问题的用户（新手也可尝试，步骤更严谨）。

1. 启用 WSL2 并安装 Ubuntu

1. 以管理员身份打开 PowerShell，执行启用命令：

   powershell

   wsl --install
   

2. 等待安装完成后，必须重启电脑（不重启无法生效）
3. 重启后自动进入 Ubuntu 初始化，设置用户名和密码（自定义即可，记住密码）

2. 进入 WSL 并更新系统

1. 后续进入 WSL，直接在 PowerShell 输入 wsl 即可
2. 更新系统包（确保软件最新，避免安装报错）：

   bash

   运行

   sudo apt update && sudo apt upgrade -y
   

   • 输入之前设置的 Ubuntu 密码，等待更新完成

3. 安装 Node.js 22+（WSL 专用）

WSL 是 Linux 系统，安装命令与 Windows 不同：

bash

运行

# 下载 Node.js 22 版本安装脚本
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
# 安装 Node.js
sudo apt install -y nodejs
# 验证安装
node -v
npm -v

• 显示版本号（≥22）即为成功

4. 安装 OpenClaw 主程序

WSL 下使用 Linux 安装脚本，一键执行：

bash

运行

wget -qO- https://clawd.org.cn/install.sh | bash

• 验证安装：

bash

运行

openclaw-cn --version

• 显示版本号，说明安装成功

5. 配置 & 启动（与 Windows 原生完全一致）

1. 运行配置向导：

   bash

   运行

   openclaw-cn onboard --install-daemon
   

   • 步骤同原生部署：选 MiniMax → 填 API Key → 端口 18789 → 跳过聊天平台 → 安装守护进程（Y）
2. 启动网关：

   bash

   运行

   openclaw-cn gateway --port 18789
   

3. 访问控制台：在 Windows 浏览器 输入地址（WSL 与 Windows 共享网络）：

   plaintext

   http://127.0.0.1:18789/
   

4. 发送指令验证，有回复即为成功。

6. WSL2 专属常见问题

1. 重启后找不到 WSL：PowerShell 输入 wsl 即可进入
2. Node.js 命令找不到：执行 sudo apt install nodejs -y 重新安装
3. 网关启动后端口无法访问：确保 WSL 内网关正常运行，Windows 直接访问 127.0.0.1:18789 即可

---

🎯 六、实战篇：让 OpenClaw 自动整理下载文件夹（第一个真实任务）

部署成功后，直接体验 OpenClaw 的核心价值 ——动手帮你干活。新手必做这个任务，直观感受它和普通 AI 的区别。

任务目标

自动整理「下载文件夹」，按文件类型分类（图片、文档、压缩包、软件、视频等），告别杂乱下载内容。

1. 前提准备

确保 OpenClaw 网关正在运行（终端未关，显示 Gateway is running）。

2. 打开控制台

浏览器访问：http://127.0.0.1:18789/

3. 发送核心指令

直接复制粘贴以下句子发送给 OpenClaw：

plaintext

帮我整理下载文件夹，按照文件类型归类，图片放到图片文件夹，文档放到文档文件夹，压缩包放到压缩包文件夹，程序安装包放到软件文件夹，视频放到视频文件夹，其他文件放到其他文件夹。

4. 查看执行结果

1. OpenClaw 会自动执行以下步骤：
   • 扫描你的 Windows 下载文件夹（路径：此电脑 → 下载）
   • 自动创建分类子文件夹
   • 移动对应类型文件到对应文件夹
2. 执行完成后，终端会显示进度日志，浏览器也会同步反馈结果
3. 打开「下载文件夹」查看，文件已整整齐齐分类完成！

进阶实用指令（可直接复制使用）

1. 按日期整理下载文件夹：

plaintext

帮我把下载文件夹按日期整理，今天的文件放今天文件夹，昨天的放昨天，更早的放历史文件文件夹。

1. 仅整理图片文件：

plaintext

帮我把下载文件夹里所有图片（jpg、png、jpeg、gif 格式）移动到桌面的「图片整理」文件夹。

1. 扫描重复文件（安全无删除）：

plaintext

帮我扫描下载文件夹，找出重复的文件并列出完整路径，我确认后再执行删除操作。

⚠️ 重要注意事项

• OpenClaw 会真实操作电脑文件（移动、删除、修改），建议先备份重要文件，熟悉操作后再放开完全权限
• 若不想让它操作某个磁盘，可在配置向导中限制访问路径

---

✅ 七、总结：你现在拥有的工具

至此，你已经完成了从 0 到 1 的部署，拥有了一个完全免费、开源、本地运行、可自主操作的 AI 数字管家：

1. 成功安装 Node.js 运行环境
2. 完成 OpenClaw 原生 / WSL2 双模式部署
3. 配置国内最稳的 MiniMax 模型大脑
4. 实现本地 AI 助手的正常运行
5. 完成第一个自动化文件整理任务

后续可拓展：接入飞书、Telegram 等聊天平台，实现多端远程控制；配置定时任务，自动每日推送 AI 资讯、文件总结等。

这份文档可直接保存为 OpenClaw-Windows-完整部署指南.md，本地查看、分享发布均无问题，跟着步骤做，新手也能一次部署成功！