1. OpenClaw 被验证码卡住时模型通道和扩展要分开配OpenClaw 是一个跑在你自己设备上的个人 AI 助手它能通过自然语言指令打开网页、填表单、点按钮、截图取数据浏览器是它内置的独立 Chromium 配置文件跟你日常用的浏览器完全隔离。问题也出在这里当它去访问带 reCAPTCHA v2/v3、Cloudflare Turnstile 这类防护的页面时表单提交会被拦下任务停在“等待人工干预”那一步。CapSolver 的 Chrome 扩展能解决这个卡点——扩展在后台检测验证码、调用 CapSolver 接口拿 token、再注入隐藏字段整个过程不需要你写代码也不需要告诉 AI“去解验证码”。但很多人照着教程配到一半发现扩展加载成功了验证码也能过可 OpenClaw 的 agent 根本跑不起来因为它连模型都调不通。原因在于原文的先决条件里只写了“需要 AI 模型提供者的 API Key”却没讲这个 Key 从哪来、Base URL 填什么。这篇就把这块补上TaoToken 负责 OpenClaw agent 消耗模型 Token 时的统一 API 兼容通道CapSolver 负责解验证码两者各管一摊Key 不能混用。你从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 拿到模型 Key 后再按原文让 CapSolver 扩展处理 reCAPTCHA 和 Turnstile整条链路才算通。2. 先分清两个 Key模型通道用 TaoToken解验证码用 CapSolver这是最容易踩的坑。OpenClaw 在运行时会消耗两类外部服务一类是模型推理agent 每次理解你的自然语言指令、决定点哪个按钮都要调用大模型另一类是验证码求解CapSolver 扩展在页面里检测到挑战后调用 CapSolver 自己的接口。这两套凭证完全独立。模型这一侧你需要一个能兼容 OpenAI 风格请求的 API 通道。TaoToken 提供的就是这个统一的 Base URL 加上一个 API KeyOpenClaw 的模型配置指向它即可不用改 agent 的调用逻辑。注册和创建 Key 的入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 登录后在控制台里生成。验证码这一侧CapSolver 的 apiKey 是去 CapSolver 后台拿的填在扩展目录的assets/config.js里跟 TaoToken 的 Key 没有任何关系。我见过有人把 TaoToken 的 Key 填进 CapSolver 配置结果扩展一直报鉴权失败排查半天才发现是两码事。注意TaoToken 在这里只承担 OpenClaw agent 的模型 Token 消耗不参与验证码识别也不接触页面内容。CapSolver 扩展的求解过程完全在浏览器会话内完成。具体分工可以对照下面这张表配置项填什么填在哪作用模型 API KeyTaoToken 控制台创建的 KeyOpenClaw 模型通道配置agent 调用大模型模型 Base URLhttps://taotoken.net/apiOpenClaw 模型通道配置统一 API 兼容入口CapSolver apiKeyCapSolver 后台的 Key~/.openclaw/capsolver-extension/assets/config.js扩展求解验证码Base URL 这里要特别强调填https://taotoken.net/api不要带/v1也不要加任何 UTM 参数。带/v1会导致路径拼接后请求打到不存在的端点加 UTM 则可能让某些客户端把查询串当成路径的一部分。3. 可复制配置模型通道 浏览器扩展一次配好先处理模型通道。打开 OpenClaw 的配置文件找到模型提供者相关段落把 Base URL 和 Key 填进去。不同版本的 OpenClaw 配置字段名可能略有差异核心是baseUrl和apiKey两个值{ model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: 你在TaoToken控制台创建的Key, model: 你选用的模型名称 } }如果你用的是环境变量方式也可以这样设置避免 Key 写进配置文件export OPENAI_BASE_URLhttps://taotoken.net/api export OPENAI_API_KEY你在TaoToken控制台创建的Key接着配浏览器扩展。把 CapSolver 扩展解压到固定目录确认manifest.json在位mkdir -p ~/.openclaw/capsolver-extension unzip CapSolver.Browser.Extension-chrome-v*.zip -d ~/.openclaw/capsolver-extension/ ls ~/.openclaw/capsolver-extension/manifest.json然后编辑扩展的配置文件填入 CapSolver 后台的 Key注意这里不是 TaoToken 的 Keyexport const defaultConfig { apiKey: CAP-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX, useCapsolver: true, };再改 OpenClaw 的浏览器配置把扩展目录挂上去。executablePath必须指向 Chrome for Testing 或独立 Chromium不能用品牌版 Google Chrome 137那个版本会静默忽略--load-extension{ browser: { enabled: true, executablePath: /path/to/chrome-for-testing/chrome, extensions: [ ~/.openclaw/capsolver-extension ], noSandbox: true, defaultProfile: openclaw } }服务器或 Docker 环境里noSandbox设为true桌面环境有完整沙箱能力可以省略。无头服务器还需要虚拟显示否则扩展没有显示上下文无法激活sudo apt-get install xvfb Xvfb :99 -screen 0 1280x720x24 export DISPLAY:994. 验证请求重启网关后看日志和 CDP配置改完必须重启网关让模型通道和浏览器扩展同时生效pm2 restart opencrawl --update-env # 或者直接运行 openclaw gateway restart重启后先确认扩展加载。看网关日志pm2 logs opencrawl --lines 20 --nostream日志里应该出现这两行关键信息[browser/chrome] 加载 1 个扩展 [browser/chrome] 启动 Chrome: /path/to/chrome-for-testing (参数: 15)再做一次 CDP 层面的确认看扩展的 service worker 是否真的跑起来了curl -s http://127.0.0.1:8091/json/list返回结果里找带chrome-extension://的 service_worker 条目{ title: Service Worker chrome-extension://cnopfoopenkdblckmekkipihdnambjhf/background.js, type: service_worker, url: chrome-extension://cnopfoopenkdblckmekkipihdnambjhf/background.js }看到这个说明 CapSolver 扩展已加载并在运行。接下来验证模型通道是否通。给 OpenClaw 发一条自然语言指令比如通过你绑定的 Discord 或 Telegram去 https://example.com等待60秒然后点击提交并告诉我页面上显示的文本。这条指令同时验证两件事agent 能调用模型理解指令模型通道通扩展能在等待窗口内解掉页面上的验证码CapSolver 通。如果模型通道没配好agent 会在第一步就报错根本走不到浏览器操作。实测下来模型调用成功时日志里能看到对应的请求记录页面最终返回 “Verification Success” 之类的文本说明 token 已注入且表单提交成功。5. 本篇常见错排查模型调用 401 或 404先检查 Base URL 是不是写成了https://taotoken.net/api/v1带/v1会 404再确认 Key 有没有多余空格以及是不是从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 控制台里创建的那个。401 基本都是 Key 不对404 基本都是路径不对。扩展日志显示加载了但 CDP 里没有 chrome-extension 条目八成是用了品牌版 Google Chrome 137。用--version确认一下如果是 “Google Chrome” 开头而不是 “Chromium”换成 Chrome for Testing 或 Playwright 自带的 Chromium再把executablePath指过去。验证码没解表单提交失败先看等待时间够不够reCAPTCHA v2 建议 30-60 秒Turnstile 建议 20-30 秒不确定就统一给 60 秒。再查 CapSolver 后台余额余额不足会静默失败。最后确认assets/config.js里的 apiKey 是 CapSolver 的不是 TaoToken 的。重启后第一次浏览器操作超时Chromium 冷启动加 CDP 连接重试可能超过首次工具超时这是已知现象重发一次指令通常就正常了因为浏览器已经预热。切换浏览器后 Chrome 崩溃旧用户数据目录跟新版本不兼容删掉重建rm -rf ~/.openclaw/browser/openclaw/user-data然后重启网关。这个操作会清掉浏览器登录态如果里面有需要保留的会话先备份再删。6. 配通之后模型走 TaoToken验证码走 CapSolver整条链路理顺后你的日常使用其实很简单模型通道固定指向https://taotoken.net/apiKey 从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建CapSolver 扩展的 Key 留在assets/config.js里不动。给 OpenClaw 下指令时别提“验证码”或“CapSolver”就说“等待 60 秒然后提交”扩展会在后台把 reCAPTCHA v2/v3、Turnstile 这些处理掉。如果你后面要长期跑编码类或 Agent 类任务模型调用量会明显上来可以到 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 的 Coding Plan 页面看看适合的套餐需要单独管理 Key 或查用量控制台在 https://taotoken.net/console 想先验证模型通不通直接用模型对话页面发一条测试请求最快https://taotoken.net/model-chat 。接入细节和参数说明都在文档里https://taotoken.net/doc 。把模型通道和验证码扩展这两件事分开配、分开管OpenClaw 才能真正跑顺。