OpenClaw 实测：Windows 安装、模型配置、电脑任务执行与公网访问

1. OpenClaw 在 Windows 上到底能做什么OpenClaw 是一个开源的个人 AI 助手网关它把大模型、Windows 本地环境和消息入口串在一起模型不只是聊天还能读写文件、生成代码、调用本地工具甚至通过桌面自动化完成操作。适合谁适合想把 AI 从“网页问答”推进到“本地任务执行”的 Windows 用户比如让模型帮你找文件、生成网页、启动本地服务。但它的配置链路比普通聊天工具长得多。我实测下来真正卡人的不是安装而是四个环节Windows 环境能否稳定装好、模型接口能否正确接入、本地任务能否真的执行、异地访问时公网入口怎么打通。这篇就按这个顺序走一遍完整链路交付可复制的配置文件骨架、TaoToken 统一 Key/API 通道的接入步骤以及 cpolar 公网访问的逐项验证动作。需要先明确一点OpenClaw 不是“自动什么都能做”的数字员工而是一套需要模型、权限、工具和网络配置共同配合的本地运行环境。任何一环没配好页面能打开也不代表链路通了。2. 前置准备Node.js、Git 与 TaoToken 统一通道2.1 Windows 基础依赖OpenClaw 需要 Node.js 22 及以上版本以及 Git 用于拉取源码。推荐用 nvm-windows 管理 Node 版本方便切换。安装完成后在 cmd 里验证nvm install 22 nvm use 22.20.0 node -v npm -v git --version如果 PowerShell 提示“禁止运行脚本”先放开当前用户的执行策略Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser然后执行官方一键脚本iwr -useb https://openclaw.ai/install.ps1 | iex安装过程会跳过已存在的 Node直接装 OpenClaw。初始化时选择 QuickStart接着进入模型供应商配置环节。2.2 为什么用 TaoToken 做统一 Key/API 通道OpenClaw 支持自定义 Provider这意味着你可以把模型请求统一指向一个兼容 OpenAI 协议的入口。TaoToken 提供的就是这样一个统一通道一个 Key 覆盖多种模型Base URL 固定切换模型只改模型 Code不用反复改配置。对 OpenClaw 这种需要长期跑任务的场景统一通道的好处很直接配置文件里只维护一份 API Key 和 Base URL模型 Code 按需替换。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。注意API Key 属于敏感凭证不要写进公开分享的配置文件也不要在截图里暴露完整 Key。3. 可复制配置settings.json / config.toml 骨架与模型接入3.1 自定义 Provider 配置步骤在 OpenClaw 初始化界面选择 Custom Provider然后按下面填写配置项填写内容API Base URLhttps://taotoken.net/apiAPI Key你在 TaoToken 控制台创建的 KeyEndpoints 兼容OpenAI-compatible模型 Code按需填写例如你开通的模型标识Endpoint ID直接回车跳过模型别名自定义如 tao-default验证通过会提示 Verification successful。接着 channel 部分可以先跳过技能配置选 NoEnable hooks 建议全部启用包含命令历史、记忆功能。3.2 openclaw.json 关键字段骨架配置文件默认位于C:\Users\你的用户名\.openclaw\openclaw.json。模型接入后务必检查上下文参数默认 4096 会导致长回答被截断。参考骨架如下{ models: { providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: 你的_TaoToken_Key, api: openai-compatible, models: [ { id: 你的模型Code, name: tao-default, contextWindow: 200000, maxTokens: 8192 } ] } } }, gateway: { controlUi: { allowedOrigins: [] } } }改完保存重启 Gateway 生效。contextWindow和maxTokens这两个值是最容易被忽略、又最容易导致“回答到一半断掉”的地方。4. 验证请求从对话到本地任务执行4.1 基础对话验证在 Web UI 里发一条测试消息你好你是谁你当前运行在什么操作系统上接入你的大模型是什么请详细回答。如果返回正常且内容完整说明模型接入和上下文参数都已生效。如果回答被截断回到 3.2 检查maxTokens。4.2 本地任务执行验证基础对话跑通后测试它能否把模型输出转成电脑上的实际操作。第一个任务文件检索加桌面自动化。我昨天在桌面上放了一个带“元旦”两个字的 docx 方案文件帮我找一下找到后直接发送给我。实测它会先定位文件再尝试打开微信、搜索文件传输助手并发送。这说明它调用了桌面 UI 自动化能力。第二个任务代码生成加本地服务启动。帮我写一个个人简历的 HTML 页面样式现代一点。写完后在 D 盘新建 resume 文件夹放进去然后在本地运行起来给我一个浏览器能打开的链接。它会返回一个本地地址实际打开验证页面可访问。这一步的关键不是“它说运行了”而是你真的点开链接看到页面。5. 公网访问cpolar 打通与常见报错排查5.1 cpolar 安装与隧道配置cpolar 是内网穿透工具把本地端口映射成公网地址。安装后在 cmd 验证cpolar version访问http://127.0.0.1:9200登录 Web UI编辑 website 隧道协议选 http本地地址填 OpenClaw 的端口 18789地区选 China Top更新后到在线隧道列表拿到公网地址。5.2 三个高频报错与处理报错一origin not allowedorigin not allowed (open the Control UI from the gateway host or allow it in gateway.controlUi.allowedOrigins)处理方式把 cpolar 生成的公网域名加进gateway.controlUi.allowedOrigins。可以直接在本地 OpenClaw 对话里让它改我将 OpenClaw 的 WebUI 18789 端口通过 cpolar 穿透至公网域名是 https://你的域名访问提示 origin not allowed请帮我修改配置文件允许它改完重启网关。报错二pairing requiredpairing required openclaw devices list openclaw devices approve requestId处理方式在终端执行设备列表和批准命令。openclaw devices list openclaw devices approve requestId报错三404 页面找不到第一次生成的公网地址可能返回 404继续反馈错误后通常会得到新地址。这不是配置错误而是隧道状态或服务绑定问题重新获取地址再验证即可。5.3 固定二级子域名免费随机域名约 24 小时更换一次。要固定进入 cpolar 预留页面保留二级子域名然后在隧道编辑里把域名类型改为二级子域名并填入保留名称更新后公网地址变为固定形式。同样需要把新域名加进allowedOrigins并重新配对设备。6. 继续深入模型对话、Coding Plan 与接入文档链路跑通后下一步通常有三个方向。想验证不同模型在 OpenClaw 里的表现可以直接用模型对话快速对比输出质量入口在 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你打算长期用 OpenClaw 跑编码和 Agent 任务Coding Plan 更适合按周期使用入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。需要管理多个 Key 或查看用量控制台在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 创建 Key 的页面在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入过程中如果遇到参数对不上、报错定位不清接入文档里有完整的字段说明和示例地址是 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你用的是 Claude Code 这类工具链Anthropic 兼容接入的说明在 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后提醒一句公网入口打开后安全比连通更重要。网关令牌、设备配对和 allowedOrigins 都要单独保护不要把带管理权限的完整地址公开分享。