OpenClaw 完整安装与 AI 模型 API 配置教程（Windows 版）

OpenClaw 是一款功能丰富的 AI 交互工具，支持对接多款主流大模型（如 Moonshot Kimi、OpenAI GPT、Anthropic Claude 等），本文基于 Windows 系统，详细讲解从安装到 API 配置的全流程，并解决配置过程中常见的网关启动、命令不兼容等问题。

一、前置依赖配置（Node.js + Git）

OpenClaw 基于 Node.js 开发，Git 用于版本管理和依赖拉取，需先完成这两项配置。

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

（1）下载安装包

访问 Node.js 官方下载页：https://nodejs.org/zh-cn/download/

选择「Windows 安装程序 (.msi)」（推荐 LTS 长期支持版，如 20.x 版本）；
64 位系统选 node-v20.x.x-x64.msi，32 位选 x86 版本。

（2）安装步骤

双击安装包，勾选「I accept the terms in the License Agreement」，点击「Next」；
自定义安装路径（建议默认 C:\Program Files\nodejs\），点击「Next」；
关键步骤：勾选「Add to PATH」（自动配置环境变量，必选），其余默认，点击「Next」；
无需勾选「Tools for Native Modules」（新手无需编译原生模块），点击「Install」；
安装完成后点击「Finish」。

（3）验证 Node.js 安装

以管理员身份打开终端（CMD/PowerShell），执行以下命令，输出版本号则安装成功：

# 验证 Node.js 版本
node -v

# 验证 npm（Node 包管理器，随 Node.js 自带）版本
npm -v

2. 安装 Git（可选但推荐）

（1）下载安装包

访问 Git 官方下载页：https://git-scm.com/download/win

自动识别系统版本，下载 64 位 Git for Windows Setup。

（2）安装步骤

双击安装包，一路点击「Next」（默认选项即可，新手无需修改）；
关键步骤：「Adjusting your PATH environment」选择「Git from the command line and also from 3rd-party software」；
「Default editor for Git」可选默认的 Vim，或改为 Notepad++（如有安装）；
其余步骤默认，直至安装完成。

（3）验证 Git 安装

终端执行以下命令，输出版本号则成功：

git --version

3. 配置 npm 国内镜像（可选，解决安装慢）

国内网络访问 npm 官方源较慢，可配置淘宝镜像：

# 临时配置
npm config set registry https://registry.npmmirror.com

# 永久配置（推荐）
npm config set registry https://registry.npmmirror.com --global

二、环境准备（补充后）

1. 基础要求

系统：Windows 10/11（64 位）
权限：全程使用管理员身份运行终端（CMD/PowerShell）
编码：提前设置终端为 UTF-8，避免中文乱码：
```
chcp 65001
```
网络：确保能访问目标 AI 模型的 API 端点（如 Moonshot、OpenAI 服务器）。

2. 依赖确认

已完成 Node.js（含 npm）和 Git 安装，且验证版本正常。

三、安装 OpenClaw

1. 快速安装（推荐）

在管理员终端执行以下命令：

# npm 全局安装 OpenClaw
npm install -g openclaw

# 若 npm 安装失败，尝试通过 Git 克隆（备选）
git clone https://github.com/openclaw/openclaw.git
cd openclaw
npm install -g

2. 验证安装

执行以下命令，若输出版本号则安装成功：

openclaw --version

四、初始化配置与网关部署

网关是 OpenClaw 的核心服务，负责面板访问和模型调用，需先解决网关安装 / 启动问题。

1. 初始化配置向导

运行交互式配置向导，完成基础设置（如存储路径、通道等）：

openclaw configure

按向导提示操作：

遇到「Config handling」时，推荐选 Reset 重置旧配置，避免冲突；
遇到「Model/auth provider」时，若暂时不想配置模型，用方向键滚动找到 Skip for now 跳过；
遇到「Skills status」时，选 Skip for now 跳过依赖安装，优先完成基础配置。

2. 安装并启动网关服务

（1）安装网关注册为 Windows 服务

openclaw gateway install

若提示「schtasks create failed」：确认终端是管理员权限，且已执行 chcp 65001 切换编码；
若仍失败，手动启动网关（无需安装服务）：
```
openclaw gateway
```

（2）启动 / 重启网关

# 启动网关
openclaw gateway start

# 重启网关（配置修改后需执行）
openclaw gateway restart

# 检查网关状态
openclaw gateway status

