源起
就像之前章節所提到,因為 token 的性價比,使得許多老牌以及新創的 AI 服務公司,快速地發展出大量符合不同需求及不同價格的 AI 模型,來爭取在市場上存活的機會;大量數百個可用的 AI 模型提供了 OpenClaw 更差異化、個人化、社區化的使用市場;這是封閉型 AI Agent 無法達到的市場 (例如 Anthropic Cowork)。我相信這也是 nVidia 在不到半年的時間就快速地推出"nemoClawd"的一個重要的啇業原因。
OpenRouter 是什麼
因為市場上有很多 AI 模型要跟 OpenClaw 的使用者或是 AI 應用的開發人員來配對,所以就會有 AI 模型的仲介公司提供這個服務;使用者不需要一個一個去各個不同設計風格的網頁瞭解各家模型的能力、特點,取得 API Key,然後使用各種不同的模型使用計算方式,在每一家公司都累積了一堆儲值金。 AI 模型仲介公司提供使用者「一站購足」的地方,將所有在市場上的 AI 模型一字排開,所有模型的特點、適合範圍、市佔率、價格,都清楚地標示出來;使者用使用一致的界面,用同一個計費流程,刷一次卡用使用數十甚至上百種模型;而且也不需要時時去確認 AI 服務公司是否有改版或新增模型,而要手動自己去改變 OpenClaw 的設定。這樣子在 AI token provider 以及終端使用中間的服務公司,目前大家最熟知的就是 "OpenRouter"。我請小蝦把 OpenRouter 和 OpenClaw 的協同工作模式畫成以下的圖。OpenRouter 提供一組特殊的 AI 模型,這組模型取代原來 OpenClaw 使用者的手動設定,依照使用者的需求動態地將適當的 AI 服務提供給使用者。

OpenRouter 這家公司不僅提供市場上主力 AI 產品媒介適當需求者的平台,也提供了一個讓新創 AI 公司可以提供使用者說明以及產品及試用的地方;同時,因為它有最多 Token Provider 的使用狀況,所以它也常常提供市場調查公司或是媒體即時的 Token 的"銷售狀況" ,作為使用者或投資人的參考;而且它供應的 AI 模型名單,會隨時 AI 服務公司的產品更動以及策略變化動態調整,不會讓你多付一毛錢。它的計價服務及企業服務;如下表所列,如果 AI 服務公司所提供的是免費的 AI 模型,它也不會收取服務費;等於使用者的 Token 費用為零:

OpenRouter 的協同工作模式:自動/免費/指定
- 自動模型模式
OpenRouter 透過一個特殊的 AI 模型 ("openrouter/auto"),提供使用者自動模型選擇的工作模式,OpenClaw 裝好了這個模型,它就依照你的需求 (性價比最高、成本最低、反應最快、最會推理) 以及你對模型的偏好 (例如說你偏好使用中國公司或是美國公司的模型),來自動動態地幫你調用模型;同時,你也可以在 OpenRouter 網頁上,即時看到你所使用的模型有那些,它的用量以及成本。


- 免費模型模式
除了自動切換付費模型以外,我覺得最好的事情是,你可以用它另一個特殊模型 ("openrouter/free"),只切換使用免費的模型,而且不用服務費;把你 Token 的成本直接降為零。這些免費 AI 模型其實效能也不差,例如 nVidia 的模型反應速度都還不錯;不過免費模型一般來說都只能聊天或查資料,沒有辦法使用圖片作為輸入。我很習慣把這個模型使用模式放在 OpenClaw 最後一個備份模型,保證小蝦可能因為没力了,反應會變慢但永遠不會當機。

