實作指南 — 兩種路徑、真實錯誤，以及如何修正它們。

Tested on OpenClaw 2026.5.27 (WSL2/Linux)  ·  OrcaRouter plugin requires OpenClaw ≥ 2026.5.12  ·  2026年7月

Claude Fable 5 是 Anthropic 首個公開釋出的Mythos 級模型—一個高於Opus 的等級，專為長時間、多步驟、自主工作而設計。這樣的特性使其非常適合像 OpenClaw 這樣的代理框架，在該框架中，模型不僅僅是回答問題，而是規劃、呼叫工具，並在多次回合中維持連貫性。

本指南涵蓋兩種將Fable 5連接到您的OpenClaw代理的方式：直接透過Anthropic API金鑰（路徑A），以及透過OrcaRouter使用單一OpenAI相容的金鑰（路徑B）。兩者都會帶您使用相同的模型——它們在設置、成本控制和路由靈活性上有所不同。

關於驗證的備註： 路徑B已在 OpenClaw 2026.5.27 上進行了端到端測試——該部分中的每個指令區塊和錯誤訊息均來自該次執行的真實記錄。路徑A則遵循 Anthropic 和 OpenClaw 的官方文件。

首先，大多數教程跳過的事情：Fable 5 的安全保護重新路由

对于聊天机器人来说，这只是一个脚注。对于一个 代理框架 它是本指南中最重要的一部分，所以它放在最前面。

Fable 5 附帶了額外的安全措施。根據Anthropic的官方頁面，該模型包含了健全的防護措施對網路安全和生物學：在這些領域中，許多查詢會自動導向 Anthropic 的次級能力最強的模型，Claude Opus 4.8，如果被這些防護措施標記——而且您無需支付 Fable 的價格為重新導向的請求。Anthropic 更詳細地解釋了回退體驗在這篇支援文章。

這對你的 OpenClaw 代理意味著什麼

•    拒絕請求是以成功的回應送達，而非錯誤。在Claude API中，被拒絕的請求會返回一個帶有拒絕停止原因的正常回應，而不是HTTP錯誤。你的代理循環必須將其視為「重試另一個模型」，而不是「API宕機」。

•    您得到的回應可能並非 Fable 5。如果您在 OpenClaw 內比較模型時感覺回應有異，可能是安全重定向到 Opus 4.8 所致。這是預期行為，並非錯誤——在那些受限領域之外，模型表現正常。

本指南中的其他所有內容都是機械性的；這部分需要您注意。

0. 先決條件

•    OpenClaw ≥ 2026.5.12已安裝並初始化（使用 openclaw --version 檢查——本指南已在 2026.5.27 上測試）。

• 可運作的閘道（openclaw 狀態顯示可達）。

• Node 22.19+ 或 24.

•    如果您位於一個需要代理才能連線到 Anthropic / OrcaRouter 的網路環境中，請確保 閘道服務本身 能夠使用它 — 這幾乎每個人都會遇到一次（參見 §2.3）。

密钥安全规则：您需要自己生成并粘贴API密钥。切勿在截图、聊天或公共仓库中分享密钥。将密钥存储在一个只有您可读取的文件中（chmod 600），并从该文件引用它们——切勿将密钥硬编码到您可能提交的文件中。

1. 你應該選擇哪條路？

Anthropic官方金鑰

OrcaRouter 金鑰

金鑰前綴

sk-ant-

sk-orca-

可達到的模型

僅限Anthropic模型

Fable 5 + GPT / Gemini / GLM / DeepSeek…

在 OpenClaw 中設定

內建提供者

首先安裝 ClawHub 外掛程式

路由/支出政策

每個代理配置

中央控制台

原生拒絕 / 回退

一流（Anthropic 自家的 API）

取決於路由器如何呈現它

帳單

Anthropic 帳戶

OrcaRouter帳戶（單一餘額）

兩條路徑都能到達該同一模型。兩者沒有「更好」之分——它們是不同的取捨。如果你只在乎 Fable 5 這個前沿模型，且想要最純粹地使用其原生行為，請直接使用。如果你要路由多個模型，且想要一個金鑰加上集中控制，那麼路由器就值得採用。

2. 路線A — Anthropic官方API金鑰

最直接的路徑：OpenClaw直接與Anthropic溝通，無需中介。您獲得的是Anthropic提供的原始模型，包括原生拒絕與回退語義。

2.1 生成金鑰

•    在 console.anthropic.com 登入。

•    開啟 API Keys → 建立金鑰. 複製 sk-ant- 字串 (僅顯示一次).

• 在 帳單下，新增額度並設定每月上限，以免失控的代理程式耗盡您的帳戶。Fable 5 的定價為 每百萬輸入代幣10美元、每百萬輸出代幣50美元，並針對提示快取提供90%的輸入代幣折扣（來源）。

