Um guia prático — dois caminhos, erros reais e como corrigi-los.

Testado no OpenClaw 2026.5.27 (WSL2/Linux)  ·  O plugin OrcaRouter requer OpenClaw ≥ 2026.5.12  ·  Julho de 2026

Claude Fable 5 é o primeiro lançado publicamente pela Anthropic Mythos-class modelo — uma categoria que fica acima da Opus, construído para trabalho autônomo de longa duração, multi-etapas. Esse perfil o torna naturalmente adequado para uma estrutura de agente como OpenClaw, onde o modelo não apenas responde a uma pergunta, mas planeja, chama ferramentas e mantém coerência ao longo de muitas rodadas.

Este guia aborda duas maneiras de integrar o Fable 5 ao seu agente OpenClaw: diretamente por meio de uma chave da API Anthropic (Caminho A), e por meio de OrcaRouter usando uma única chave compatível com OpenAI (Caminho B). Ambos levam ao mesmo modelo — diferem na configuração, controle de custos e flexibilidade de roteamento.

Uma nota sobre verificação: O Caminho B foi testado de ponta a ponta no OpenClaw 2026.5.27 — cada bloco de comando e mensagem de erro nessa seção é uma transcrição real dessa execução. O Caminho A segue a documentação oficial da Anthropic e do OpenClaw.

Primeiro, a coisa que a maioria dos tutoriais pula: o desvio de segurança do Fable 5

Para um chatbot, isso seria uma nota de rodapé. Para um framework de agente , é a seção mais importante do guia, então vem primeiro.

O Fable 5 vem com medidas de segurança adicionais. Conforme página oficial da Anthropic, o modelo inclui salvaguardas robustas para cibersegurança e biologia: muitas consultas nesses domínios são automaticamente roteadas para o modelo mais capaz seguinte da Anthropic, Claude Opus 4.8, se sinalizado por essas salvaguardas — e você é não cobrado os preços da Fable pelas solicitações redirecionadas. A Anthropic explica a experiência de fallback em mais detalhes em este artigo de suporte.

O que isso significa para o seu {{KEEP}}OpenClaw{{/KEEP}} agente

•    As recusas chegam como uma bem-sucedida resposta, não como um erro. Na API Claude, uma solicitação recusada retorna uma resposta normal com um motivo de parada de recusa, em vez de um erro HTTP. Seu loop de agente deve tratar isso como “retry on another model,” não “a API caiu.”

• O que você recebe pode não ser Fable 5. Se você está comparando modelos dentro do OpenClaw e uma resposta parece estranha, um redirecionamento de segurança para o Opus 4.8 pode ser o motivo. É um comportamento esperado, não um bug — fora desses domínios restritos, o modelo se comporta normalmente.

Todo o resto neste guia é mecânico; esta é a parte que precisa de sua atenção.

0. Pré-requisitos

•    OpenClaw ≥ 2026.5.12 instalado e inicializado (openclaw --version para verificar — este guia foi testado na versão 2026.5.27).

•    Um gateway funcional (estado do openclaw mostra que está acessível).

• Node 22.19+ ou 24.

•    Se você está atrás de uma rede que precisa de um proxy para acessar a Anthropic / OrcaRouter, certifique-se de que o próprio serviço de gateway pode usá-lo — isso pega quase todo mundo uma vez (veja §2.3).

Regra de segurança de chaves: você mesmo gera e cola as chaves de API. Nunca compartilhe uma chave em uma captura de tela, em um chat ou em um repositório público. Armazene chaves em um arquivo legível apenas por você (chmod 600) e referencie-as a partir daí — nunca codifique uma chave diretamente em um arquivo que você possa commitar.

1. Qual caminho você deve escolher?

Chave oficial da Anthropic

Chave OrcaRouter

Prefixo de chave

sk-ant-

sk-orca

Modelos alcançáveis

Apenas modelos Anthropic

