OpenClaw Windows 部署指南：搭建本地 AI 助手

OpenClaw Windows 部署指南

1. 什么是 OpenClaw？

OpenClaw 是一个开源的个人 AI 助手网关，支持运行在电脑或服务器上。它可以将各种 AI 能力（如 Claude、Qwen、ChatGPT 等）接入到日常使用的通讯工具中（飞书、钉钉、Telegram 等），实现一个 AI 助手在多个平台同时在线。

简单来说，OpenClaw 就像一个数字员工：你通过微信、飞书、钉钉等发消息，它在后台操控电脑帮你干活，包括发文件、查资料、写代码、控制智能家居等。

2. 环境准备与依赖安装

本教程演示在 Windows 操作系统上进行部署。在运行 OpenClaw 前，需要安装 Node.js 和 Git。

2.1 安装 Node.js 环境

推荐使用 nvm 进行安装，nvm 是 node.js 的版本管理器。

打开 nvm-windows 发布页面下载最新版本。
双击执行启动安装程序，选择同意协议，点击下一步。
选择安装目录（例如 D:\nvm），继续点击下一步。
设置 nodejs 的下载位置，建议也选择在 nvm 文件夹中。
一路选择下一步直到最后点击 Install。

安装完成后，打开 D:\nvm\settings.txt 文件，添加国内镜像源配置：

node_mirror: https://npmmirror.com/mirrors/node/
npm_mirror: https://npmmirror.com/mirrors/npm/

打开 cmd 窗口，输入命令查看版本是否安装成功：
```
nvm -v
```
依次输入以下命令，安装 nodejs 环境（需要 22 版本及以上），以及启用该版本：
```
nvm install 22
nvm use 22.20.0
node -v
```
验证 node 环境版本确认是否生效。

2.2 安装 Git 环境

打开 git 的下载页面，下载对应版本的安装包。
双击启动安装程序，一直点击 Next 即可。
其他相关配置保持默认，点击 Install。
安装完成后，重新进入 cmd 窗口，输入如下命令进行验证版本：
```
git --version
```

输出版本信息即代表安装成功。

3. 一键部署 OpenClaw

安装完成 Node.js 和 Git 环境后，接下来就是部署 OpenClaw。推荐使用一键部署脚本，官方提供多种部署方式，这里以 PowerShell 为例。

3.1 解决 PowerShell 执行脚本问题

按 Win + X，选择终端/PowerShell 打开。
如果提示禁止运行脚本，输入以下命令允许执行脚本：
```
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```
执行以后，重新打开 PowerShell 就不会出现该提示了。

3.2 执行一键部署脚本

在 PowerShell 终端，输入如下命令进行一键部署：

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

等待 OpenClaw 安装，安装时长取决于网络。安装完成后，按键盘左右键进行选择，切换到 YES，然后回车。

同意风险后，选择 QuickStart（快速开始），回车。

接着来到选择 AI 大脑供应商页面，给 OpenClaw 配置一个 AI 大模型。推荐选择 MiniMax、Qwen、硅基流动等平台。

配置自定义模型（以硅基流动为例）

访问硅基流动注册登录界面，注册登录后领取体验额度。
点击侧边栏的 API 密钥，新建密钥并复制。
回到 PowerShell 终端的配置界面，用键盘上下选择 Custom Provider 回车，进行自定义配置。
在 API Base URL 这一栏中，填写硅基流动的 Base API 地址：
```
https://api.siliconflow.cn/v1
```
粘贴刚才复制好的 API Key，回车。
选择 API 接口兼容，默认为 OpenAI-compatible，直接回车。
输入模型 Code，可以在模型广场选择一个要使用的模型 Code，例如 Pro/MiniMaxAI/MiniMax-M2.5。
复制整个名称，回到配置界面，输入该模型 Code，回车等待验证。提示 Verification successful 即代表验证成功。
Endpoint ID 项直接回车，来到模型别名部分，随意设置一个直接回车即可。
选择 channel 部分，这里是配置消息平台，可以接入飞书等平台，优先跳过，选择最底下跳过即可。
来到技能配置项，直接选择 No 即可。
来到 Enable hooks 项，按需选择，建议全部启用（包含命令历史、记忆功能等），选中对应的按空格键即可选中。
回车，即开始安装 Gateway。安装完成后会弹出新的窗口，进行启动 OpenClaw 的 GateWay 服务。
在原来配置的 PowerShell 选择 Open the Web UI 后，会自动跳转浏览器打开，打开后就是 OpenClaw 的聊天界面。

调试与配置

可以进行对话测试，比如询问身份和系统信息。如果发现回答有问题，可能是自定义接入的 API 配置文件中默认的上下文 tokens 限制。需要修改 openclaw.json 配置文件。

回到配置的 PowerShell 窗口，寻找配置文件所在的位置，例如：
```
C:\Users\admin\.openclaw\openclaw.json
```
打开资源管理器，在地址栏输入路径回车。
选中该文件，右键选择打开方式，用记事本打开。
找到模型配置的部分，修改 contextWindow 和 maxTokens 参数的值，例如：
```
"contextWindow": 200000,
"maxTokens": 8192
```
修改完成后，按 Ctrl + S 保存，重启服务。
再次询问测试，确认正常。

4. 硬核实测：一句话让 AI 接管电脑替你干活

OpenClaw 能直接读取和操控你的电脑，替你完成各种繁杂的任务。

场景一：找回遗忘在家里的重要文件

如果你家里的电脑开着机并连着 OpenClaw，直接在手机里发一条消息给它：

