前言
OpenClaw 是一个开源的个人 AI 助手网关,旨在将复杂的环境配置、模型接入、平台对接封装成脚本。本教程演示如何在 Windows 系统上完成 OpenClaw 的部署,实现 AI 助手在本地运行并支持远程访问。
1 什么是 OpenClaw?
OpenClaw 可以运行在你的电脑或服务器上,通过它能把各种 AI 能力(如 Claude、Pi、ChatGPT 等)接入到日常使用的通讯工具中——飞书、钉钉、Telegram、Discord、iMessage、WhatsApp 等,实现一个 AI 助手,多个平台同时在线。
简单来说,OpenClaw 就像一个数字员工:
- 你通过微信、飞书、钉钉、Telegram 发消息
- 它在后台操控电脑,帮你干活
- 发文件、查资料、写代码、控制智能家居…
2 环境准备与依赖安装
本教程演示在 Windows 操作系统上进行部署。在运行 OpenClaw 前,必须安装基础工具:Node.js 和 Git。
2.1 安装 Node.js 环境
推荐使用 nvm 进行安装,nvm 是 node.js 的版本管理器。
- 打开 nvm-windows 发布页面下载最新版本。
- 双击执行启动安装程序,选择同意协议,点击下一步。
- 选择安装目录(例如 D:\nvm),继续点击下一步。
- 设置 nodejs 的下载位置,建议也在 nvm 文件夹中。
- 一路选择 Next 直到最后一步点击 Install。
- 安装完成后,打开 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
npm -v
2.2 安装 Git 环境
Git 是代码管理工具,部署 openclaw 时需要从 github 上下载源码。
- 打开 git 的下载页面下载。
- 双击启动安装程序,一直点击 Next。
- 最后点击 Install,其他相关配置保持默认。
- 安装完成后,进入 cmd 窗口,输入命令验证版本:
git --version
输出版本信息即安装成功。
3 一键部署 OpenClaw
安装完成 nodejs 和 git 环境后,接下来就是部署 openclaw。这里推荐使用一键部署脚本,官方提供多种部署方式,包括 cmd、powershell、npm、pnpm 等,这里以 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 终端的配置 OpenClaw 界面,用键盘上下选择【Custom Provider】回车,进行自定义配置。
- 在【API Base URL】这一栏中,填写硅基流动的 Base API 地址:
https://api.siliconflow.cn/v1
- 粘贴刚才复制好的【API Key】,然后继续回车。
- 选择 API 接口(Endpoints)兼容,默认为【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 是 4096,我们需要修改【openclaw.json】配置文件。
- 回到配置的 PowerShell 窗口,往上寻找,可以看到配置文件所在的位置。
- 路径通常为
C:\Users\admin\.openclaw\openclaw.json。 - 打开资源管理器,在地址栏输入路径回车。
- 选中该文件,右键选择【打开方式】,用记事本打开。
- 找到模型配置的部分,修改【contextWindow】和【maxTokens】参数的值,为如下:
"contextWindow": 200000,
"maxTokens": 8192
- 修改完成后,按 Ctrl + S 键进行保存,保存后叉掉即可。
- 然后回到网页中再次询问,确认是否正常。
4 硬核实测:一句话让 AI 接管电脑替你干活
装好了 OpenClaw,它真正厉害的地方在于能直接读取和操控你的电脑,替你完成各种繁杂的任务。
4.1 场景一:一句话找回遗忘在家里的重要文件
如果你家里的电脑开着机并连着 OpenClaw,你直接在手机里发一条消息给它:
我昨天在桌面上放了一个带'元旦'两个字的 docx 方案文件,你帮我找一下,找到后直接发送给我。
它可以成功的定位到微信,打开微信,然后搜索【文件传输助手】,再把文件发送过来。它是通过模拟人工操作,通过键盘鼠标自动化来操作。
4.2 场景二:一句话写全套代码并部署跑起来
比如你想临时做一个个人简历的漂亮网页,你可以这样指挥它:
帮我写一个个人简历的 HTML 页面,样式要做得现代、好看一点。我的具体信息如下:姓名:苏苏,求职意向:新媒体运营专员... 写完后,帮我在 D 盘新建一个叫 resume 的文件夹把它放进去,然后想办法直接把它在本地运行起来,最后发给我一个能在浏览器里直接点开预览的网页链接。
它可以成功的写好代码并部署。如果当前访问的是局域网地址,可以通过内网穿透工具获取公网地址。
5 下载安装 cpolar
虽然上面我们在局域网里把 OpenClaw 跑得风生水起,但目前它只能通过内网进行访问。要让这套系统真正发挥出随时随地待命的威力,你就必须让它能够被公网访问。
借助 cpolar 内网穿透工具,可以将本地的 OpenClaw 服务映射到公网。
5.1 什么是 cpolar?
cpolar 是一款内网穿透工具,可以将你在局域网内运行的服务(如本地 Web 服务器、SSH、远程桌面等)通过一条安全加密的中间隧道映射至公网。
5.2 下载安装 cpolar
- 打开 cpolar 官网的下载页面。
- 点击下载按钮,下载安装包。
- 解压后执行目录中的应用程序,一路默认安装即可。
- 安装完成后,打开 cmd 窗口输入如下命令确认安装:
cpolar version
出现如上版本即代表安装成功。
5.3 注册及登录 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://xxxx.r1.cpolar.top,但是访问页面提示 origin not allowed 需要在网关.controlUi.allowedOrigins 中允许它,请你帮我修改一下 openclaw 的配置文件允许它,改完后并且重启 openclaw 网关
- 等待它修改,改完后网关会自动重启。
- 回到穿透的界面,进入概览菜单中复制网关令牌,粘贴复制的网关令牌,然后点击连接。
- 点击连接后,会看到右边会出现配对提示。我们需要回到终端 cmd 窗口或者 PowerShell 页面,依次输入如下命令:
openclaw devices list
openclaw devices approve <requestId>
- 执行完成如上操作后,即可在概览页面发现,健康状态为正常了。
此时再进行询问,就可以发现能够正常对话啦。
6.2 固定域名方式
固定域名方案能够让你拥有一个永久不变的专属地址。
- 进入官网的预留页面,选择保留二级子域名项,填写其中的地区、名称、描述,然后点击保留按钮。
- 进入侧边菜单栏的隧道管理下的隧道列表,可以看到名为 openclaw 的隧道,点击编辑按钮进入编辑页面。
- 修改域名类型为二级子域名,然后填写前面配置好的子域名,点击更新按钮。
- 来到状态菜单下的在线隧道列表可以看到隧道名称为 openclaw 的公网地址已经变更为二级子域名 + 固定域名主体及后缀的形式了。
- 这里以 https 协议做访问测试。
- 如果出现 origin not allowed 提示,使用同样的方式询问 openclaw 让它自我修改配置重启网关即可。
- 填写网关令牌,然后授权一下设备就可以正常的使用固定后的二级子域名进行正常的对话啦。
总结
本教程带你从零搭建了一个基于 OpenClaw 的全能个人 AI 助手,实现了让大模型接管电脑自动执行任务的惊艳效果,并通过 cpolar 内网穿透让该服务支持了稳定且安全的公网访问。
- 极简部署:通过一键脚本快速安装 OpenClaw,免去繁琐配置。
- 自定义模型:手把手教你零成本接入强悍的 AI 模型,打造最强大脑。
- 全网畅联:借助 cpolar 内网穿透,将局域网变身云端服务,让你的数字助理打破空间限制,随时随地待命。
安全警告: 由于 OpenClaw 拥有直接读取文件和读取控制鼠标键盘的最高系统执行权限,当你使用 cpolar 或其他内网穿透工具将其穿透映射到公网后,请务必保护好你的网关令牌(Token)和相关访问密码,切勿将其发在公开群组或分享给不信任的人,以免造成电脑数据泄露或被恶意篡改!