Fable 5 + GPT / Gemini / GLM / DeepSeek…

Configuração no OpenClaw

Provedor integrado

Instale o plugin ClawHub primeiro.

Roteamento / política de gastos

Configuração por agente

Console central

Recusa nativa / fallback

de primeira classe (API própria da Anthropic)

Depende de como o roteador expõe isso.

Faturamento

Conta da Anthropic

conta OrcaRouter (saldo único)

Ambos os caminhos chegam ao mesmo modelo. Nenhum é “melhor” — são trade-offs diferentes. Se o Fable 5 é o único modelo de fronteira que lhe interessa e você deseja o acesso mais limpo ao seu comportamento nativo, vá direto. Se você está roteando muitos modelos e quer uma única chave mais controle central, um roteador vale a pena.

2. Caminho A — Chave oficial da API Anthropic

A rota mais direta: OpenClaw fala diretamente com a Anthropic, sem intermediário. Você obtém o modelo exatamente como a Anthropic o serve, incluindo semânticas nativas de recusa e fallback.

2.1 Gerar a chave

•    Faça login em console.anthropic.com.

•    Abrir API Keys → Create Key. Copie a string sk-ant- (mostrada uma vez).

•    Em Faturamento, adicione crédito e defina um limite mensal para que um agente descontrolado não possa esvaziar sua conta. O Fable 5 é precificado a $10 por milhão de tokens de entrada e $50 por milhão de tokens de saída, com um desconto de 90% em tokens de entrada para cache de prompts (fonte).

2.2  Armazene a chave de forma segura

Mantenha-o em um arquivo de segredos protegido em vez de colá-lo inline em qualquer lugar:

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

nano ~/.openclaw_secrets

Adicione esta linha e depois salve:

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

Carregue e confirme (imprime apenas o prefixo, nunca a chave completa):

carregue ~/.openclaw_secrets

echo "carregado: ${ANTHROPIC_API_KEY:0:10}..."

Erro comum:  export: '=': não é um identificador válido  → você colocou espaços ao redor do =, ou usou aspas curvas “inteligentes”. Use exatamente KEY="value" — sem espaços, aspas ASCII retas.

2.3  Faça o gateway ver a chave (crítica)

Esta é a maior armadilha. No Linux, o gateway OpenClaw geralmente é executado como um serviço de usuário do systemd. Uma variável que você exporta no seu shell vive apenas naquele shell — o serviço de fundo é iniciado separadamente e não pode vê-la. Portanto, mesmo que seu terminal tenha a chave, o gateway pode não tê-la.

Dê ao serviço sua própria cópia através de um arquivo drop-in:

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

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

Conteúdo — observe que a sintaxe Environment= do systemd aceita um literal KEY=value, sem export, e você deve escrever a chave real, porque uma referência $VAR não será resolvida aqui:

[Serviço]

Ambiente="ANTHROPIC_API_KEY=sk-ant-..."

Bloqueie, recarregue, reinicie:

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

systemctl --user daemon-reload

systemctl --user reiniciar openclaw-gateway

Confirme que o serviço realmente o carregou (imprime apenas o prefixo):

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

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

2.4 Configure o Fable 5 como modelo

Faça backup da sua configuração primeiro (seguro barato), depois verifique a referência exata do modelo que sua compilação expõe:

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

openclaw models list | grep -i fable

Defina-o como padrão, usando a referência exata que você viu acima (mostrada aqui como anthropic/claude-fable-5):

openclaw config set agents.defaults.model.primary "anthropic/claude-fable-5"

openclaw validar configuração

systemctl --user reiniciar openclaw-gateway

Nota de lista de permissões: algumas configurações impõem uma lista de permissões de modelos como proteção de custo/segurança. Se a sua fizer, registre anthropic/claude-fable-5 em agents.defaults.models primeiro, ou a troca de modelo será rejeitada com um erro “não permitido” (você verá o texto real do erro em Path B, §3.4 — é o mesmo mecanismo).

