用服務(wù)器接入千帆大模型與APIKey配置指南)
1. 輕量應(yīng)用服務(wù)器部署 OpenClaw 到底在解決什么問(wèn)題OpenClaw 是一個(gè)能“指揮”計(jì)算機(jī)干活的開源 AI Agent你可以把它理解成一個(gè)住在服務(wù)器里的數(shù)字員工它能讀寫文件、執(zhí)行 Shell 命令、維護(hù)跨會(huì)話記憶還能通過(guò)消息平臺(tái)跟你對(duì)話。但很多人第一次接觸它時(shí)卡住的地方往往不是“它是什么”而是“我該怎么把它跑起來(lái)并且讓它真的能調(diào)用大模型”。這就是輕量應(yīng)用服務(wù)器 千帆大模型這套組合的價(jià)值所在。輕量應(yīng)用服務(wù)器提供了一臺(tái)開箱即用的機(jī)器鏡像里已經(jīng)預(yù)置了 OpenClaw 的運(yùn)行環(huán)境千帆大模型則負(fù)責(zé)提供推理能力讓 OpenClaw 的對(duì)話和任務(wù)執(zhí)行有“大腦”可用。兩者之間靠 APIKey 打通而 18789 端口則是你訪問(wèn) OpenClaw 控制臺(tái)網(wǎng)頁(yè)的入口。我實(shí)測(cè)下來(lái)整個(gè)流程里最容易出問(wèn)題的三個(gè)點(diǎn)分別是APIKey 填錯(cuò)位置、18789 端口沒(méi)放行、以及模型配置后沒(méi)有真正驗(yàn)證調(diào)用是否成功。這篇內(nèi)容就圍繞這三個(gè)點(diǎn)展開把每一步都寫成可以直接復(fù)制粘貼的操作適合剛拿到服務(wù)器、還沒(méi)跑通第一條對(duì)話的小白。先明確一下適合誰(shuí)看如果你手上有一臺(tái)輕量應(yīng)用服務(wù)器想部署一個(gè)能長(zhǎng)期在線、能調(diào)用千帆大模型的 AI Agent并且希望通過(guò)網(wǎng)頁(yè)控制臺(tái)直接和它聊天那這篇就是為你寫的。如果你只是想本地跑個(gè) demo那用本地環(huán)境更省事但如果你想要 7×24 小時(shí)在線、能接消息平臺(tái)、能執(zhí)行后臺(tái)任務(wù)的 Agent服務(wù)器部署才是正解。OpenClaw 基于 Moltbot 框架核心能力包括文件操作read/write/edit、終端執(zhí)行exec、內(nèi)存管理MEMORY.md 和 memory/YYYY-MM-DD.md、跨會(huì)話協(xié)作sessions_spawn。這些能力決定了它不是那種“只會(huì)在聊天框里回話”的機(jī)器人而是能真正動(dòng)你服務(wù)器上文件和命令的 Agent。所以部署時(shí)對(duì)權(quán)限和端口的管理要格外小心尤其是 18789 端口對(duì)應(yīng)的控制臺(tái)鏈接里面帶著身份驗(yàn)證憑據(jù)泄露出去等于把管理員權(quán)限交出去。下面從環(huán)境準(zhǔn)備開始一步步走到驗(yàn)證模型調(diào)用成功。2. TaoToken 前置準(zhǔn)備與千帆大模型 APIKey 獲取在正式配置 OpenClaw 之前需要先把“模型側(cè)”的憑據(jù)準(zhǔn)備好。OpenClaw 本身不生產(chǎn)模型能力它只是一個(gè)調(diào)度框架真正干活的是背后的大模型 API。這里有兩種主流接法一種是直接用千帆大模型的 APIKey另一種是通過(guò) TaoToken 這類聚合入口來(lái)統(tǒng)一管理模型調(diào)用。TaoToken 的定位是模型調(diào)用入口官網(wǎng)地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。它的好處是你可以在一個(gè)地方管理多個(gè)模型的 Key不用在千帆、其他模型平臺(tái)之間來(lái)回切換。對(duì)于 OpenClaw 這種需要頻繁調(diào)用模型的 Agent 來(lái)說(shuō)統(tǒng)一入口能省掉不少配置上的麻煩。如果你選擇直接用千帆大模型流程是這樣的進(jìn)入千帆控制臺(tái)開通大模型服務(wù)然后在 APIKey 管理頁(yè)面創(chuàng)建一個(gè)新的 Key。這個(gè) Key 通常以特定前綴開頭創(chuàng)建后只顯示一次務(wù)必當(dāng)場(chǎng)復(fù)制保存。如果你用的是 CodingPlan 方式需要先在千帆控制臺(tái)完成訂閱并生成專屬 APIKey再回到輕量應(yīng)用服務(wù)器的實(shí)例詳情頁(yè)刷新系統(tǒng)會(huì)自動(dòng)識(shí)別可用的 CodingPlan。如果你選擇通過(guò) TaoToken 接入操作路徑是先到 https://taotoken.net/api-keys 創(chuàng)建 APIKey這個(gè)頁(yè)面就是專門管理 Key 的地方。創(chuàng)建完成后你會(huì)拿到一串 Key后面在 OpenClaw 的環(huán)境變量里會(huì)用到它。TaoToken 的模型對(duì)話入口在 https://taotoken.net/chat 你可以先用這個(gè)頁(yè)面測(cè)試 Key 是否有效確認(rèn)能正常對(duì)話后再去配置 OpenClaw這樣能避免“到底是 Key 錯(cuò)了還是 OpenClaw 配錯(cuò)了”這種排查困境。這里有個(gè)關(guān)鍵點(diǎn)無(wú)論你用哪種方式最終 OpenClaw 需要的是三件套——Base URL、APIKey、Model ID。Base URL 決定請(qǐng)求發(fā)到哪里APIKey 決定你有沒(méi)有權(quán)限Model ID 決定用哪個(gè)模型。這三者缺一不可而且必須匹配。比如你拿的是千帆的 KeyBase URL 就要指向千帆的接口地址如果你用 TaoTokenBase URL 就指向 https://taotoken.net/api 。對(duì)于長(zhǎng)期編碼或 Agent 場(chǎng)景可以考慮 Coding Plan入口在 https://taotoken.net/coding-plan 。它的優(yōu)勢(shì)是適合高頻調(diào)用不用每次擔(dān)心 Token 用量。如果你的 OpenClaw 只是偶爾聊聊天按量計(jì)費(fèi)也夠用但如果你打算讓它長(zhǎng)期在線、頻繁執(zhí)行任務(wù)Coding Plan 更劃算。準(zhǔn)備好 Key 之后先別急著往 OpenClaw 里填。建議先在模型對(duì)話頁(yè)面發(fā)一條測(cè)試消息確認(rèn) Key 能正常返回結(jié)果。這一步花不了一分鐘但能幫你排除掉后面一半的報(bào)錯(cuò)。確認(rèn) Key 有效后再進(jìn)入服務(wù)器配置環(huán)節(jié)。3. 可復(fù)制配置環(huán)境變量、APIKey 填寫位置與 18789 端口放行這一節(jié)是整篇的核心所有配置都寫成可以直接復(fù)制的形式。先說(shuō)明一點(diǎn)輕量應(yīng)用服務(wù)器的 OpenClaw 鏡像通常已經(jīng)預(yù)裝了運(yùn)行環(huán)境你不需要從零編譯只需要改配置、放行端口、啟動(dòng)服務(wù)。首先是環(huán)境變量配置。OpenClaw 讀取模型配置的方式通常是通過(guò)環(huán)境變量或配置文件。以環(huán)境變量為例你可以在服務(wù)器的 shell 里執(zhí)行以下命令把 Base URL、APIKey、Model ID 寫進(jìn)去。注意把引號(hào)里的內(nèi)容替換成你自己的實(shí)際值export OPENCLAW_BASE_URLhttps://taotoken.net/api export OPENCLAW_API_KEYsk-你的實(shí)際APIKey export OPENCLAW_MODEL_ID你的模型ID如果你希望這些變量在每次登錄時(shí)自動(dòng)生效可以把它們寫進(jìn)~/.bashrc或~/.profile文件末尾。用編輯器打開文件追加同樣的 export 語(yǔ)句保存后執(zhí)行source ~/.bashrc讓配置立即生效。如果你更習(xí)慣用配置文件的方式OpenClaw 通常會(huì)在用戶目錄下讀取一個(gè) JSON 或 TOML 格式的配置。以 JSON 為例路徑可能是~/.openclaw/config.json內(nèi)容結(jié)構(gòu)如下{ model: { base_url: https://taotoken.net/api, api_key: sk-你的實(shí)際APIKey, model_id: 你的模型ID }, gateway: { port: 18789 } }注意這里的base_url末尾不要多加斜杠api_key要完整復(fù)制不要帶空格。model_id必須和你在模型平臺(tái)看到的 ID 完全一致大小寫敏感。如果你用的是千帆 CodingPlanBase URL 和 Model ID 以千帆控制臺(tái)顯示的為準(zhǔn)如果你用 TaoTokenBase URL 就是https://taotoken.net/api。接下來(lái)是 18789 端口放行。OpenClaw 的控制臺(tái)網(wǎng)頁(yè)通過(guò) 18789 端口訪問(wèn)如果防火墻沒(méi)放行你在瀏覽器里會(huì)看到連接超時(shí)或拒絕訪問(wèn)。在輕量應(yīng)用服務(wù)器的管理控制臺(tái)里找到“防火墻”或“安全組”設(shè)置添加一條入站規(guī)則協(xié)議選 TCP端口填 18789來(lái)源可以先填0.0.0.0/0方便測(cè)試但正式使用時(shí)建議限制為你的固定 IP避免控制臺(tái)鏈接被掃描到。如果你習(xí)慣用命令行操作也可以用ufw或firewalld放行。以u(píng)fw為例sudo ufw allow 18789/tcp sudo ufw reload放行之后用sudo ufw status確認(rèn)規(guī)則已經(jīng)生效。如果你用的是云廠商的安全組命令行放行還不夠必須在控制臺(tái)的安全組里也加一條規(guī)則兩層都放行才能訪問(wèn)。配置完成后啟動(dòng) OpenClaw 服務(wù)。常用命令如下openclaw gateway install openclaw gateway start openclaw gateway statusinstall會(huì)安裝服務(wù)并設(shè)置開機(jī)自啟start啟動(dòng)服務(wù)status查看運(yùn)行狀態(tài)。如果狀態(tài)顯示 running說(shuō)明服務(wù)已經(jīng)起來(lái)了。如果啟動(dòng)失敗用openclaw logs --follow查看日志日志里通常會(huì)直接告訴你哪一項(xiàng)配置有問(wèn)題。這里要提醒一句控制臺(tái)鏈接里包含身份驗(yàn)證憑據(jù)任何拿到鏈接的人都能繞過(guò)登錄直接進(jìn)入管理員控制臺(tái)。所以不要把鏈接發(fā)到公開群組或截圖分享測(cè)試完成后如果不再需要外網(wǎng)訪問(wèn)可以把 18789 端口的來(lái)源限制為你的 IP。4. 驗(yàn)證請(qǐng)求確認(rèn) OpenClaw 真的調(diào)用了千帆大模型配置寫完、服務(wù)啟動(dòng)不代表模型調(diào)用就成功了。很多人卡在“服務(wù)是 running但對(duì)話沒(méi)反應(yīng)”這個(gè)狀態(tài)。所以這一步要做的是主動(dòng)驗(yàn)證模型調(diào)用鏈路是否打通。最直接的驗(yàn)證方式是通過(guò)控制臺(tái)網(wǎng)頁(yè)發(fā)一條消息。在瀏覽器里打開http://你的服務(wù)器IP:18789如果端口放行正確、服務(wù)正常運(yùn)行你會(huì)看到 OpenClaw 的控制臺(tái)界面。在對(duì)話框里輸入一句簡(jiǎn)單的話比如“你好請(qǐng)回復(fù)你的模型名稱”然后觀察返回。如果返回正常說(shuō)明 Base URL、APIKey、Model ID 三件套都配對(duì)了。如果返回報(bào)錯(cuò)根據(jù)錯(cuò)誤類型判斷401 通常是 APIKey 無(wú)效或沒(méi)填對(duì)404 通常是 Base URL 或 Model ID 寫錯(cuò)超時(shí)通常是網(wǎng)絡(luò)不通或端口沒(méi)放行。除了網(wǎng)頁(yè)驗(yàn)證也可以用命令行直接測(cè)試模型接口排除 OpenClaw 本身的干擾。用curl發(fā)一個(gè)請(qǐng)求到 TaoToken 的 APIcurl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的實(shí)際APIKey \ -H Content-Type: application/json \ -d { model: 你的模型ID, messages: [{role: user, content: 你好}] }如果這條命令能返回正常的 JSON 結(jié)果說(shuō)明 Key 和 Base URL 沒(méi)問(wèn)題問(wèn)題就出在 OpenClaw 的配置讀取上。如果這條命令也報(bào)錯(cuò)那就要先解決 Key 或網(wǎng)絡(luò)的問(wèn)題。還有一種驗(yàn)證方式是查看 OpenClaw 的日志。執(zhí)行openclaw logs --follow然后在網(wǎng)頁(yè)里發(fā)一條消息觀察日志里有沒(méi)有出現(xiàn)模型請(qǐng)求的記錄。如果日志里顯示請(qǐng)求發(fā)出去了但返回錯(cuò)誤錯(cuò)誤信息會(huì)直接告訴你原因。如果日志里根本沒(méi)有請(qǐng)求記錄說(shuō)明 OpenClaw 沒(méi)有讀到模型配置需要檢查環(huán)境變量或配置文件路徑是否正確。我試過(guò)的一個(gè)常見(jiàn)坑是環(huán)境變量寫進(jìn)了~/.bashrc但 OpenClaw 是以服務(wù)方式啟動(dòng)的服務(wù)啟動(dòng)時(shí)不會(huì)加載用戶的 bashrc導(dǎo)致讀不到變量。解決辦法是把配置寫進(jìn) OpenClaw 自己的配置文件或者在服務(wù)的 systemd unit 里通過(guò)Environment指定變量。用openclaw gateway install安裝的服務(wù)通常會(huì)在/etc/systemd/system/下生成 unit 文件你可以編輯它在[Service]段里加上EnvironmentOPENCLAW_BASE_URLhttps://taotoken.net/api EnvironmentOPENCLAW_API_KEYsk-你的實(shí)際APIKey EnvironmentOPENCLAW_MODEL_ID你的模型ID改完后執(zhí)行sudo systemctl daemon-reload和openclaw gateway restart讓配置生效。這樣無(wú)論服務(wù)以什么方式啟動(dòng)都能讀到正確的變量。驗(yàn)證成功后你可以在控制臺(tái)里讓 OpenClaw 執(zhí)行一個(gè)簡(jiǎn)單任務(wù)比如“列出當(dāng)前目錄下的文件”觀察它是否能調(diào)用 exec 能力并返回結(jié)果。這一步能同時(shí)驗(yàn)證模型調(diào)用和 Agent 執(zhí)行鏈路。5. 本篇常見(jiàn)錯(cuò)誤排查401、local proxy failed、reading choices、OAuth這一節(jié)把部署過(guò)程中最常遇到的幾類報(bào)錯(cuò)集中列出來(lái)對(duì)照著排查能省很多時(shí)間。第一類是 401 錯(cuò)誤。報(bào)錯(cuò)信息通常是401 Unauthorized或invalid api key。原因基本只有一個(gè)APIKey 不對(duì)?？赡苁菑?fù)制時(shí)漏了字符、帶了空格、或者 Key 已經(jīng)過(guò)期被禁用。解決辦法是回到 APIKey 管理頁(yè)面重新生成一個(gè)然后完整替換配置里的值。如果你用的是 TaoToken到 https://taotoken.net/api-keys 重新創(chuàng)建如果用千帆到千帆控制臺(tái)的 APIKey 頁(yè)面重新生成。替換后重啟服務(wù)再試。第二類是local proxy failed或類似的連接失敗報(bào)錯(cuò)。這通常意味著 OpenClaw 嘗試請(qǐng)求模型接口但網(wǎng)絡(luò)不通。先確認(rèn) Base URL 寫對(duì)了TaoToken 的地址是https://taotoken.net/api不要寫成別的路徑。然后確認(rèn)服務(wù)器能正常訪問(wèn)外網(wǎng)可以用curl -I https://taotoken.net/api測(cè)試連通性。如果服務(wù)器本身沒(méi)有外網(wǎng)出口那任何模型調(diào)用都會(huì)失敗需要先解決網(wǎng)絡(luò)問(wèn)題。第三類是reading choices相關(guān)的報(bào)錯(cuò)比如error reading choices或返回結(jié)構(gòu)解析失敗。這類錯(cuò)誤通常出現(xiàn)在模型返回的 JSON 結(jié)構(gòu)和 OpenClaw 預(yù)期的結(jié)構(gòu)不一致時(shí)?？赡艿脑蚴?Model ID 寫錯(cuò)了導(dǎo)致請(qǐng)求發(fā)到了錯(cuò)誤的模型端點(diǎn)或者 Base URL 指向了一個(gè)不兼容 OpenAI 格式的接口。解決辦法是確認(rèn) Model ID 和 Base URL 匹配并且接口兼容 OpenAI 的 chat completions 格式。TaoToken 的接口是兼容的所以用https://taotoken.net/api作為 Base URL 時(shí)Model ID 填對(duì)即可。第四類是 OAuth 相關(guān)報(bào)錯(cuò)。如果你在配置消息平臺(tái)飛書、釘釘、企業(yè)微信、QQ時(shí)遇到 OAuth 授權(quán)失敗先檢查你填的 App ID、App Secret、回調(diào)地址是否和平臺(tái)后臺(tái)一致。消息平臺(tái)配置是可選項(xiàng)如果你暫時(shí)不需要接入這些平臺(tái)可以先跳過(guò)專注把網(wǎng)頁(yè)控制臺(tái)的模型調(diào)用跑通。等核心鏈路穩(wěn)定后再回來(lái)配消息平臺(tái)。除了這四類還有一個(gè)高頻問(wèn)題是 18789 端口訪問(wèn)不了。表現(xiàn)是瀏覽器一直轉(zhuǎn)圈或提示連接被拒絕。排查順序是先確認(rèn) OpenClaw 服務(wù)在運(yùn)行openclaw gateway status再確認(rèn)服務(wù)器本機(jī)防火墻放行了 18789sudo ufw status最后確認(rèn)云廠商安全組也放行了 18789。三層都確認(rèn)后用curl http://localhost:18789在服務(wù)器本機(jī)測(cè)試如果本機(jī)能通但外網(wǎng)不通那問(wèn)題一定在安全組或防火墻。還有一個(gè)容易忽略的點(diǎn)控制臺(tái)鏈接里的憑據(jù)。如果你把鏈接分享出去后又想收回權(quán)限光改端口是不夠的需要在 OpenClaw 里重新生成憑據(jù)或重啟服務(wù)讓舊鏈接失效。具體方式取決于 OpenClaw 的版本通常在配置里可以重置。排查時(shí)養(yǎng)成看日志的習(xí)慣。openclaw logs --follow會(huì)實(shí)時(shí)輸出請(qǐng)求和錯(cuò)誤大部分問(wèn)題在日志里都有明確提示。比起盲目改配置先看日志能快很多。6. 長(zhǎng)期使用建議與模型調(diào)用入口選擇把 OpenClaw 跑起來(lái)只是第一步真正決定體驗(yàn)的是模型調(diào)用的穩(wěn)定性和成本。如果你只是偶爾用網(wǎng)頁(yè)控制臺(tái)聊幾句按量計(jì)費(fèi)完全夠用但如果你打算讓 OpenClaw 長(zhǎng)期在線、接消息平臺(tái)、頻繁執(zhí)行任務(wù)那模型調(diào)用的頻率會(huì)高很多這時(shí)候統(tǒng)一入口和套餐方式就值得考慮。TaoToken 的模型對(duì)話入口在 https://taotoken.net/chat 你可以用它快速測(cè)試不同模型的效果找到最適合你任務(wù)的 Model ID?？刂婆_(tái)在 https://taotoken.net/console APIKey 管理在 https://taotoken.net/api-keys 接入文檔在 https://taotoken.net/doc 。這幾個(gè)頁(yè)面建議收藏后面改配置、換模型、排查 Key 問(wèn)題都會(huì)用到。對(duì)于長(zhǎng)期編碼或 Agent 場(chǎng)景Coding Plan 的入口是 https://taotoken.net/coding-plan 。它的邏輯是提前鎖定用量適合高頻調(diào)用。你可以先估算一下 OpenClaw 每天的請(qǐng)求量如果每天幾十次以上套餐方式通常比按量更省心。另外OpenClaw 的 Skills 配置也值得花點(diǎn)時(shí)間。輕量應(yīng)用服務(wù)器默認(rèn)提供百度搜索、百度百科等 Skills你可以按需啟用。如果默認(rèn)的不夠用可以清空輸入框自行輸入 Skills或者到 OpenClaw 官網(wǎng)獲取更多。Skills 決定了 Agent 能調(diào)用哪些外部能力配得好能讓它從“會(huì)聊天”變成“能干活”。最后提醒一句控制臺(tái)鏈接的憑據(jù)安全。部署完成后如果不再需要外網(wǎng)訪問(wèn)把 18789 端口的來(lái)源限制為你的固定 IP如果鏈接曾經(jīng)泄露過(guò)及時(shí)重置憑據(jù)。OpenClaw 能執(zhí)行 Shell 命令和文件操作權(quán)限泄露的后果比普通聊天機(jī)器人嚴(yán)重得多。整個(gè)流程走下來(lái)核心就是三件事Key 配對(duì)、端口放行、驗(yàn)證調(diào)用。把這三步做扎實(shí)后面換模型、加 Skills、接消息平臺(tái)都是在這個(gè)基礎(chǔ)上擴(kuò)展。 快速部署OpenClaw：輕量應(yīng)用服務(wù)器接入千帆大模型與APIKey配置指南
1. 輕量應(yīng)用服務(wù)器部署 OpenClaw 到底在解決什么問(wèn)題OpenClaw 是一個(gè)能“指揮”計(jì)算機(jī)干活的開源 AI Agent你可以把它理解成一個(gè)住在服務(wù)器里的數(shù)字員工它能讀寫文件、執(zhí)行 Shell 命令、維護(hù)跨會(huì)話記憶還能通過(guò)消息平臺(tái)跟你對(duì)話。但很多人第一次接觸它時(shí)卡住的地方往往不是“它是什么”而是“我該怎么把它跑起來(lái)并且讓它真的能調(diào)用大模型”。這就是輕量應(yīng)用服務(wù)器 千帆大模型這套組合的價(jià)值所在。輕量應(yīng)用服務(wù)器提供了一臺(tái)開箱即用的機(jī)器鏡像里已經(jīng)預(yù)置了 OpenClaw 的運(yùn)行環(huán)境千帆大模型則負(fù)責(zé)提供推理能力讓 OpenClaw 的對(duì)話和任務(wù)執(zhí)行有“大腦”可用。兩者之間靠 APIKey 打通而 18789 端口則是你訪問(wèn) OpenClaw 控制臺(tái)網(wǎng)頁(yè)的入口。我實(shí)測(cè)下來(lái)整個(gè)流程里最容易出問(wèn)題的三個(gè)點(diǎn)分別是APIKey 填錯(cuò)位置、18789 端口沒(méi)放行、以及模型配置后沒(méi)有真正驗(yàn)證調(diào)用是否成功。這篇內(nèi)容就圍繞這三個(gè)點(diǎn)展開把每一步都寫成可以直接復(fù)制粘貼的操作適合剛拿到服務(wù)器、還沒(méi)跑通第一條對(duì)話的小白。先明確一下適合誰(shuí)看如果你手上有一臺(tái)輕量應(yīng)用服務(wù)器想部署一個(gè)能長(zhǎng)期在線、能調(diào)用千帆大模型的 AI Agent并且希望通過(guò)網(wǎng)頁(yè)控制臺(tái)直接和它聊天那這篇就是為你寫的。如果你只是想本地跑個(gè) demo那用本地環(huán)境更省事但如果你想要 7×24 小時(shí)在線、能接消息平臺(tái)、能執(zhí)行后臺(tái)任務(wù)的 Agent服務(wù)器部署才是正解。OpenClaw 基于 Moltbot 框架核心能力包括文件操作read/write/edit、終端執(zhí)行exec、內(nèi)存管理MEMORY.md 和 memory/YYYY-MM-DD.md、跨會(huì)話協(xié)作sessions_spawn。這些能力決定了它不是那種“只會(huì)在聊天框里回話”的機(jī)器人而是能真正動(dòng)你服務(wù)器上文件和命令的 Agent。所以部署時(shí)對(duì)權(quán)限和端口的管理要格外小心尤其是 18789 端口對(duì)應(yīng)的控制臺(tái)鏈接里面帶著身份驗(yàn)證憑據(jù)泄露出去等于把管理員權(quán)限交出去。下面從環(huán)境準(zhǔn)備開始一步步走到驗(yàn)證模型調(diào)用成功。2. TaoToken 前置準(zhǔn)備與千帆大模型 APIKey 獲取在正式配置 OpenClaw 之前需要先把“模型側(cè)”的憑據(jù)準(zhǔn)備好。OpenClaw 本身不生產(chǎn)模型能力它只是一個(gè)調(diào)度框架真正干活的是背后的大模型 API。這里有兩種主流接法一種是直接用千帆大模型的 APIKey另一種是通過(guò) TaoToken 這類聚合入口來(lái)統(tǒng)一管理模型調(diào)用。TaoToken 的定位是模型調(diào)用入口官網(wǎng)地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。它的好處是你可以在一個(gè)地方管理多個(gè)模型的 Key不用在千帆、其他模型平臺(tái)之間來(lái)回切換。對(duì)于 OpenClaw 這種需要頻繁調(diào)用模型的 Agent 來(lái)說(shuō)統(tǒng)一入口能省掉不少配置上的麻煩。如果你選擇直接用千帆大模型流程是這樣的進(jìn)入千帆控制臺(tái)開通大模型服務(wù)然后在 APIKey 管理頁(yè)面創(chuàng)建一個(gè)新的 Key。這個(gè) Key 通常以特定前綴開頭創(chuàng)建后只顯示一次務(wù)必當(dāng)場(chǎng)復(fù)制保存。如果你用的是 CodingPlan 方式需要先在千帆控制臺(tái)完成訂閱并生成專屬 APIKey再回到輕量應(yīng)用服務(wù)器的實(shí)例詳情頁(yè)刷新系統(tǒng)會(huì)自動(dòng)識(shí)別可用的 CodingPlan。如果你選擇通過(guò) TaoToken 接入操作路徑是先到 https://taotoken.net/api-keys 創(chuàng)建 APIKey這個(gè)頁(yè)面就是專門管理 Key 的地方。創(chuàng)建完成后你會(huì)拿到一串 Key后面在 OpenClaw 的環(huán)境變量里會(huì)用到它。TaoToken 的模型對(duì)話入口在 https://taotoken.net/chat 你可以先用這個(gè)頁(yè)面測(cè)試 Key 是否有效確認(rèn)能正常對(duì)話后再去配置 OpenClaw這樣能避免“到底是 Key 錯(cuò)了還是 OpenClaw 配錯(cuò)了”這種排查困境。這里有個(gè)關(guān)鍵點(diǎn)無(wú)論你用哪種方式最終 OpenClaw 需要的是三件套——Base URL、APIKey、Model ID。Base URL 決定請(qǐng)求發(fā)到哪里APIKey 決定你有沒(méi)有權(quán)限Model ID 決定用哪個(gè)模型。這三者缺一不可而且必須匹配。比如你拿的是千帆的 KeyBase URL 就要指向千帆的接口地址如果你用 TaoTokenBase URL 就指向 https://taotoken.net/api 。對(duì)于長(zhǎng)期編碼或 Agent 場(chǎng)景可以考慮 Coding Plan入口在 https://taotoken.net/coding-plan 。它的優(yōu)勢(shì)是適合高頻調(diào)用不用每次擔(dān)心 Token 用量。如果你的 OpenClaw 只是偶爾聊聊天按量計(jì)費(fèi)也夠用但如果你打算讓它長(zhǎng)期在線、頻繁執(zhí)行任務(wù)Coding Plan 更劃算。準(zhǔn)備好 Key 之后先別急著往 OpenClaw 里填。建議先在模型對(duì)話頁(yè)面發(fā)一條測(cè)試消息確認(rèn) Key 能正常返回結(jié)果。這一步花不了一分鐘但能幫你排除掉后面一半的報(bào)錯(cuò)。確認(rèn) Key 有效后再進(jìn)入服務(wù)器配置環(huán)節(jié)。3. 可復(fù)制配置環(huán)境變量、APIKey 填寫位置與 18789 端口放行這一節(jié)是整篇的核心所有配置都寫成可以直接復(fù)制的形式。先說(shuō)明一點(diǎn)輕量應(yīng)用服務(wù)器的 OpenClaw 鏡像通常已經(jīng)預(yù)裝了運(yùn)行環(huán)境你不需要從零編譯只需要改配置、放行端口、啟動(dòng)服務(wù)。首先是環(huán)境變量配置。OpenClaw 讀取模型配置的方式通常是通過(guò)環(huán)境變量或配置文件。以環(huán)境變量為例你可以在服務(wù)器的 shell 里執(zhí)行以下命令把 Base URL、APIKey、Model ID 寫進(jìn)去。注意把引號(hào)里的內(nèi)容替換成你自己的實(shí)際值export OPENCLAW_BASE_URLhttps://taotoken.net/api export OPENCLAW_API_KEYsk-你的實(shí)際APIKey export OPENCLAW_MODEL_ID你的模型ID如果你希望這些變量在每次登錄時(shí)自動(dòng)生效可以把它們寫進(jìn)~/.bashrc或~/.profile文件末尾。用編輯器打開文件追加同樣的 export 語(yǔ)句保存后執(zhí)行source ~/.bashrc讓配置立即生效。如果你更習(xí)慣用配置文件的方式OpenClaw 通常會(huì)在用戶目錄下讀取一個(gè) JSON 或 TOML 格式的配置。以 JSON 為例路徑可能是~/.openclaw/config.json內(nèi)容結(jié)構(gòu)如下{ model: { base_url: https://taotoken.net/api, api_key: sk-你的實(shí)際APIKey, model_id: 你的模型ID }, gateway: { port: 18789 } }注意這里的base_url末尾不要多加斜杠api_key要完整復(fù)制不要帶空格。model_id必須和你在模型平臺(tái)看到的 ID 完全一致大小寫敏感。如果你用的是千帆 CodingPlanBase URL 和 Model ID 以千帆控制臺(tái)顯示的為準(zhǔn)如果你用 TaoTokenBase URL 就是https://taotoken.net/api。接下來(lái)是 18789 端口放行。OpenClaw 的控制臺(tái)網(wǎng)頁(yè)通過(guò) 18789 端口訪問(wèn)如果防火墻沒(méi)放行你在瀏覽器里會(huì)看到連接超時(shí)或拒絕訪問(wèn)。在輕量應(yīng)用服務(wù)器的管理控制臺(tái)里找到“防火墻”或“安全組”設(shè)置添加一條入站規(guī)則協(xié)議選 TCP端口填 18789來(lái)源可以先填0.0.0.0/0方便測(cè)試但正式使用時(shí)建議限制為你的固定 IP避免控制臺(tái)鏈接被掃描到。如果你習(xí)慣用命令行操作也可以用ufw或firewalld放行。以u(píng)fw為例sudo ufw allow 18789/tcp sudo ufw reload放行之后用sudo ufw status確認(rèn)規(guī)則已經(jīng)生效。如果你用的是云廠商的安全組命令行放行還不夠必須在控制臺(tái)的安全組里也加一條規(guī)則兩層都放行才能訪問(wèn)。配置完成后啟動(dòng) OpenClaw 服務(wù)。常用命令如下openclaw gateway install openclaw gateway start openclaw gateway statusinstall會(huì)安裝服務(wù)并設(shè)置開機(jī)自啟start啟動(dòng)服務(wù)status查看運(yùn)行狀態(tài)。如果狀態(tài)顯示 running說(shuō)明服務(wù)已經(jīng)起來(lái)了。如果啟動(dòng)失敗用openclaw logs --follow查看日志日志里通常會(huì)直接告訴你哪一項(xiàng)配置有問(wèn)題。這里要提醒一句控制臺(tái)鏈接里包含身份驗(yàn)證憑據(jù)任何拿到鏈接的人都能繞過(guò)登錄直接進(jìn)入管理員控制臺(tái)。所以不要把鏈接發(fā)到公開群組或截圖分享測(cè)試完成后如果不再需要外網(wǎng)訪問(wèn)可以把 18789 端口的來(lái)源限制為你的 IP。4. 驗(yàn)證請(qǐng)求確認(rèn) OpenClaw 真的調(diào)用了千帆大模型配置寫完、服務(wù)啟動(dòng)不代表模型調(diào)用就成功了。很多人卡在“服務(wù)是 running但對(duì)話沒(méi)反應(yīng)”這個(gè)狀態(tài)。所以這一步要做的是主動(dòng)驗(yàn)證模型調(diào)用鏈路是否打通。最直接的驗(yàn)證方式是通過(guò)控制臺(tái)網(wǎng)頁(yè)發(fā)一條消息。在瀏覽器里打開http://你的服務(wù)器IP:18789如果端口放行正確、服務(wù)正常運(yùn)行你會(huì)看到 OpenClaw 的控制臺(tái)界面。在對(duì)話框里輸入一句簡(jiǎn)單的話比如“你好請(qǐng)回復(fù)你的模型名稱”然后觀察返回。如果返回正常說(shuō)明 Base URL、APIKey、Model ID 三件套都配對(duì)了。如果返回報(bào)錯(cuò)根據(jù)錯(cuò)誤類型判斷401 通常是 APIKey 無(wú)效或沒(méi)填對(duì)404 通常是 Base URL 或 Model ID 寫錯(cuò)超時(shí)通常是網(wǎng)絡(luò)不通或端口沒(méi)放行。除了網(wǎng)頁(yè)驗(yàn)證也可以用命令行直接測(cè)試模型接口排除 OpenClaw 本身的干擾。用curl發(fā)一個(gè)請(qǐng)求到 TaoToken 的 APIcurl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的實(shí)際APIKey \ -H Content-Type: application/json \ -d { model: 你的模型ID, messages: [{role: user, content: 你好}] }如果這條命令能返回正常的 JSON 結(jié)果說(shuō)明 Key 和 Base URL 沒(méi)問(wèn)題問(wèn)題就出在 OpenClaw 的配置讀取上。如果這條命令也報(bào)錯(cuò)那就要先解決 Key 或網(wǎng)絡(luò)的問(wèn)題。還有一種驗(yàn)證方式是查看 OpenClaw 的日志。執(zhí)行openclaw logs --follow然后在網(wǎng)頁(yè)里發(fā)一條消息觀察日志里有沒(méi)有出現(xiàn)模型請(qǐng)求的記錄。如果日志里顯示請(qǐng)求發(fā)出去了但返回錯(cuò)誤錯(cuò)誤信息會(huì)直接告訴你原因。如果日志里根本沒(méi)有請(qǐng)求記錄說(shuō)明 OpenClaw 沒(méi)有讀到模型配置需要檢查環(huán)境變量或配置文件路徑是否正確。我試過(guò)的一個(gè)常見(jiàn)坑是環(huán)境變量寫進(jìn)了~/.bashrc但 OpenClaw 是以服務(wù)方式啟動(dòng)的服務(wù)啟動(dòng)時(shí)不會(huì)加載用戶的 bashrc導(dǎo)致讀不到變量。解決辦法是把配置寫進(jìn) OpenClaw 自己的配置文件或者在服務(wù)的 systemd unit 里通過(guò)Environment指定變量。用openclaw gateway install安裝的服務(wù)通常會(huì)在/etc/systemd/system/下生成 unit 文件你可以編輯它在[Service]段里加上EnvironmentOPENCLAW_BASE_URLhttps://taotoken.net/api EnvironmentOPENCLAW_API_KEYsk-你的實(shí)際APIKey EnvironmentOPENCLAW_MODEL_ID你的模型ID改完后執(zhí)行sudo systemctl daemon-reload和openclaw gateway restart讓配置生效。這樣無(wú)論服務(wù)以什么方式啟動(dòng)都能讀到正確的變量。驗(yàn)證成功后你可以在控制臺(tái)里讓 OpenClaw 執(zhí)行一個(gè)簡(jiǎn)單任務(wù)比如“列出當(dāng)前目錄下的文件”觀察它是否能調(diào)用 exec 能力并返回結(jié)果。這一步能同時(shí)驗(yàn)證模型調(diào)用和 Agent 執(zhí)行鏈路。5. 本篇常見(jiàn)錯(cuò)誤排查401、local proxy failed、reading choices、OAuth這一節(jié)把部署過(guò)程中最常遇到的幾類報(bào)錯(cuò)集中列出來(lái)對(duì)照著排查能省很多時(shí)間。第一類是 401 錯(cuò)誤。報(bào)錯(cuò)信息通常是401 Unauthorized或invalid api key。原因基本只有一個(gè)APIKey 不對(duì)?？赡苁菑?fù)制時(shí)漏了字符、帶了空格、或者 Key 已經(jīng)過(guò)期被禁用。解決辦法是回到 APIKey 管理頁(yè)面重新生成一個(gè)然后完整替換配置里的值。如果你用的是 TaoToken到 https://taotoken.net/api-keys 重新創(chuàng)建如果用千帆到千帆控制臺(tái)的 APIKey 頁(yè)面重新生成。替換后重啟服務(wù)再試。第二類是local proxy failed或類似的連接失敗報(bào)錯(cuò)。這通常意味著 OpenClaw 嘗試請(qǐng)求模型接口但網(wǎng)絡(luò)不通。先確認(rèn) Base URL 寫對(duì)了TaoToken 的地址是https://taotoken.net/api不要寫成別的路徑。然后確認(rèn)服務(wù)器能正常訪問(wèn)外網(wǎng)可以用curl -I https://taotoken.net/api測(cè)試連通性。如果服務(wù)器本身沒(méi)有外網(wǎng)出口那任何模型調(diào)用都會(huì)失敗需要先解決網(wǎng)絡(luò)問(wèn)題。第三類是reading choices相關(guān)的報(bào)錯(cuò)比如error reading choices或返回結(jié)構(gòu)解析失敗。這類錯(cuò)誤通常出現(xiàn)在模型返回的 JSON 結(jié)構(gòu)和 OpenClaw 預(yù)期的結(jié)構(gòu)不一致時(shí)?？赡艿脑蚴?Model ID 寫錯(cuò)了導(dǎo)致請(qǐng)求發(fā)到了錯(cuò)誤的模型端點(diǎn)或者 Base URL 指向了一個(gè)不兼容 OpenAI 格式的接口。解決辦法是確認(rèn) Model ID 和 Base URL 匹配并且接口兼容 OpenAI 的 chat completions 格式。TaoToken 的接口是兼容的所以用https://taotoken.net/api作為 Base URL 時(shí)Model ID 填對(duì)即可。第四類是 OAuth 相關(guān)報(bào)錯(cuò)。如果你在配置消息平臺(tái)飛書、釘釘、企業(yè)微信、QQ時(shí)遇到 OAuth 授權(quán)失敗先檢查你填的 App ID、App Secret、回調(diào)地址是否和平臺(tái)后臺(tái)一致。消息平臺(tái)配置是可選項(xiàng)如果你暫時(shí)不需要接入這些平臺(tái)可以先跳過(guò)專注把網(wǎng)頁(yè)控制臺(tái)的模型調(diào)用跑通。等核心鏈路穩(wěn)定后再回來(lái)配消息平臺(tái)。除了這四類還有一個(gè)高頻問(wèn)題是 18789 端口訪問(wèn)不了。表現(xiàn)是瀏覽器一直轉(zhuǎn)圈或提示連接被拒絕。排查順序是先確認(rèn) OpenClaw 服務(wù)在運(yùn)行openclaw gateway status再確認(rèn)服務(wù)器本機(jī)防火墻放行了 18789sudo ufw status最后確認(rèn)云廠商安全組也放行了 18789。三層都確認(rèn)后用curl http://localhost:18789在服務(wù)器本機(jī)測(cè)試如果本機(jī)能通但外網(wǎng)不通那問(wèn)題一定在安全組或防火墻。還有一個(gè)容易忽略的點(diǎn)控制臺(tái)鏈接里的憑據(jù)。如果你把鏈接分享出去后又想收回權(quán)限光改端口是不夠的需要在 OpenClaw 里重新生成憑據(jù)或重啟服務(wù)讓舊鏈接失效。具體方式取決于 OpenClaw 的版本通常在配置里可以重置。排查時(shí)養(yǎng)成看日志的習(xí)慣。openclaw logs --follow會(huì)實(shí)時(shí)輸出請(qǐng)求和錯(cuò)誤大部分問(wèn)題在日志里都有明確提示。比起盲目改配置先看日志能快很多。6. 長(zhǎng)期使用建議與模型調(diào)用入口選擇把 OpenClaw 跑起來(lái)只是第一步真正決定體驗(yàn)的是模型調(diào)用的穩(wěn)定性和成本。如果你只是偶爾用網(wǎng)頁(yè)控制臺(tái)聊幾句按量計(jì)費(fèi)完全夠用但如果你打算讓 OpenClaw 長(zhǎng)期在線、接消息平臺(tái)、頻繁執(zhí)行任務(wù)那模型調(diào)用的頻率會(huì)高很多這時(shí)候統(tǒng)一入口和套餐方式就值得考慮。TaoToken 的模型對(duì)話入口在 https://taotoken.net/chat 你可以用它快速測(cè)試不同模型的效果找到最適合你任務(wù)的 Model ID?？刂婆_(tái)在 https://taotoken.net/console APIKey 管理在 https://taotoken.net/api-keys 接入文檔在 https://taotoken.net/doc 。這幾個(gè)頁(yè)面建議收藏后面改配置、換模型、排查 Key 問(wèn)題都會(huì)用到。對(duì)于長(zhǎng)期編碼或 Agent 場(chǎng)景Coding Plan 的入口是 https://taotoken.net/coding-plan 。它的邏輯是提前鎖定用量適合高頻調(diào)用。你可以先估算一下 OpenClaw 每天的請(qǐng)求量如果每天幾十次以上套餐方式通常比按量更省心。另外OpenClaw 的 Skills 配置也值得花點(diǎn)時(shí)間。輕量應(yīng)用服務(wù)器默認(rèn)提供百度搜索、百度百科等 Skills你可以按需啟用。如果默認(rèn)的不夠用可以清空輸入框自行輸入 Skills或者到 OpenClaw 官網(wǎng)獲取更多。Skills 決定了 Agent 能調(diào)用哪些外部能力配得好能讓它從“會(huì)聊天”變成“能干活”。最后提醒一句控制臺(tái)鏈接的憑據(jù)安全。部署完成后如果不再需要外網(wǎng)訪問(wèn)把 18789 端口的來(lái)源限制為你的固定 IP如果鏈接曾經(jīng)泄露過(guò)及時(shí)重置憑據(jù)。OpenClaw 能執(zhí)行 Shell 命令和文件操作權(quán)限泄露的后果比普通聊天機(jī)器人嚴(yán)重得多。整個(gè)流程走下來(lái)核心就是三件事Key 配對(duì)、端口放行、驗(yàn)證調(diào)用。把這三步做扎實(shí)后面換模型、加 Skills、接消息平臺(tái)都是在這個(gè)基礎(chǔ)上擴(kuò)展。