★ FEATURED ARTICLE 1. OpenClaw 装完只能局域网用公网调用困境与 TaoToken 统一 Key 的破局思路OpenClaw 本地部署完成后很多人会卡在同一个地方浏览器打开http://127.0.0.1:18789一切正常同一局域网内的手机、平板也能通过192.168.x.x:18789访问但一旦离开家里的 Wi-Fi页面就打不开了。这不是 OpenClaw 的问题而是它默认只监听本地回环或局域网地址公网根本没有入口。我试过最直接的思路是用 cpolar 这类内网穿透工具把 18789 端口映射到公网拿到一个https://xxxx.cpolar.top的地址。这个方案确实能跑通但随之而来的是三个新问题第一cpolar 免费版域名每 24 小时变一次今天收藏的链接明天就失效第二OpenClaw 有allowedOrigins白名单机制穿透域名变了就得重新执行openclaw config set gateway.controlUi.allowedOrigins并重启网关第三如果你有多个外部工具比如 Cline、Codex、Claude Code都想调用 OpenClaw 的能力每个工具都要单独配一遍 endpoint 和 token管理成本很高。TaoToken 在这里扮演的角色是提供一个统一的 Key 和 API 通道。你可以把它理解为一个“API 网关层”外部工具不再直接连你家里的 OpenClaw 地址而是连 TaoToken 的统一入口由 TaoToken 负责鉴权、路由和转发。这样做的好处是你只需要在 TaoToken 控制台生成一个 Key然后在各个工具里填同一个 Base URL 和 Key就能调用到 OpenClaw 的能力。即使家里的公网地址变了也只需要在 TaoToken 侧更新一次映射外部工具完全不用动。适合谁看这篇教程如果你已经装好了 OpenClaw但被“只能局域网访问”卡住或者你希望用 Cline、Codex、Claude Code 这类编码工具远程调用 OpenClaw 的本地能力又或者你单纯想搞清楚auth.json、Base URL、Model ID 这三件套怎么配那接下来的内容可以直接跟做。2. TaoToken 前置准备统一 Key 与 API 通道配置在开始配置之前先把 TaoToken 侧的东西准备好。打开官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content注册并登录后进入控制台。控制台左侧菜单里找到“API Keys”点击创建新的 Key。这个 Key 就是你后续所有外部工具要填的凭证建议命名成openclaw-remote之类的方便区分。创建完成后你会拿到两样东西一个是 API Key格式类似sk-xxxxxxxx另一个是 API 基础地址也就是 Base URL固定为https://taotoken.net/api。注意这个地址后面不加 UTM 参数直接写就行。这两个值先复制到记事本里后面配置auth.json和settings.json都要用。接下来要确认 OpenClaw 本体的网关令牌。回到你部署 OpenClaw 的那台机器打开本地控制台http://127.0.0.1:18789进入“概览”菜单找到“网关令牌”那一栏点击复制。这个令牌是 OpenClaw 用来验证请求来源的外部工具调用时必须带上。如果你之前已经用 cpolar 穿透并配置过allowedOrigins那这一步应该已经做过了如果还没做先执行下面这条命令把穿透域名加进白名单openclaw config set gateway.controlUi.allowedOrigins [\https://你的穿透域名\] --strict-json openclaw gateway restart注意把你的穿透域名替换成实际地址比如https://openclaw.cpolar.top。执行完重启网关等几秒钟让配置生效。现在你手上有三个关键值TaoToken 的 API Key、TaoToken 的 Base URLhttps://taotoken.net/api、OpenClaw 的网关令牌。这三个值就是后面所有配置的核心。如果你用的是 Cline 或 Claude Code 这类工具它们通常需要填 Base URL、API Key、Model ID 三件套。Model ID 填你在 TaoToken 控制台里看到的模型名称比如gpt-4o或claude-3-5-sonnet具体以控制台显示为准。这里要提醒一点TaoToken 的 Key 和 OpenClaw 的网关令牌是两个不同的东西不要混用。TaoToken 的 Key 用来鉴权外部工具到 TaoToken 的请求OpenClaw 的网关令牌用来鉴权 TaoToken 到 OpenClaw 的转发请求。两者配合才能打通整条链路。3. 可复制配置auth.json、settings.json 与 endpoint 片段这一节直接给可复制的配置片段。先说你最可能用到的auth.json这个文件通常出现在 Codex 或类似工具的配置目录里。路径一般是~/.codex/auth.jsonLinux/macOS或C:\Users\你的用户名\.codex\auth.jsonWindows。如果目录不存在就手动创建文件内容如下{ base_url: https://taotoken.net/api, api_key: sk-你的TaoTokenKey, model: gpt-4o, gateway_token: 你的OpenClaw网关令牌 }注意base_url后面不要加斜杠直接写https://taotoken.net/api。api_key填 TaoToken 控制台生成的 Keygateway_token填 OpenClaw 概览页复制的令牌。model按你实际使用的模型填。如果你用的是 Cline 或 Claude Code配置方式略有不同。Cline 通常在 VS Code 设置里填 Base URL 和 API KeyModel ID 选自定义输入。Claude Code 则是在settings.json里配置路径一般是~/.claude/settings.json内容如下{ api_base: https://taotoken.net/api, api_key: sk-你的TaoTokenKey, model: claude-3-5-sonnet, headers: { X-Gateway-Token: 你的OpenClaw网关令牌 } }这里用headers把 OpenClaw 的网关令牌带过去避免和 TaoToken 的 Key 混淆。如果你的工具不支持自定义 header那就把网关令牌拼在 URL 参数里具体看工具文档。对于 Cline MCP 模式配置片段如下{ mcpServers: { openclaw: { url: https://taotoken.net/api, headers: { Authorization: Bearer sk-你的TaoTokenKey, X-Gateway-Token: 你的OpenClaw网关令牌 } } } }这段配置放在 Cline 的 MCP 设置文件里通常是cline_mcp_settings.json。保存后重启 Cline就能在 MCP 服务列表里看到 openclaw 这个条目。如果你用的是 CC Switch 来管理多个配置那就在 CC Switch 里新建一个 profileBase URL 填https://taotoken.net/apiAPI Key 填 TaoToken 的 KeyModel ID 填模型名称额外 header 里加X-Gateway-Token。这样切换配置的时候不用手动改文件。所有配置里出现的sk-你的TaoTokenKey和你的OpenClaw网关令牌都要替换成实际值。建议配置完成后用cat或type命令检查一遍文件内容确认没有拼写错误。4. 验证请求curl 测试公网可达性与成功结果配置写完了接下来要验证整条链路是否通。最直接的方法是用curl发一个请求看能不能拿到正常响应。打开终端执行下面这条命令curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoTokenKey \ -H X-Gateway-Token: 你的OpenClaw网关令牌 \ -H Content-Type: application/json \ -d { model: gpt-4o, messages: [{role: user, content: 你好测试公网调用}] }如果一切正常你会看到类似下面的返回{ id: chatcmpl-xxxx, object: chat.completion, created: 1730000000, model: gpt-4o, choices: [ { index: 0, message: { role: assistant, content: 你好公网调用测试成功。 }, finish_reason: stop } ] }看到choices数组里有内容就说明 TaoToken 到 OpenClaw 的转发链路是通的。如果返回的是401 Unauthorized检查 TaoToken 的 Key 有没有填错如果返回403 Forbidden检查 OpenClaw 的网关令牌是否正确如果返回502 Bad Gateway说明 TaoToken 连不上你家里的 OpenClaw大概率是公网地址变了或者 OpenClaw 网关没启动。再测一下 OpenClaw 本体的公网可达性。假设你已经用 cpolar 把 18789 端口穿透到了https://openclaw.cpolar.top执行curl -I https://openclaw.cpolar.top正常应该返回HTTP/2 200或HTTP/1.1 200 OK。如果返回502或超时说明穿透隧道断了去 cpolar 后台看隧道状态必要时重启隧道。还有一个常见场景是验证allowedOrigins是否生效。在浏览器里打开穿透后的地址如果看到origin not allowed的提示说明白名单没配好。回到终端执行openclaw config get gateway.controlUi.allowedOrigins确认返回的数组里包含你的穿透域名。如果没有重新执行第 2 节里的config set命令并重启网关。实测下来整条链路打通后你在公司、咖啡厅或者外地只要打开配置好的工具就能直接调用家里 OpenClaw 的能力。响应速度和本地调用差别不大主要延迟在公网转发那一跳通常几十毫秒到一两百毫秒。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth这一节把最容易踩的坑列出来对照报错找原因。401 Unauthorized最常见的原因是 TaoToken 的 Key 填错了或者 Key 被删除/过期了。去 TaoToken 控制台确认 Key 状态必要时重新生成一个。还有一种可能是Authorizationheader 格式不对必须是Bearer sk-xxx中间有一个空格不能少。local proxy failed这个报错通常出现在 Cline 或 Claude Code 里意思是本地代理层连不上 TaoToken。检查 Base URL 是不是写成了https://taotoken.net/api/末尾多了斜杠去掉斜杠再试。另外确认你的网络能正常访问taotoken.net如果公司网络有防火墙限制可能需要换网络环境。reading choices这个报错说明请求发出去了但返回的 JSON 里没有choices字段。常见原因是 Model ID 填错了TaoToken 找不到对应模型。去控制台确认模型名称注意大小写和连字符。还有一种可能是 OpenClaw 侧返回了错误信息但被 TaoToken 包装成了非标准格式这时候用curl -v看完整响应体定位具体错误。OAuth 相关报错如果你用的是 Claude Code 并且开了 OAuth 模式可能会遇到OAuth token expired或invalid_grant。这是因为 Claude Code 默认走 OAuth 流程而 TaoToken 用的是 API Key 模式。解决办法是在settings.json里显式指定api_key并禁用 OAuth或者用claude config set --global apiKey sk-xxx命令切换认证方式。网关令牌不匹配报错信息可能是gateway token mismatch或invalid gateway token。检查auth.json或settings.json里的gateway_token是否和 OpenClaw 概览页显示的一致。注意令牌里可能包含特殊字符复制时不要漏掉。设备未授权OpenClaw 有设备配对机制新设备首次连接需要在终端执行openclaw devices list查看待批准的请求然后openclaw devices approve requestId批准。如果跳过这一步连接会一直卡在“等待配对批准”。cpolar 域名变更导致 502免费版 cpolar 每 24 小时换一次域名换完之后 TaoToken 侧如果还指向旧地址就会 502。解决办法是要么升级 cpolar 固定二级子域名要么在 TaoToken 侧配置动态更新。固定域名的操作是进 cpolar 后台“预留”页面保留一个二级子域名然后在隧道编辑里把域名类型改成二级子域名并填入保留的名称。6. 语义一致 CTA从统一 Key 到长期编码 Agent 的落地路径整条链路跑通之后你手上就有了一个稳定的公网调用入口。TaoToken 的统一 Key 让你不用在每个工具里重复配置OpenClaw 的本地能力通过 cpolar 暴露到公网外部工具通过 TaoToken 的 API 通道调用。这套组合适合临时测试也适合长期使用。如果你只是偶尔在外面问 OpenClaw 几个问题那配好auth.json和settings.json就够了。但如果你打算把 OpenClaw 接入日常编码流程比如让 Cline 或 Claude Code 长期调用本地模型能力那建议去 TaoToken 控制台看一下 Coding Plan 的说明了解长期编码场景下的配额和路由策略。控制台里也能直接管理 API Keys方便你随时轮换或撤销。验证模型连通性的时候可以用模型对话功能快速发一条测试消息确认返回正常。接入文档里有各工具的详细配置示例遇到不确定的 header 名称或路径格式直接对照文档改就行。最后提醒一句OpenClaw 有读取本地文件和操作键鼠的权限公网暴露后务必保护好网关令牌和 TaoToken 的 Key。不要把包含 Key 的配置文件截图发到公开群组也不要把穿透地址分享给不信任的人。定期在 TaoToken 控制台轮换 Key在 OpenClaw 侧检查设备授权列表移除不用的设备。做到这些这套远程调用方案就能稳定又安全地跑下去。
阅读完成 · 觉得有帮助？