2.5  Teste-o

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

Elabore um plano de três etapas para migrar um serviço legado. Mantenha-o conciso.

Um prompt do tipo planejamento é um bom primeiro teste — ele explora o ponto forte do Fable 5 (raciocínio de longo prazo com várias etapas) em vez de uma frase curta onde você mal notaria a diferença de um modelo mais barato.

Path A — erros que você pode encontrar

Sintoma

Causa

Corrigir

401 / erro de autenticação

O gateway não consegue ver a chave.

Adicione-o ao drop-in do systemd (§2.3), reinicie

modelo não encontrado

Ref errada do Fable 5

Copie a referência exata da lista de modelos.

não permitido para agente

Modelo não está na lista de permissões do agente.

Registre-o em agents.defaults.models

Erro de crédito / cota

Sem saldo ou impacto no teto

Adicionar créditos / aumentar o limite no console da Anthropic

Funciona no terminal, falha no gateway

Variável de shell vs. env de serviço

Veja §2.3 — o serviço precisa do seu próprio ambiente.

Melhor para: permanecer próximo ao hardware — você quer o modelo sem mediação, já está no ecossistema da Anthropic e deseja acesso de primeira classe ao tratamento nativo de recusa/fallback.

3. Caminho B — Chave da API do OrcaRouter (verificada de ponta a ponta)

OrcaRouter é um roteador de LLM compatível com OpenAI: uma chave sk-orca- acessa o Fable 5 e modelos de muitos outros fornecedores, com políticas de roteamento no lado do servidor. No OpenClaw, ele é distribuído como um plugin do ClawHub, portanto há uma etapa extra de instalação em comparação com o Path A. Tudo abaixo é uma transcrição real do OpenClaw 2026.5.27.

3.1  Instale o plugin

instalar plugins do openclaw clawhub:@continuum-ai-corp/openclaw-orcarouter

openclaw lista de plugins | grep -i orca

Antes de confiar em qualquer plugin de terceiros, inspecione o que ele pode fazer:

sailt@savor:~$ openclaw plugins inspect orcarouter

Provedor OrcaRouter

ID: orcarouter

OrcaRouter - roteamento adaptativo entre muitos LLMs através de um único

API compatível com OpenAI.

Status: carregado

Versão: 0.1.0

Modo de capacidade: simples

Legacy before_agent_start: não

Capacidades:

inferência de texto: orcarouter

Instalar:

clawhub

Especificação: clawhub:@continuum-ai-corp/openclaw-orcarouter

Canal ClawHub: comunidade

Integridade do Npm: sha512-Gpu6fC30zZ8iNiEliLEj6Qbr...

Leia aquele bloco de capacidade antes de prosseguir: o plugin declara uma única capacidade de inferência de texto e nenhum hook before_agent_start — é um encaminhador de modelo, nada mais. Ele não lê seus arquivos nem executa comandos de shell. (Página do plugin: ClawHub.)

Você também pode notar este aviso na sua próxima execução:

[plugins] plugins.allow está vazio; plugins não incluídos descobertos podem

carregamento automático: orcarouter (/home/sailt/.openclaw/extensions/orcarouter/)

dist/index.js). Defina plugins.allow para IDs confiáveis explícitos.

Isso é o OpenClaw dizendo que nenhuma lista de permissão de plugins está definida, portanto qualquer plugin descoberto pode carregar automaticamente. Silencie-o — e torne sua confiança explícita — com:

openclaw config set plugins.allow '["orcarouter"]'

3.2  Obter e armazenar a chave

Gere uma chave sk-orca- a partir do OrcaRouter console, então armazene-a da mesma forma que Path A:

# em ~/.openclaw_secrets

exportar ORCAROUTER_API_KEY="sk-orca-..."

3.3  Dê a chave ao gateway.

Mesma regra crítica que o Path A — o serviço systemd precisa de sua própria cópia. Mantenha-o em um drop-in separado para organização:

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

