Free Ride - Unlimited free AI

• 您想在不支付 LLM API 訂閱費用的情況下使用 OpenClaw，並且可以接受免費方案的速率限制。
• 您在免費模型上遇到速率限制，希望透過自動備援切換來避免工作階段中斷。
• 您想快速試驗不同的免費模型（例如 qwen3-coder、nvidia/nemotron），而無需手動編輯設定檔。
• 您想要一個「設定後即可忘懷」的配置，讓 OpenRouter 的智慧路由器自動為每個請求選擇最佳可用的免費模型。

• 您需要有保障的 SLA、低延遲或穩定的吞吐量——免費模型使用共享容量，可用性難以預測。
• 您並未使用 OpenClaw；Free Ride - Unlimited free AI 會直接寫入 openclaw.json，並與 OpenClaw 生態系緊密耦合。

執行 freeride auto 即可自動擷取最新的 OpenRouter 免費模型清單，依品質進行排名，將最佳模型設為主要模型，並建立一份排序後的備用清單——全部只需一個步驟即可完成。

FreeRide 預設最多設定 5 個備援模型（可透過 -c 參數調整）。第一個備援模型始終為 openrouter/free，即 OpenRouter 自有的智慧路由器，確保當某個模型達到速率限制時，請求能自動重新路由。

~/.openclaw/openclaw.json 中只有三個鍵會被修改：agents.defaults.model.primary、agents.defaults.model.fallbacks 以及 agents.defaults.models。其他所有內容——閘道、頻道、外掛程式、環境變數及自訂指示——均會完整保留。

使用 freeride switch <model> 將特定免費模型設為主要模型，或使用 freeride switch <model> -f 僅將其新增為備用模型，而不變更目前的主要模型。

freeride-watcher 常駐程式會持續監控頻率限制事件並自動輪換模型，您也可以使用 freeride-watcher --rotate 手動觸發輪換。

執行 freeride auto，接著執行 openclaw gateway restart，即可立即將 OpenClaw 切換至免費的程式設計專用模型，例如 qwen3-coder。繼續正常使用 OpenClaw — 當達到速率限制時，系統會自動靜默切換備用模型，不會中斷您的工作階段。

使用 freeride list -n 30 查看所有可用的免費模型（依品質排序），再用 freeride switch <model> 試用特定模型。隨時在 OpenClaw 內輸入 /status 查看目前使用中的模型狀態。

如果您已經設定了偏好的模型，請執行 freeride auto -f，這樣可以在不更動主要模型的情況下，將目前最佳的免費選項填入備援清單中。

在執行長時間任務之前，先啟用 freeride-watcher --daemon，讓監控程式在背景持續偵測速率限制事件，並自動輪換備用模型，無需手動介入即可維持工作階段持續運作。