- 指定模型
如果自己經有申請 AI token provider 公司,也有了有效的 API Key,你也可以透過 OpenRouter 的 BYOK (Bring Your Own Key) 服務,使用自己 AI 模型;它的這個特殊 AI 型名稱是"openrouter/[模型名稱]";例如,我在之前一直使用的 Mistral 公司的模型因為更新改名,原來的組態沒辦法使用,自己手動去改又一直搞不定。後來,我把原來 直接透過 OpenRouter 指定 Mistral 的 AI 模型很簡單就完成了;只要先在的 "BYOK" 頁面測試 API Key 有效之,再把用 "open router/[模型名稱]"寫進 openclaw.json 組態檔就可以,其他的參數設定都會由 OpenRouter 搞定。

對我這種有管理潔癖的人來說,不用在自己的電腦文字組態檔中存取 Key API,可以有統一管理 API Key的管道,是件相當貼心的服務,而且 OpenClaw 的模型組態也可以變得很簡潔。特別是如果 AI 模型有版本或名稱變更的時候,我們不必到處去找這些新的參數要如何改才能使用,OpenRouter 提供 API Key 的測試機制以並且設定好所有的參數。在使用指定模型 (BYOK) 的時候,OpenRouter 並不會收取服務費,你也可以使用所有原來 AI 模型公司提供的優惠方案都沒有問題,不過,所有成本及流量的管理都要回到原來的 AI 模型公司來處理;OpenRouter 也不會提供流量報表。
後話
在安裝程序說明前,我先把使用的一些感想寫在前面。目前我主要是使用 OpenRouter 的服務是 Bring Your Own Key 作為 OperClaw 跟 Token Provider 的 MiddleWare,雖然會有約 0.2 秒左右的 delay,但是我覺得這樣的結構,會比較符合我希望 OpenClaw 跟使用者端的 Passive Framework 架構,比較不會產生交談過程塞車的問題。不過我也問一下 Gemini ,這樣的作法和原來直接連結 Token provider 的差異,它給出來的比較是這樣;

這問題我就沒有問小蝦了,反正他們是同一個人。
另外,常常在談論的也是 OpenClaw 跟 Open AI 或 Gemini 到底有什麼差別?這於這種科普的問題,我也是作弊地問了 Gemini,它給了一個簡單的比較表。

當我們使用 OpenClaw 越久,就發現跟之前使用 OpenAI 或 Gemini 的使用感覺差異越大;雖然是同一個大腦,但是設計的架構不同,有不同的行為;例如:當我們在問 Gemini 問題時,他會很快回覆或是會看到有東西在一直在轉,我們會比較安心地等待,畢竟是大公司,總會給個交代;但是,我們在請小蝦 (它是連蘋果都不支援了的 Intel Core 5 iMac Mini) 作事的時候,如果事情不難,你也可以看到他 "typing"一下,就會回答了;但是如果事情不是短時間可以解決,他會自己跑去作事,沒有訊號出來也沒有什麼東西在轉來轉去;然後老板又問你什麼時候有結果,同事又在找吃午餐,你叫小蝦他也只回你"正在作";一直叫他又很煩,怎麼辦?很想給他重開機。對使用者來說,如何去安排一個適當的機制,來減少這種 AI Agent 行為造成使用者的焦慮,我們下次再講;下個段落先講安裝。
OpenRouter 安裝程序
- 申請 OpenRouter 的 API Key
先到 OpenRouter 網站申請會員之後,找到 API Key 的申請,API Key 只會出現一次,之後在網站任何地方都不會再出現,所以一定要自己記錄下來。然後,依照流程申請;在付費的地方,可以先用儲值的方式來進行,我是先存 10 美金,然後也可以設定每月使用上限;如果沒有儲值或設定扣款,是沒辦法使用自動模型的功能。
- 備份模型
安裝 OpenRouter 因為會改到核心的模型,所以一定要把
- ".openclaw/openclaw.json"
- ".openclaw/agents/main/agent/auth-profiles.json"、
- ".openclaw/agents/main/agent/models.json"
這三個檔案備份下來;在安裝過程當中,如果有任何問題,只要把這三個檔案回覆回去,就會回到原來模型的狀況。
- 建立空白模型
因為 OpenRouter 的特殊 AI 模型不在 OpenClaw 的預定表列中,所以安裝上簡單起見。先把所有已裝好的模型清空,使用一個單純的環境來安裝。首先要把 openclaw.json 裏面的 "models" 整個區塊全部刪除,然後在 "agents"區塊中有關 model 的部份也全部刪除,只留下"workspace",大概長這樣。

