Update README and guide for model configuration and Supabase integration; enhance setup script for fallback models

README.md

@@ -23,32 +23,34 @@ This Space runs the [OpenClaw](https://github.com/openclaw/openclaw) gateway so
    - **`OPENCLAW_GATEWAY_TOKEN`** — long random string (e.g. `openssl rand -hex 24`). Paste this in the Control UI to log in. **Recommended.** (Alternative: use `OPENCLAW_GATEWAY_PASSWORD` for password auth; if both are set, token is used.)
    - **`OPENCLAW_GATEWAY_PASSWORD`** — (optional) Gateway password; startup script sets `gateway.auth.mode: "password"`. Use when you prefer password over token.
    - **`HF_TOKEN`** — your [Hugging Face token](https://huggingface.co/settings/tokens) with **Make calls to Inference Providers**. Needed only when you want to use the Hugging Face provider; without it, choose another provider such as Gemini or OpenCode.
-   - **`GEMINI_API_KEY`** — (optional fallback) Google Gemini API key. Use this when you want Gemini as the fallback model path.
+   - **`GEMINI_API_KEY`** — (optional) Google Gemini API key. Not needed for the default DeepSeek -> Qwen -> Codex chain.
    - **`OPENCODE_API_KEY`** — (optional) OpenCode Zen API key. OpenClaw reads this directly from the gateway environment for the `opencode` provider.
    - **`SUPABASE_URL`** — (recommended) Supabase project URL for external state backup.
    - **`SUPABASE_KEY`** — (recommended) Supabase service key or project API key with insert/update access to your sync table.
-   - **`OPENCLAW_DEFAULT_MODEL`** — (optional) Generic default model ref. This repo now defaults to `gpt-codex`. Example overrides: `gpt-codex`, `google/gemini-3.1-pro-preview`, `opencode/claude-opus-4-6`, or `huggingface/Qwen/Qwen3-8B`.
+   - **`OPENCLAW_DEFAULT_MODEL`** — (optional) Primary model ref. This repo now defaults to `huggingface/Qwen/Qwen3-8B`.
+   - **`OPENCLAW_FALLBACK_MODELS`** — (optional) Comma-separated fallback model refs. This repo now defaults to `huggingface/deepseek-ai/DeepSeek-R1,gpt-codex`.
    - **`OPENCLAW_HF_DEFAULT_MODEL`** — (optional, legacy alias) Backwards-compatible alias for `OPENCLAW_DEFAULT_MODEL`. If both are set, `OPENCLAW_DEFAULT_MODEL` wins.
    - **`OPENCLAW_GATEWAY_TRUSTED_PROXIES`** — (optional) Comma-separated proxy IPs (e.g. `10.20.31.87,10.20.26.157`). The startup script writes this into `gateway.trustedProxies`; set if you see “Proxy headers detected from untrusted address” or pairing/unauthorized. Use **Variables** if you prefer (IPs need not be secret).
    - **`OPENCLAW_CONTROL_UI_ALLOWED_ORIGINS`** — (optional) Comma-separated origins (e.g. `https://your-space.hf.space`). Written to `gateway.controlUi.allowedOrigins` so only those origins can open the Control UI; useful to lock down to your Space URL.
    - **`TELEGRAM_BOT_TOKEN`** — (optional) Telegram BotFather token. This is the only Telegram setting you need for a minimal setup.
    - **`OPENCLAW_TELEGRAM_DM_POLICY`** / **`OPENCLAW_TELEGRAM_ALLOW_FROM`** / **`OPENCLAW_TELEGRAM_GROUP_POLICY`** / **`OPENCLAW_TELEGRAM_GROUP_ALLOW_FROM`** / **`OPENCLAW_TELEGRAM_REQUIRE_MENTION`** — (optional) Advanced Telegram access-control settings.
-4. **Build and run** — push to the Space repo; the Space will build and start the gateway. Startup writes config so the default model is `gpt-codex`, the Control UI accepts token-only connections (no device pairing), and Supabase sync starts automatically when `SUPABASE_URL` + `SUPABASE_KEY` are present.
+4. **Build and run** — push to the Space repo; the Space will build and start the gateway. Startup writes config so the default model chain is `Qwen3-8B -> DeepSeek-R1 -> gpt-codex`, the Control UI accepts token-only connections (no device pairing), and Supabase sync starts automatically when `SUPABASE_URL` + `SUPABASE_KEY` are present.
 
 When the logs show `listening on ws://0.0.0.0:7860`, open your Space’s URL (e.g. `https://your-username-openclaw-gateway.hf.space`) and paste the gateway token in **Settings → token** (or use `https://your-space.hf.space#token=YOUR_TOKEN`).
 
-## Codex Primary, Gemini Fallback, and Telegram
+## DeepSeek Primary, Qwen and Codex Fallback, and Telegram
 
-- **Default behavior in this repo** is now `OPENCLAW_DEFAULT_MODEL=gpt-codex`.
-- **Gemini CLI OAuth support is still present in the image**, but it is no longer documented as the primary path.
-- **Gemini fallback** should use `google/gemini-3.1-pro-preview` with `GEMINI_API_KEY` when you want a simpler non-OAuth backup path.
-- **Fallback in this wrapper currently means operational fallback, not automatic failover.** The startup script writes one primary model. If `gpt-codex` is unavailable, switch `OPENCLAW_DEFAULT_MODEL` to `google/gemini-3.1-pro-preview`.
+- **Default behavior in this repo** is now:
+  - primary: `huggingface/Qwen/Qwen3-8B`
+  - fallbacks: `huggingface/deepseek-ai/DeepSeek-R1`, `gpt-codex`
+- **The startup script now writes both `primary` and `fallbacks`.**
+- **Codex fallback only works if Codex itself is already authenticated and usable.** If `gpt-codex` still lacks auth, fallback will still fail when traffic reaches it.
 - **OpenCode Zen** also works well in Hugging Face Spaces. Set `OPENCODE_API_KEY` and use a default model such as `opencode/claude-opus-4-6`.
-- **Codex OAuth remains interactive**: if your `gpt-codex` path depends on OAuth-backed credentials, use persistent storage or Dev Mode so refreshable credentials survive restarts.
+- **Codex auth remains the special case**: if your `gpt-codex` path depends on OAuth-backed credentials, use a separate environment that can complete the login flow first, or expect the Codex fallback to fail.
 - **Telegram minimal setup** only needs `TELEGRAM_BOT_TOKEN`.
 - **Telegram advanced settings** are optional and only needed when you want allowlists, group restrictions, or mention-only behavior.
 
-Minimal example for `gpt-codex` primary + Supabase + Telegram:
+Minimal example for `Qwen -> DeepSeek -> Codex` + Supabase + Telegram:
 
 ```text
 Secrets
@@ -58,24 +60,13 @@ SUPABASE_KEY=<your supabase service key>
 TELEGRAM_BOT_TOKEN=<botfather token>
 
 Variables
-OPENCLAW_DEFAULT_MODEL=gpt-codex
+OPENCLAW_DEFAULT_MODEL=huggingface/Qwen/Qwen3-8B
+OPENCLAW_FALLBACK_MODELS=huggingface/deepseek-ai/DeepSeek-R1,gpt-codex
 OPENCLAW_CONTROL_UI_ALLOWED_ORIGINS=https://your-space.hf.space
 OPENCLAW_SUPABASE_TABLE=openclaw_state
 OPENCLAW_SYNC_INTERVAL_MS=300000
 ```
 
-If you want Telegram access controls later, add the optional `OPENCLAW_TELEGRAM_*` variables.
-
-If you want to switch the primary model to Gemini fallback mode:
-
-```text
-Secrets
-GEMINI_API_KEY=<your google ai studio key>
-
-Variables
-OPENCLAW_DEFAULT_MODEL=google/gemini-3.1-pro-preview
-```
-
 ## Keep it running 24/7
 
 - **Free hardware:** The Space will **sleep after ~48 hours** of inactivity. Anyone opening the URL will wake it.
@@ -153,6 +144,7 @@ The startup script `setup-hf-config.mjs` reads the following from **Secrets** or
 | Env variable | Config path | Format |
 |--------------|------------|--------|
 | `OPENCLAW_DEFAULT_MODEL` | `agents.defaults.model.primary` | Generic model ref string |
+| `OPENCLAW_FALLBACK_MODELS` | `agents.defaults.model.fallbacks` | Comma-separated model refs |
 | `OPENCLAW_HF_DEFAULT_MODEL` | `agents.defaults.model.primary` | Legacy alias for `OPENCLAW_DEFAULT_MODEL` |
 | `OPENCLAW_GATEWAY_TOKEN` | `gateway.auth.mode` + `gateway.auth.token` | Any string |
 | `OPENCLAW_GATEWAY_PASSWORD` | `gateway.auth.mode` + `gateway.auth.password` | Any string (token wins if both set) |

guide.md

@@ -1,68 +1,25 @@
-# OpenClaw HF Space Stable Deployment Guide
+# OpenClaw HF Space 設定指引
 
-這份指引以「穩定優先」為原則，目標是讓你的 Hugging Face Space 長期可用，並把重要資料保存在外部。
+這份是目前專案的實際配置指引。
 
-## 1. 你現在這個 repo 的預設行為
+## 模型順序
 
-- 預設模型是 `gpt-codex`
-- 主路徑是 Codex
-- `gemini-3.1-pro-preview` 是備援切換方案
-- 如果有設定 `SUPABASE_URL` 和 `SUPABASE_KEY`，會自動啟動背景同步，把 `.openclaw` 內的文字狀態檔同步到 Supabase
+目前預設模型鏈是：
 
-注意：
-
-- 目前這個 wrapper 只會寫一個 primary model
-- 所以這裡的 fallback 不是自動 failover
-- 如果 `gpt-codex` 出問題，你要手動把 `OPENCLAW_DEFAULT_MODEL` 改成 `google/gemini-3.1-pro-preview`
-
-## 2. 最穩定的建議架構
-
-- Hugging Face Space：跑 OpenClaw gateway
-- HF Persistent Storage：保存 OAuth refresh token 與本地狀態
-- Supabase：做外部備份，保存 config、session、memory、logs
-- Uptime Robot：每 30 分鐘 ping 一次 Space，降低休眠機率
-
-這樣即使 Space 重啟，主要狀態仍有兩層保護：
-
-- 本地 persistent storage
-- 外部 Supabase 備份
-
-## 3. 部署前要準備的東西
-
-你需要先準備：
-
-- 一個 Hugging Face Space，SDK 選 `Docker`
-- 一個 Supabase 專案
-- 一組你要給 `gpt-codex` 使用的憑證或 OAuth 能力
-- 一個 Google Gemini API key，作為 fallback
-- 一個 Uptime Robot 帳號
-
-## 4. Supabase 先建立資料表
-
-到 Supabase SQL Editor 執行：
-
-```sql
-create table if not exists openclaw_state (
-  path text primary key,
-  kind text not null,
-  content text not null,
-  sha256 text not null,
-  size_bytes bigint not null,
-  updated_at timestamptz not null,
-  synced_at timestamptz not null
-);
-```
+1. `huggingface/Qwen/Qwen3-8B`
+2. `huggingface/deepseek-ai/DeepSeek-R1`
+3. `gpt-codex`
 
-建好之後，記下：
-
-- `SUPABASE_URL`
-- `SUPABASE_KEY`
+注意：
 
-建議優先使用可寫入該 table 的 service role key。不要把 key 寫進 repo。
+- `Qwen` 是 primary
+- `DeepSeek` 是第一個 fallback
+- `gpt-codex` 是第二個 fallback
+- `gpt-codex` 只有在它本身已經可用時，fallback 才會成功
 
-## 5. HF Space 要放哪些檔案
+## 你在 HF Space 要放的檔案
 
-把這個資料夾的內容推到你的 Space repo，至少包含：
+至少要有：
 
 - `Dockerfile`
 - `README.md`
@@ -70,231 +27,139 @@ create table if not exists openclaw_state (
 - `sync-external-storage.mjs`
 - `guide.md`
 
-## 6. HF Space Settings 要怎麼設
+## HF Space Settings
 
 ### Secrets
 
-至少加這些：
+請加入：
 
 ```text
-OPENCLAW_GATEWAY_TOKEN=<長隨機字串>
-SUPABASE_URL=https://your-project.supabase.co
-SUPABASE_KEY=<your-supabase-service-role-key>
+OPENCLAW_GATEWAY_TOKEN=<你的 gateway token>
+HF_TOKEN=<你的 Hugging Face token>
+SUPABASE_URL=https://cpflxjkupogczhyodoov.supabase.co
+SUPABASE_KEY=<你的 supabase service_role key>
 ```
 
-可選：
+如果你要 Telegram，再加：
 
 ```text
-GEMINI_API_KEY=<只有你想改走 API key 時才需要>
-TELEGRAM_BOT_TOKEN=<如果要接 Telegram，只要這個就能先用>
-HF_TOKEN=<只有你要用 Hugging Face provider 才需要>
-OPENCODE_API_KEY=<只有你要用 OpenCode provider 才需要>
+TELEGRAM_BOT_TOKEN=<你的 telegram bot token>
 ```
 
 ### Variables
 
-建議先這樣設：
+請加入：
 
 ```text
-OPENCLAW_DEFAULT_MODEL=gpt-codex
+OPENCLAW_DEFAULT_MODEL=huggingface/Qwen/Qwen3-8B
+OPENCLAW_FALLBACK_MODELS=huggingface/deepseek-ai/DeepSeek-R1,gpt-codex
+OPENCLAW_CONTROL_UI_ALLOWED_ORIGINS=https://你的-space-url.hf.space
 OPENCLAW_SUPABASE_TABLE=openclaw_state
 OPENCLAW_SYNC_INTERVAL_MS=300000
-OPENCLAW_SYNC_MAX_FILE_BYTES=5242880
-OPENCLAW_SYNC_INCLUDE_EXTENSIONS=.json,.jsonl,.md,.txt
-OPENCLAW_CONTROL_UI_ALLOWED_ORIGINS=https://your-space-name.hf.space
 ```
 
-如果你只要最小可用 Telegram，不需要再補任何 Telegram Variables。
+## Supabase
 
-只有你想做限制時，才加這些進階設定：
+先在 Supabase SQL Editor 建這個 table：
 
-```text
-OPENCLAW_TELEGRAM_DM_POLICY=allowlist
-OPENCLAW_TELEGRAM_ALLOW_FROM=123456789
-OPENCLAW_TELEGRAM_GROUP_POLICY=allowlist
-OPENCLAW_TELEGRAM_GROUP_ALLOW_FROM=123456789
-OPENCLAW_TELEGRAM_REQUIRE_MENTION=1
+```sql
+create table if not exists openclaw_state (
+  path text primary key,
+  kind text not null,
+  content text not null,
+  sha256 text not null,
+  size_bytes bigint not null,
+  updated_at timestamptz not null,
+  synced_at timestamptz not null
+);
 ```
 
-## 7. 一定要開 Persistent Storage
-
-這一步很重要，尤其是你把主路徑放在 `gpt-codex` 時。
-
-到 HF Space 的 `Settings -> Storage`：
+`SUPABASE_KEY` 要用：
 
-- 開啟 persistent storage
-
-原因：
+- `service_role key`
 
-- 若 `gpt-codex` 走 OAuth，refresh token 需要保留
-- OpenClaw 本地狀態會寫到 `/data/.openclaw`
-- 沒有 persistent storage，Space 重建後 OAuth 很容易失效
+不要用：
 
-如果你���「穩定為主」，這步不要省。
+- `Publishable Key`
+- `Anon Key`
 
-## 8. 第一次完成 `gpt-codex` 所需登入
+## Telegram 最小可用設定
 
-這是唯一需要手動處理的重點。
-
-如果你的 `gpt-codex` 依賴互動式 OAuth，第一次通常要在有 shell 的環境完成。
-
-穩定做法：
-
-1. 先讓 Space build 完成
-2. 開啟 HF Space Dev Mode 或其他可進 shell 的方式
-3. 在容器內完成 `gpt-codex` 對應的登入流程
-4. 確認 OAuth 或 auth profile 憑證落在 persistent storage
-5. 重新啟動 Space
-
-原則上你要確保登入後產生的憑證不是只留在臨時層，而是能跟著 `/data` 保留。
-
-如果你發現每次重啟都要重登，通常就是：
-
-- 沒開 persistent storage
-- 或 auth profile / OAuth 憑證沒有寫到持久化路徑
-
-## 9. Gemini fallback 要怎麼設
-
-你現在的策略應該是：
-
-- 主模型：`gpt-codex`
-- fallback：`google/gemini-3.1-pro-preview`
-
-如果你暫時要切到 Gemini，只要改 primary model 即可。
-
-Secrets：
-
-```text
-GEMINI_API_KEY=<your-google-ai-studio-key>
-```
-
-Variables：
+如果你只是要 bot 先能用，只要：
 
 ```text
-OPENCLAW_DEFAULT_MODEL=google/gemini-3.1-pro-preview
+TELEGRAM_BOT_TOKEN=<你的 bot token>
 ```
 
-## 10. Supabase 同步實際在做什麼
-
-背景腳本會定期掃描 `.openclaw` 下面符合副檔名條件的文字檔，例如：
-
-- `openclaw.json`
-- sessions
-- memory
-- logs
-
-然後把內容 upsert 到 Supabase 的 `openclaw_state`。
-
-目前這個同步層的定位是：
-
-- 外部備份
-- 快速還原依據
-- 避免 Space 重啟後資料完全消失
+其他 `OPENCLAW_TELEGRAM_*` 都不是必填。
 
-它不是完整 DB 重構，也不是 upstream OpenClaw 原生資料庫模式。這是刻意做的，因為現在目標是穩定，不是大改架構。
+## Persistent Storage
 
-## 11. Uptime Robot 設定
+建議開啟 HF Space 的 persistent storage。
 
-到 Uptime Robot 新增一個 monitor：
-
-- Monitor Type: `HTTP(s)`
-- URL: `https://your-space-name.hf.space`
-- Monitoring Interval: `30 minutes`
-
-作用：
-
-- 定期送 GET
-- 降低因為長時間無人訪問而進入 sleep 的機率
-
-注意：
-
-- HF 免費層仍可能受平台政策影響，不保證絕不休眠
-- 真正要長時間穩定在線，還是建議付費硬體或其他常駐環境
-
-## 12. 部署完成後怎麼驗證
-
-先看 Space logs，確認幾件事：
+原因：
 
-1. `setup-hf-config.mjs` 有跑起來
-2. log 內看到 `model=gpt-codex`
-3. `auth=token` 或符合你設定的 auth 模式
-4. `supabase=1`
-5. gateway 正常 listen 在 `0.0.0.0:7860`
+- OpenClaw 狀態會存在 `/data/.openclaw`
+- 如果之後 `gpt-codex` 要用到持久化 auth，沒有 persistent storage 會不穩
 
-再檢查：
+## 部署後怎麼檢查
 
-1. 能打開 Control UI
-2. 能用 `OPENCLAW_GATEWAY_TOKEN` 登入
-3. Supabase table 有開始出現同步資料
+看 Space logs，至少確認：
 
-## 13. 常見問題排查
+1. `setup-hf-config.mjs` 有執行
+2. 出現 `model=huggingface/Qwen/Qwen3-8B`
+3. 出現 `fallbacks=2`
+4. 出現 `supabase=1`
+5. gateway listen 在 `0.0.0.0:7860`
 
-### 問題 1：Space 每次重啟後 `gpt-codex` 又要重新登入
+再確認：
 
-優先檢查：
+1. Control UI 能打開
+2. 可以用 `OPENCLAW_GATEWAY_TOKEN` 登入
+3. Supabase 的 `openclaw_state` 有同步資料
 
-- 是否已開 persistent storage
-- OAuth 或 auth profile 憑證是否真的寫到持久化路徑
-- 是否在 rebuild 後把憑證留在 ephemeral layer
+## 關於 `gpt-codex`
 
-### 問題 2：Supabase 沒有資料
+目前 `gpt-codex` 是 fallback，不是 primary。
 
-優先檢查：
+這樣做的好處是：
 
-- `SUPABASE_URL` 是否正確
-- `SUPABASE_KEY` 是否正確
-- table `openclaw_state` 是否存在
-- key 是否有 insert / update 權限
+- 主要流量先走 Qwen
+- Qwen 不行再走 DeepSeek
+- Codex 放最後
 
-### 問題 3：Control UI 能打開但連不上
+但要注意：
 
-優先檢查：
+- 如果 `gpt-codex` 還沒完成它需要的登入或授權
+- 真正切到第三個 fallback 時，仍然可能失敗
 
-- `OPENCLAW_GATEWAY_TOKEN` 是否正確
-- `OPENCLAW_CONTROL_UI_ALLOWED_ORIGINS` 是否有填對 Space URL
-- `OPENCLAW_GATEWAY_TRUSTED_PROXIES` 是否需要手動補 IP
+所以目前最穩的理解方式是：
 
-### 問題 4：`gpt-codex` 驗證不穩
+- `Qwen + DeepSeek` 保證主流程
+- `Codex` 先保留在 fallback 鏈
 
-如果你當下先要「能穩定跑」，不要硬撐互動式登入。
+## 最後的最小清單
 
-直接切回：
+### 必填 Secrets
 
 ```text
-OPENCLAW_DEFAULT_MODEL=google/gemini-3.1-pro-preview
+OPENCLAW_GATEWAY_TOKEN
+HF_TOKEN
+SUPABASE_URL
+SUPABASE_KEY
 ```
 
-再加上：
+### 必填 Variables
 
 ```text
-GEMINI_API_KEY=<your key>
+OPENCLAW_DEFAULT_MODEL=huggingface/Qwen/Qwen3-8B
+OPENCLAW_FALLBACK_MODELS=huggingface/deepseek-ai/DeepSeek-R1,gpt-codex
 ```
 
-這樣通常會比 OAuth 更容易穩定。
-
-## 14. 我建議你實際操作順序
+### 建議 Variables
 
-照這個順序最穩：
-
-1. ��� Supabase table
-2. 建 HF Space
-3. 上傳這個 repo
-4. 先設定 Secrets 和 Variables
-5. 開 persistent storage
-6. 等第一次 build 完成
-7. 進 Dev Mode 完成 `gpt-codex` 所需登入
-8. 重啟 Space
-9. 檢查 logs 和 Supabase
-10. 最後再接 Uptime Robot
-
-## 15. 最後建議
-
-如果你的目標是「長期穩定運行」，優先順序應該是：
-
-1. persistent storage
-2. gateway token auth
-3. Supabase 外部備份
-4. Uptime Robot
-5. `gpt-codex` 的 auth 持久化
-
-也就是說，OAuth 不是最先要保證的，資料持久化和可恢復性才是。
+```text
+OPENCLAW_CONTROL_UI_ALLOWED_ORIGINS=https://你的-space-url.hf.space
+OPENCLAW_SUPABASE_TABLE=openclaw_state
+OPENCLAW_SYNC_INTERVAL_MS=300000
+```

setup-hf-config.mjs

@@ -3,6 +3,7 @@
  * One-time setup for OpenClaw on Hugging Face Spaces.
  * Runs at container startup; writes or merges openclaw.json from env (Secrets/Variables):
  * - agents.defaults.model.primary from OPENCLAW_DEFAULT_MODEL / OPENCLAW_HF_DEFAULT_MODEL.
+ * - agents.defaults.model.fallbacks from OPENCLAW_FALLBACK_MODELS.
  * - gateway.auth: OPENCLAW_GATEWAY_TOKEN (token) or OPENCLAW_GATEWAY_PASSWORD (password); token wins if both set.
  * - gateway.controlUi.dangerouslyDisableDeviceAuth when auth is set (no device pairing in Spaces).
  * - gateway.trustedProxies from OPENCLAW_GATEWAY_TRUSTED_PROXIES, or default HF proxy IPs so the UI works without extra config.
@@ -48,7 +49,11 @@ function parseBoolean(raw) {
 const defaultModel =
   process.env.OPENCLAW_DEFAULT_MODEL?.trim() ||
   process.env.OPENCLAW_HF_DEFAULT_MODEL?.trim() ||
-  "gpt-codex";
+  "huggingface/Qwen/Qwen3-8B";
+const fallbackModels = parseCsv(
+  process.env.OPENCLAW_FALLBACK_MODELS?.trim() ||
+  "huggingface/deepseek-ai/DeepSeek-R1,gpt-codex",
+);
 const gatewayToken = readGatewayToken();
 const gatewayPassword = process.env.OPENCLAW_GATEWAY_PASSWORD?.trim();
 const telegramBotToken = process.env.TELEGRAM_BOT_TOKEN?.trim();
@@ -94,6 +99,7 @@ if (!config.agents) config.agents = {};
 if (!config.agents.defaults) config.agents.defaults = {};
 if (!config.agents.defaults.model) config.agents.defaults.model = {};
 config.agents.defaults.model.primary = defaultModel;
+config.agents.defaults.model.fallbacks = fallbackModels;
 
 // Auth: token wins if both set; otherwise password
 const useTokenAuth = Boolean(gatewayToken);
@@ -163,6 +169,7 @@ fs.writeFileSync(configPath, JSON.stringify(config, null, 2), "utf-8");
 const authKind = useTokenAuth ? "token" : usePasswordAuth ? "password" : "none";
 const parts = [
   `model=${defaultModel}`,
+  `fallbacks=${fallbackModels.length}`,
   `token_present=${useTokenAuth ? "1" : "0"}`,
   `password_present=${usePasswordAuth ? "1" : "0"}`,
   `auth=${authKind}`,