1. 为什么要把 OpenClaw 变成私人助手很多人对 AI 的印象还停留在聊天窗口里问一句答一句写文案、查资料、生成代码都行但真到要打开文件、运行程序、把结果发出去的时候还是得自己动手。OpenClaw 这类开源个人 AI 助手网关改变的就是这一点——它跑在你自己的 Windows 电脑或服务器上接入兼容 OpenAI 接口的大模型后可以通过网页或飞书、钉钉、Telegram 等平台接收指令然后真的去操作电脑找文件、写代码、启动本地服务、调用已有工具。这篇教程聚焦一条完整落地路径从 Node.js 环境准备、Git 拉取项目、PowerShell 启动服务到用 cpolar 把本地端口映射成公网地址让手机和浏览器随时调用。目标很明确——在本地跑通一个能远程访问的私人助手而不是只停留在“装好了但出不了门”的状态。适合谁看有 Windows 电脑、愿意敲几条命令、想让 AI 从“会聊天”变成“能替你做事”的人。全程不需要买云服务器也不需要公网 IP一台常年开机的家用电脑加 cpolar 免费隧道就能起步。下面按环境准备、部署、配置、验证、排障、长期使用的顺序展开每一步都给可复制的命令和配置片段。2. Node.js 与 Git 环境准备OpenClaw 部署前置依赖OpenClaw 基于 Node.js 运行源码通过 Git 拉取所以这两样必须先装好。官方虽然提供一键脚本但网络波动时容易卡住手动装更稳。2.1 用 nvm 管理 Node.js 版本推荐用 nvm-windows 安装 Node.js方便后续切换版本。打开 nvm 的 GitHub Releases 页面下载nvm-setup.exe双击安装。安装路径建议选D:\nvmNode.js 的下载位置也放在同一目录下一路 Next 到 Install 即可。装完后打开D:\nvm\settings.txt粘贴国内镜像源保存node_mirror: https://npmmirror.com/mirrors/node/ npm_mirror: https://npmmirror.com/mirrors/npm/按WinR输入cmd回车验证 nvm 是否可用nvm -v然后安装并启用 Node.js 22 及以上版本nvm install 22 nvm use 22.20.0 node -v npm -v能输出版本号就说明环境生效了。nvm 的好处是以后想换版本一条nvm use就行不用卸载重装。2.2 安装 Git 并验证Git 用于从 GitHub 拉取 OpenClaw 源码。到 Git 官网下载 Windows 安装包双击后一路 Next保持默认配置最后点 Install。装完重新开一个 cmd 窗口git --version输出版本信息即安装成功。到这里Node.js 和 Git 两个前置依赖就齐了接下来可以进入 OpenClaw 的部署环节。3. PowerShell 启动 OpenClaw 并接入大模型这一节是核心配置环节包含可复制的 JSON 配置片段路径与原文一致方便你直接对照修改。3.1 解决 PowerShell 脚本执行限制按WinX选择“终端”或“PowerShell”。如果提示“在此系统上禁止运行脚本”先放开当前用户的执行策略Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser重新打开 PowerShell 后提示消失。接着执行一键部署脚本iwr -useb https://openclaw.ai/install.ps1 | iex脚本会跳过已安装的 Node.js直接安装 OpenClaw。安装完成后进入初始化向导按左右键选 YES 同意风险选 QuickStart 快速开始。3.2 配置兼容 OpenAI 接口的模型向导会询问 AI 大脑供应商。这里选 Custom Provider 自定义配置填入兼容 OpenAI 接口的 Base URL 和 API Key。以硅基流动为例Base URL 填https://api.siliconflow.cn/v1API Key 从平台侧边栏“API 密钥”新建并复制。接口类型保持OpenAI-compatible模型 Code 从模型广场复制例如Pro/MiniMaxAI/MiniMax-M2.5。提示Verification successful即接入成功。Endpoint ID 直接回车模型别名随意填channel 和技能配置可先跳过Enable hooks 建议全选含命令历史、记忆功能。安装 Gateway 后会弹出新窗口启动服务选择 Open the Web UI 自动打开浏览器聊天界面。3.3 修改 openclaw.json 上下文参数自定义接入的 API 默认上下文 tokens 只有 4096问复杂问题会报错。配置文件路径为C:\Users\admin\.openclaw\openclaw.json其中admin换成你自己的用户名。用记事本打开找到模型配置部分修改两个参数{ contextWindow: 200000, maxTokens: 8192 }保存后回到网页重新提问能正常回答并说明运行系统和接入模型就说明配置生效了。4. 用 curl 验证接口连通性与 cpolar 隧道配置服务跑起来只是第一步还要验证接口真的通再把本地端口映射到公网。4.1 curl 验证本地接口OpenClaw 默认端口通常是 18789。先在本地用 curl 确认服务在监听curl -i http://127.0.0.1:18789返回 HTTP 状态码和页面内容说明本地服务正常。如果连接被拒绝检查 Gateway 窗口是否还在运行以及端口是否被占用netstat -ano | findstr 187894.2 安装并登录 cpolar到 cpolar 官网下载 64-bit 安装包解压后一路默认安装。cmd 中验证cpolar version注册账号后浏览器访问http://127.0.0.1:9200进入 Web UI 管理界面用刚注册的账号登录。4.3 配置隧道映射 18789 端口点击左侧“隧道管理”进入隧道列表编辑 website 隧道隧道名称填 openclaw协议选 http本地地址填 18789地区选 China Top点击更新。再到“状态”→“在线隧道列表”能看到 http 和 https 两个公网地址。浏览器访问 https 地址如果出现origin not allowed (open the Control UI from the gateway host or allow it in gateway.controlUi.allowedOrigins)说明需要在配置里放行公网域名。可以直接在本地 OpenClaw 聊天界面里让它自己改我将 openclaw 的 webui 界面 18789 端口通过 cpolar 穿透至公网了域名地址是https://1cf1b8b8.r1.cpolar.top但是访问页面提示 origin not allowed请在 gateway.controlUi.allowedOrigins 中允许它改完后重启 openclaw 网关。网关重启后回到穿透页面从本地“概览”菜单复制网关令牌粘贴后点连接。若提示pairing required在终端执行openclaw devices list openclaw devices approve requestId把requestId换成列表里的实际 id。批准后健康状态显示“正常”即可正常对话。4.4 固定二级子域名长期方案免费随机域名约 24 小时换一次长期用建议保留二级子域名。进入 cpolar 预留页面选“保留二级子域名”填地区、名称、描述点保留。回到隧道列表编辑 openclaw 隧道域名类型改为二级子域名填入刚保留的名称更新。在线隧道列表里地址就变成固定形式例如https://openclaw.cpolar.top。同样让 OpenClaw 把 allowedOrigins 里的旧域名替换成新域名并重启网关再重新填令牌、授权设备即可。5. 常见报错排查401、local proxy failed 与 OAuth部署过程中最容易卡在几个固定报错上逐个对照处理。401 Unauthorized多半是 API Key 填错或过期。检查openclaw.json里的 key 是否与平台一致注意不要带多余空格。如果用的是兼容接口确认 Base URL 结尾是/v1不要多写或少写。local proxy failed / connection refused本地代理或网关没起来。先确认 Gateway 窗口在运行再用curl -i http://127.0.0.1:18789测本地端口。如果端口不通重启 OpenClaw 网关如果端口通但穿透地址打不开检查 cpolar 隧道本地地址是否写成 18789协议是否选 http。reading choices 报错通常是模型返回格式与预期不符或上下文 tokens 太小被截断。把contextWindow调到 200000、maxTokens调到 8192 后重启网关多数情况能解决。OAuth / 授权失败出现在设备配对环节。确认执行了openclaw devices approve requestId且 requestId 与openclaw devices list输出一致。如果令牌过期从本地“概览”菜单重新复制网关令牌再连接。origin not allowed公网域名没加进gateway.controlUi.allowedOrigins。按第 4 节的方法让 OpenClaw 自己改配置并重启或手动编辑openclaw.json后重启网关。排查时记住一个顺序先本地 curl 通不通再看隧道地址对不对最后看配置里的域名和令牌。三步走完绝大多数问题都能定位。6. 长期使用与接入建议跑通之后OpenClaw 就不再只是一个聊天页面而是大模型和本地电脑之间的操作入口。模型负责理解和规划OpenClaw 负责调用文件、命令行、浏览器等本地工具cpolar 负责把能力延伸到公网。三者衔接起来个人 AI 助手才从“会聊天”走向“能替你做事”。长期使用时固定二级子域名比随机域名省心不用频繁改书签和授权来源。但能力越强安全边界越重要OpenClaw 可能拥有读取文件、执行命令、操作软件的权限网关令牌、模型密钥、公网入口一旦泄露风险远高于普通网页服务。建议妥善保管 Token只批准自己的设备严格控制 allowedOrigins 里的域名不用的隧道及时关闭。如果你还想把这套能力接到更稳定的模型服务上可以到 TaoToken 官网 了解兼容 OpenAI 接口的接入方式API 地址为 https://taotoken.net/api。需要管理密钥时进 API Keys想先试模型对话可以打开 模型对话长期编码或跑 Agent 任务则看 Coding Plan接入细节在 接入文档 里都有说明。把模型侧和本地执行侧都配稳这套私人助手才算真正能长期待命。