[Serviço]

Environment="ORCAROUTER_API_KEY=sk-orca-..."

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

systemctl --user daemon-reload

systemctl --user reiniciar openclaw-gateway

Confirme que o serviço realmente o vê:

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

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

ORCAROUTER_API_KEY=sk-orca-****

3.4  Registre-se e selecione Fable 5

As refs do OrcaRouter seguem orcarouter/<fornecedor>/<modelo>. Verifique a ref exata para o Fable 5:

sailt@savor:~$ openclaw models list | grep -i fábula

orcarouter/anthropic/claude-fable-5     texto    195k    não   sim   configurado

Portanto, a referência é orcarouter/anthropic/claude-fable-5, com uma janela de contexto de 195k tokens conforme exposta através do roteador. (Página do modelo: orcarouter.ai/models/anthropic/claude-fable-5.)

Aqui está o que acontece se você pular o registro e apenas tentar usar um modelo — uma transcrição real:

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

conte-me uma piada

GatewayClientRequestError: Erro: Substituição de modelo "orcarouter/z-ai/glm-5.2"

não é permitido para o agente "main".

OpenClaw impõe uma lista de permissão de modelo por agente como guarda de custo/segurança. Registre o modelo primeiro:

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

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

Entendi — pontos nos nomes de modelos. Se uma referência contém um ponto de versão, o config set trata o ponto como separador de caminho e o rejeita. Transcrição real, usando GLM-5.2 como exemplo:

sailt@savor:~$ openclaw config set \

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

Erro: Falha na validação da configuração:

agents.defaults.models.orcarouter/z-ai/glm-5: Entrada inválida

Note como a ref foi truncada em .2. A ref do Fable 5 não tem ponto, então não é afetada — mas para refs com ponto, edite ~/.openclaw/openclaw.json manualmente para adicionar a entrada, depois execute openclaw config validate.

Em seguida, defina-o como padrão (ou apenas passe --model por execução), valide, reinicie:

openclaw config set agents.defaults.model.primary "orcarouter/anthropic/claude-fable-5"

openclaw validar configuração

systemctl --user reiniciar openclaw-gateway

3.5  Teste-o

Transcrição real:

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

--model "orcarouter/anthropic/claude-fable-5" --message "conte uma piada"

OpenClaw 2026.5.27 (27ae826) — Eu vi suas mensagens de commit.

Vamos trabalhar nisso juntos.

A esposa de um programador pergunta a ele: "Você poderia ir à loja e comprar um pão?"

de pão? E se eles tiverem ovos, pegue uma dúzia.

Ele volta com 12 pães.

Por que diabos você comprou 12 pães?!

Eles comeram ovos.

Fable 5, respondendo através do OrcaRouter, em um comando. (Além disso: o modelo tem um timing cômico melhor do que a maioria de nós.)

Path B — erros que você pode encontrar

Sintoma

Causa

Corrigir

plugins.allow está vazio (aviso)

Nenhuma lista de permissão de plugins definida

config set plugins.allow '["orcarouter"]'

Nenhuma sessão alvo selecionada

Falta --agent

Adicionar --agent main

não permitido para o agente "main"

Modelo não registrado

Adicionar a agents.defaults.models (§3.4)

Entrada inválida na definição de configuração

Ponto no nome do modelo analisado como um caminho

Edite openclaw.json manualmente, depois valide.

401 não autorizado

Gateway não recebeu a chave.

Verifique o drop-in do systemd (§3.3)

modelo não encontrado

Referência errada / não no catálogo

Verifique a referência na página de modelos

Melhor para: uma chave entre muitos fornecedores, gerenciando política de roteamento e gasto centralmente no console do roteador em vez de configuração por agente, ou teste A/B do Fable 5 contra modelos de outros fornecedores sem precisar gerenciar chaves de provedor separadas.

4. Usando Fable 5 no dia a dia

