1. 為什么你的 OpenClaw 對(duì)話模式調(diào)不動(dòng) skills前幾篇把 OpenClaw 在個(gè)人游戲筆記本上跑起來(lái)之后webchat 里能聊天、命令行能執(zhí)行agent-browser但一到對(duì)話界面讓它調(diào) skills 就裝死。我試過(guò)在 webchat 里發(fā)「幫我打開(kāi)瀏覽器搜一下」它回你一段禮貌的拒絕命令行里同樣的指令卻跑得飛起。這不是模型笨是openclaw.json里的權(quán)限沒(méi)給夠。OpenClaw 的對(duì)話模式默認(rèn)跑在嚴(yán)格沙箱里只允許純文本往返文件讀寫、瀏覽器操作、shell 執(zhí)行這些全被按住。命令行模式權(quán)限更高所以同一個(gè) agent 在兩個(gè)入口表現(xiàn)完全不同。要打通這個(gè)差異核心就落在兩個(gè)配置塊上agents決定 agent 運(yùn)行時(shí)能碰什么gateway決定 webchat 這個(gè)入口怎么連、連上之后認(rèn)不認(rèn)你的 token。把這兩塊配明白再通過(guò) TaoToken 統(tǒng)一 Key 通道接上模型本地就能跑通一套可復(fù)制的配置。這篇給出一份可以直接抄的openclaw.json骨架重點(diǎn)講agents和gateway然后演示用 TaoToken 的 API 通道完成接入驗(yàn)證。適合已經(jīng)在 Win10WSL2 里裝好 OpenClaw、模型也拉下來(lái)了但卡在「對(duì)話模式不干活」這一步的人。2. TaoToken 前置統(tǒng)一 Key 與 API 通道OpenClaw 支持多種模型提供方本地 ollama 是一種走云端 API 也是一種。本地 6G 顯存跑 2B 量化模型夠聊天但一旦要 agent 連續(xù)調(diào)工具、多輪推理本地模型容易在工具調(diào)用格式上翻車。這時(shí)候把模型請(qǐng)求切到 TaoToken 的統(tǒng)一通道用同一個(gè) Key 管多個(gè)模型配置上反而更省事。TaoToken 在這里的角色是統(tǒng)一入口你不需要在openclaw.json里為每個(gè)模型單獨(dú)填一套 base_url 和 key而是把 OpenAI 兼容的 base_url 指向 TaoToken 的 API 地址Key 用同一個(gè)。OpenClaw 的models塊里配好 providerauth塊里放 Keyagent 就能通過(guò) gateway 把請(qǐng)求發(fā)出去。需要提前準(zhǔn)備的東西一個(gè) TaoToken 賬號(hào)登錄后在控制臺(tái)創(chuàng)建 API Key本地 OpenClaw 已經(jīng)能啟動(dòng)openclaw doctor不報(bào)致命錯(cuò)誤知道你的openclaw.json路徑通常在~/.openclaw/openclaw.json創(chuàng)建 Key 的入口在控制臺(tái)的 API Keys 頁(yè)面拿到之后先別急著寫進(jìn)配置用 curl 驗(yàn)一下通道通不通避免配置寫完才發(fā)現(xiàn)是 Key 的問(wèn)題。curl https://taotoken.net/api/v1/models \ -H Authorization: Bearer sk-你的Key返回模型列表就說(shuō)明通道沒(méi)問(wèn)題。這一步很關(guān)鍵因?yàn)楹竺鎜penclaw.json里任何一處寫錯(cuò)報(bào)錯(cuò)信息都不會(huì)直接告訴你「是 Key 錯(cuò)了」而是 gateway 超時(shí)或者 401排查起來(lái)繞遠(yuǎn)路。3. 可復(fù)制的 openclaw.json 骨架下面這份骨架是在自動(dòng)生成配置的基礎(chǔ)上補(bǔ)全的重點(diǎn)標(biāo)了agents和gateway兩塊。JSON5 格式支持注釋但為了復(fù)制方便這里用標(biāo)準(zhǔn) JSON 寫法你粘貼時(shí)把注釋行刪掉即可。3.1 agents 塊把權(quán)限開(kāi)到位agents里的defaults管全局默認(rèn)list管具體 agent 實(shí)例。對(duì)話模式調(diào)不動(dòng) skills八成是elevatedDefault沒(méi)開(kāi)或者list里 agent 的tools.elevated沒(méi)放行 webchat。{ agents: { defaults: { model: { primary: taotoken/qwen3.5-2b }, workspace: /home/hello/.openclaw/workspace, userTimezone: Asia/Shanghai, timeFormat: 24, elevatedDefault: on, contextPruning: { mode: cache-ttl, ttl: 1h, keepLastAssistants: 3 }, heartbeat: { every: 30m, model: taotoken/qwen3.5-2b, session: main, target: none } }, list: [ { id: main, default: true, name: Main, workspace: ~/.openclaw/workspace, model: taotoken/qwen3.5-2b, skills: [ agent-browser, healthcheck, weather ], sandbox: { mode: off }, tools: { allow: [llm-task], elevated: { enabled: true, allowFrom: { webchat: [*] } } } } ] } }幾個(gè)容易踩的點(diǎn)elevatedDefault設(shè)成on是讓 agent 默認(rèn)具備提權(quán)能力但真正決定 webchat 能不能用是list里那個(gè) agent 的tools.elevated.allowFrom.webchat。只開(kāi)前者不開(kāi)后者對(duì)話模式照樣被攔。sandbox.mode設(shè)off是本地自用場(chǎng)景的取舍如果你后面要接外部渠道這里得重新評(píng)估。3.2 gateway 塊讓 webchat 連得上gateway管的是 webchat 這個(gè)入口的監(jiān)聽(tīng)、認(rèn)證和節(jié)點(diǎn)權(quán)限。自動(dòng)生成的配置里port、bind、auth.token都有但nodes.denyCommands默認(rèn)會(huì)擋掉一批敏感命令本地自用可以按需放開(kāi)。{ gateway: { port: 18789, mode: local, bind: loopback, controlUi: { enabled: true }, auth: { mode: token, token: 你的gateway-token }, nodes: { denyCommands: [ camera.snap, screen.record, sms.send ] } } }bind保持loopback意味著只有本機(jī)能連這對(duì)個(gè)人筆記本場(chǎng)景是合適的。auth.token是 webchat 握手用的和 TaoToken 的 API Key 是兩回事別混。nodes.denyCommands里我保留了攝像頭和錄屏的禁用瀏覽器和 shell 相關(guān)的沒(méi)放進(jìn)去這樣 agent-browser 才能正常跑。3.3 models 與 auth接上 TaoToken模型提供方這塊把 base_url 指向 TaoToken 的 API 地址Key 放在auth里。OpenClaw 的 provider 命名可以自定義這里用taotoken作為前綴。{ models: { providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKeyEnv: TAOTOKEN_API_KEY, models: { qwen3.5-2b: { contextWindow: 104858, maxTokens: 8192 } } } } }, auth: { taotoken: { apiKey: sk-你的Key } } }contextWindow和maxTokens這兩個(gè)參數(shù)別貪大。6G 顯存下contextWindow拉到十萬(wàn)級(jí)別多輪對(duì)話后內(nèi)存會(huì)頂?shù)缴舷尴到y(tǒng)直接崩。maxTokens設(shè) 8192 是留了工具調(diào)用返回的空間再大推理速度掉得明顯。4. 驗(yàn)證請(qǐng)求gateway 是否正常響應(yīng)配置寫完先跑openclaw doctor看有沒(méi)有語(yǔ)法錯(cuò)誤然后重啟 gateway。openclaw doctor openclaw gateway restart重啟后確認(rèn) gateway 在監(jiān)聽(tīng)curl http://127.0.0.1:18789/health返回{status:ok}之類的響應(yīng)就說(shuō)明 gateway 起來(lái)了。接著打開(kāi) webchat在對(duì)話里發(fā)一條能觸發(fā) shell 的指令比如!echo hello from openclaw如果返回hello from openclaw說(shuō)明elevated權(quán)限生效了對(duì)話模式能執(zhí)行外部命令。再試一條 skills 指令幫我用 agent-browser 打開(kāi) example.com 并截圖agent 如果開(kāi)始調(diào)agent-browser并返回執(zhí)行結(jié)果說(shuō)明agents和gateway兩塊配置都通了。這時(shí)候模型請(qǐng)求走的是 TaoToken 通道你可以在 TaoToken 控制臺(tái)的用量頁(yè)面看到對(duì)應(yīng)的調(diào)用記錄確認(rèn)請(qǐng)求確實(shí)從統(tǒng)一通道出去了。驗(yàn)證模型對(duì)話是否正?？梢灾苯釉?webchat 里問(wèn)一個(gè)需要推理的問(wèn)題觀察返回是否連貫。如果返回中斷或者報(bào) context 超限回去調(diào)小contextWindow。5. 本篇常見(jiàn)錯(cuò)排查gateway 起不來(lái)端口被占18789被別的進(jìn)程占了openclaw gateway restart會(huì)報(bào) bind 失敗。換端口或者lsof -i :18789找到占用進(jìn)程處理掉。webchat 連不上一直轉(zhuǎn)圈先確認(rèn)gateway.auth.token和 webchat 里填的 token 一致。token 不一致時(shí)握手會(huì)靜默失敗界面不報(bào)錯(cuò)但就是連不上。對(duì)話模式還是調(diào)不動(dòng) skills檢查list里 agent 的tools.elevated.allowFrom.webchat是不是[*]。只配defaults.elevatedDefault不夠?qū)嵗?jí)的放行才是最終生效的。模型請(qǐng)求 401TaoToken 的 Key 寫錯(cuò)了或者auth.taotoken.apiKey和models.providers.taotoken.apiKeyEnv指向的環(huán)境變量不一致。先用第 2 節(jié)的 curl 命令單獨(dú)驗(yàn) Key。改了配置沒(méi)生效OpenClaw 不會(huì)熱加載所有字段改完必須openclaw gateway restart。建議每改一個(gè)字段就跑一次openclaw doctor別攢一堆再重啟出錯(cuò)時(shí)定位困難。agent-browser 執(zhí)行超時(shí)tools.exec.timeoutSec默認(rèn)可能偏短瀏覽器操作慢的時(shí)候會(huì)被掐斷。適當(dāng)調(diào)大但別設(shè)成無(wú)限避免卡死。6. 接入與后續(xù)配置跑通之后日常改動(dòng)的節(jié)奏是改openclaw.json→openclaw doctor→openclaw gateway restart→ webchat 里發(fā)一條驗(yàn)證指令。這套流程走順了后面加 skills、調(diào)模型參數(shù)都不會(huì)再卡在權(quán)限上。如果你還沒(méi)創(chuàng)建 TaoToken 的 Key去控制臺(tái)的 API Keys 頁(yè)面建一個(gè)接入文檔里有 OpenAI 兼容調(diào)用的完整說(shuō)明。模型對(duì)話入口可以用來(lái)單獨(dú)驗(yàn)證某個(gè)模型在 TaoToken 通道上的表現(xiàn)不用每次都起 OpenClaw。長(zhǎng)期跑編碼類 agent 的話Coding Plan 的額度模型更適合連續(xù)多輪工具調(diào)用比按次計(jì)費(fèi)省心。下一篇會(huì)講怎么在openclaw.json里配channels把 webchat 之外的入口也接進(jìn)來(lái)以及session的隔離范圍怎么選。