在 Windows 电脑上安装 OpenClaw 实战攻略

碎碎念

最近因为工作太忙，断更了一下，不是偷懒去了，除了工作还去折腾了一下openclaw，整理一下分享出来。

最早的时候是过年期间听说openclaw的，那时候只知道 OpenClaw 是一个在您自己的设备/云设备上运行的个人 AI 助手，可以连接到各种消息平台（如飞书、Telegram、WhatsApp 等）。

当时看了一下安装攻略，感觉太难了，光看到那么多技术名词就放弃了。

后来还是去继续研究opencode，稍微搞明白一点之后又抽点时间折腾了一下openclaw，找了一台mini的Windows主机，在Windows上成功部署openclaw，并正常运行。

之所以选择本地物理机，除了数据安全以外，主要还是穷。

小白折腾这些ai产品，是真的不容易，不一定有成果就算了，还得搭上各种成本，我就只能抠搜着来，至少少亏点嘛。

大概是3月10日左右开始研究openclaw的，看了好几篇攻略，开始是打算在Windows上通过WSL2安装的，通过指挥opencode安装了wsl2之后正好是周末，玩得太开心，忘记了。

后来出了AutoClaw，安装简单，还有白嫖的模型，那就直接下载安装，玩了一天，感触不大。

问了一圈，听说他可以和openclaw同时存在，第二天便试着让他给我装openclaw，装完之后接入飞书，两个都能用，这时候是2026.3.8版本，后来不知道改了什么配置，把他玩坏了。

便让opencode把这两个龙虾都卸载了，重头来过。

不信邪的我用opencode又安装了一次openclaw 3.13版本，3/17的时候成功安装了，但是用的不多……

直到3.22版本出来，我更新了一下，然后……

砰！崩了，因为这个版本内容比较多，最主要就是官方修改了插件导致飞书连接用不了了。

小白一通折腾，最终又把这只虾杀死了，无奈，只能再次重装。

这一次我借助了飞书的openclaw、opencode、豆包多个AI的智慧，再加上自己老老实实的去官方网站和智谱官网的openclaw接入指南，再次成功上车。

接下来是面向小白用户的实战攻略，提供从零开始的详细步骤。即使您没有深厚的技术背景，也能按照步骤顺利完成安装。

前置准备

1. 硬件要求

操作系统: Windows 10 或更高版本（Windows 11 最佳）

内存: 建议 8GB 或以上

磁盘空间: 至少 10GB 可用空间

网络: 稳定的互联网连接（需要下载和访问 API）

2. 软件准备

安装 Node.js

OpenClaw 需要 Node.js 环境。

检查是否已安装 Node.js：

打开命令提示符（CMD）或PowerShell，输入：

node --version

如果显示版本号（如 v22.14.0），说明已安装。如果提示"不是内部或外部命令"，则需要安装。

安装 Node.js：

访问Node.js 官网
下载 Windows 安装包（推荐 LTS 长期支持版）
运行安装程序，按提示完成安装
重新打开终端，验证安装成功：

node --version

重要提示：

OpenClaw 要求 Node.js 版本 22 或更高（文档建议 Node.js 22 或更新版本）
安装完成后，重启命令提示符确保环境变量生效

安装 npm / pnpm（可选但推荐）

pnpm 是一个更快的 npm 替代品，安装 OpenClaw 时推荐使用（我是装的 npm）。

npm install -g pnpm

安装完成后验证：

pnpm --version

3. 准备智谱 AI API Key

在开始配置之前，您需要拥有智谱 AI 的 API Key。（因为我只有这一家的API，所以写的也是他，其他家的也是可以的，方法类似，只有端点、模型ID不一样）

获取APIKey 步骤：

访问智谱开放平台
注册或登录您的账户
进入API Keys 管理页面
创建一个新的 API Key
确保您已订阅GLMCoding Plan 或者有余额或资源包（这是使用智谱模型的必要条件）

重要提醒：API Key 是敏感信息，请妥善保管

💰 GLM Coding Plan 是订阅套餐，也可以去白嫖，比如mimo、国家超算等平台的tokens，后面记得切换嗷

安装步骤

方法一：使用官方安装脚本（推荐）

这是最简单、最快速的安装方式，适合小白用户。

Windows PowerShell 安装步骤

打开PowerShell（右键点击开始菜单 → Windows PowerShell）
输入以下命令：

iwr -useb https://openclaw.ai/install.ps1 | iex

3. 按回车，等待安装完成

4. 安装完成后，会自动进入配置向导

注意：

如果提示脚本执行权限，可能需要以管理员身份运行 PowerShell
iwr 是 Invoke-WebRequest 的简写
iex 是 Invoke-Expression 的简写
如果命令失败，可以尝试手动下载安装脚本

方法二：使用 npm 或 pnpm 全局安装

如果您希望更可控地管理安装过程，可以使用包管理器安装。

使用 npm 安装（我用的）

npm install -g openclaw@latest

使用 pnpm 安装（推荐，更快）

pnpm add -g openclaw@latest

如果使用 pnpm，建议同时批准相关构建工具：

pnpm approve-builds -g

