RK3588 這類 arm 開發(fā)板刷上 Armbian 之后其實已經(jīng)是一臺能跑 AI 工具鏈的小主機了。我手上這塊 NanoPi R6CRK3588、8G DDR、32G eMMC系統(tǒng)是 Armbian Ubuntu 24.03 LTS就是典型代表功耗低、常駐開機、arm64 原生支持越來越好。這篇要聊的是在這臺 arm 設(shè)備上部署 OpenClaw并且把多模型調(diào)用統(tǒng)一收斂到 TaoToken 的 Key 通道上解決一個很現(xiàn)實的問題——以前每接一個模型就要改一次配置、換一次 Key散落在好幾個文件里維護起來很煩。目標(biāo)很明確在 armbian rk3588 上跑通 OpenClaw用一份 config.toml 和 settings.json 骨架配合 CC Switch 切換最后做一次 API 連通性驗證。適合手里有 arm 開發(fā)板、想把它當(dāng)常駐 AI 牛馬用的人。1. 為什么要在 armbian 上折騰 OpenClaw先說場景。OpenClaw 這類工具本質(zhì)是一個本地跑的 AI 工作臺能接模型、能執(zhí)行任務(wù)、能開 Web UI。放在 x86 服務(wù)器上當(dāng)然也行但 RK3588 開發(fā)板的優(yōu)勢是7x24 常開不心疼電費體積小塞在角落就行armbian 又是干凈的 Debian/Ubuntu 底子apt 生態(tài)齊全。真正讓我下決心的是 Key 管理這件事。一開始我是每個模型單獨配千問一個 Key、Claude 一個 Key、別的又一個 Key散在~/.openclaw/openclaw.json、環(huán)境變量、還有幾個腳本里。換模型要翻三個地方時間一長自己都記不清哪個 Key 對應(yīng)哪個服務(wù)。后來改成走 TaoToken 統(tǒng)一通道所有模型調(diào)用都指向同一個入口配置只維護一份切換模型只改模型名Key 不動。這才是 arm 設(shè)備當(dāng)牛馬的正確姿勢——穩(wěn)定、少維護。下面按實際落地順序走先裝依賴再裝 OpenClaw然后接 TaoToken最后驗證。2. TaoToken 前置拿到統(tǒng)一 Key 和接入地址在動 OpenClaw 配置之前先把 TaoToken 這邊的準(zhǔn)備工作做完不然后面配置填不進去。你需要兩樣?xùn)|西一個 API Key和一個接入地址。Key 在控制臺生成地址用官方給的 API 入口。整個流程是注冊登錄 → 進控制臺 → 創(chuàng)建 API Key → 復(fù)制保存。具體入口我列一下方便你直接點控制臺生成和管理 Keyhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteAPI Keys 頁面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite接入文檔各語言/工具怎么填https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteAPI 的基礎(chǔ)地址是https://taotoken.net/api這個不帶任何參數(shù)配置里就填它。Key 生成后形如sk-xxxx只顯示一次記得存好。注意Key 屬于敏感憑證別提交到 git也別貼到公開的 issue 里。armbian 上建議放在~/.openclaw/目錄下并chmod 600。如果你后面要長期跑編碼類、Agent 類任務(wù)可以順帶看下 Coding Plan額度模型更適合常駐調(diào)用https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite3. armbian 環(huán)境準(zhǔn)備與 OpenClaw 安裝3.1 補齊基礎(chǔ)依賴Armbian Ubuntu 24.03 默認(rèn)沒裝 curl先補上。SSH 進設(shè)備后執(zhí)行sudo apt update sudo apt install curl -y裝完確認(rèn)一下版本能打印出來就說明 OKcurl --version3.2 安裝 OpenClaw官方提供了一鍵腳本指定 git 安裝方式curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git這一步在 arm64 上會拉源碼并編譯依賴RK3588 八核跑起來不算慢耐心等幾分鐘。3.3 踩坑一缺少 pnpm安裝過程中大概率會報找不到 pnpm。OpenClaw 的依賴管理用 pnpm單獨裝一下sudo npm install -g pnpm如果提示 npm 也沒有先裝 Node.jssudo apt install nodejs npm -y裝完 pnpm 后重新執(zhí)行 3.2 的安裝命令讓它繼續(xù)。3.4 踩坑二找不到 openclaw 命令安裝腳本跑完直接敲openclaw可能提示 command not found。這不是沒裝上而是當(dāng)前 shell 的 PATH 沒刷新。最省事的辦法是關(guān)掉當(dāng)前終端重新開一個 SSH 會話再敲openclaw --version能出版本號就說明裝好了。如果還不行手動 source 一下 profilesource ~/.bashrc4. 可復(fù)制配置config.toml 與 settings.json 骨架這是全文的核心。OpenClaw 的模型接入配置主要落在兩個文件里下面給的是可直接改的骨架把 Key 換成你自己的即可。4.1 config.toml 骨架放在~/.openclaw/config.toml# OpenClaw 主配置 - armbian/rk3588 實測骨架 [provider.taotoken] # 統(tǒng)一 Key 通道所有模型走這里 base_url https://taotoken.net/api api_key sk-你的Key # 默認(rèn)模型可被 settings.json 覆蓋 default_model claude-sonnet-4-20250514 [gateway] # 局域網(wǎng)訪問 bind lan port 18789 [gateway.controlUi] # http 訪問需要放開否則會被攔 allowInsecureAuth true幾個參數(shù)說明一下避免填錯參數(shù)作用建議值base_url模型調(diào)用入口https://taotoken.net/apiapi_key統(tǒng)一憑證控制臺生成的 sk-xxxdefault_model默認(rèn)模型按需填bind監(jiān)聽范圍lan局域網(wǎng)或 localallowInsecureAuth允許 http 訪問 UItrue4.2 settings.json 骨架放在~/.openclaw/settings.json用來做模型級別的細(xì)調(diào){ models: { default: claude-sonnet-4-20250514, fallback: qwen-plus, list: [ claude-sonnet-4-20250514, qwen-plus, gpt-4o-mini ] }, provider: taotoken, request: { timeout: 60, retry: 2 } }provider指向 config.toml 里定義的taotoken這樣模型列表和憑證就解耦了換模型只動 settings.jsonKey 永遠(yuǎn)在 config.toml 里不動。4.3 CC Switch 切換示例如果你裝了 CC SwitchClaude Code 的配置切換工具可以把它也指到同一個通道實現(xiàn)命令行和 OpenClaw 共用一份 Key。配置片段{ profiles: { taotoken: { base_url: https://taotoken.net/api, api_key: sk-你的Key, model: claude-sonnet-4-20250514 } }, active: taotoken }切換時執(zhí)行cc-switch use taotoken這樣 OpenClaw 和 CC Switch 都走 TaoTokenKey 只維護一處。CC Switch 相關(guān)的接入細(xì)節(jié)在文檔里有https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite5. 驗證請求一次 API 連通性測試配置寫完別急著開 UI先用 curl 打一次接口確認(rèn) Key 和地址都對。這一步能省掉后面一堆排查。curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的Key \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-20250514, messages: [{role: user, content: ping}], max_tokens: 16 }返回里能看到choices字段和一段回復(fù)內(nèi)容就說明通道通了。如果返回 401是 Key 問題返回 404多半是 base_url 或路徑寫錯超時則是網(wǎng)絡(luò)出口問題。接口通了之后重啟 OpenClaw 的 gateway 讓配置生效openclaw gateway restart然后瀏覽器訪問http://設(shè)備局域網(wǎng)IP:18789?tokenYOUR_TOKENYOUR_TOKEN在~/.openclaw/openclaw.json的 auth 段里。能打開 Web UI 并且模型列表正常加載就說明 arm 設(shè)備上的統(tǒng)一 Key 通道跑通了。想直接在網(wǎng)頁里試模型對話也可以走這個入口驗證https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite6. 本篇常見錯誤排查把我在 RK3588 上實際遇到的坑整理成對照表遇到問題直接查現(xiàn)象原因解決curl: command not found系統(tǒng)沒裝 curlsudo apt install curl -ypnpm: not found依賴管理器缺失sudo npm install -g pnpmopenclaw: command not foundPATH 未刷新重開終端或 source ~/.bashrc401 UnauthorizedKey 錯誤或過期重新生成并替換404 Not Foundbase_url 寫錯確認(rèn)為 https://taotoken.net/apiUI 打不開/被攔未開 allowInsecureAuth設(shè)為 true 并重啟 gateway局域網(wǎng)訪問不了bind 為 local改為 lan 后重啟模型列表為空provider 名不匹配檢查 settings.json 的 provider 字段幾個容易忽略的點改完 config.toml 一定要openclaw gateway restart不然不生效armbian 上防火墻如果開了 ufw記得放行 18789 端口sudo ufw allow 18789/tcp另外 RK3588 內(nèi)存 8G跑 OpenClaw 本身沒問題但如果同時開多個模型會話注意看下free -h必要時在 settings.json 里把并發(fā)降下來。7. 后續(xù)怎么用這套統(tǒng)一通道跑通之后日常維護就輕松了。換模型只改 settings.json 的default字段Key 永遠(yuǎn)不動要加新模型往list里加名字就行前提是 TaoToken 那邊支持。CC Switch 和 OpenClaw 共用一份憑證命令行和 Web UI 行為一致。如果后面要接 Claude Code 這類編碼工具同樣把 base_url 指向https://taotoken.net/apiKey 復(fù)用即可接入方式文檔里寫得很細(xì)https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite長期常駐跑 Agent 任務(wù)的話建議看下 Coding Plan 的額度模型比按次調(diào)用更劃算https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite最后提醒一句armbian 系統(tǒng)升級內(nèi)核后偶爾會動到網(wǎng)絡(luò)配置如果哪天 UI 突然訪問不了先ip addr看下 IP 有沒有變再檢查 gateway 是否在跑。這套東西在 RK3588 上穩(wěn)定跑了一周多沒出現(xiàn)掉線當(dāng)個安靜的 AI 牛馬挺合適。