一份实践指南——两条路径、真实错误以及如何修复它们。

已在OpenClaw 2026.5.27（WSL2/Linux）上测试 · OrcaRouter插件要求OpenClaw ≥ 2026.5.12 · 2026年7月

Claude Fable 5 是 Anthropic 首次公开发布的 Mythos-class模型——该等级位于高于 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 密钥 → 创建密钥。复制 sk-ant- 字符串（仅显示一次）。

• 在 账单， 添加信用额度并设置每月上限，以免失控代理耗尽您的账户。Fable 5 的定价为每百万输入代币10美元，每百万输出代币50美元， 提示缓存可享受90%的输入代币折扣 (来源).

2.2 安全存储密钥

将其保存在受保护的机密文件中，而不是将其内联粘贴到任何地方：

touch ~/.openclaw_secrets && chmod 600 ~/.openclaw_secrets

nano ~/.openclaw_secrets

添加此行，然后保存：

导出 ANTHROPIC_API_KEY="sk-ant-..."

加载并确认（仅打印前缀，绝不打印完整密钥）：

执行 ~/.openclaw_secrets

echo "已加载: ${ANTHROPIC_API_KEY:0:10}..."

常见错误：export: '=': not a valid identifier → 你在等号两侧加了空格，或者使用了卷曲的“智能引号”。请严格使用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 daemon-reload

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 config set agents.defaults.model.primary "anthropic/claude-fable-5"

openclaw 配置验证

systemctl --user 重启 openclaw-gateway

允许列表备注：某些设置会强制使用模型允许列表作为成本/安全防护。如果你的设置如此，请先在 agents.defaults.models 下注册 anthropic/claude-fable-5，否则模型切换会被拒绝并显示“不允许”错误（你将在路径 B 的第 3.4 节看到实际错误文本——这是同样的机制）。

2.5 测试它

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

起草一个三阶段计划，用于迁移遗留服务。保持简洁。

计划型提示是一个很好的初步测试——它能发挥Fable 5的优势（长周期、多步骤推理），而不是一句你几乎看不出与更便宜模型区别的简短台词。

Path A — 你可能遇到的错误

症状

原因

修复

401 / 认证错误

网关无法看到密钥

将其添加到 systemd drop-in（§2.3），然后重启

未找到模型

错误的 Fable 5 引用

从模型列表中复制确切的引用

不允许代理使用

模型不在代理允许列表中。

将其注册到 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 提供商

标识：orcarouter

OrcaRouter - 跨多个LLM的自适应路由通过单一

兼容OpenAI的API。

状态：已加载

版本：0.1.0

能力模式：普通

旧版代理启动前: 否

能力：

文本推理: 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 配置设置 plugins.allow '["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 daemon-reload

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 引用遵循 orcarouter/<vendor>/<model>。请检查 Fable 5 的确切引用：

sailt@savor:~$ openclaw 模型列表 | grep -i fable

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

因此，参考是 orcarouter/anthropic/claude-fable-5，通过路由器暴露的上下文窗口为 195k token。（模型页面：orcarouter.ai/models/anthropic/claude-fable-5。）

如果您跳过注册而直接尝试使用模型，会发生以下情况——这是一份真实记录：

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

给我讲个笑话

网关客户端请求错误：错误：模型覆盖 "orcarouter/z-ai/glm-5.2"

不允许代理"main"。

OpenClaw 强制实施每个代理的模型允许列表，作为成本/安全防护。首先注册模型：

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

openclaw 配置设置 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 config set agents.defaults.model.primary "orcarouter/anthropic/claude-fable-5"

openclaw 配置验证

systemctl --user 重启 openclaw-gateway

3.5 测试它

真实转录：

sailt@savor:~$ openclaw agent --agent main \

--model "orcarouter/anthropic/claude-fable-5" --message "讲个笑话"

OpenClaw 2026.5.27 (27ae826) — 我已经看到了你的提交信息。

我们会一起处理那个。

一位程序员的妻子问他：“你能不能去商店买一条面包

面包呢？如果有鸡蛋，买一打。

他带着12条面包回来了。

"你到底为什么要买12条面包？！"

他们吃了鸡蛋。

Fable 5，通过OrcaRouter回答，只需一条命令。（此外：这个模型的喜剧节奏比我们大多数人把握得都好。）

路径B — 你可能遇到的错误

症状

原因

修复

plugins.allow 为空（警告）

未设置插件允许列表

config set 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 智能体 --model <ref> --message ...

单次运行

在对话中途切换

/model <ref> (在TUI内部)

当前会话

将其设为默认

配置设置 agents.defaults.model.primary <ref>

所有新会话

4.2 背景与成本说明

Fable 5 每个token都很昂贵而在长任务上消耗大量token——这是为连续工作数小时而设计的模型的本质。一些习惯可以让账单保持合理：

• 把它留给真正需要它的任务。使用一个更便宜的模型作为代理的默认模型，仅在真正困难、长周期任务时切换到 Fable 5——可通过每次运行的 --model 覆盖，或者如果你在路径 B 上，则通过路由策略实现。

•    在不相关的任务之间开启全新会话（TUI中的/new命令），这样你就不必在每次来回重新发送长历史记录。切换模型可以保持对话的连贯性——OpenClaw会将文本历史重新发送给新模型——而费用是根据上下文长度计算的，而不是你是否切换了模型。

• 注意令牌计数器。 OpenClaw 显示每次会话的令牌使用情况；如果一次简单的对话消耗了数万令牌，那通常是固定的提示开销（你的身份文件 + 技能描述），而不是模型的问题——值得单独修剪。

• 如果回复感觉风格不对，请回想顶部的安全防护部分——按设计，某些受限领域中的查询由 Opus 4.8 回答，并且这些查询不会按 Fable 价格计费。

5. 最终检查清单

•    密钥存储在 chmod 600 秘密文件中；从不粘贴到已提交的文件中。

•    密钥也存在于网关的 systemd drop-in 中 — 这实际上是使其工作的原因。

•    Fable 5 已在 agents.defaults.models 下注册并设为主模型。

• openclaw config validate 通过；每次配置更改后网关都会重启。

•    针对您结算的账户设置月度消费上限。

•    (路径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之类的路由器，其中引用为 orcarouter/anthropic/claude-fable-5（上述路径B）。

为什么我的Fable 5请求返回了一个不同的模型？

Fable 5包括了网络安全和生物学方面的保护措施。被标记为这些领域的查询会自动路由到Claude Opus 4.8，并且重路由的请求不会按Fable价格收费。请参阅Anthropic的解释。

Claude Fable 5 每百万 tokens 的成本是多少？

每百万输入标记10美元，每百万输出标记50美元，提示缓存可获得90%的输入标记折扣（Anthropic）。通过路由器，查看实时费率在模型页面上。

为什么OpenClaw说我的模型“不允许用于代理”？

OpenClaw 强制实行基于代理的模型允许列表。在选择引用之前，先将其注册到 agents.defaults.models 下（§3.4）——并注意如果引用包含点号，则存在版本点解析陷阱。

🦞 给你的龙虾装上Mythos级大脑。