실습 가이드 — 두 가지 경로, 실제 오류, 그리고 이를 해결하는 방법.

OpenClaw 2026.5.27 (WSL2/Linux)에서 테스트됨 · OrcaRouter 플러그인은 OpenClaw ≥ 2026.5.12 필요 · 2026년 7월

클로드 페이블 5는 Anthropic이 처음으로 공개한 Mythos-class 모델 — 즉, 위치한 위에 Opus, 장기 실행, 다단계, 자율 작업을 위해 구축된 것입니다. 이러한 프로필은 OpenClaw와 같은 에이전트 프레임워크에 자연스럽게 적합하며, 이 모델은 단순히 질문에 답하는 것이 아니라 계획을 세우고, 도구를 호출하며, 여러 번의 상호작용에 걸쳐 일관성을 유지합니다.

이 가이드는 Fable 5를 OpenClaw 에이전트에 연결하는 두 가지 방법을 설명합니다: Anthropic API 키를 통해 직접 (경로 A), 그리고 를 통해 OrcaRouter단일 OpenAI 호환 키를 사용하는 (경로 B)입니다. 두 방법 모두 동일한 모델에 도달하지만 설정, 비용 제어, 라우팅 유연성에서 차이가 있습니다.

검증에 관한 참고사항: Path B는 OpenClaw 2026.5.27에서 엔드투엔드로 테스트되었습니다 — 해당 섹션의 모든 명령 블록과 오류 메시지는 그 실행의 실제 기록입니다. Path 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의 가격은 입력 토큰 100만 개당 $10, 출력 토큰 100만 개당 $50, 프롬프트 캐싱에 대해 90% 입력 토큰 할인이 적용됩니다 (출처).

2.2 키를 안전하게 보관하십시오

보호된 비밀 파일에 보관하고, 어디에도 인라인으로 붙여넣지 마십시오:

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

nano ~/.openclaw_secrets

이 줄을 추가한 다음 저장하세요:

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

로드하고 확인합니다(전체 키가 아닌 접두사만 출력됨):

source ~/.openclaw_secrets

에코 "로드됨: ${ANTHROPIC_API_KEY:0:10}..."

일반적인 오류: export: '=': 유효한 식별자가 아닙니다 → = 주위에 공백을 두었거나, 굽은 따옴표(“스마트 따옴표”)를 사용했습니다. 정확히 KEY="value" 형식을 사용하세요. 공백 없이, 직선 ASCII 따옴표로.

2.3  게이트웨이가 키(중요)를 인식하도록 합니다.

이것은 가장 큰 함정입니다. Linux에서 OpenClaw 게이트웨이는 보통 systemd user service로 실행됩니다. 쉘에서 내보낸 변수는 오직 해당 쉘에만 존재합니다 — 백그라운드 서비스는 별도로 시작되며 이를 볼 수 없습니다. 따라서 터미널에 키가 있더라도 게이트웨이는 이를 인식하지 못할 수 있습니다.

드롭인 파일을 통해 서비스에 자체 복사본을 제공하십시오:

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를 모델로 구성

먼저 구성을 백업한 다음(저렴한 보험), 빌드가 노출하는 정확한 모델 참조를 확인하세요:

~/.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를 등록하십시오. 그렇지 않으면 모델 전환이 "허용되지 않음" 오류와 함께 거부됩니다. (실제 오류 텍스트는 Path B, §3.4에서 확인할 수 있습니다. 동일한 메커니즘입니다.)

2.5 테스트하세요

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

레거시 서비스 마이그레이션을 위한 3단계 계획을 초안하세요. 간결하게 유지하세요.

계획형 프롬프트는 좋은 첫 번째 테스트입니다. 이는 Fable 5의 강점(장기적이고 다단계 추론)을 활용하는 것이지, 더 저렴한 모델과의 차이를 거의 느끼지 못하는 한 줄짜리 질문과는 다릅니다.

경로 A — 발생할 수 있는 오류들

증상

원인

수정

401 / 인증 오류

게이트웨이가 키를 인식할 수 없습니다

systemd 드롭인(§2.3)에 추가한 후, 다시 시작하세요.

모델을 찾을 수 없음

잘못된 Fable 5 ref

모델 목록에서 정확한 참조를 복사하세요.

에이전트에게 허용되지 않음

모델이 에이전트 허용 목록에 없습니다.

그것을 agents.defaults.models 아래에 등록하십시오.

크레딧 / 할당량 오류

잔액 또는 캡 히트 없음

Anthropic 콘솔에서 충전 / 한도 인상

터미널에서는 작동하지만 게이트웨이에서는 실패합니다.

셸 변수 vs. 서비스 환경

§2.3을 참조하세요 — 서비스는 자체 환경이 필요합니다.

