OpenClaw | Windows 环境安装与配置

OpenClaw 环境配置、核心程序安装、模型接入及第三方通讯平台集成。

一、环境预配置

在正式安装 OpenClaw 之前，预先配置以下环境可以有效避免后续安装过程中常见的报错。

1. 安装 Node.js

虽然官方文档未强制要求，但预装 Node.js 是避坑的关键步骤。

操作步骤：

访问 Node.js 官方下载页面。
点击 Windows 安装程序 按钮。
运行安装包，在弹窗中允许应用更改设备。
遵循安装向导：勾选用户同意协议，点击 Next，安装位置保持默认。
点击 Install 等待安装完成后点击 Finish。

2. 安装 Git

Git 配置不当是导致许多安装报错的根源。

操作步骤：

访问 Git 官方下载页面。
根据电脑架构选择下载链接（如 Windows X64）。
运行安装包，安装位置保持默认，非专业开发者可直接一路点击 Next。
点击 Install，安装完成后取消勾选 "View release notes"，点击 Finish。

二、 OpenClaw 核心安装步骤

安装过程需通过Windows PowerShell 以管理权限执行。

启动终端：

在 Windows 搜索栏搜索 PowerShell，选择“以管理员身份运行”。

2. 放宽执行策略：

为避免脚本运行报错，输入命令：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force

回车，系统提示确认修改时，输入 Y 并回车。

3. 执行安装命令：

输入 OpenClaw 官方安装命令

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

https://docs.openclaw.ai/start/getting-started#windows-powershell

4. 授权访问：

运行过程中若弹出网络访问提示，选择“允许公共网络和专用网络访问”。

5. 完成确认：

当屏幕显示来自 OpenClaw 的欢迎信息时，即表示安装成功。

三、基础交互配置

在安装的过程中，程序引导可进行如下初始设置。

配置项	操作说明
风险提示	使用键盘左方向键选择 Yes 并回车确认。
运行模式	保持默认的 GUI 模式，直接回车。
模型服务商	使用上下方向键选择，ChatGPT和Moonshot AI都可选择，后续以Kimi为例。
API 密钥获取	以Kimi为例，登录对应平台（如 Kimi 开放平台），进入 API Key 管理，新建密钥并复制。
接入密钥	在终端选择对应的 API 密钥类型，粘贴复制的密钥值。
模型选择	建议保持默认模型（如 Kimi k2.5）。
后续跳过项	通讯渠道、技能（Skills）、额外 API 密钥（如 NO Banana）及 Hook 功能在初次配置时均可选择 Skip for now 或 No。

完成上述配置后，系统会自动打开一个命令窗口（网关），请勿关闭此窗口。回到原窗口选择使用 WebUI 启动，在浏览器打开 127.0.0.1 即可开始对话测试，如果能正常回复，就OK。

四、集成飞书 (Feishu) 机器人

将 OpenClaw 接入飞书，可实现通过手机端远程控制电脑端任务。

1. 创建飞书应用

（1）登录飞书开放平台，进入“开发者后台” （或谷歌搜索 "飞书开发者后台"）。

（2）点击“创建企业自建应用”，填写名称与描述。

（3）在应用详情页，点击“添加机器人能力”。

（4）权限管理：在权限管理中搜索 IM:，开通所有相关的消息权限。

（5）发布应用：创建版本（如 1.0.0），保存并申请发布。

2. 连接 OpenClaw 与飞书

（1）在 PowerShell 中输入配置命令进入设置。

（2）选择 Local 运行模式，进入 Channels -> Configure link -> Feishu。

（3）根据提示通过 npm 安装飞书渠道插件。

（4）输入凭证：

从飞书开发者后台的“凭证与基础信息”中复制 App ID 和 App Secret 并粘贴至终端。

（5）通信设置：

选择 WebSocket 模式，域名选择 China (.cn)。

（6）访问策略：

设置私聊访问策略为 Open（测试用）或 Pairing（正式用）。

3. 配置事件回调

（1）在飞书开发者后台进入“事件与回调”。

（2）编辑订阅方式，选择 长连接 并保存。

（3）添加事件：搜索并勾选“接收消息”。

（4）获取通讯录权限：在权限管理中开通“获取通讯录基本信息”。

（5）二次发布：必须再次创建并发布新版本，上述设置才会生效。

五、AI 模型切换

实际使用中，我们会切换不同的大模型，当需要更改使用的 AI 模型时，有两种主要路径，主要在Windows PowerShell使用：

方法一：交互式引导 (Onboard)

输入命令：openclaw onboard。
按照引导进入快速设置，重新选择模型服务商（如 GLM/智谱清言）并更新密钥。

方法二：直接配置 (Configure)

输入命令：openclaw configure。
依次选择 Default -> Model。
选择目标模型（如 Kimi k2.5）并更新对应的 API Key 模式。

六、安全与建议

密钥安全：
API Key 必须严格保密，防止额度被他人冒用。
技能扩展：
建议仅安装来自官方或可信来源的 Skills，以规避潜在的安全风险。
网关运行：
使用过程中，自动弹出的 Gateway 命令窗口必须保持开启状态。
重新启动：
WebUI无响应，重新启动：openclaw gateway。

最后强调，一定合法合规使用！！！！！！