1. OpenClaw 被驗證碼卡住時模型通道和擴展要分開配OpenClaw 是一個跑在你自己設(shè)備上的個人 AI 助手它能通過自然語言指令打開網(wǎng)頁、填表單、點按鈕、截圖取數(shù)據(jù)瀏覽器是它內(nèi)置的獨立 Chromium 配置文件跟你日常用的瀏覽器完全隔離。問題也出在這里當(dāng)它去訪問帶 reCAPTCHA v2/v3、Cloudflare Turnstile 這類防護(hù)的頁面時表單提交會被攔下任務(wù)停在“等待人工干預(yù)”那一步。CapSolver 的 Chrome 擴展能解決這個卡點——擴展在后臺檢測驗證碼、調(diào)用 CapSolver 接口拿 token、再注入隱藏字段整個過程不需要你寫代碼也不需要告訴 AI“去解驗證碼”。但很多人照著教程配到一半發(fā)現(xiàn)擴展加載成功了驗證碼也能過可 OpenClaw 的 agent 根本跑不起來因為它連模型都調(diào)不通。原因在于原文的先決條件里只寫了“需要 AI 模型提供者的 API Key”卻沒講這個 Key 從哪來、Base URL 填什么。這篇就把這塊補上TaoToken 負(fù)責(zé) OpenClaw agent 消耗模型 Token 時的統(tǒng)一 API 兼容通道CapSolver 負(fù)責(zé)解驗證碼兩者各管一攤Key 不能混用。你從 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 拿到模型 Key 后再按原文讓 CapSolver 擴展處理 reCAPTCHA 和 Turnstile整條鏈路才算通。2. 先分清兩個 Key模型通道用 TaoToken解驗證碼用 CapSolver這是最容易踩的坑。OpenClaw 在運行時會消耗兩類外部服務(wù)一類是模型推理agent 每次理解你的自然語言指令、決定點哪個按鈕都要調(diào)用大模型另一類是驗證碼求解CapSolver 擴展在頁面里檢測到挑戰(zhàn)后調(diào)用 CapSolver 自己的接口。這兩套憑證完全獨立。模型這一側(cè)你需要一個能兼容 OpenAI 風(fēng)格請求的 API 通道。TaoToken 提供的就是這個統(tǒng)一的 Base URL 加上一個 API KeyOpenClaw 的模型配置指向它即可不用改 agent 的調(diào)用邏輯。注冊和創(chuàng)建 Key 的入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 登錄后在控制臺里生成。驗證碼這一側(cè)CapSolver 的 apiKey 是去 CapSolver 后臺拿的填在擴展目錄的assets/config.js里跟 TaoToken 的 Key 沒有任何關(guān)系。我見過有人把 TaoToken 的 Key 填進(jìn) CapSolver 配置結(jié)果擴展一直報鑒權(quán)失敗排查半天才發(fā)現(xiàn)是兩碼事。注意TaoToken 在這里只承擔(dān) OpenClaw agent 的模型 Token 消耗不參與驗證碼識別也不接觸頁面內(nèi)容。CapSolver 擴展的求解過程完全在瀏覽器會話內(nèi)完成。具體分工可以對照下面這張表配置項填什么填在哪作用模型 API KeyTaoToken 控制臺創(chuàng)建的 KeyOpenClaw 模型通道配置agent 調(diào)用大模型模型 Base URLhttps://taotoken.net/apiOpenClaw 模型通道配置統(tǒng)一 API 兼容入口CapSolver apiKeyCapSolver 后臺的 Key~/.openclaw/capsolver-extension/assets/config.js擴展求解驗證碼Base URL 這里要特別強調(diào)填https://taotoken.net/api不要帶/v1也不要加任何 UTM 參數(shù)。帶/v1會導(dǎo)致路徑拼接后請求打到不存在的端點加 UTM 則可能讓某些客戶端把查詢串當(dāng)成路徑的一部分。3. 可復(fù)制配置模型通道 瀏覽器擴展一次配好先處理模型通道。打開 OpenClaw 的配置文件找到模型提供者相關(guān)段落把 Base URL 和 Key 填進(jìn)去。不同版本的 OpenClaw 配置字段名可能略有差異核心是baseUrl和apiKey兩個值{ model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: 你在TaoToken控制臺創(chuàng)建的Key, model: 你選用的模型名稱 } }如果你用的是環(huán)境變量方式也可以這樣設(shè)置避免 Key 寫進(jìn)配置文件export OPENAI_BASE_URLhttps://taotoken.net/api export OPENAI_API_KEY你在TaoToken控制臺創(chuàng)建的Key接著配瀏覽器擴展。把 CapSolver 擴展解壓到固定目錄確認(rèn)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 } }服務(wù)器或 Docker 環(huán)境里noSandbox設(shè)為true桌面環(huán)境有完整沙箱能力可以省略。無頭服務(wù)器還需要虛擬顯示否則擴展沒有顯示上下文無法激活sudo apt-get install xvfb Xvfb :99 -screen 0 1280x720x24 export DISPLAY:994. 驗證請求重啟網(wǎng)關(guān)后看日志和 CDP配置改完必須重啟網(wǎng)關(guān)讓模型通道和瀏覽器擴展同時生效pm2 restart opencrawl --update-env # 或者直接運行 openclaw gateway restart重啟后先確認(rèn)擴展加載?？淳W(wǎng)關(guān)日志pm2 logs opencrawl --lines 20 --nostream日志里應(yīng)該出現(xiàn)這兩行關(guān)鍵信息[browser/chrome] 加載 1 個擴展 [browser/chrome] 啟動 Chrome: /path/to/chrome-for-testing (參數(shù): 15)再做一次 CDP 層面的確認(rèn)看擴展的 service worker 是否真的跑起來了curl -s http://127.0.0.1:8091/json/list返回結(jié)果里找?guī)hrome-extension://的 service_worker 條目{ title: Service Worker chrome-extension://cnopfoopenkdblckmekkipihdnambjhf/background.js, type: service_worker, url: chrome-extension://cnopfoopenkdblckmekkipihdnambjhf/background.js }看到這個說明 CapSolver 擴展已加載并在運行。接下來驗證模型通道是否通。給 OpenClaw 發(fā)一條自然語言指令比如通過你綁定的 Discord 或 Telegram去 https://example.com等待60秒然后點擊提交并告訴我頁面上顯示的文本。這條指令同時驗證兩件事agent 能調(diào)用模型理解指令模型通道通擴展能在等待窗口內(nèi)解掉頁面上的驗證碼CapSolver 通。如果模型通道沒配好agent 會在第一步就報錯根本走不到瀏覽器操作。實測下來模型調(diào)用成功時日志里能看到對應(yīng)的請求記錄頁面最終返回 “Verification Success” 之類的文本說明 token 已注入且表單提交成功。5. 本篇常見錯排查模型調(diào)用 401 或 404先檢查 Base URL 是不是寫成了https://taotoken.net/api/v1帶/v1會 404再確認(rèn) Key 有沒有多余空格以及是不是從 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 控制臺里創(chuàng)建的那個。401 基本都是 Key 不對404 基本都是路徑不對。擴展日志顯示加載了但 CDP 里沒有 chrome-extension 條目八成是用了品牌版 Google Chrome 137。用--version確認(rèn)一下如果是 “Google Chrome” 開頭而不是 “Chromium”換成 Chrome for Testing 或 Playwright 自帶的 Chromium再把executablePath指過去。驗證碼沒解表單提交失敗先看等待時間夠不夠reCAPTCHA v2 建議 30-60 秒Turnstile 建議 20-30 秒不確定就統(tǒng)一給 60 秒。再查 CapSolver 后臺余額余額不足會靜默失敗。最后確認(rèn)assets/config.js里的 apiKey 是 CapSolver 的不是 TaoToken 的。重啟后第一次瀏覽器操作超時Chromium 冷啟動加 CDP 連接重試可能超過首次工具超時這是已知現(xiàn)象重發(fā)一次指令通常就正常了因為瀏覽器已經(jīng)預(yù)熱。切換瀏覽器后 Chrome 崩潰舊用戶數(shù)據(jù)目錄跟新版本不兼容刪掉重建rm -rf ~/.openclaw/browser/openclaw/user-data然后重啟網(wǎng)關(guān)。這個操作會清掉瀏覽器登錄態(tài)如果里面有需要保留的會話先備份再刪。6. 配通之后模型走 TaoToken驗證碼走 CapSolver整條鏈路理順后你的日常使用其實很簡單模型通道固定指向https://taotoken.net/apiKey 從 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 創(chuàng)建CapSolver 擴展的 Key 留在assets/config.js里不動。給 OpenClaw 下指令時別提“驗證碼”或“CapSolver”就說“等待 60 秒然后提交”擴展會在后臺把 reCAPTCHA v2/v3、Turnstile 這些處理掉。如果你后面要長期跑編碼類或 Agent 類任務(wù)模型調(diào)用量會明顯上來可以到 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 的 Coding Plan 頁面看看適合的套餐需要單獨管理 Key 或查用量控制臺在 https://taotoken.net/console 想先驗證模型通不通直接用模型對話頁面發(fā)一條測試請求最快https://taotoken.net/model-chat 。接入細(xì)節(jié)和參數(shù)說明都在文檔里https://taotoken.net/doc 。把模型通道和驗證碼擴展這兩件事分開配、分開管OpenClaw 才能真正跑順。