2.2 安全地儲存金鑰

將其保存在受保護的秘密檔案中，而不是內嵌貼在任何地方：

建立 ~/.openclaw_secrets 並設定權限為 600

nano ~/.openclaw_secrets

加入這一行，然後儲存：

export ANTHROPIC_API_KEY="sk-ant-..."

載入並確認（僅列印前綴，不列印完整金鑰）：

source ~/.openclaw_secrets

echo "已載入: ${ANTHROPIC_API_KEY:0:10}..."

常見錯誤：  export: '=': 不是有效的識別碼 → 你在 = 兩邊加了空格，或者使用了花引號（智能引號）。請精確使用 KEY="value" — 無空格，直ASCII引號。

2.3 讓閘道器識別金鑰（關鍵）

這是最大的陷阱。在 Linux 上，OpenClaw 閘道通常以systemd 用戶服務的形式執行。您在 shell 中匯出的變數僅存在於該 shell 中——背景服務是獨立啟動的，因此無法看到它。即使您的終端機擁有金鑰，閘道也可能沒有。

通過一個可直接放入的文件為服務提供其專屬副本：

mkdir -p ~/.config/systemd/user/openclaw-gateway.service.d/

nano ~/.config/systemd/user/openclaw-gateway.service.d/anthropic.conf

內容 — 注意 systemd 的 Environment= 語法採用字面上的 KEY=value，沒有 export，而且您必須寫下 真正的鍵，因為 $VAR 參考在這裡不會解析：

[服務]

环境="ANTHROPIC_API_KEY=sk-ant-..."

鎖定、重新加載、重新啟動：

chmod 600 ~/.config/systemd/user/openclaw-gateway.service.d/anthropic.conf

systemctl --user 守護進程重載

systemctl --user 重新啟動 openclaw-gateway

確認服務實際已加載它（僅打印前綴）：

systemctl --user show openclaw-gateway --property=Environment \

| grep -o 'ANTHROPIC_API_KEY=sk-ant-....'

2.4 將 Fable 5 設定為模型

先備份你的配置（便宜的保險），然後檢查你的構建所暴露出的確切型號參考：

cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak

openclaw 模型列表 | grep -i fable

將其設為預設，使用你剛才看到的確切引用（此處顯示為 anthropic/claude-fable-5）：

openclaw 配置設定 agents.defaults.model.primary "anthropic/claude-fable-5"

openclaw 配置驗證

systemctl --user 重新啟動 openclaw-gateway

允许列表说明： 某些設定会強制使用模型允許列表作為成本/安全防護。如果您的設定如此，請先在 agents.defaults.models 下註冊 anthropic/claude-fable-5，否則模型切換將被拒絕並顯示「not allowed」錯誤（您會在 Path B 的 §3.4 中看到實際的錯誤文字——這是相同的機制）。

2.5 測試它

openclaw agent --agent main --model "anthropic/claude-fable-5" \

--message "起草一個三階段計劃來遷移老舊服務。保持簡潔。"

規劃型提示是一個很好的初步測試——它發揮了Fable 5的優勢（長跨度、多步驟推理），而非單行提示，因為在單行提示中你幾乎不會注意到與較便宜模型的差異。

Path A — 您可能遇到的錯誤

症狀

原因

修復

401 / 認證錯誤

閘道器無法看到金鑰

將其添加到 systemd 的 drop-in（§2.3），然後重新啟動。

模型未找到

錯誤的 Fable 5 參考

從模型清單中複製確切的 ref

不允許代理使用

模型不在代理允許清單中

將其註冊在 agents.defaults.models 之下

信用/配額錯誤

無餘額或薪資上限影響

在 Anthropic 控制台中充值/提高上限

在終端機中可運作，在閘道器則失敗

Shell變數 vs. 服務環境變數

請參閱第2.3節——該服務需要自己的環境

最適用於： 貼近底層運作 — 你希望模型不受中介干預，你已身處 Anthropic 生態系統，且你需要一流的原生拒絕/回退處理權限。

3. 路徑B — OrcaRouter API金鑰（端到端驗證）

OrcaRouter是與OpenAI相容的LLM路由器：一個sk-orca-金鑰即可存取Fable 5以及來自許多其他供應商的模型，並配備伺服器端路由策略。在OpenClaw中，它作為ClawHub外掛程式提供，因此相較於路徑A，多了一個安裝步驟。以下內容是來自OpenClaw 2026.5.27的真實記錄。

3.1 安裝插件

openclaw 插件 安裝 clawhub:@continuum-ai-corp/openclaw-orcarouter

openclaw 插件列表 | grep -i orca

在信任任何第三方插件之前，檢查它能做什麼：

sailt@savor:~$ openclaw 外掛程式 檢查 orcarouter

OrcaRouter提供者

ID：orcarouter

OrcaRouter - 跨越多個LLM的自適應路由通過單一