4.1  Três maneiras de selecionar o modelo

Objetivo

Comando

Escopo

Experimente por uma chamada

agente openclaw --model <ref> --message ...

execução única

Mudar no meio da conversa

/model <ref>  (dentro do TUI)

sessão atual

Definir como padrão

definir configuração agents.defaults.model.primary <ref>

todas as novas sessões

4.2  Notas de contexto e custo

Fable 5 é caro por token e consumidor de tokens em tarefas longas — essa é a natureza de um modelo construído para funcionar por horas. Alguns hábitos mantêm a conta razoável:

•    Reserve-o para os trabalhos que o justificam. Use um modelo mais barato como padrão do seu agente e mude para o Fable 5 em tarefas genuinamente difíceis e de longo horizonte — com uma substituição --model por execução, ou por política de roteamento se você estiver no Path B.

• Inicie novas sessões entre tarefas não relacionadas (/new no TUI) para que você não reenvie um longo histórico a cada turno. Trocar de modelos mantém sua conversa coerente — o OpenClaw reenvia o histórico de texto para o novo modelo — e o custo rastreia o tamanho do contexto, não se você trocou.

•    Observe o contador de tokens. OpenClaw mostra o uso de tokens por sessão; se uma troca trivial queima dezenas de milhares de tokens, isso geralmente é sobrecarga fixa do prompt (seu arquivo de identidade + descrições de habilidades), não do modelo — vale a pena cortar separadamente.

•    Se uma resposta parecer fora do estilo, lembre-se da seção de salvaguarda no topo — algumas consultas em domínios restritos são respondidas pelo Opus 4.8 por design, e você não é cobrado pelos preços da Fable por elas.

5. Lista de verificação final

•    Chave armazenada em um arquivo secrets com chmod 600; nunca colada em um arquivo commitado.

•    Chave também presente no drop-in do systemd do gateway — isto é o que realmente o faz funcionar.

•    Fable 5 registrado sob agents.defaults.models e definido como primário.

•    openclaw config validate passa; gateway reiniciado após cada alteração de configuração.

•    Um limite de gastos mensais definido na conta contra a qual você faturou.

•    (Path B) plugins.allow configurado para que nenhum plugin carregue automaticamente de forma silenciosa.

A única coisa que as pessoas não percebem: a sua chave funcionar no terminal não significa que o gateway a possui. O passo de drop-in do systemd (§2.3 / §3.3) é o que faz o Fable 5 realmente responder. Se você receber um 401 com uma chave que sabe ser válida, essa é quase sempre a razão.

Perguntas Frequentes

O Claude Fable 5 está disponível através de APIs compatíveis com OpenAI?

Não diretamente da Anthropic — a Anthropic o serve através da API Claude como claude-fable-5. Para alcançá-lo através de um endpoint compatível com OpenAI, use um roteador como OrcaRouter, onde a referência é orcarouter/anthropic/claude-fable-5 (Path B acima).

Por que minha solicitação do Fable 5 retornou um modelo diferente?

Fable 5 inclui salvaguardas para cibersegurança e biologia. Consultas sinalizadas nesses domínios são automaticamente roteadas para Claude Opus 4.8, e você não é cobrado pelos preços Fable por solicitações redirecionadas. Veja a explicação da Anthropic.

Quanto custa o Claude Fable 5 por milhão de tokens?

$10 por milhão de tokens de entrada e $50 por milhão de tokens de saída, com um desconto de 90% nos tokens de entrada para cache de prompt (Anthropic). Através de um roteador, verifique a taxa atual na página do modelo.

Por que o OpenClaw diz que meu modelo “não é permitido para agente”?

OpenClaw impõe uma lista de permissão de modelo por agente. Registre a ref em agents.defaults.models antes de selecioná-la (§3.4) — e cuidado com a pegadinha de análise do ponto de versão se a ref contiver um ponto.

🦞  Dê à sua lagosta um cérebro classe Mythos.