这将批准 openclaw、node-llama-cpp、sharp 等组件，避免安装过程中的交互确认。

验证安装

安装完成后，验证是否成功：

openclaw --version

如果显示版本号（如 2026.3.24），说明安装成功！

配置智谱AI模型

初始化 OpenClaw

安装完成后，首次运行会进入配置向导（Onboarding）。

如果未自动启动配置，手动运行：

openclaw onboard --install-daemon

配置流程详解

配置向导会逐步引导您完成以下设置：

步骤 1：理解风险提示

系统会显示：

I understand this is powerful and inherently risky. Continue?

选择：● Yes（按右箭头或 Y 键选择）

步骤 2：选择配置模式

Onboarding mode

选择：● Quick Start（快速开始）

步骤 3：选择模型提供商

Model/auth provider

选择：● Z.AI（智谱 AI）

步骤 4：配置 API Key

系统会提示您输入 API Key。

粘贴您的智谱APIKey，然后按 Enter 键。

重要提示：

确保您粘贴的 API Key 完整无缺失

如果粘贴失败，可以手动输入

按 Ctrl+V 粘贴（PowerShell，或者是右键点击标题栏——编辑——粘贴）

步骤 5：选择模型

API Key 配置成功后，系统会显示可用模型列表。

选择您想要使用的模型：

zai/glm-5 - GLM-5（最强模型，消耗较多）
zai/glm-4.7 - GLM-4.7（推荐，性价比高）
zai/glm-4.6 - GLM-4.6
zai/glm-4.5-air - GLM-4.5-Air（快速、经济）

建议：小白用户可以先选择 zai/glm-4.7，平衡性能和成本（最先消息，GLM-5Turbo和5.1也能用了）。

步骤 6：配置通道

Select channel

选择并配置您需要的功能，如：

Web UI
飞书（Feishu）
Discord
Telegram
等

对于飞书用户，选择 feishu 并按提示配置飞书 App ID 和 App Secret。

创建飞书应用的流程：

1. 进入飞书开放平台，选择创建企业应用

2. 设置应用基本信息

3. 添加应用能力：选择“机器人”

4. 左侧菜单点击“权限管理”，选择批量导入/导出权限

5. 复制以下内容，在页面弹窗中全选——粘贴——点击“下一步，确认新增权限”

{"scopes": {"tenant": ["aily:file:read","aily:file:write","application:application.app_message_stats.overview:readonly","application:application:self_manage","application:bot.menu:write","base:app:copy","base:app:create","base:app:update","base:field:create","base:field:delete","base:field:read","base:field:update","base:record:create","base:record:delete","base:record:retrieve","base:record:update","base:table:create","base:table:delete","base:table:read","base:table:update","base:view:read","base:view:write_only","calendar:calendar:readonly","cardkit:card:read","cardkit:card:write","contact:contact.base:readonly","contact:user.employee_id:readonly","corehr:file:download","docx:document:readonly","drive:drive:readonly","event:ip_list","im:chat","im:chat.access_event.bot_p2p_chat:read","im:chat.members:bot_access","im:chat:read","im:chat:readonly","im:chat:update","im:message","im:message.group_at_msg:readonly","im:message.group_msg","im:message.p2p_msg:readonly","im:message.pins:read","im:message.pins:write_only","im:message.reactions:read","im:message.reactions:write_only","im:message:readonly","im:message:recall","im:message:send_as_bot","im:message:send_multi_depts","im:message:send_multi_users","im:message:send_sys_msg","im:message:update","im:resource","sheets:spreadsheet:readonly","task:task:readonly","wiki:wiki:readonly"],"user": ["aily:file:read","aily:file:write","base:app:copy","base:app:create","base:app:read","base:app:update","base:field:create","base:field:delete","base:field:read","base:field:update","base:record:create","base:record:delete","base:record:retrieve","base:record:update","base:table:create","base:table:delete","base:table:read","base:table:update","base:view:read","base:view:write_only","board:whiteboard:node:create","board:whiteboard:node:read","calendar:calendar.event:create","calendar:calendar.event:delete","calendar:calendar.event:read","calendar:calendar.event:reply","calendar:calendar.event:update","calendar:calendar.free_busy:read","calendar:calendar:read","contact:contact.base:readonly","contact:user.base:readonly","contact:user.employee_id:readonly","contact:user:search","docs:document.comment:create","docs:document.comment:read","docs:document.comment:update","docs:document.media:download","docs:document.media:upload","docs:document:copy","docs:document:export","docx:document:create","docx:document:readonly","docx:document:write_only","drive:drive.metadata:readonly","drive:file:download","drive:file:upload","im:chat.access_event.bot_p2p_chat:read","im:chat.members:read","im:chat:read","im:message","im:message.group_msg:get_as_user","im:message.p2p_msg:get_as_user","im:message.send_as_user","im:message:readonly","offline_access","search:docs:read","search:message","sheets:spreadsheet.meta:read","sheets:spreadsheet:create","sheets:spreadsheet:read","sheets:spreadsheet:write_only","space:document:delete","space:document:move","space:document:retrieve","task:comment:read","task:comment:write","task:task:read","task:task:write","task:task:writeonly","task:tasklist:read","task:tasklist:write","wiki:node:copy","wiki:node:create","wiki:node:move","wiki:node:read","wiki:node:retrieve","wiki:space:read","wiki:space:retrieve","wiki:space:write_only"]}}