OpenAI 相容的 API

狀態：已載入

版本: 0.1.0

能力模式：普通

舊版 before_agent_start: 否

功能:

文本推理：orcarouter

安裝：

clawhub

規格：clawhub:@continuum-ai-corp/openclaw-orcarouter

ClawHub 頻道：社群

Npm完整性：sha512-Gpu6fC30zZ8iNiEliLEj6Qbr...

在繼續之前，請先閱讀該能力區塊：該外掛宣告了單一文字推理能力，且沒有 before_agent_start 鉤子——它只是一個模型轉發器，僅此而已。它不會讀取您的檔案或執行 Shell 指令。（外掛頁面：ClawHub。）

您可能在下次運行時也會注意到這個警告：

[plugins] plugins.allow 為空；發現的非捆綁插件可能

自動載入: orcarouter (/home/sailt/.openclaw/extensions/orcarouter/

dist/index.js)。將 plugins.allow 設置為顯式的受信任 ID。

這是 OpenClaw 在告訴你尚未設定插件允許清單，因此任何發現的插件都可能自動載入。要讓它靜默——並明確你的信任——使用：

openclaw 配置 设置 插件.允許 '["orcarouter"]'

3.2 取得並儲存金鑰

產生一個 sk-orca- 金鑰從 OrcaRouter 控制台，然後以與 Path A 相同的方式儲存它：

# 位於 ~/.openclaw_secrets

匯出 ORCAROUTER_API_KEY="sk-orca-..."

3.3 將金鑰交給閘道器

與路徑A相同的重要規則——systemd服務需要自己的副本。為了整潔，將其放在單獨的drop-in中：

# ~/.config/systemd/user/openclaw-gateway.service.d/orcarouter.conf

[服務]

環境="ORCAROUTER_API_KEY=sk-orca-..."

chmod 600 ~/.config/systemd/user/openclaw-gateway.service.d/orcarouter.conf

systemctl --user 守護進程重載

systemctl --user 重新啟動 openclaw-gateway

確認服務確實能看到它：

sailt@savor:~$ systemctl --user show openclaw-gateway --property=Environment \

| grep -o 'ORCAROUTER_API_KEY=sk-orca-....'

ORCAROUTER_API_KEY=sk-orca-****

3.4 註冊並選擇 Fable 5

OrcaRouter refs 遵循 orcarouter/<vendor>/<model>。請檢查 Fable 5 的確切 ref：

sailt@savor:~$ openclaw models list | grep -i fable

orcarouter/anthropic/claude-fable-5 文字 195k 否 是 已配置

所以参考是 orcarouter/anthropic/claude-fable-5，具有通过路由器暴露的195k令牌上下文窗口。（模型页面：orcarouter.ai/models/anthropic/claude-fable-5。）

如果你跳過註冊直接嘗試使用模型，會發生這樣的情況——這是一段真實的對話記錄：

sailt@savor:~$ openclaw agent --agent main --model "orcarouter/z-ai/glm-5.2" \

--message "講個笑話給我聽"

閘道客戶端請求錯誤：錯誤：模型覆寫 "orcarouter/z-ai/glm-5.2"

不允許代理「main」。

OpenClaw 實施了每個代理模型的允許清單，作為成本/安全防護。請先註冊模型：

cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak

openclaw config set agents.defaults.models.'orcarouter/anthropic/claude-fable-5' '{}'

明白了——模型名稱中的點。  如果引用中包含版本點，config set 會將該點視為路徑分隔符號並拒絕它。實際記錄，以 GLM-5.2 為例：

sailt@savor:~$ openclaw config set \

agents.defaults.models.'orcarouter/z-ai/glm-5.2' '{}'

錯誤：配置驗證失敗：

agents.defaults.models.orcarouter/z-ai/glm-5: 無效輸入

注意參考文獻如何被截斷到 .2。Fable 5 的參考文獻沒有點，因此不受影響——但對於帶點的參考文獻，請手動編輯 ~/.openclaw/openclaw.json 以添加條目，然後執行 openclaw config validate。

然後將其設為預設值（或每次執行時傳遞 --model），驗證，重新啟動：

openclaw 設定設定 代理.預設.模型.主要 "orcarouter/anthropic/claude-fable-5"

openclaw 配置驗證

systemctl --user 重新啟動 openclaw-gateway

3.5 測試它

真實轉錄：

sailt@savor:~$ openclaw 代理程式 --agent 主要 \

--model "orcarouter/anthropic/claude-fable-5" --message "講個笑話"

OpenClaw 2026.5.27 (27ae826) — 我看過你的提交訊息。

我們會一起努力處理那件事。

一位程式設計師的妻子問他：「你能不能去商店買一條麵包」

麵包呢？如果他們還有雞蛋，就買一打。

他帶回十二條麵包。