최적 대상: 메탈에 가까운 사용 — 중개되지 않은 모델을 원하며, 이미 Anthropic 생태계에 속해 있고, 네이티브 거부/대체 처리에 대한 일급 접근을 원하는 경우.

3. Path B — OrcaRouter API 키 (엔드투엔드 검증됨)

OrcaRouter 는 OpenAI 호환 LLM 라우터입니다. 하나의 sk-orca- 키로 Fable 5 및 다른 여러 공급업체의 모델에 액세스할 수 있으며, 서버 측 라우팅 정책을 제공합니다. OpenClaw에서는 ClawHub 플러그인으로 제공되므로 Path A에 비해 설치 단계가 하나 더 필요합니다. 아래의 모든 내용은 OpenClaw 2026.5.27의 실제 기록입니다.

3.1 플러그인 설치

openclaw plugins install 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:@continuum-ai-corp/openclaw-orcarouter

ClawHub 채널: 커뮤니티

Npm 무결성: sha512-Gpu6fC30zZ8iNiEliLEj6Qbr...

계속 진행하기 전에 해당 기능 블록을 읽어보세요: 플러그인은 단일 텍스트 추론 기능을 선언하며 before_agent_start 훅이 없습니다. 이는 모델 포워더일 뿐입니다. 파일을 읽거나 셸 명령을 실행하지 않습니다. (플러그인 페이지: ClawHub.)

다음 실행 시에도 이 경고를 확인할 수 있습니다.

[plugins] plugins.allow가 비어 있습니다; 번들되지 않은 플러그인이 발견되었으며, ~할 수 있습니다.

자동 로드: orcarouter (/home/sailt/.openclaw/extensions/orcarouter/

dist/index.js). plugins.allow를 명시적인 신뢰할 수 있는 ID로 설정하십시오.

그것은 OpenClaw가 플러그인 허용 목록이 설정되지 않았다고 알려주는 것입니다. 따라서 발견된 모든 플러그인이 자동으로 로드될 수 있습니다. 그것을 비활성화하고 — 신뢰를 명시적으로 만드세요 — 다음과 같이:

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

3.2 키를 얻고 저장하세요.

에서 sk-orca- 키를 생성합니다OrcaRouter console, 그런 다음 Path A와 같은 방식으로 저장합니다

# ~/.openclaw_secrets에

export ORCAROUTER_API_KEY="sk-orca-..."

3.3 게이트웨이에 키를 제공하십시오.

Path A와 동일한 중요한 규칙 — systemd 서비스에는 자체 복사본이 필요합니다. 정리를 위해 별도의 드롭인에 보관하십시오:

# ~/.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 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" \

농담 하나 해 줘

GatewayClientRequestError: 오류: 모델 오버라이드 "orcarouter/z-ai/glm-5.2"

에이전트 "main"에 허용되지 않습니다.

OpenClaw는 비용/안전 보호 조치로 에이전트별 모델 허용 목록을 적용합니다. 먼저 모델을 등록하세요:

~/.openclaw/openclaw.json 파일을 ~/.openclaw/openclaw.json.bak 파일로 복사합니다.

openclaw config set 명령으로 agents.defaults.models.'orcarouter/anthropic/claude-fable-5'를 '{}'로 설정합니다.

주의할 점 — 모델 이름에 점(dot)이 있는 경우. 참조(ref)에 버전 점(dot)이 포함되어 있으면, config set은 그 점을 경로 구분자로 취급하여 거부합니다. 실제 예시로 GLM-5.2를 사용한 내용입니다:

sailt@savor:~$ openclaw config set \

에이전트.기본값.모델.'orcarouter/z-ai/glm-5.2' '{}'

오류: 구성 검증 실패:

agents.defaults.models.orcarouter/z-ai/glm-5: 유효하지 않은 입력

ref가 .2에서 잘린 점에 주목하세요. Fable 5의 ref에는 점이 없으므로 영향을 받지 않지만, 점이 있는 ref의 경우 ~/.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를 통해 응답, 하나의 명령으로. (또한: 이 모델은 우리 대부분보다 더 뛰어난 코미디 타이밍을 가지고 있습니다.)

Path B — 발생할 수 있는 오류들

증상

원인

수정

plugins.allow가 비어 있습니다 (경고)

플러그인 허용 목록이 설정되지 않았습니다.

구성 설정 plugins.allow '["orcarouter"]'

대상 세션이 선택되지 않았습니다.

--agent 누락됨

추가 --agent main

에이전트 "main"에 대해 허용되지 않습니다.

모델이 등록되지 않았습니다.

agents.defaults.models (§3.4)에 추가

구성 설정에 잘못된 입력