我昨天在桌面上放了一个带'元旦'两个字的 docx 方案文件，你帮我找一下，找到后直接发送给我。

它可以成功的定位到微信，打开微信，搜索文件传输助手，再把文件发送过来。它是通过模拟人工操作，通过键盘鼠标自动化来假装是你自己在操作微信。

场景二：写全套代码并部署跑起来

指挥它写一个个人简历的 HTML 页面，样式现代好看，包含具体信息。写完后，让它在新建文件夹放进去，并在本地运行起来，最后发给你一个能在浏览器里直接点开预览的网页链接。

如果当前访问的是局域网地址，在外面无法查看，可以让它利用内网穿透工具生成公网地址。

5. 下载安装 cpolar

虽然上面我们在局域网里把 OpenClaw 跑得风生水起，但目前它只能通过内网进行访问。要让这套系统真正发挥出随时随地待命的威力，就必须让它能够被公网访问。

借助 cpolar 内网穿透工具，可以将本地的 OpenClaw 服务映射到公网，生成一个稳定且安全的 HTTPS 地址。

5.1 下载安装 cpolar

打开 cpolar 官网的下载页面，点击下载按钮，下载 cpolar 的安装包。
解压后执行目录中的应用程序，一路默认安装即可。
安装完成后，打开 cmd 窗口输入如下命令确认安装：
```
cpolar version
```

出现如上版本即代表安装成功。

5.2 注册及登录 cpolar web ui 管理界面

访问 cpolar 官网，点击免费注册按钮，进行账号注册。
注册完成后，在浏览器中输入如下地址访问 web ui 管理界面：
```
http://127.0.0.1:9200
```
输入刚才注册好的 cpolar 账号登录即可进入后台页面。

6. 穿透 OpenClaw 以实现公网访问

将运行在本地的 OpenClaw 服务（默认端口通常为 18789）通过 cpolar 映射出去，就能立刻获得一个公网访问地址。

6.1 随机域名方式

点击左侧菜单栏的隧道管理，展开进入隧道列表页面。
点击编辑 website 的隧道，设置一个隧道名称，协议选择 http，本地地址填写 openclaw 的访问端口 18789，地区选择 China Top，最后点击更新。
点击状态菜单下的在线隧道列表，可以看到有隧道的公网地址。
在浏览器中访问 openclaw 隧道生成的公网地址（http 和 https 皆可）。
如果页面上出现 origin not allowed 错误提示，需要在网关.controlUi.allowedOrigins 中允许它。

可以在原来的本地 openclaw 聊天界面中，和 openclaw 对话，让它帮我们修改配置文件，例如：

# 将对话中的域名，修改为您 cpolar 穿透后对应的公网域名地址 我将 openclaw 的 webui 界面 18789 端口通过 cpolar 穿透至公网了，域名地址是：https://xxx.r1.cpolar.top，但是访问页面提示 origin not allowed 需要在网关.controlUi.allowedOrigins 中允许它，请你帮我修改一下 openclaw 的配置文件允许它，改完后并且重启 openclaw 网关

等待它修改，改完后网关会自动重启。再次访问穿透后的地址测试。
如果没有携带 Token 访问，可以在本地的 openclaw 聊天界面概览菜单中复制网关令牌。
回到穿透的界面，进入概览菜单中，粘贴复制的网关令牌，然后点击连接。
点击连接后，会看到右边会出现 pairing required 提示。我们需要回到终端 cmd 窗口或者 PowerShell 页面，依次输入如下命令：
```
openclaw devices list
openclaw devices approve <requestId>
```
执行完成如上操作后，即可在概览页面发现，健康状态为正常了。

6.2 固定域名方式

固定域名方案可以让你拥有一个永久不变的专属地址。

进入官网的预留页面，选择保留二级子域名项，填写其中的地区、名称、描述，然后点击保留按钮。
进入侧边菜单栏的隧道管理下的隧道列表，可以看到名为 openclaw 的隧道，点击编辑按钮进入编辑页面。
修改域名类型为二级子域名，然后填写前面配置好的子域名，点击更新按钮。
来到状态菜单下的在线隧道列表可以看到隧道名称为 openclaw 的公网地址已经变更为二级子域名 + 固定域名主体及后缀的形式了。
这里以 https 协议做访问测试。如果出现同样的提示，只需要用前面同样的方式询问 openclaw 让它自我修改配置重启网关即可。
填写网关令牌，然后授权一下设备就可以正常的使用固定后的二级子域名进行正常的对话啦。

总结

本教程带你从零搭建了一个基于 OpenClaw 的全能个人 AI 助手，实现了让大模型接管电脑自动执行任务的惊艳效果，并通过内网穿透让该服务支持了稳定且安全的公网访问。

极简部署：通过一键脚本快速安装 OpenClaw，免去繁琐配置。
自定义模型：手把手教你零成本接入强悍的 AI 模型，打造最强大脑。
全网畅联：借助内网穿透，将局域网变身云端服务，让你的数字助理打破空间限制，随时随地待命。

安全警告： 由于 OpenClaw 拥有直接读取文件和读取控制鼠标键盘的最高系统执行权限，这意味着它几乎可以对你的电脑进行操作。当你使用内网穿透工具将其穿透映射到公网后，请务必保护好你的网关令牌和相关访问密码，切勿将其发在公开群组或分享给不信任的人，以免造成电脑数据泄露或被恶意篡改！

OpenClaw Windows 部署指南：搭建本地 AI 助手