你到底為什麼買了12條麵包？！

他們吃了雞蛋。

Fable 5，透過 OrcaRouter 在單一指令中回答。（此外：該模型的喜劇時機比我們大多數人都好。）

Path B — 你可能會遇到的錯誤

症狀

原因

修復

plugins.allow 為空（警告）

未設定外掛程式允許清單

配置設定 plugins.allow '["orcarouter"]'

未選擇目標會話

缺少 --agent

新增 --agent main

不允許用於代理 "main"

模型未註冊

添加到 agents.defaults.models（§3.4）

配置设置无效输入

模型名稱中的點被解析為路徑

手動編輯 openclaw.json，然後驗證

401 未經授權

閘道器未取得金鑰

檢查 systemd drop-in (§3.3)

模型未找到

錯誤的參考 / 不在目錄中

驗證參考資料於模型頁面

適用於： 一個金鑰用於多個供應商，在路由器控制台中集中管理路由和支出政策，而無需逐個代理配置，或針對其他供應商的模型進行Fable 5的A/B測試，而無需處理單獨的提供者金鑰。

4. 日常使用 Fable 5

4.1 選擇模型的三種方式

目標

命令

範圍

嘗試一次通話

openclaw 代理 --模型 <ref> --訊息 ...

單次執行

對話中途切換

/model <ref>  (在 TUI 內部)

當前會話

將它設為預設

設定組態 agents.defaults.model.primary <ref>

所有新會話

4.2 背景與成本說明

Fable 5 每個代幣價格昂貴而且在長時間任務中耗費大量代幣——這就是為持續數小時工作而設計的模型的本質。一些習慣可以讓帳單保持合理：

•    將它保留給那些值得使用它的任務。 使用更便宜的模型作為代理的預設設定，並在真正困難、長期執行的任務中切換到 Fable 5——透過每次執行的 --model 覆蓋，或者如果您在路徑 B 上，則透過路由策略。

•    在不相關的任務之間開始全新的會話(/new 在 TUI 中) 這樣你就不必在每次交互時都重新發送長長的歷史記錄。切換模型可以保持對話的一致性 — OpenClaw 會將文本歷史重新發送給新模型 — 而成本是根據上下文長度來計算的，不是根據你是否切換了模型。

•    監控 token 計數器。OpenClaw 會顯示每個會話的 token 使用情況；如果一次簡單的交換就消耗了數萬個 token，那通常是固定的 prompt 開銷（你的身份檔案 + 技能描述）造成的，而非模型本身的問題——值得單獨進行縮減。

• 若某則回覆感覺風格不對，請回想頂部的安全措施部分——部分在受控領域中的查詢，設計上是由 Opus 4.8 回答，且那些查詢不會以 Fable 價格向您計費。

5. 最終檢查清單

•    金鑰儲存在權限為600的機密檔案中；切勿貼上到已提交的檔案內。

•    关键也存在于网关的systemd drop-in中—— 這就是它實際運作的原因。

• 將 Fable 5 註冊於 agents.defaults.models 下，並設為主要模型。

•    openclaw config validate passes；每次配置更改後，閘道器都會重新啟動。

•    針對您所計費的帳戶設置月度支出上限。

•    (路徑 B) plugins.allow 設定為不讓任何外掛程式自動靜默載入。

人們常忽略的一件事： 你的金鑰在終端機中可使用，並不表示閘道器也擁有它。唯有透過 systemd drop-in 步驟（§2.3 / §3.3），才能讓 Fable 5 真正回應。如果你使用已知有效的金鑰卻遇到 401 錯誤，幾乎都是這個原因。

常見問題

Claude Fable 5 是否可以透過與 OpenAI 相容的 API 使用？

並非直接來自Anthropic — Anthropic透過Claude API將其提供為claude-fable-5。若要透過相容OpenAI的端點存取，請使用如OrcaRouter的路由器，其中ref為orcarouter/anthropic/claude-fable-5（上述路徑B）。

為什麼我的 Fable 5 請求回傳了不同的模型？

Fable 5 包含了网络安全和生物学的防護措施。被標記為這些領域的查詢將自動路由至 Claude Opus 4.8，且重新路由的請求不會向您收取 Fable 的價格。請參閱Anthropic 的解釋。

Claude Fable 5 每百萬個令牌的費用是多少？

每百萬輸入令牌10美元，每百萬輸出令牌50美元，提示快取可享90%的輸入令牌折扣（Anthropic）。通過路由器，在模型頁面查看即時費率。

為什麼 OpenClaw 說我的模型「不允許用於代理」？

OpenClaw 強制執行每個代理模型的允許清單。在選擇引用之前，先將其註冊到 agents.defaults.models 下（§3.4）——並留意若引用包含點號時，版本號點解析的陷阱。

🦞 給你的龍蝦一個Mythos-class大腦。