状态显示 running 即为正常；
若提示「Gateway service missing」，重新执行 openclaw gateway install。

3. 访问 Web 控制面板

网关启动后，生成并访问控制面板地址：

openclaw dashboard --no-open

复制输出的地址（格式为 http://127.0.0.1:18789/?token=xxx，注意将 #token 改为 ?token），在浏览器中打开即可。

五、配置 AI 大模型 API（核心步骤）

OpenClaw 不同版本命令略有差异，若 provider 命令无效，改用 models 命令（本文以 Moonshot Kimi 为例，适配 OpenAI/Anthropic 等）。

1. 查看模型配置命令

确认当前版本支持的模型操作命令：

openclaw models --help

2. 添加 AI 模型提供商认证（以 Moonshot Kimi 为例）

# 交互式添加（推荐，避免 API Key 明文暴露）
openclaw models auth add moonshot

# 按提示输入 Moonshot API Key，回车确认

若配置 OpenAI：
```
openclaw models auth add openai
```
若配置 Anthropic Claude：
```
openclaw models auth add anthropic
```

3. 扫描并获取可用模型列表

配置认证后，扫描提供商的所有可用模型：

openclaw models scan

4. 查看模型列表并设置默认模型

# 查看所有可用模型
openclaw models list

# 设置默认模型（以 Moonshot Kimi K2.5 为例）
openclaw models set moonshot/kimi-k2.5

5. 手动修改配置文件（备选方案）

若命令行配置失败，直接编辑配置文件：

配置文件路径：C:\Users\你的用户名\.config\openclaw\config.yaml

添加模型配置（示例）：

ai:
  default_provider: moonshot
  providers:
    moonshot:
      api_key: "你的 Moonshot API Key"
      default_model: "kimi-k2.5"
      base_url: "https://api.moonshot.cn/v1"

保存后重启网关：openclaw gateway restart。

六、验证配置有效性

执行以下命令测试模型调用，若返回 AI 回答则配置成功：

openclaw chat "你好，介绍一下自己"

七、常见问题排查

1. 无法访问控制面板地址

检查端口占用：netstat -ano | findstr "18789"，结束占用进程；
放行防火墙：在 Windows 防火墙中新增入站规则，允许 18789 端口。

2. 提示「unknown command ‘provider’」

改用 models 命令（如 openclaw models auth add）；
执行 openclaw --help 确认当前版本支持的命令。

3. 网关启动失败（1006 异常关闭）

查看日志定位问题：openclaw logs --tail 50；
检查 API Key 有效性，确保网络能访问模型 API 端点；
重启网关：openclaw gateway stop && openclaw gateway start。

4. npm 安装 OpenClaw 失败

检查 Node.js 版本是否兼容（推荐 18+）；
切换 npm 镜像：npm config set registry https://registry.npmmirror.com；
清除 npm 缓存：npm cache clean --force，重新安装。

八、总结

OpenClaw 安装前必须完成 Node.js（含 npm） 配置，Git 为可选但推荐安装，国内用户建议配置 npm 国内镜像；
核心流程：依赖安装 → OpenClaw 安装 → 网关部署 → AI 模型 API 配置，全程需用管理员终端并切换 UTF-8 编码；
模型配置优先用 models 命令（替代不兼容的 provider），核心步骤为「添加认证→扫描模型→设置默认」；
配置后重启网关并通过 openclaw chat 验证，遇到报错优先查看日志或检查端口、API Key、网络。

按照以上步骤操作，即可完成 OpenClaw 的全流程配置，若遇到特定报错，可通过日志定位问题，或核对依赖版本、权限、编码等关键项。

温馨提示：

文章标题：OpenClaw 完整安装与 AI 模型 API 配置教程（Windows 版）

文章链接：https://www.wuyanshuo.cn/20014.html

更新时间：2026年03月05日

本站资源均为两层压缩，第一层7z（后缀若为wys，请自行修改为7z）有解压密码；第二层zip或cbz，无解压密码，可直接使用漫画类软件程序查看；详情可参考解压教程。

本站大部分内容均收集于网络!若内容若侵犯到您的权益，请发送邮件至：service@wuyanshuo.cn我们将第一时间处理！资源所需价格并非资源售卖价格，是收集、整理、编辑详情以及本站运营的适当补贴，并且本站不提供任何免费技术支持。所有资源仅限于参考和学习，版权归原作者所有，更多请阅读无言说网络服务协议。

{{userData.name}}已认证