1. Windows 下 OpenClaw 网关启动失败到底卡在哪OpenClaw 这个项目在圈子里被叫成“小龙虾”本质是一套浏览器自动化加模型调用的本地网关工具。它能做什么简单说就是把你的浏览器操作和 AI 模型调用串起来让脚本能自动开网页、抓内容、调模型、回填结果。适合谁适合在 Windows 上做自动化采集、批量任务、AI Agent 原型验证的开发者。但很多人装完之后第一步就卡住网关起不来。我见过最多的场景是这样的一键脚本跑完命令行敲openclaw-cn gateway run结果直接甩一句Gateway start blocked: set gateway.modelocal。这不是安装失败而是网关没有声明运行模式。OpenClaw 的网关默认不自动选模式必须显式告诉它“我在本地跑”。修复就一行openclaw-cn config set gateway.mode local执行完再openclaw-cn gateway run窗口会挂住并输出监听地址这是正常现象别关窗口。第二个高频坑是浏览器访问127.0.0.1:18792提示ERR_CONNECTION_REFUSED。这有两种可能网关根本没起来或者端口被别的进程占了。先确认服务状态再查端口openclaw-cn gateway stop -Force openclaw-cn gateway run另开一个 PowerShell 窗口查占用netstat -ano | findstr :18792 taskkill /F /PID 1234把 1234 换成实际 PID。如果端口长期冲突直接改端口更省事openclaw-cn config set gateway.port 18793改完记得同步改浏览器访问地址。这里有个细节改端口后必须重启网关配置不会热加载。很多人改完直接刷新浏览器还是拒绝连接就是因为旧进程还占着 18792。还有一个容易被忽略的点Windows 防火墙。首次运行网关时系统会弹网络授权如果你点了“取消”本地回环也可能被拦。排查时可以先临时关闭防火墙测试确认是它的问题后再加放行规则而不是一直关着。这一节的核心就一句话网关启动失败九成是gateway.mode没设剩下一成是端口和防火墙。把这三样排完网关基本能稳定跑起来。下面进入 Token 配置环节这是第二个大坑区。2. TaoToken 前置准备与 Token 配置避坑在讲 Token 之前先说清楚模型调用这一侧的准备。OpenClaw 本身是网关和自动化框架真正干活的大模型需要外部接入。我实测下来用 TaoToken 做模型侧接入比较顺它的 API 地址是https://taotoken.net/api兼容主流调用格式配置进 OpenClaw 的模型端点即可。官网入口在https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content需要看文档和拿 Key 的话从那里进。注意区分两个 Token一个是 OpenClaw 网关自己的认证 Tokengateway.auth.token一个是模型服务的 API Key。这俩完全不是一回事混用是新手最常见的错误。网关 Token 是给浏览器和本地客户端访问网关用的模型 API Key 是网关去调模型时用的。下面分开讲。网关 Token 有三种模式按场景选本地单机调试直接禁用验证最省事openclaw-cn config set gateway.auth.mode none这样就不会再报unauthorized: gateway token missing。但只要你把网关暴露到局域网或公网必须启用 Tokenopenclaw-cn config set gateway.auth.mode token然后生成一个 32 位随机 Token 写进配置$token -join ((65..90) (97..122) (48..57) | Get-Random -Count 32 | ForEach-Object {[char]$_}) Write-Host 生成的Token$token openclaw-cn config set gateway.auth.token $token把输出的 Token 复制保存后面浏览器插件和客户端都要填。别用默认值默认 Token 等于没有认证。模型侧的 API Key 则是在 TaoToken 控制台创建拿到后填到 OpenClaw 的模型配置里。这里的关键是三件套必须齐全Base URL、Key、Model ID。少任何一个都会在调用时报错。Base URL 用https://taotoken.net/apiKey 用你创建的那串Model ID 按你实际要用的模型填。配置模型端点可以用命令行openclaw-cn config set model.baseUrl https://taotoken.net/api openclaw-cn config set model.apiKey 你的APIKey openclaw-cn config set model.name 你的ModelID也可以用后面要讲的 JSON 文件统一写。两种方式等价命令行不容易出语法错JSON 便于版本管理。一个真实踩坑有人把网关 Token 填到了模型 apiKey 里结果网关能启动但一调模型就 401。排查时先看报错来源是网关拒绝你还是模型服务拒绝你。网关拒绝通常是unauthorized: gateway token missing模型拒绝通常是 401 加invalid api key。分清楚这两类排查方向就不会跑偏。3. 可复制的 openclaw.json 配置模板命令行配置适合快速改单项但完整配置还是落在openclaw.json里更清晰。这个文件默认在C:\Users\你的用户名\.openclaw\openclaw.json。一键安装后它可能缺失也可能因为手动编辑出现语法错误。下面给一份可直接复制的完整模板把你的Token和你的APIKey替换成实际值即可。{ gateway: { mode: local, port: 18792, auth: { mode: none, token: 你的Token } }, model: { baseUrl: https://taotoken.net/api, apiKey: 你的APIKey, name: 你的ModelID }, browser: { enabled: true, defaultProfile: openclaw, headless: false, noSandbox: false, executablePath: C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe } }几个必须注意的点。第一Windows 路径里的反斜杠在 JSON 中要写成双反斜杠\\写成单反斜杠会直接解析失败。第二文件编码必须是 UTF-8用记事本保存时“编码”选 UTF-8“文件类型”选“所有文件”否则会存成openclaw.json.txt程序读不到。第三JSON 不允许尾随逗号最后一个字段后面不能有逗号这是手动编辑最常见的语法错误来源。如果你更想用命令行生成避免手抖可以这样New-Item -Path $env:USERPROFILE\.openclaw -ItemType Directory -Force { gateway: { mode: local, port: 18792, auth: { mode: none, token: 你的Token } }, model: { baseUrl: https://taotoken.net/api, apiKey: 你的APIKey, name: 你的ModelID }, browser: { enabled: true, defaultProfile: openclaw, headless: false, noSandbox: false, executablePath: C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe } } | Out-File $env:USERPROFILE\.openclaw\openclaw.json -Encoding UTF8生成后建议用openclaw-cn config读一遍确认能正常解析。如果报解析错误多半是编码或逗号问题。浏览器路径按你实际安装位置改。Chrome 默认在C:\Program Files\Google\Chrome\Application\chrome.exeEdge 在C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe。路径写错的表现是网关能起但一执行浏览器任务就报找不到可执行文件。headless设为 false 表示有界面模式调试阶段建议保持 false能看到浏览器实际动作方便定位问题。noSandbox一般保持 false除非在受限环境里启动失败再考虑打开。配置改完必须重启网关才生效openclaw-cn gateway restart4. 验证请求与成功结果确认配置写完不算完得验证整条链路真的通。验证分三层网关层、模型层、浏览器层。逐层确认出问题好定位。网关层验证启动服务后浏览器访问http://127.0.0.1:18792能看到网关响应页面或返回 JSON 即说明网关活着。如果启用了 Token 验证访问时可能需要带上 Token 参数。命令行也可以直接测openclaw-cn gateway status模型层验证这一步确认网关能成功调到模型。用一条最小请求测试观察返回。如果返回正常内容说明 Base URL、Key、Model ID 三件套都对。如果报 401检查 Key 是否填错或过期如果报模型不存在检查 Model ID 拼写。浏览器层验证执行一条自动化命令比如打开一个页面openclaw-cn browser open https://baidu.com如果浏览器被拉起并打开页面说明浏览器配置正确。如果报找不到浏览器回到上一节检查executablePath。三层都通之后跑一个端到端的小任务让网关打开页面、抓取标题、调模型总结。这一步能同时验证网关、浏览器、模型三条链路。成功的话你会看到模型返回的总结内容这就是完整链路跑通的标志。验证时建议保持网关窗口可见日志会实时输出请求和错误。遇到问题时日志里的报错信息比浏览器提示更准确。常用日志命令openclaw-cn logs gateway如果日志里出现local proxy failed通常是模型端点地址写错或网络不通出现reading choices相关错误多半是模型返回格式和预期不符检查 Model ID 是否选错出现 OAuth 相关提示说明认证方式配错了本地场景应该用 API Key 而不是 OAuth 流程。验证通过后建议把当前可用的openclaw.json备份一份。后面调参调乱了直接还原比重新配快得多。5. 本篇常见报错逐条排查这一节把前面提到的报错集中对照方便你按现象直接定位。Gateway start blocked: set gateway.modelocal网关模式未设置。执行openclaw-cn config set gateway.mode local后重启。ERR_CONNECTION_REFUSED网关没启动或端口被占。先openclaw-cn gateway run确认服务在跑再netstat -ano | findstr :18792查占用必要时改端口。unauthorized: gateway token missing启用了 Token 验证但请求没带 Token。要么在请求里带上要么本地调试改成gateway.auth.mode none。401 invalid api key模型侧 Key 错误。检查model.apiKey是否填的是 TaoToken 创建的 Key而不是网关 Token。local proxy failed模型端点地址不通。确认model.baseUrl是https://taotoken.net/api且网络能访问。reading choices相关解析错误模型返回结构和预期不符。检查 Model ID 是否填错或换一个兼容的模型。OAuth 相关报错认证方式配错。本地 API Key 场景不需要走 OAuth检查配置里是否误开了 OAuth 模式。JSON 解析失败检查编码是否 UTF-8、是否有尾随逗号、路径反斜杠是否双写。浏览器找不到可执行文件检查browser.executablePath路径是否正确注意 32 位和 64 位程序的安装目录差异。端口改了但访问还是旧端口配置未生效执行openclaw-cn gateway restart。排查顺序建议从网关到模型再到浏览器逐层确认不要一上来就怀疑最复杂的部分。大部分问题都在配置层不在代码层。6. 后续接入与长期使用建议链路跑通之后接下来就是把它用起来。如果你只是偶尔验证模型效果直接在网关里发请求、看返回就够了模型对话入口在https://taotoken.net/api对应的控制台里可以试。如果你要做长期的编码任务或 Agent 自动化建议走 Coding Plan 这类长期方案配置一次后续稳定调用不用每次重新折腾 Key 和端点。接入文档和 API Key 管理都在控制台里需要新建 Key、查看用量、切换模型时从那里操作。文档入口https://taotoken.net/api。把这些入口存好后面换模型、加设备、排查认证问题都用得上。最后给几个长期使用的实用建议。第一把可用的openclaw.json纳入版本管理每次改动前先提交出问题能快速回滚。第二网关 Token 和模型 Key 分开管理不要图省事用同一个值。第三端口如果经常冲突固定一个不常用的端口写进配置避免每次排查。第四日志定期清理长时间运行日志会占空间。第五浏览器路径和版本升级后可能变化升级 Chrome 后如果自动化失效先回来检查executablePath。这套流程我在多台 Windows 机器上复现过最耗时的从来不是配置本身而是报错信息不明确导致的反复试错。把这篇里的报错对照表留着下次遇到直接查能省不少时间。
1. Windows 下 OpenClaw 网关启动失败到底卡在哪OpenClaw 这个项目在圈子里被叫成“小龙虾”本质是一套浏览器自动化加模型调用的本地网关工具。它能做什么简单说就是把你的浏览器操作和 AI 模型调用串起来让脚本能自动开网页、抓内容、调模型、回填结果。适合谁适合在 Windows 上做自动化采集、批量任务、AI Agent 原型验证的开发者。但很多人装完之后第一步就卡住网关起不来。我见过最多的场景是这样的一键脚本跑完命令行敲openclaw-cn gateway run结果直接甩一句Gateway start blocked: set gateway.modelocal。这不是安装失败而是网关没有声明运行模式。OpenClaw 的网关默认不自动选模式必须显式告诉它“我在本地跑”。修复就一行openclaw-cn config set gateway.mode local执行完再openclaw-cn gateway run窗口会挂住并输出监听地址这是正常现象别关窗口。第二个高频坑是浏览器访问127.0.0.1:18792提示ERR_CONNECTION_REFUSED。这有两种可能网关根本没起来或者端口被别的进程占了。先确认服务状态再查端口openclaw-cn gateway stop -Force openclaw-cn gateway run另开一个 PowerShell 窗口查占用netstat -ano | findstr :18792 taskkill /F /PID 1234把 1234 换成实际 PID。如果端口长期冲突直接改端口更省事openclaw-cn config set gateway.port 18793改完记得同步改浏览器访问地址。这里有个细节改端口后必须重启网关配置不会热加载。很多人改完直接刷新浏览器还是拒绝连接就是因为旧进程还占着 18792。还有一个容易被忽略的点Windows 防火墙。首次运行网关时系统会弹网络授权如果你点了“取消”本地回环也可能被拦。排查时可以先临时关闭防火墙测试确认是它的问题后再加放行规则而不是一直关着。这一节的核心就一句话网关启动失败九成是gateway.mode没设剩下一成是端口和防火墙。把这三样排完网关基本能稳定跑起来。下面进入 Token 配置环节这是第二个大坑区。2. TaoToken 前置准备与 Token 配置避坑在讲 Token 之前先说清楚模型调用这一侧的准备。OpenClaw 本身是网关和自动化框架真正干活的大模型需要外部接入。我实测下来用 TaoToken 做模型侧接入比较顺它的 API 地址是https://taotoken.net/api兼容主流调用格式配置进 OpenClaw 的模型端点即可。官网入口在https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content需要看文档和拿 Key 的话从那里进。注意区分两个 Token一个是 OpenClaw 网关自己的认证 Tokengateway.auth.token一个是模型服务的 API Key。这俩完全不是一回事混用是新手最常见的错误。网关 Token 是给浏览器和本地客户端访问网关用的模型 API Key 是网关去调模型时用的。下面分开讲。网关 Token 有三种模式按场景选本地单机调试直接禁用验证最省事openclaw-cn config set gateway.auth.mode none这样就不会再报unauthorized: gateway token missing。但只要你把网关暴露到局域网或公网必须启用 Tokenopenclaw-cn config set gateway.auth.mode token然后生成一个 32 位随机 Token 写进配置$token -join ((65..90) (97..122) (48..57) | Get-Random -Count 32 | ForEach-Object {[char]$_}) Write-Host 生成的Token$token openclaw-cn config set gateway.auth.token $token把输出的 Token 复制保存后面浏览器插件和客户端都要填。别用默认值默认 Token 等于没有认证。模型侧的 API Key 则是在 TaoToken 控制台创建拿到后填到 OpenClaw 的模型配置里。这里的关键是三件套必须齐全Base URL、Key、Model ID。少任何一个都会在调用时报错。Base URL 用https://taotoken.net/apiKey 用你创建的那串Model ID 按你实际要用的模型填。配置模型端点可以用命令行openclaw-cn config set model.baseUrl https://taotoken.net/api openclaw-cn config set model.apiKey 你的APIKey openclaw-cn config set model.name 你的ModelID也可以用后面要讲的 JSON 文件统一写。两种方式等价命令行不容易出语法错JSON 便于版本管理。一个真实踩坑有人把网关 Token 填到了模型 apiKey 里结果网关能启动但一调模型就 401。排查时先看报错来源是网关拒绝你还是模型服务拒绝你。网关拒绝通常是unauthorized: gateway token missing模型拒绝通常是 401 加invalid api key。分清楚这两类排查方向就不会跑偏。3. 可复制的 openclaw.json 配置模板命令行配置适合快速改单项但完整配置还是落在openclaw.json里更清晰。这个文件默认在C:\Users\你的用户名\.openclaw\openclaw.json。一键安装后它可能缺失也可能因为手动编辑出现语法错误。下面给一份可直接复制的完整模板把你的Token和你的APIKey替换成实际值即可。{ gateway: { mode: local, port: 18792, auth: { mode: none, token: 你的Token } }, model: { baseUrl: https://taotoken.net/api, apiKey: 你的APIKey, name: 你的ModelID }, browser: { enabled: true, defaultProfile: openclaw, headless: false, noSandbox: false, executablePath: C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe } }几个必须注意的点。第一Windows 路径里的反斜杠在 JSON 中要写成双反斜杠\\写成单反斜杠会直接解析失败。第二文件编码必须是 UTF-8用记事本保存时“编码”选 UTF-8“文件类型”选“所有文件”否则会存成openclaw.json.txt程序读不到。第三JSON 不允许尾随逗号最后一个字段后面不能有逗号这是手动编辑最常见的语法错误来源。如果你更想用命令行生成避免手抖可以这样New-Item -Path $env:USERPROFILE\.openclaw -ItemType Directory -Force { gateway: { mode: local, port: 18792, auth: { mode: none, token: 你的Token } }, model: { baseUrl: https://taotoken.net/api, apiKey: 你的APIKey, name: 你的ModelID }, browser: { enabled: true, defaultProfile: openclaw, headless: false, noSandbox: false, executablePath: C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe } } | Out-File $env:USERPROFILE\.openclaw\openclaw.json -Encoding UTF8生成后建议用openclaw-cn config读一遍确认能正常解析。如果报解析错误多半是编码或逗号问题。浏览器路径按你实际安装位置改。Chrome 默认在C:\Program Files\Google\Chrome\Application\chrome.exeEdge 在C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe。路径写错的表现是网关能起但一执行浏览器任务就报找不到可执行文件。headless设为 false 表示有界面模式调试阶段建议保持 false能看到浏览器实际动作方便定位问题。noSandbox一般保持 false除非在受限环境里启动失败再考虑打开。配置改完必须重启网关才生效openclaw-cn gateway restart4. 验证请求与成功结果确认配置写完不算完得验证整条链路真的通。验证分三层网关层、模型层、浏览器层。逐层确认出问题好定位。网关层验证启动服务后浏览器访问http://127.0.0.1:18792能看到网关响应页面或返回 JSON 即说明网关活着。如果启用了 Token 验证访问时可能需要带上 Token 参数。命令行也可以直接测openclaw-cn gateway status模型层验证这一步确认网关能成功调到模型。用一条最小请求测试观察返回。如果返回正常内容说明 Base URL、Key、Model ID 三件套都对。如果报 401检查 Key 是否填错或过期如果报模型不存在检查 Model ID 拼写。浏览器层验证执行一条自动化命令比如打开一个页面openclaw-cn browser open https://baidu.com如果浏览器被拉起并打开页面说明浏览器配置正确。如果报找不到浏览器回到上一节检查executablePath。三层都通之后跑一个端到端的小任务让网关打开页面、抓取标题、调模型总结。这一步能同时验证网关、浏览器、模型三条链路。成功的话你会看到模型返回的总结内容这就是完整链路跑通的标志。验证时建议保持网关窗口可见日志会实时输出请求和错误。遇到问题时日志里的报错信息比浏览器提示更准确。常用日志命令openclaw-cn logs gateway如果日志里出现local proxy failed通常是模型端点地址写错或网络不通出现reading choices相关错误多半是模型返回格式和预期不符检查 Model ID 是否选错出现 OAuth 相关提示说明认证方式配错了本地场景应该用 API Key 而不是 OAuth 流程。验证通过后建议把当前可用的openclaw.json备份一份。后面调参调乱了直接还原比重新配快得多。5. 本篇常见报错逐条排查这一节把前面提到的报错集中对照方便你按现象直接定位。Gateway start blocked: set gateway.modelocal网关模式未设置。执行openclaw-cn config set gateway.mode local后重启。ERR_CONNECTION_REFUSED网关没启动或端口被占。先openclaw-cn gateway run确认服务在跑再netstat -ano | findstr :18792查占用必要时改端口。unauthorized: gateway token missing启用了 Token 验证但请求没带 Token。要么在请求里带上要么本地调试改成gateway.auth.mode none。401 invalid api key模型侧 Key 错误。检查model.apiKey是否填的是 TaoToken 创建的 Key而不是网关 Token。local proxy failed模型端点地址不通。确认model.baseUrl是https://taotoken.net/api且网络能访问。reading choices相关解析错误模型返回结构和预期不符。检查 Model ID 是否填错或换一个兼容的模型。OAuth 相关报错认证方式配错。本地 API Key 场景不需要走 OAuth检查配置里是否误开了 OAuth 模式。JSON 解析失败检查编码是否 UTF-8、是否有尾随逗号、路径反斜杠是否双写。浏览器找不到可执行文件检查browser.executablePath路径是否正确注意 32 位和 64 位程序的安装目录差异。端口改了但访问还是旧端口配置未生效执行openclaw-cn gateway restart。排查顺序建议从网关到模型再到浏览器逐层确认不要一上来就怀疑最复杂的部分。大部分问题都在配置层不在代码层。6. 后续接入与长期使用建议链路跑通之后接下来就是把它用起来。如果你只是偶尔验证模型效果直接在网关里发请求、看返回就够了模型对话入口在https://taotoken.net/api对应的控制台里可以试。如果你要做长期的编码任务或 Agent 自动化建议走 Coding Plan 这类长期方案配置一次后续稳定调用不用每次重新折腾 Key 和端点。接入文档和 API Key 管理都在控制台里需要新建 Key、查看用量、切换模型时从那里操作。文档入口https://taotoken.net/api。把这些入口存好后面换模型、加设备、排查认证问题都用得上。最后给几个长期使用的实用建议。第一把可用的openclaw.json纳入版本管理每次改动前先提交出问题能快速回滚。第二网关 Token 和模型 Key 分开管理不要图省事用同一个值。第三端口如果经常冲突固定一个不常用的端口写进配置避免每次排查。第四日志定期清理长时间运行日志会占空间。第五浏览器路径和版本升级后可能变化升级 Chrome 后如果自动化失效先回来检查executablePath。这套流程我在多台 Windows 机器上复现过最耗时的从来不是配置本身而是报错信息不明确导致的反复试错。把这篇里的报错对照表留着下次遇到直接查能省不少时间。
平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测)
