【保姆级教程】用 npm 安装 OpenClaw + opencode免费模型完整指南

目标：Windows 10/11 上 直接 npm 全局安装 OpenClaw，启动 Gateway，然后在浏览器打开 WebChat（Dashboard）：

http://127.0.0.1:18789/

一、前言：OpenClaw 是什么？为什么值得装？

OpenClaw（官网：https://openclaw.ai/）是一个开源的 个人 AI 助手（Personal AI Assistant） 项目。它的核心思路不是“给你一个聊天网页”，而是把 AI 变成一个 常驻运行的助手进程（Gateway）：你只需要在熟悉的界面里发一句话，它就能在你的电脑上持续工作、调用工具、处理任务，并且能把能力扩展到各种聊天平台。

简单理解：

你发消息（WebChat/Telegram/WhatsApp/Discord 等）
OpenClaw 在你的机器上执行（读取文件、运行命令、控制浏览器、调用插件/技能）
再把结果返回给你
OpenClaw 能做什么？
OpenClaw 的定位是 “The AI that actually does things.”（真正能动手做事的 AI）。

常见用途包括：

在 WebChat 里当一个“能动手”的 AI 助手（不仅是对话）
结合工具完成自动化任务（例如文件处理、网页操作、信息整理等）
通过网关把能力接入到不同平台（你不需要换一套使用习惯）

为什么本文选择 WebChat（Dashboard）作为入门？
对新手来说，WebChat 是最容易跑通的方式：

不需要先配置 Telegram/WhatsApp Bot
先把 安装 + Gateway 启动 + 模型认证 跑通
后续再扩展到其它平台会更顺

二、环境准备（必须）

2.1 安装 Node.js（要求 ≥ 22）

建议直接去 Node.js 官网装最新版 LTS/Current（确保 ≥22）：

• https://nodejs.org/

安装后打开 PowerShell 验证：

node -v
npm -v

确认 node 是 v22.x.x 或更高。

2.2（建议）准备好 Git

虽然 npm 安装不一定必须 Git，但很多 Windows 环境排错会用到，建议装上：

• https://git-scm.com/
• 

三、用 npm 安装 OpenClaw

以普通 PowerShell 执行即可（如果装全局权限报错，再用管理员 PowerShell）：

npm install -g openclaw@latest

验证：

openclaw --version
openclaw --help

到这里就是安装完毕，openclaw --help这个列表里都是openclaw的一些操作指令

四、首次配置：Onboarding 向导（核心）

执行：

openclaw onboard --install-daemon

这个是风险提示，选择Yes进入后续设置

选择第一个QuickStart（快速启动）

接着是配置相关API，例如OpenAI,Google等是可以通过OAuth或者API进行配置的。今天我选择使用opencode的免费的MiniMax M2.1 free模型。

首先打开opencode的相关网址https://opencode.ai/zen，注册登录好并且获取API

回到终端进行相关配置，选择opencode，输入刚刚复制的API密钥，就会出现很多的模型让你选择默认模型（后期可以修改），我这里选择的是MiniMax M2.1 free，这是一个免费模型

选择完成后，会让你选择下载skill和配置移动端，这里我们先不配置，我们在web端进行使用，如果需要配置移动端（飞书），后续会出相关教程。

这里我选择了一个会话记忆，大家可以根据自己的需求选择。

接着openclaw会启动gateway服务，会自动弹出网页端http://127.0.0.1:18789/

五、快速自检（2 分钟）

openclaw配置自我检查的功能

另开一个 PowerShell 窗口执行：

openclaw status
openclaw health
openclaw doctor

• health 里如果提示 no auth / provider not configured：说明模型认证还没配好（回到 onboard 把 key/OAuth 配完即可）。
• 如果端口打不开：看 --verbose 控制台输出的报错最直接。

六、后续启动 Gateway + 打开 WebChat（Dashboard）

6.1 查看 Gateway 状态（如果你装了 daemon）

openclaw gateway status

6.2 前台启动（推荐你先用这个跑通）

就算 daemon 装不上，前台启动也能直接用 WebChat：

openclaw gateway --port 18789 --verbose

看到 Gateway 正常运行后，在浏览器打开：

• http://127.0.0.1:18789/

七、进行相关功能测试（创建个人主页）

 可以对他进行初始化，并且测试一下模型

接着测试一下让他做一个个人主页

测试结果展示：

八、Windows 原生最常见的坑

8.1 npm install -g openclaw 卡在原生依赖/编译（常见）

OpenClaw 依赖里可能包含需要原生构建的包（例如图像相关）。Windows 下如果报 node-gyp、编译工具链缺失之类，通常解决思路是：

• 安装 Visual Studio Build Tools（C++ 生成工具）
• 或按报错提示补齐 Python / MSVC 环境

8.2 Gateway 能跑，但 WebChat 不回复

99% 是 模型认证没配好（没 API Key/OAuth，或者环境变量没被服务进程读到）。先用：

openclaw health

确认 auth/provider 状态。