Windows 部署 OpenClaw:本地 AI 助手搭建与公网访问指南
你是否遇到过这样的场景:想让 AI 帮忙写工作汇报,却要在 ChatGPT、飞书、钉钉之间反复切换;出门在外想调取家里电脑资料,却被局域网限制束手无策;尝试接入不同的大模型,却被复杂的 API 配置劝退……
OpenClaw 是一个开源的个人 AI 助手网关,旨在解决上述痛点。它运行在你的 Windows 电脑上,既是 AI 能力的中转站,能对接 Claude、千问、硅基流动等主流大模型;也是通讯平台的连接器,可同时接入飞书、钉钉、Telegram 等常用工具。通过这份教程,我们将从环境搭建到公网访问,带你完成从零到一的部署。
1. 什么是 OpenClaw?
OpenClaw 就像一个长在你电脑里的数字员工。你通过微信、飞书、钉钉或 Telegram 发消息,它在后台操控电脑帮你干活——发文件、查资料、写代码、控制智能家居,无所不能。自 2025 年 11 月开源以来,该项目在 GitHub 上获得了大量关注,成为增长较快的 AI 项目之一。
2. 环境准备与依赖安装
本教程基于 Windows 操作系统。在运行 OpenClaw 前,必须安装 Node.js 和 Git。虽然官方提供一键脚本,但为了确保稳定性,建议手动安装基础环境。
2.1 安装 Node.js 环境
推荐使用 nvm(Node Version Manager)进行版本管理,方便后续切换。首先访问 nvm-windows 的发布页面下载最新版本。
下载安装程序后,一路点击 Next 即可。安装完成后,打开安装目录下的 settings.txt 文件,添加国内镜像源以加速下载:
node_mirror: https://npmmirror.com/mirrors/node/
npm_mirror: https://npmmirror.com/mirrors/npm/
保存后,打开 CMD 窗口验证安装:
nvm -v
接着安装并启用 Node.js 22 版本及以上:
nvm install 22
nvm use 22.20.0
node -v
npm -v
2.2 安装 Git 环境
Git 是代码管理工具,部署时需要从 GitHub 拉取源码。访问 Git 官网下载 Windows 安装包,默认配置一路 Next 安装即可。
安装完成后,在终端输入以下命令验证:
git --version
3. 一键部署 OpenClaw
环境就绪后,使用官方提供的一键部署脚本最为便捷。这里以 PowerShell 为例。
3.1 解决 PowerShell 执行策略问题
首次运行脚本可能会提示禁止运行脚本,这是因为 PowerShell 默认安全策略限制。我们需要修改当前用户的执行策略:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
确认后重新打开 PowerShell 即可正常执行。
3.2 执行部署脚本
在 PowerShell 终端输入以下命令开始安装:
iwr -useb https://openclaw.ai/install.ps1 | iex
脚本会自动检测环境并开始安装 OpenClaw。等待初始化完成后,按键盘左右键选择【YES】同意风险协议,然后回车进入快速开始模式。
接下来需要配置 AI 大脑供应商。推荐选择 MiniMax、Qwen 或硅基流动等平台。以硅基流动为例,你需要先注册账号并获取 API Key。
- 访问硅基流动控制台,领取新用户额度。
- 在侧边栏创建 API 密钥并复制。
- 回到 PowerShell 配置界面,选择【Custom Provider】。
- 填入 Base URL:
https://api.siliconflow.cn/v1 - 粘贴刚才复制的 API Key。
- 接口类型保持默认的 OpenAI-compatible。
- 输入模型 Code,例如
Pro/MiniMaxAI/MiniMax-M2.5。 - 验证成功后设置模型别名。
- 通道(Channel)配置可暂时跳过,技能配置选 No,Hooks 建议全部启用。
最后启动 Gateway 服务,Web UI 会自动跳转浏览器打开。
3.3 常见问题修复
初次对话时,如果发现回答不完整或报错,通常是因为自定义模型的上下文窗口配置过小。配置文件位于用户目录下,路径类似:
C:\Users\<你的用户名>\.openclaw\openclaw.json
用记事本打开该文件,找到模型配置部分,修改以下参数:
"contextWindow": 200000,
"maxTokens": 8192
保存后重启网关服务,再次测试对话即可恢复正常。
4. 实战场景:让 AI 接管电脑
OpenClaw 的强大之处在于它能直接读取和操控你的电脑。以下是几个真实可用的场景:
场景一:远程找回遗忘的文件
人在公司,文件忘在家里电脑桌面上。只需给家里的 OpenClaw 发送指令:
我昨天在桌面上放了一个带'元旦'两个字的 docx 方案文件,你帮我找一下,找到后直接发送给我。
它会模拟人工操作,定位文件并通过微信文件传输助手发送给你。这种自动化能力比单纯的聊天机器人实用得多。
场景二:生成网页并部署
想要一个个人简历网页?你可以这样指挥:
帮我写一个个人简历的 HTML 页面,样式要现代好看。具体信息如下:姓名苏苏,求职新媒体运营... 写完后放在 D 盘 resume 文件夹,并在本地运行起来,给我一个预览链接。
它能完成代码编写、文件保存和本地服务器启动。不过此时生成的通常是局域网地址,外网无法访问。
5. 内网穿透实现公网访问
为了让 OpenClaw 随时随地可用,我们需要将其映射到公网。传统的云服务器配置复杂且昂贵,借助 cpolar 内网穿透工具可以零成本快速实现。
5.1 安装与登录
下载 cpolar 客户端并安装,CMD 输入 cpolar version 确认。注册账号后,访问本地 Web UI 管理界面:
http://127.0.0.1:9200
使用注册的账号登录。
5.2 配置隧道
随机域名方式(免费)
适合预算有限的用户。在隧道管理中新建隧道,协议选 HTTP,本地地址填 OpenClaw 端口(默认 18789),地区选择 China Top。更新后,状态页会显示生成的公网地址。
访问该地址时,如果遇到 origin not allowed 错误,说明需要允许公网域名访问。此时可直接在本地 OpenClaw 界面询问它修改配置:
我将 openclaw 的 webui 界面 18789 端口通过 cpolar 穿透至公网了,域名地址是:https://xxxx.r1.cpolar.top,但是访问页面提示 origin not allowed,请你帮我修改一下 openclaw 的配置文件允许它,改完后并且重启 openclaw 网关
修改完成后,网关会自动重启。再次访问公网地址,粘贴网关令牌进行设备配对授权,即可正常使用。
固定域名方式
如果需要长期稳定的访问地址,可以在 cpolar 官网预留二级子域名。在隧道编辑页面将域名类型改为二级子域名,填入预留的名称。后续配置与随机域名类似,只需更新允许的域名列表即可。
6. 安全警告
由于 OpenClaw 拥有直接读取文件和操控鼠标键盘的最高系统执行权限,安全性至关重要。当你将其穿透映射到公网后,请务必保护好你的网关令牌(Token)和相关访问密码,切勿将其发在公开群组或分享给不信任的人,以免造成数据泄露或被恶意篡改。
通过本教程,我们成功搭建了基于 OpenClaw 的全能个人 AI 助手。它不仅实现了跨平台的消息互通,还能在公网环境下自动执行复杂任务。30 分钟的部署成本,换来的是效率的翻倍和生活的便捷。记住,智能生活的边界已被打破,但安全始终是前提。