整個"models"區塊都刪除了。存檔後,把這個乾淨的 openclaw.json 檔備份起來,例如叫"openclaw.json.clean.bak",然後把 ".openclaw/agents/main/agent/auth-profiles.json" 檔案刪掉。
cp openclaw.json openclaw.json.clean.bak
cd ~/.openclaw/agents/main/agent
rm auth-profiles.json
- 建立 OpenRouter 模型
先下指令把 openclaw 先停掉;在空白模型的狀況下,加入 "openrouter/auto"。因為 OpenRouter 的特殊模型不在 openclaw 2026.3.13 提供的模型名單中,所以要用 "openclaw onboard" 的 Quick 模式,重走一次安裝過程,記得在命令列就要提供 OpenRouter 的 API Key。
openclaw gateway stop
openclaw onboard --auth-choice apiKey --token-provider openrouter --token [你的 OpenRouter API Key]
執行完,會產生 "/.openclaw/agents/main/agent/auth-profiles.json" 這個檔,看一下內容,是不是已經把 OpenRouter 的 API Key 記下來。
然後,打開 "openclaw.json",應該就可以看到有"openrouter/auto",這個模型。如果沒有的話,就自己加上去,像這樣;

然後,重啟 openclaw。如果沒有出現錯誤訊息,表示已經建立好 OpenRouter 和 OpenClaw 之間的連結。
打開 Telegram,key in "/new",重啟新的對話;就可以看到目前在使用的模型轉到 "openrouter/auto"。
openclaw models list
openclaw gateway start


- 設定模型選擇偏好原則
你可以在可以在 OpenRouter 的"Routing" 網頁設定選擇模型的條件、順序和偏好和是否要要將某個模型設為 Default 模型;不過,經驗上 Default model 建議不要去設,因為有時候你設的模型很忙或者設錯名字,OpenClaw 就會當機;如果你真的偏好某個模型,一定要用它;建議使用 OpenRouter 的 "BYOK (Bring Your Own Key)" 服務。

- 使用免費的模型
在 OpenRouter 也有一些免費模型;所以,它也提供了另一個 "openrouter/free"的自動使用免費模型的方法;安裝上沒辦法在對話框來進行,只能手動,但是很簡單;只要把 "openclaw.json"檔案裏面所有的 "openrouter/auto"字串,改成 "openrouter/free"就可以了,然後重啟 openclam;就可以了。 不過,免費的模型基本上都不會有圖形輸入的功能。
vi openclaw.json
openclaw models list
openclaw gateway restart
這時候,我們再去看 OpenRouter 網頁,token 成本直接降為 0.

除了免費模型一般比較慢以外,也没有圖形功能;對於使用 openrouter/free ,OpenRouter 是不收平台服務費,也有一些使用限制;可以參考它的網頁說明。
- 切換模式的組態設定
如果想要切換這兩種模式 (Auto/Free),可以把 openclaw.json 改成有兩個備用模型,像這樣子。

然後在 Telegram 下達"/models",就可以在對話過程中切換模式。或是個性比較強勢的人,也可以在命令列下切換模型 ("openclaw models set openrouter/auto")、重啟服務 ("openclaw gateway restart"),就可以了。
同樣的方式,如果你有使用 "BYOK" 服務,就把你的指定模型加在組態檔 ("openclaw.json") 中"models" 這個區塊就好了。以我自己的組態檔為例,如下圖所示。





















