大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



本教程基于官方开源源码，100% 纯净无捆绑、全程免费，适配 Windows10 系统，包含新手零门槛一键安装、开发者源码部署两种方案，完整覆盖智谱 AI 大模型自定义配置、国内环境避坑、常见问题解决全流程。

1.1 Windows10 系统最低要求

1.2 系统环境预配置（解决 90% 安装失败问题）

Set-ExecutionPolicy RemoteSigned 

￮验证：输入Get-ExecutionPolicy，输出RemoteSigned即为成功

2.临时关闭安全软件拦截

3.路径规范强制要求

1.3 获取智谱 AI 免费 API Key（核心，完全零成本）

OpenClaw 本身不内置大模型，需对接第三方 API，智谱 AI 新用户送海量免费额度，且提供永久免费模型，可实现零成本使用。

官方推荐方案，国内专属加速脚本，解决 GitHub 访问慢、依赖下载超时问题，全程自动化，零代码门槛，适合所有新手用户。

2.1 执行一键安装命令

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

￮官方原版命令（海外用户使用，国内不推荐）：iwr -useb https://openclaw.ai/install.ps1 | iex

2.2 等待自动化安装

2.3 安装成功验证

2.4 快速初始化配置（零代码对接智谱 AI）

输入以下命令，启动交互式配置向导，全程按提示操作即可完成智谱 AI 对接：

openclaw onboard 

适合开发者、需要修改源码、完全掌控安装过程的用户，基于官方开源仓库，无任何捆绑，国内镜像加速。

3.1 手动安装前置依赖

必须先完成以下依赖安装，全程使用管理员 PowerShell 操作：

1.安装 Node.js 22+ LTS（核心必备）

￮国内镜像下载地址：https://npmmirror.com/mirrors/node/v22.12.0/node-v22.12.0-x64.msi ￮下载后双击安装，全程默认下一步，必须勾选「Add to PATH」，安装完成后重启电脑 ￮验证：重启后打开管理员 PowerShell，输入node -v，输出v22.x.x即为成功 

2.安装 pnpm 包管理器（解决国内依赖下载问题）

npm install -g pnpm --registry=https://registry.npmmirror.com 

验证：输入pnpm -v，输出版本号即为成功

3.安装 Git（拉取开源源码必备）

￮国内镜像下载地址：https://npmmirror.com/mirrors/git-for-windows/v2.45.1.windows.1/Git-2.45.1-64-bit.exe ￮安装全程默认下一步，自动添加系统 PATH，安装完成后重启 PowerShell ￮验证：输入git --version，输出版本号即为成功 

3.2 拉取官方开源源码（国内镜像加速）

1.在 PowerShell 中切换到安装磁盘（以 D 盘为例），输入：

D: 

2.克隆国内 Gitee 镜像仓库（速度快，避免 GitHub 超时）：

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

3.进入源码根目录：

cd openclaw 

3.3 依赖安装 & 源码编译

1.配置 pnpm 国内镜像源，避免依赖下载超时：

pnpm config set registry https://registry.npmmirror.com 

2.安装项目全量依赖：（最新版本v2026.4.15-beta.1报错~采用v2026.4.14）

pnpm install 

等待安装完成，无报错即为成功，若出现超时，重新执行命令即可。

3.编译构建项目：

pnpm run build 

构建完成无报错，即为源码编译成功。

3.4 源码模式初始化配置

执行以下命令，启动配置向导，步骤和一键安装的 2.4 完全一致（启动openclaw直接配置访问），完成智谱 AI 对接：

pnpm run openclaw onboard 

提供可视化零代码、手动配置文件两种方式，支持自定义模型参数、多模型切换、故障自动兜底，满足不同使用需求。

4.1 方式一：Web UI 可视化配置（新手首选，零代码）

1.启动 OpenClaw 服务

￮一键安装用户：管理员 PowerShell 执行openclaw start ￮源码安装用户：源码目录执行pnpm run openclaw start 

4.2 方式二：手动编辑配置文件（高级用户，全自定义）

适合精细配置、多模型批量管理、故障自动切换场景，可实现主力 + 备用模型自动兜底，保障服务不中断。

1.快速打开配置文件目录：在 PowerShell 中输入以下命令，自动打开文件夹

explorer ~/.openclaw 

"zhipu": { "provider": "openai", "baseURL": "https://open.bigmodel.cn/api/paas/v4", "apiKey": "这里替换成你的智谱API Key", "models": [ "glm-4-flash", "glm-4-flash-", "glm-4-plus", "glm-5.1", "glm-4-long" ] } 

4.设置默认主力模型 & 备用兜底模型，找到agents.defaults.model节点，修改为：

"model": { "primary": "zhipu/glm-4-flash", "fallbacks": [ "zhipu/glm-4-plus" ] } 

openclaw gateway restart 

7.配置验证：执行openclaw doctor，终端无红色报错，即为配置生效成功。

4.3 智谱 AI 免费模型推荐（零成本优先使用）

5.1 服务启动命令

启动场景 一键安装用户命令 源码安装用户命令 前台启动（终端显示日志） openclaw start pnpm run openclaw start 后台常驻启动（关闭终端不停止） openclaw start –daemon pnpm run openclaw start –daemon 停止服务 openclaw stop pnpm run openclaw stop 重启网关 openclaw gateway restart pnpm run openclaw gateway restart 

5.2 功能完整性验证

1.Web UI 访问：启动成功后，浏览器打开http://localhost:3000，可正常进入管理界面 2.对话测试：在聊天界面输入简单指令，如 “帮我写一个 Windows 清理垃圾的批处理脚本”，模型正常响应无报错，即为对接成功 3.系统状态检查：PowerShell 执行openclaw status，网关、模型、渠道全部显示running即为正常 4.健康检查：执行openclaw doctor，自动检测系统环境、配置文件、依赖完整性，无红色报错即为部署完全成功。 

6.1 安装类常见问题

powershell npm config set registry https://registry.npmmirror.com pnpm config set registry https://registry.npmmirror.com 

6.2 模型对接类常见问题

1.多模型同时配置：在配置文件的models.providers中，可同时添加豆包、通义千问、DeepSeek 等多个厂商的模型，格式和智谱一致，实现一键切换模型。

2.开机自启设置：按下Win+R，输入shell:startup打开开机启动文件夹，右键新建快捷方式，对象填写powershell.exe -Command “openclaw start --daemon”，命名为 OpenClaw，下次开机自动启动服务。

3.自定义技能开发：OpenClaw 支持基于 JavaScript/TypeScript 开发自定义技能，源码目录的skills文件夹可添加自定义脚本，实现自动化办公、数据处理、爬虫等个性化功能。

4.官方文档参考：https://openclaws.io/zh/，可查看更多进阶玩法和开发文档。

1.OpenClaw 是完全开源免费的项目，官方源码无任何捆绑、无收费项，所有费用仅来自大模型 API 调用，使用智谱永久免费模型可实现零成本使用。

2.严禁将你的 API Key 泄露给他人，不要将服务部署到公网环境，避免产生安全风险和意外费用损失。

3.本教程仅用于个人学习使用，请勿用于任何违规违法场景。