모델 이름에 있는 점이 경로로 파싱됨

openclaw.json을 수동으로 편집한 후 검증하십시오.

401 권한 없음

게이트웨이가 키를 받지 못했습니다.

systemd 드롭인(§3.3)을 확인하세요.

모델을 찾을 수 없음

잘못된 참조 / 카탈로그에 없음

참조를 확인하세요모델 페이지

최적 대상: 여러 공급업체에 하나의 키 사용, 라우터 콘솔에서 에이전트별 구성 대신 중앙 집중식 라우팅 및 지출 정책 관리, 또는 여러 공급업체 키를 관리할 필요 없이 Fable 5를 다른 공급업체 모델과 A/B 테스트.

4. Fable 5 일상 사용

4.1  모델을 선택하는 세 가지 방법

목표

명령

범위

한 번 통화로 시도해보세요

openclaw 에이전트 --model <ref> --message ...

단일 실행

대화 중 전환

/model <ref>  (TUI 내부)

현재 세션

기본값으로 설정

에이전트 기본값의 모델 주 설정을 설정합니다 <참조>

모든 새 세션

4.2 문맥 및 비용 참고사항

Fable 5는 토큰당 비쌉니다 그리고 긴 작업에서 토큰을 많이 소모합니다 — 그것은 몇 시간 동안 작동하도록 만들어진 모델의 특성입니다. 몇 가지 습관이 비용을 합리적으로 유지합니다:

• 그것을 정당화하는 작업을 위해 아껴두세요. 에이전트의 기본 모델로 더 저렴한 모델을 사용하고, 진정으로 어렵고 장기적인 작업에는 Fable 5로 전환하세요. — 실행 시 --model 오버라이드를 사용하거나, Path B를 사용 중인 경우 라우팅 정책을 통해 전환하세요.

•    관련 없는 작업 사이에 새 세션을 시작하세요(/new in the TUI)를 사용하면 매번 긴 대화 내역을 다시 보내지 않아도 됩니다. 모델을 전환해도 OpenClaw가 텍스트 기록을 새 모델로 다시 전송하기 때문에 대화가 일관되게 유지됩니다. — 비용은 컨텍스트의 길이에 따라 추적되며, 모델을 바꿨는지 여부는 영향을 미치지 않습니다.

• 토큰 카운터를 확인하세요. OpenClaw는 세션별 토큰 사용량을 보여줍니다. 사소한 대화에서 수만 개의 토큰이 소모된다면, 이는 보통 고정 프롬프트 오버헤드(사용자 식별 파일 + 기술 설명) 때문이며, 모델 때문이 아닙니다 — 별도로 정리할 가치가 있습니다.

•    만약 답변이 스타일에 어긋난다고 느껴진다면, 상단의 보호 조치 섹션을 기억하세요 — 게이트가 있는 도메인의 일부 질문은 설계상 Opus 4.8이 응답하며, 해당 질문에 대해 Fable 가격으로 청구되지 않습니다.

5. 최종 체크리스트

•    키는 chmod 600 비밀 파일에 저장되며, 커밋된 파일에 붙여넣지 않습니다.

•    게이트웨이의 systemd 드롭인에도 있는 키 — 이것이 실제로 작동하게 만드는 것입니다.

•    Fable 5가 agents.defaults.models에 등록되었으며 기본으로 설정되었습니다.

•    openclaw config validate가 통과되며, 구성 변경 시마다 게이트웨이가 다시 시작됩니다.

•    청구한 계정에 설정된 월별 지출 한도입니다.

•    (경로 B) plugins.allow 설정으로 플러그인이 자동으로 조용히 로드되지 않습니다.

사람들이 놓치는 한 가지:  터미널에서 키가 작동한다고 해서 게이트웨이가 그 키를 가지고 있다는 의미는 아닙니다. Fable 5가 실제로 응답하게 만드는 것은 systemd drop-in 단계 (§2.3 / §3.3)입니다. 유효한 키로 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의 백만 토큰당 비용은 얼마인가요?

입력 토큰 100만 개당 $10, 출력 토큰 100만 개당 $50, 프롬프트 캐싱에 대해 90% 입력 토큰 할인 (Anthropic). 라우터를 통해 실시간 요금을 확인하세요: 모델 페이지.

왜 OpenClaw가 내 모델이 “agent에 대해 허용되지 않음”이라고 말하나요?

OpenClaw는 에이전트별 모델 허용 목록을 적용합니다. ref에 점(.)이 포함된 경우, ref를 선택하기 전에 agents.defaults.models 아래에 등록하십시오(§3.4). 그리고 버전-점 구문 분석 문제를 주의하십시오.

🦞  당신의 랍스터에게 Mythos-class 두뇌를 주세요.