6. 一路点击：申请开通——确认

7. 创建版本——填写信息——保存并发布

复制App ID、App Secret备用

步骤 7：配置技能

Configure skills

选择并安装您需要的技能（Skills），如：

文档处理
日历管理
邮件处理
数据库操作

不熟悉的可以直接选择跳过（skip …），反正目前我还没装几个skills

步骤 8：完成设置

完成所有配置后，选择完成，系统会启动 OpenClaw 网关。

验证安装

检查 OpenClaw 状态

openclaw status

正常情况下，您应该看到类似以下的输出：

Gateway: local · ws://127.0.0.1:18789 (local loopback) · reachable 49msChannel: stable (default)Agents: 6 · sessions 0

启动网关

如果网关未启动，手动启动：

openclaw gateway start

访问 Web UI

安装成功后，您可以通过浏览器访问 OpenClaw 的 Web UI：

http://127.0.0.1:18789/

在 Web UI 中，您可以：

查看所有 agent 的状态
管理配置
查看会话历史
测试模型响应

检查配置文件

主配置文件位于：

C:\Users\Administrator\.openclaw\openclaw.json

您可以打开这个文件查看所有配置，确保 API Key 和模型配置正确。

常见问题

Q1: 安装脚本运行失败，提示权限不足

解决方案：

右键点击 PowerShell，选择"以管理员身份运行"
或者按住 Shift + 右键点击 PowerShell，选择"以管理员身份运行"

Q2: Node.js 版本不兼容

解决方案：

OpenClaw 要求 Node.js 22 或更新版本
访问下载最新 LTS 版本
卸载旧版本后重新安装

Q3: API Key 配置后模型仍无法使用

解决方案：

重新检查 API Key 是否正确
确认智谱账户余额充足
运行诊断命令：openclaw doctor
查看日志：openclaw logs --follow

Q4: 网关启动失败

解决方案：

检查端口占用：netstat -ano | findstr :18789
检查配置文件：确保 JSON 格式正确
添加防火墙例外：允许 OpenClaw 通过 Windows 防火墙

小白用户建议少折腾网关，这东西我搞挂了好多次。

Q5: 如何重置配置？

解决方案：

完全重置配置：

openclaw config reset

重新运行配置向导：

openclaw onboard --install-daemon

进阶技巧

使用环境变量管理 API Key

为了避免在配置文件中硬编码 API Key，您可以使用环境变量：

Windows 系统变量设置：

右键点击"此电脑" → "属性"

点击"高级系统设置" → "环境变量"

在"用户变量"或"系统变量"中添加：

变量名：ZAI_API_KEY
变量值：您的智谱 API Key

在配置文件中引用：

{"auth": {"profiles": {"zai:default": {"provider": "zai","mode": "api_key"           }       }   }}

这样配置更安全，不会泄露敏感信息。

如果在这之前你的openclaw已经可以用了，那么可以把这个任务交给他。

启用自动启动

每次开机或者关闭 openclaw 之后需要手动启用网关服务，偷懒的话可以将 OpenClaw 设置为 Windows 服务，开机自动运行：

openclaw service install

启动服务：

openclaw service start

当然，照样可以告诉他你的需求，让他给你处理，我目前就是这样，开机后自动启动gateway，无线排插配合电脑的通电自启动的话，即使人在外面时电脑意外断电也能启动openclaw。

使用 ClawHub 安装技能

ClawHub 是 OpenClaw 技能的官方仓库，但是好像有点网络延迟，另外接口会限制请求次数，所以不要一次安装太多个。

安装 ClawHub：

npm install -g clawhub

搜索技能：

clawhub search "文档处理"

安装技能：

clawhub install "技能名称"

更新所有技能：

clawhub update --all

当然，也可以直接将技能的github链接丢给 Openclaw，让他给你安装，因为他好像自带了 skill 安装技能，如果没有就先安装那个技能。

总结

虽然上车比较晚，但是相对于之前，现在的使用门槛相对也在降低，也不失为一件好事。

我2026.3.13版本升级时，就遇到了一个大坑，openclaw官方将feishu等IM工具的插件从外部插件改成了内置插件，导致当天大家的IM工具与openclaw的连接都挂了，花了好大劲才在webchat对话框中让openclaw找到问题并修复，后来才知道具体原因，现在插件安装更简单了。（注：本文的飞书插件部分是当前最新安装方法）

希望通过本攻略，您能够：

✅ 在 Windows 电脑上成功安装 OpenClaw

✅ 配置智谱 AI 模型

✅ 启动并访问 Web UI

✅ 了解常见问题的解决方法

✅ 掌握进阶使用技巧

最近研究了一只虾多agent的方案，后续抽空更新《搭建多智能体团队实现方案全攻略》。

祝您安装顺利，使用顺畅！如有问题，欢迎留言沟通！🍁