OpenClaw本地部署

OpenClaw 是一款灵活的 AI 智能体框架，支持对接各类大模型 API，本文基于 Win10 环境，从环境准备、安装部署、模型切换到问题排查，手把手带你完成 OpenClaw 全流程搭建，重点解决新手常见报错，同时适配免费开源模型接入。

1.1 硬件与系统要求

• 系统：Windows 10 64位（专业版/企业版/家庭版均可）
• 内存：≥8GB（推荐16GB，本地调用模型需更高配置）
• 网络：稳定的网络环境（需访问模型服务商 API）

1.2 软件依赖安装

OpenClaw 基于 Node.js 开发，需先安装以下基础软件：

（1）安装 Node.js

• 下载地址：https://nodejs.org/zh-cn/download/
• 版本选择：LTS 长期支持版（如 v20.x）openclaw skills 教程，勾选「Add to PATH」自动配置环境变量
• 验证安装：打开 PowerShell，执行以下命令，显示版本号即成功

（2）可选：安装 Git（便于后续更新）

• 下载地址：https://git-scm.com/download/win
• 安装时勾选「Git Bash Here」「Add Git to PATH」

（3）可选：安装 curl（接口测试用）

Win10/11 自带 curl，验证：

1.3 模型服务商准备（以硅基流动为例）

本文优先对接硅基流动（SiliconFlow） 免费模型（永久免费、国内直连），需提前准备：

1. 注册硅基流动账号：https://cloud.siliconflow.cn/
2. 完成实名认证（必填，否则无法生成 API Key）
3. 生成 API Key：左侧菜单「API 密钥」→「新建密钥」，复制 格式密钥并保存

2.1 安装 OpenClaw

打开 PowerShell（管理员模式/普通模式均可），执行全局安装命令：

验证安装：

2.2 初始化 OpenClaw 配置

执行配置向导，完成基础设置：

按向导提示操作：

1. Gateway 运行位置：选择 （本地运行，默认即可）
2. 端口配置：默认 18789（无需修改，避免端口冲突）
3. 日志路径：保持默认，按回车确认

2.3 启动网关服务

正常输出需包含：

默认 OpenClaw 可能对接 qwen-portal 等模型（易出现 OAuth 令牌过期），以下步骤切换到永久免费的硅基流动模型：

3.1 进入模型配置向导

3.2 按向导完成配置（关键步骤）

1. 选择模型提供商：选中 （自定义 API 提供商）
2. 接口兼容类型：选择 （硅基流动兼容 OpenAI 接口）
3. 填写 Base URL：（浏览器访问 404 属正常，程序调用不受影响）
4. 填写 API Key：粘贴硅基流动生成的 密钥
5. 填写 Model ID：（永久免费、中文友好）
6. Model alias（可选）：直接回车留空，或自定义别名（如 ）
7. Endpoint ID：默认 ，回车确认

3.3 验证模型配置

输出中需包含 ，且标记 。

3.4 重启网关使配置生效

4.1 报错 1：OAuth 令牌过期（qwen-portal 模型）

• 现象：/
• 原因：通义千问模型的临时令牌失效，且需付费/授权
• 解决：直接切换到硅基流动免费模型（参考第三章），或注销旧认证：

4.2 报错 2：unknown command ‘chat’/’run’

• 现象：执行 提示
• 原因：不同版本 OpenClaw 命令差异，2026.3.12 版本无 / 命令
• 解决：
  1. 优先使用交互式 Shell（部分版本支持）：

  2. 通用方案：通过网关接口调用（PowerShell 脚本）：

4.3 报错 3：400 Bad Request

• 现象：调用接口返回
• 原因：请求体格式错误、模型名拼写错误、参数缺失
• 解决：
  1. 确认 Model ID 为 （大小写敏感）
  2. 确保请求体包含 、 核心字段
  3. 通过 OpenClaw 仪表盘验证：访问 ，在「Model Tester」中选择模型后重试

4.4 报错 4：网关启动失败（Port occupied）

• 现象：
• 原因：端口被其他程序占用
• 解决：

4.5 参考：更多报错解决（适配 juejin 教程）

针对 juejin 教程中提到的常见问题补充：

• Node.js 版本不兼容：降级到 LTS 版（如 v18/v20），避免使用最新测试版
• 权限不足：以管理员身份运行 PowerShell
• 配置文件损坏：删除 后重新执行

1. 访问 OpenClaw 仪表盘：
2. 在「Model Tester」模块选择
3. 输入问题（如「你现在使用的是哪个模型？」），点击发送
4. 收到模型回复（包含「Qwen2.5-7B-Instruct」「硅基流动」等关键词），即搭建成功

Win10 环境下搭建 OpenClaw 的核心是：先完成 Node.js 基础环境，通过 向导配置模型（优先选择硅基流动免费模型），启动网关后通过仪表盘/接口验证。新手遇到报错时，优先排查模型配置和网关状态，核心命令可参考本文汇总表快速操作。

相比付费模型，硅基流动的 Qwen2.5-7B-Instruct 永久免费、国内直连，是 OpenClaw 新手入门的最优选择，彻底避免令牌过期、付费等问题。