剛把 OpenClaw v2.7.9 按入門攻略裝完右鍵啟動(dòng)界面是出來了但右上角一直顯示 Gateway 離線。你發(fā)一句「整理 D 盤圖片」輸入框像沒聽見再發(fā)「提取網(wǎng)頁數(shù)據(jù)生成 Excel」還是沒反應(yīng)。很多人翻到原文 Q3照著關(guān)殺毒、重啟軟件、卸載重裝走一遍Gateway 依舊灰著。這里被漏掉的一環(huán)通常是模型渠道OpenClaw 的 Gateway 要連上模型服務(wù)才能算在線而各家 Key 的格式、Base URL、模型名不一致時(shí)它就會(huì)卡在認(rèn)證這一步。先去 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注冊(cè)并創(chuàng)建一把 TaoToken Key再回 OpenClaw 左側(cè)「渠道」頁把模型服務(wù)商的 Base URL 填成 https://taotoken.net/api粘貼剛創(chuàng)建的 Key保存后點(diǎn)右上角重啟 Gateway離線提示才有機(jī)會(huì)消失。下面按排障順序從「為什么只關(guān)殺毒沒用」講到「怎么確認(rèn) Tokens 真的在消耗」。1. OpenClaw v2.7.9 右上角 Gateway 離線時(shí)先別急著重裝1.1 離線狀態(tài)下 OpenClaw 卡在模型認(rèn)證不是界面崩潰OpenClaw 的界面能打開左側(cè)菜單能點(diǎn)渠道頁能保存這已經(jīng)說明主程序沒有崩。右上角那個(gè) Gateway 更像一個(gè)本地通信層它替 OpenClaw 去和模型服務(wù)說話把指令送出去再把回復(fù)拿回來。啟動(dòng)時(shí)它會(huì)讀渠道配置拿到 Base URL、API Key、模型 ID然后向模型服務(wù)發(fā)一個(gè)輕量請(qǐng)求。如果這個(gè)請(qǐng)求沒有正常返回Gateway 就不會(huì)標(biāo)記為在線哪怕本機(jī)進(jìn)程還活著。所以「Gateway 離線」不等于「OpenClaw 沒裝好」。它可能只是模型通道沒通。你發(fā)指令沒反應(yīng)是因?yàn)?OpenClaw 根本沒拿到模型回復(fù)而不是它不會(huì)執(zhí)行「整理 D 盤圖片」或「提取網(wǎng)頁數(shù)據(jù)生成 Excel」。排障時(shí)先分清這兩層能省掉很多次無意義的卸載重裝。1.2 原文 Q3 關(guān)殺毒、重啟、重裝為什么沒碰到根因原文 Q3 給的處理方式偏系統(tǒng)層殺毒軟件可能攔截本地進(jìn)程重啟能解決臨時(shí)端口占用重裝能修復(fù)文件損壞。這些動(dòng)作在特定情況下有效但它們不會(huì)修改「渠道」頁里的模型服務(wù)配置。如果根因是 Key 過期、Base URL 填了別家地址、模型名帶了不存在的日期后綴那么你重裝十次配置還是舊的Gateway 還是會(huì)離線。更常見的情況是你之前配過另一家模型服務(wù)Key 已經(jīng)失效但 OpenClaw 默認(rèn)還在走那個(gè)舊渠道。界面看起來正常日志里卻在報(bào) 401。原文 Q3 沒讓你檢查模型渠道所以照著做只會(huì)把系統(tǒng)層折騰一遍真正該改的 Base URL 和 Key 還在原地。1.3 用一張表判斷渠道沒通還是 Gateway 沒起可以先做一個(gè)快速判斷?，F(xiàn)象不一樣優(yōu)先檢查的方向也不一樣?，F(xiàn)象優(yōu)先檢查原因OpenClaw 界面能開渠道頁能保存右上角 Gateway 離線渠道頁的 Base URL、Key、模型 IDGateway 已啟動(dòng)但模型認(rèn)證沒通過OpenClaw 雙擊沒反應(yīng)任務(wù)管理器里沒有進(jìn)程殺毒攔截、安裝文件、系統(tǒng)權(quán)限主程序還沒起來輪不到模型渠道Gateway 偶爾在線發(fā)指令后馬上掉線模型 ID、賬號(hào)余額、請(qǐng)求超時(shí)首次握手成功實(shí)際調(diào)用失敗渠道頁保存報(bào)錯(cuò)或保存后配置丟失配置文件權(quán)限、安裝目錄寫入權(quán)限配置沒落盤Gateway 讀不到新渠道如果你落在第一行下面就不用再糾結(jié)殺毒和重裝直接去準(zhǔn)備一把能統(tǒng)一認(rèn)證的 Key。2. 去 TaoToken 創(chuàng)建 Key再回 OpenClaw 渠道頁2.1 模型廣場(chǎng)先確認(rèn)模型 ID別自己拼日期后綴打開 TaoToken 注冊(cè)后先別急著復(fù)制 Key。先去模型廣場(chǎng)看一眼當(dāng)前可用的模型 ID。OpenClaw 渠道頁里要填的模型 ID必須和模型廣場(chǎng)當(dāng)時(shí)列表一致。不要自己憑記憶寫一個(gè)帶日期后綴的名字也不要拿別的平臺(tái)看到的模型名直接套過來。模型 ID 填錯(cuò)時(shí)Gateway 可能先顯示在線等你一發(fā)送指令就報(bào)模型不存在然后右上角又變回離線。這種「閃一下在線」最容易被誤判成網(wǎng)絡(luò)問題。模型 ID 以 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 模型廣場(chǎng)為準(zhǔn)復(fù)制完整字符串不要手動(dòng)改大小寫。2.2 控制臺(tái)創(chuàng)建 API Key文章里只寫 YOUR_API_KEY在控制臺(tái)創(chuàng)建 API Key 后先把它放進(jìn)密碼管理器或本地臨時(shí)文件。本文所有示例都用YOUR_API_KEY占位你真正填進(jìn) OpenClaw 時(shí)換成自己剛創(chuàng)建的那把。不要把真實(shí) Key 貼到截圖、群聊、公開 issue 或錄屏里。Key 從 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 創(chuàng)建創(chuàng)建后如果懷疑泄露直接刪掉重建。OpenClaw 渠道頁通常只需要一條 Key。粘貼時(shí)注意前后不要帶空格也不要手動(dòng)加Bearer前綴。很多工具會(huì)在內(nèi)部自動(dòng)拼Authorization: Bearer你再加一次就變成雙 Bearer認(rèn)證直接失敗。2.3 各家 Key 格式不一致時(shí)OpenClaw 為什么直接離線不同模型服務(wù)商的鑒權(quán)頭、路徑、模型名格式不一樣。有的走Authorization: Bearer有的走x-api-key有的 Base URL 要帶/v1有的不要有的模型名帶日期有的不帶。OpenClaw 的渠道頁如果選錯(cuò)供應(yīng)商模板它就會(huì)按錯(cuò)誤格式發(fā)請(qǐng)求。請(qǐng)求被拒Gateway 收不到有效響應(yīng)右上角就離線。TaoToken 在這里做的是統(tǒng)一 API / 兼容通道把認(rèn)證收口成一種格式你填 Base URL https://taotoken.net/api再貼一把 KeyOpenClaw 不用為每家服務(wù)商寫不同適配。換模型時(shí)也只需要改模型 ID不用重新研究鑒權(quán)頭。3. OpenClaw v2.7.9 渠道頁的 Base URL 到底填什么3.1 渠道頁字段對(duì)照Base URL https://taotoken.net/api回到 OpenClaw v2.7.9左側(cè)點(diǎn)「渠道」頁新增或編輯模型服務(wù)商。不同小版本界面文字可能略有差異但核心字段就這幾個(gè)字段填寫內(nèi)容供應(yīng)商類型OpenAI 兼容 / 自定義以渠道頁實(shí)際選項(xiàng)為準(zhǔn)Base URLhttps://taotoken.net/apiAPI KeyYOUR_API_KEY模型 ID以 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 模型廣場(chǎng)為準(zhǔn)默認(rèn)渠道設(shè)為你剛保存的 TaoToken 渠道注意Base URL 末尾不要加/v1。官網(wǎng)落地頁https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end是給人注冊(cè)、創(chuàng)建 Key、看模型廣場(chǎng)用的不要填進(jìn) Base URL。填進(jìn) OpenClaw 的接口地址只有https://taotoken.net/api。3.2 保存后重啟 Gateway 的順序比反復(fù)點(diǎn)重啟重要正確順序是先保存渠道確認(rèn)界面沒有報(bào)錯(cuò)再點(diǎn)右上角重啟 Gateway等圖標(biāo)從灰變綠或顯示在線最后才發(fā)測(cè)試指令。很多人反過來先發(fā)指令看到?jīng)]反應(yīng)再去點(diǎn)重啟然后以為重啟沒用。其實(shí) Gateway 啟動(dòng)時(shí)讀的是舊配置你后改的渠道還沒被加載。如果渠道頁有「測(cè)試連接」按鈕可以先點(diǎn)一下。測(cè)試通過再重啟 Gateway。測(cè)試不通過就回看 Key、Base URL、模型 ID 三欄不要急著去殺毒軟件里加白名單。3.3 多個(gè)模型服務(wù)商并存時(shí)默認(rèn)渠道別選錯(cuò)渠道頁里可能躺著好幾個(gè)供應(yīng)商之前試過的、朋友給的、別的項(xiàng)目留下的。OpenClaw 可能按默認(rèn)渠道或排序第一個(gè)來走。你把 TaoToken 配好了但默認(rèn)渠道還是舊的那個(gè)Gateway 照樣離線。處理辦法很簡(jiǎn)單把舊渠道禁用或刪除如果不想刪就把剛保存的 TaoToken 渠道設(shè)為默認(rèn)并確認(rèn)當(dāng)前活躍渠道是它。保存后如果日志里出現(xiàn)舊服務(wù)商的域名或舊 Key 的報(bào)錯(cuò)就說明請(qǐng)求根本沒走新渠道?；厍理摍z查默認(rèn)項(xiàng)比反復(fù)重啟有效。4. 驗(yàn)證 Gateway 在線從「整理 D 盤圖片」開始4.1 先讓它生成清單和腳本不要直接動(dòng)文件Gateway 顯示在線后先發(fā)一個(gè)低風(fēng)險(xiǎn)指令比如「整理 D 盤圖片」。更穩(wěn)妥的做法是讓它先生成文件清單、分類規(guī)則和可執(zhí)行的腳本你在本地確認(rèn)后再運(yùn)行。不要一上來就讓它直接移動(dòng)或刪除你的文件。AI 編程工具可以生成、解釋、對(duì)照代碼也可以幫你寫腳本但真正執(zhí)行本地文件操作時(shí)最好由你確認(rèn)每一步。如果 OpenClaw 能把分類步驟列出來說明模型通道已經(jīng)通了Gateway 不是假在線。接下來再試多步任務(wù)。4.2 右上角剩余 Tokens 有沒有隨調(diào)用變化發(fā)一條測(cè)試消息后看 OpenClaw 右上角剩余 Tokens 是否變化。如果一直不變可能請(qǐng)求沒走 TaoToken 通道或者本地緩存了舊結(jié)果。打開 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 控制臺(tái)看用量和請(qǐng)求日志里有沒有這次調(diào)用。有記錄說明通道通了沒記錄回渠道頁確認(rèn)默認(rèn)供應(yīng)商和 Base URL。這個(gè)動(dòng)作能區(qū)分「Gateway 在線」和「模型真的被調(diào)用」。有些配置錯(cuò)誤會(huì)讓 Gateway 顯示在線但一調(diào)用就失敗Tokens 自然不動(dòng)。4.3 多步任務(wù)「提取網(wǎng)頁數(shù)據(jù)生成 Excel」怎么觀察日志「提取網(wǎng)頁數(shù)據(jù)生成 Excel」通常會(huì)觸發(fā)多次模型調(diào)用第一次理解任務(wù)第二次生成解析邏輯第三次整理輸出格式。你可以在 OpenClaw 日志里觀察是否出現(xiàn)多次 request右上角 Tokens 是否逐步下降。如果第一次成功、第二次報(bào)錯(cuò)可能是模型 ID 不支持長(zhǎng)上下文或者中間結(jié)果太長(zhǎng)。遇到這種情況讓 OpenClaw 把中間結(jié)果先輸出成文本由你檢查后再繼續(xù)。不要讓它直接連接生產(chǎn)庫或生產(chǎn)機(jī)器執(zhí)行操作。生成 SQL、解釋報(bào)錯(cuò)、對(duì)照代碼都可以執(zhí)行診斷 SQL 或編譯運(yùn)行請(qǐng)?jiān)谀惚镜赝瓿稍侔呀Y(jié)果貼回對(duì)話。5. 渠道填完仍離線OpenClaw v2.7.9 排查清單5.1 401、403、模型不存在分別回看哪一欄401 多半是 Key 問題Key 復(fù)制少了、多了空格、過期、被刪除或者渠道頁里重復(fù)加了Bearer。403 可能是 Key 權(quán)限不足或者模型未開通。模型不存在通常是模型 ID 寫錯(cuò)回模型廣場(chǎng)復(fù)制完整 ID。把報(bào)錯(cuò)原文和渠道頁字段對(duì)照一遍比重裝快得多。5.2 Base URL 多了 /v1、少了 /api、填了官網(wǎng)會(huì)怎樣Base URL 是這一節(jié)最容易填錯(cuò)的地方。正確和錯(cuò)誤對(duì)照如下正確https://taotoken.net/api 錯(cuò)誤https://taotoken.net/api/v1 錯(cuò)誤https://taotoken.net 錯(cuò)誤https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end多寫/v1時(shí)工具可能再拼一次/v1變成/api/v1/v1。少了/api請(qǐng)求打到官網(wǎng)頁面上當(dāng)然沒有模型響應(yīng)。把官網(wǎng)落地頁填進(jìn) Base URL同樣不會(huì)得到接口返回。記住注冊(cè)、創(chuàng)建 Key、看模型廣場(chǎng)用官網(wǎng)填進(jìn) OpenClaw 的 Base URL 只用https://taotoken.net/api。5.3 殺毒、端口、Gateway 進(jìn)程與原文 Q3 的分工如果渠道配置確認(rèn)無誤還是離線再回到原文 Q3 那套系統(tǒng)層檢查殺毒軟件是否攔截了 OpenClaw 進(jìn)程防火墻是否阻止本地端口Gateway 進(jìn)程是否真的在運(yùn)行。順序建議是先查渠道再看系統(tǒng)層。否則你關(guān)了殺毒、重裝了三次渠道里還是舊 Key問題依舊。5.4 日志里找 request、response、status 三行OpenClaw 的日志窗口或日志文件里重點(diǎn)找三行有沒有發(fā)出 requestrequest 的地址是不是https://taotoken.net/apiresponse 的 status 是多少。如果 request 地址是舊服務(wù)商說明默認(rèn)渠道沒切如果 status 是 401回 Key如果是 404回模型 ID。把這些行貼到模型對(duì)話里解釋可以但記得先把真實(shí) Key 打碼。6. 固定 OpenClaw 渠道配置別讓 Gateway 再次離線6.1 把 Key、模型 ID、默認(rèn)渠道記在配置清單里配通之后把渠道頁里的關(guān)鍵字段記到自己的配置清單Base URL 是https://taotoken.net/apiKey 用YOUR_API_KEY占位模型 ID 以模型廣場(chǎng)為準(zhǔn)默認(rèn)渠道選 TaoToken。下次 OpenClaw 升級(jí)或換機(jī)器直接照這張清單填不用重新猜。TaoToken 在這里的價(jià)值是統(tǒng)一通道你不需要為每個(gè)模型服務(wù)商記不同的鑒權(quán)格式。換模型時(shí)只改模型 IDKey 泄露時(shí)只換 Key。Base URL 始終是https://taotoken.net/api。6.2 去控制臺(tái)對(duì)一次調(diào)用確認(rèn) Tokens 真的扣了再發(fā)一條測(cè)試消息然后打開 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 控制臺(tái)看這次調(diào)用的用量記錄。如果 OpenClaw 顯示在線、控制臺(tái)也有記錄說明整條鏈路通了。如果控制臺(tái)沒記錄但 OpenClaw 有回復(fù)可能走了本地緩存或別的渠道回渠道頁再確認(rèn)默認(rèn)項(xiàng)。6.3 下一步模型對(duì)話、Coding Plan、創(chuàng)建 Key渠道頁保存后別停在 OpenClaw 里反復(fù)點(diǎn)重啟。去 TaoToken 模型對(duì)話 用同一把 Key 發(fā)一條測(cè)試消息確認(rèn)模型 ID 和 Base URL 沒填錯(cuò)如果你準(zhǔn)備讓 OpenClaw 長(zhǎng)期跑整理圖片、提取表格這類任務(wù)可以看 Coding Plan 是否夠用Key 要換或要新建在 控制臺(tái) API Keys 里操作。下一步就是回 OpenClaw 發(fā)一條「整理 D 盤圖片」盯著右上角剩余 Tokens 是否隨任務(wù)變化。