1. 為什么要在本地跑一個(gè) OpenClaw AI AgentOpenClaw 是一個(gè)本地優(yōu)先、頻道無(wú)關(guān)的開(kāi)源 AI Agent 平臺(tái)。簡(jiǎn)單說(shuō)它讓 AI 助手住在你自己的機(jī)器上通過(guò)你日常用的聊天 AppTelegram、Slack、Discord、飛書(shū)等 20 多個(gè)頻道響應(yīng)你的指令。它適合誰(shuí)適合想快速跑通智能體閉環(huán)、又不想把 API 密鑰和歷史記錄交給第三方 SaaS 的開(kāi)發(fā)者。我第一次接觸它的時(shí)候最直觀的感受是這東西把「模型能力」和「消息通道」徹底解耦了。Gateway 跑在本地頻道適配器負(fù)責(zé)收發(fā)消息Skills 負(fù)責(zé)擴(kuò)展能力MCP 負(fù)責(zé)對(duì)接外部工具。你換模型、換頻道、加技能都不用動(dòng)核心邏輯。但問(wèn)題也在這里。OpenClaw 默認(rèn)要你填一堆 API KeyAnthropic 的、OpenAI 的、DeepSeek 的每個(gè)模型提供商一套密鑰、一套計(jì)費(fèi)、一套限流。如果你像我一樣同時(shí)用 Claude 寫(xiě)代碼、用 DeepSeek 跑批量任務(wù)、偶爾還要切 Gemini 做多模態(tài)密鑰管理很快就會(huì)變成一團(tuán)亂麻。更麻煩的是OpenClaw 的配置文件里如果明文寫(xiě)死這些 Key一旦 Gateway 端口暴露后果不堪設(shè)想。所以這篇指南的核心思路是用 TaoToken 作為統(tǒng)一的 Key/API 通道把模型接入這一層收斂成一個(gè) Base URL 一個(gè) Key 一個(gè) Model ID。這樣 OpenClaw 只需要認(rèn)一個(gè) OpenAI 兼容端點(diǎn)剩下的模型切換、額度管理、密鑰輪換都在 TaoToken 側(cè)完成。下面我從環(huán)境準(zhǔn)備開(kāi)始一步步帶你跑通整個(gè)閉環(huán)。2. TaoToken 前置準(zhǔn)備統(tǒng)一 Key 與 API 通道在動(dòng)手裝 OpenClaw 之前先把模型接入這層理清楚。OpenClaw 支持任意 OpenAI 兼容端點(diǎn)這意味著只要你的模型服務(wù)暴露/v1/chat/completions接口就能直接接進(jìn)去。TaoToken 提供的正是這樣一個(gè)統(tǒng)一通道。你需要準(zhǔn)備三樣?xùn)|西Base URL、API Key、Model ID。這三件套在后面的 OpenClaw 配置、Lobster 工作流、以及排障環(huán)節(jié)都會(huì)反復(fù)出現(xiàn)建議先記下來(lái)。Base URL 是https://taotoken.net/api注意這里不加任何查詢(xún)參數(shù)。API Key 需要你登錄 TaoToken 控制臺(tái)在 API Keys 頁(yè)面創(chuàng)建一個(gè)。創(chuàng)建的時(shí)候建議按用途命名比如openclaw-local方便后續(xù)審計(jì)。Model ID 取決于你想用哪個(gè)模型TaoToken 的模型列表里會(huì)給出對(duì)應(yīng)的標(biāo)識(shí)符比如claude-sonnet-4-20250514、deepseek-chat這類(lèi)。我試過(guò)把 TaoToken 的 Key 直接寫(xiě)進(jìn) OpenClaw 的config.yaml結(jié)果在一次誤操作把 Gateway 監(jiān)聽(tīng)到0.0.0.0之后日志里出現(xiàn)了大量未授權(quán)請(qǐng)求。后來(lái)改成環(huán)境變量注入配合secrets.backend加密存儲(chǔ)才算踏實(shí)。所以這里強(qiáng)烈建議不要把 Key 明文寫(xiě)進(jìn)配置文件用環(huán)境變量或者 OpenClaw 的加密密鑰后端。具體操作上你可以先在 TaoToken 控制臺(tái)創(chuàng)建 Key然后本地導(dǎo)出export TAOTOKEN_API_KEYsk-你的實(shí)際密鑰 export TAOTOKEN_BASE_URLhttps://taotoken.net/api export OPENCLAW_DEFAULT_MODELclaude-sonnet-4-20250514如果你打算長(zhǎng)期跑 Agent 任務(wù)比如定時(shí)監(jiān)控 GitHub PR、自動(dòng)整理知識(shí)庫(kù)建議直接上 Coding Plan。它的額度模型更適合高頻調(diào)用場(chǎng)景不用每次手動(dòng)充值。接入文檔里有完整的端點(diǎn)說(shuō)明和錯(cuò)誤碼對(duì)照排障的時(shí)候會(huì)用到。這里有個(gè)細(xì)節(jié)OpenClaw 的onboard向?qū)?huì)問(wèn)你「選擇 AI 模型提供商」。列表里可能沒(méi)有 TaoToken 這個(gè)選項(xiàng)沒(méi)關(guān)系選「OpenAI Compatible」或者「Custom Endpoint」然后手動(dòng)填 Base URL 和 Key。向?qū)ё咄曛笤偃/.openclaw/config.yaml里核對(duì)一遍確保base_url指向的是https://taotoken.net/api而不是默認(rèn)的 OpenAI 地址。3. 可復(fù)制配置OpenClaw 接入 TaoToken 的完整片段這一節(jié)給你可以直接復(fù)制粘貼的配置。OpenClaw 的配置分兩層一層是 Gateway 的全局配置~/.openclaw/config.yaml另一層是模型提供商的定義。我建議把模型提供商單獨(dú)放在~/.openclaw/providers/taotoken.yaml這樣升級(jí) OpenClaw 的時(shí)候不會(huì)被覆蓋。先看全局配置里跟模型接入相關(guān)的部分# ~/.openclaw/config.yaml gateway: host: 127.0.0.1 port: 3000 auth: enabled: true token: ${OPENCLAW_GATEWAY_TOKEN} model: default: claude-sonnet-4-20250514 fallback: deepseek-chat provider: taotoken providers: taotoken: type: openai-compatible base_url: https://taotoken.net/api api_key: ${TAOTOKEN_API_KEY} models: - id: claude-sonnet-4-20250514 context_window: 200000 - id: deepseek-chat context_window: 64000 - id: claude-opus-4-20250514 context_window: 200000 secrets: backend: env注意gateway.host必須是127.0.0.1不要改成0.0.0.0。我見(jiàn)過(guò)太多因?yàn)閳D省事暴露公網(wǎng)導(dǎo)致 Key 泄露的案例。如果你確實(shí)需要遠(yuǎn)程訪問(wèn)用 Nginx 或 Caddy 做反向代理加 HTTPS 和認(rèn)證而不是直接暴露 Gateway 端口。如果你用的是 Docker 部署docker-compose.yml里這樣寫(xiě)# docker-compose.yml version: 3.8 services: openclaw: image: ghcr.io/openclaw/openclaw:latest restart: unless-stopped volumes: - ./config:/home/node/.openclaw environment: - TAOTOKEN_API_KEY${TAOTOKEN_API_KEY} - TAOTOKEN_BASE_URLhttps://taotoken.net/api - OPENCLAW_DEFAULT_MODELclaude-sonnet-4-20250514 - OPENCLAW_GATEWAY_TOKEN${OPENCLAW_GATEWAY_TOKEN} ports: - 127.0.0.1:3000:3000端口映射這里寫(xiě)127.0.0.1:3000:3000意思是只允許本機(jī)訪問(wèn)。如果你在 VPS 上跑想通過(guò) SSH 隧道訪問(wèn)這樣配置就夠了。配置寫(xiě)完之后跑一次openclaw config validate檢查語(yǔ)法。如果報(bào)unknown field providers說(shuō)明你的 OpenClaw 版本太老需要升級(jí)到最新版。如果報(bào)api_key not found檢查環(huán)境變量有沒(méi)有正確導(dǎo)出echo $TAOTOKEN_API_KEY確認(rèn)一下。還有一個(gè)容易踩的坑OpenClaw 的onboard向?qū)Э赡軙?huì)在config.yaml里生成一份默認(rèn)的providers段跟你手動(dòng)寫(xiě)的沖突。解決辦法是走完向?qū)е笫謩?dòng)合并或者干脆跳過(guò)向?qū)У哪Ｐ团渲貌襟E全部手寫(xiě)。我傾向于后者因?yàn)橄驅(qū)У慕换ナ絾?wèn)答在自動(dòng)化部署場(chǎng)景下很麻煩。4. 驗(yàn)證請(qǐng)求從 Gateway 狀態(tài)到 Agent 閉環(huán)配置寫(xiě)完接下來(lái)驗(yàn)證整條鏈路能不能跑通。驗(yàn)證分三步Gateway 是否起來(lái)、模型調(diào)用是否通、Agent 是否能通過(guò)頻道響應(yīng)。第一步檢查 Gateway 狀態(tài)openclaw status正常輸出應(yīng)該類(lèi)似Gateway: running (pid 12345) Host: 127.0.0.1:3000 Uptime: 2m 30s Channels: telegram (connected) Model: claude-sonnet-4-20250514 via taotoken如果Model那一行顯示unknown或者error說(shuō)明模型提供商配置沒(méi)加載成功。去看openclaw logs --tail 50通常會(huì)告訴你具體是哪個(gè)字段解析失敗。第二步直接測(cè)模型調(diào)用。OpenClaw 提供了一個(gè)openclaw invoke命令可以繞過(guò)頻道直接調(diào)模型openclaw invoke --model claude-sonnet-4-20250514 \ --prompt 用一句話(huà)解釋什么是本地優(yōu)先的 AI Agent如果返回正常文本說(shuō)明 TaoToken 通道是通的。如果報(bào)401 Unauthorized檢查 Key 是否正確、是否過(guò)期。如果報(bào)model not found檢查 Model ID 是否跟 TaoToken 模型列表里的一致。第三步配一個(gè) Telegram 頻道做端到端驗(yàn)證。在 Telegram 里找BotFather發(fā)/newbot按提示拿到 Token然后openclaw channel add telegram --token 7123456789:AAHdqTcvE-Xe_abcdefghij1234567890 openclaw restart重啟之后在 Telegram 里給你的 Bot 發(fā)一條消息比如「幫我總結(jié)一下今天的待辦」。如果 Agent 能回復(fù)說(shuō)明整條鏈路——Telegram → Gateway → TaoToken → 模型 → 返回——全部打通。我實(shí)測(cè)下來(lái)從零到跑通大概 15 分鐘前提是環(huán)境變量和配置文件沒(méi)寫(xiě)錯(cuò)。最容易出問(wèn)題的地方是base_url末尾多了斜杠或者api_key前面多了Bearer前綴。OpenClaw 的 OpenAI 兼容層會(huì)自動(dòng)加Bearer你只需要填裸 Key。驗(yàn)證通過(guò)之后你可以進(jìn)一步測(cè) Lobster 工作流。比如寫(xiě)一個(gè)最簡(jiǎn)單的hello.lobster# hello.lobster name: hello description: 最小工作流驗(yàn)證 steps: - id: greet pipeline: llm.invoke --prompt 用一句話(huà)問(wèn)候用戶(hù) - id: show run: echo $greet.stdout然后lobster run hello.lobster。如果能看到模型生成的問(wèn)候語(yǔ)被 echo 出來(lái)說(shuō)明 Lobster 引擎和模型通道都正常。這一步跑通之后你就可以開(kāi)始編排更復(fù)雜的任務(wù)了。5. 本篇常見(jiàn)錯(cuò)排查401、local proxy failed 與 OAuth 報(bào)錯(cuò)這一節(jié)整理我在部署過(guò)程中真實(shí)遇到的報(bào)錯(cuò)和解決辦法。你大概率會(huì)碰到其中一兩個(gè)。報(bào)錯(cuò)一401 Unauthorized或invalid api key這是最常見(jiàn)的。原因通常有三個(gè)Key 復(fù)制的時(shí)候帶了空格、Key 已經(jīng)過(guò)期或被撤銷(xiāo)、環(huán)境變量沒(méi)被 OpenClaw 進(jìn)程讀到。排查順序先echo $TAOTOKEN_API_KEY確認(rèn)變量存在且無(wú)空格再登錄 TaoToken 控制臺(tái)確認(rèn) Key 狀態(tài)最后檢查 OpenClaw 是不是以另一個(gè)用戶(hù)身份運(yùn)行的比如 systemd 服務(wù)默認(rèn)不繼承你的 shell 環(huán)境變量。如果是 systemd需要在 unit 文件里加EnvironmentFile/etc/openclaw/env。報(bào)錯(cuò)二local proxy failed或connection refused這個(gè)報(bào)錯(cuò)通常出現(xiàn)在 Docker 部署場(chǎng)景。容器里的127.0.0.1指向容器自身不是宿主機(jī)。如果你在宿主機(jī)上跑了什么本地代理容器是訪問(wèn)不到的。解決辦法是改用宿主機(jī)的實(shí)際 IP或者在 docker-compose 里加network_mode: host。但注意network_mode: host會(huì)讓容器直接暴露在宿主機(jī)網(wǎng)絡(luò)里安全上要額外小心。報(bào)錯(cuò)三reading choices或unexpected response format這個(gè)報(bào)錯(cuò)說(shuō)明 OpenClaw 收到了響應(yīng)但解析不出choices字段。原因可能是 TaoToken 返回的是流式響應(yīng)而 OpenClaw 的某個(gè)版本對(duì) SSE 解析有 bug。解決辦法在 provider 配置里加stream: false強(qiáng)制非流式或者升級(jí) OpenClaw 到最新版。我遇到過(guò)一次升級(jí)之后就好了。報(bào)錯(cuò)四OAuth 相關(guān)報(bào)錯(cuò)比如oauth token expired如果你在 OpenClaw 里配了 Gmail、GitHub 這類(lèi)需要 OAuth 的工具可能會(huì)碰到這個(gè)。注意OAuth 是工具層的認(rèn)證跟模型層的 TaoToken Key 是兩回事。排查的時(shí)候先確認(rèn)是哪個(gè)工具報(bào)的錯(cuò)然后重新走一遍該工具的授權(quán)流程。Lobster 的設(shè)計(jì)原則里明確說(shuō)了「不擁有任何 OAuth / Token」所有工具調(diào)用都通過(guò) OpenClaw 已有的權(quán)限體系執(zhí)行所以 OAuth 問(wèn)題要去 OpenClaw 的工具配置里找不要?jiǎng)?TaoToken 的配置。報(bào)錯(cuò)五model not found但 Model ID 明明是對(duì)的這種情況通常是 Base URL 寫(xiě)錯(cuò)了。比如寫(xiě)成了https://taotoken.net/api/v1而 OpenClaw 又自動(dòng)追加了/v1/chat/completions變成/api/v1/v1/chat/completions。正確的 Base URL 是https://taotoken.net/api不要帶/v1。另外如果你在 TaoToken 側(cè)沒(méi)有開(kāi)通某個(gè)模型的權(quán)限也會(huì)報(bào)model not found去控制臺(tái)確認(rèn)一下模型權(quán)限。排障的時(shí)候openclaw logs --tail 100是你的好朋友。日志里會(huì)打印完整的請(qǐng)求 URL 和響應(yīng)狀態(tài)碼對(duì)照上面的報(bào)錯(cuò)類(lèi)型基本能定位到問(wèn)題。如果日志里看不到敏感信息可以臨時(shí)把日志級(jí)別調(diào)到debug但記得排查完調(diào)回去。6. 用 TaoToken 統(tǒng)一通道跑通你的第一個(gè) Agent 工作流到這里環(huán)境、配置、驗(yàn)證、排障都走了一遍。最后說(shuō)一個(gè)實(shí)際的工作流例子把前面所有東西串起來(lái)。假設(shè)你想讓 OpenClaw 每天早上 9 點(diǎn)檢查指定 GitHub 倉(cāng)庫(kù)的 PR 狀態(tài)有超時(shí)未 Review 的就發(fā) Telegram 通知。這個(gè)工作流分三步Lobster 編排、TaoToken 提供模型能力、OpenClaw 負(fù)責(zé)頻道和工具調(diào)用。先寫(xiě)pr-monitor.lobster# pr-monitor.lobster name: pr-monitor description: 監(jiān)控 PR 狀態(tài)并通知 args: repo: default: myorg/myrepo steps: - id: check_prs run: openclaw.invoke --tool github --action list-open-prs --args-json {repo:${repo}} - id: summarize pipeline: llm.invoke --prompt 總結(jié)以下 PR 列表標(biāo)出超過(guò) 3 天未 Review 的 PR用 Markdown 輸出 stdin: $check_prs.json - id: notify run: openclaw.invoke --tool message --action send --args-json {provider:telegram,to:me} stdin: $summarize.stdout然后注冊(cè)定時(shí)任務(wù)openclaw cron add \ --name daily-pr-monitor \ --schedule 0 9 * * 1-5 \ --workflow pr-monitor.lobster \ --args-json {repo:myorg/api-service}這個(gè)工作流里llm.invoke那一步走的就是 TaoToken 通道。你不需要在 Lobster 文件里寫(xiě)任何 KeyOpenClaw 會(huì)從全局配置里讀providers.taotoken。這樣設(shè)計(jì)的好處是工作流文件可以提交到 Git 倉(cāng)庫(kù)不用擔(dān)心密鑰泄露換模型只需要改全局配置不用動(dòng)工作流。如果你想讓 Agent 更自主一點(diǎn)可以在 Telegram 里直接發(fā)「幫我跑一下 PR 監(jiān)控」OpenClaw 會(huì)識(shí)別意圖并調(diào)用對(duì)應(yīng)的工作流。這背后是 Skills 系統(tǒng)在起作用你可以在~/.openclaw/skills/下放SKILL.md來(lái)定義觸發(fā)規(guī)則。最后提醒一句OpenClaw 的能力來(lái)自它廣泛的權(quán)限配置不當(dāng)風(fēng)險(xiǎn)很高。確保 Gateway 只監(jiān)聽(tīng)127.0.0.1API Key 用環(huán)境變量注入第三方 Skills 只裝可信來(lái)源。把這些基礎(chǔ)打牢再用 TaoToken 統(tǒng)一模型通道你就能在一個(gè)可復(fù)現(xiàn)、可審計(jì)的環(huán)境里跑通完整的 Agent 閉環(huán)。