OpenClaw Anthropic 인증 가이드

새로운 도구를 설치했는데 시작부터 인증 오류가 발생하면 정말 답답하죠. API 키를 어디에 저장해야 할지, 백그라운드에서 실행되는 프로세스는 이 키를 어떻게 읽는지 고민하다 보면 개발 흐름이 끊기기 마련입니다. OpenClaw를 설정할 때 겪을 수 있는 이런 번거로움을 줄이기 위해 Anthropic 인증 방법을 정리했습니다.

필요한 것

• Claude Max 또는 Pro 구독 (claude setup-token 사용 시)
• Claude Code CLI 설치 (claude 명령어 사용 가능)

빠른 시작

가장 추천하는 방법은 API 키를 사용하는 거예요. Anthropic Console에서 키를 만든 후, openclaw gateway가 실행 중인 Gateway host에서 다음 단계를 진행하세요.

1. API 키 설정하기

터미널에서 직접 키를 내보내서 확인할 수 있습니다.

export ANTHROPIC_API_KEY="..."
openclaw models status

2. 데몬 설정 (systemd/launchd)

Gateway를 서비스 형태로 실행한다면 ~/.openclaw/.env 파일에 키를 저장하는 것이 좋습니다. 그래야 데몬이 키를 읽을 수 있거든요.

cat >> ~/.openclaw/.env <<'EOF'
ANTHROPIC_API_KEY=...
EOF

설정 후에는 프로세스를 재시작하고 상태를 확인하세요.

openclaw models status
openclaw doctor

직접 환경 변수를 관리하기 귀찮다면 openclaw onboard 명령어를 통해 온보딩 마법사를 실행할 수도 있습니다.

3. Claude 구독 인증 (setup-token)

API 키 대신 Claude 구독을 사용한다면 setup-token 흐름을 따르세요. 이 명령어는 대화형 TTY가 필요하므로 Gateway host에서 직접 실행해야 합니다.

claude setup-token

생성된 토큰을 OpenClaw에 등록합니다.

openclaw models auth setup-token --provider anthropic

다른 장비에서 생성한 토큰이라면 수동으로 붙여넣을 수도 있습니다.

openclaw models auth paste-token --provider anthropic

문제 해결

“No credentials found”

Anthropic 토큰 프로필이 없다면 Gateway host에서 claude setup-token을 다시 실행한 후 상태를 확인하세요.

openclaw models status

토큰 만료 또는 만료 예정

openclaw models status를 실행해 어떤 프로필이 만료되었는지 확인하세요. 프로필이 사라졌다면 claude setup-token을 다시 실행하고 토큰을 다시 붙여넣어야 합니다.

“This credential is only authorized for use with Claude Code…”

이 에러 메시지가 표시된다면 해당 토큰은 다른 API 요청에 사용할 수 없습니다. 이 경우에는 Anthropic API 키를 대신 사용하세요.

인증 정보 제어하기

세션별 설정

채팅 세션 중에 특정 인증 정보를 고정하려면 /model 명령어를 사용합니다. (예: anthropic:default, anthropic:work)

/model \<alias-or-id\>@\<profileId\>

• /model 또는 /model list: 간이 선택창 열기
• /model status: 현재 사용 가능한 후보와 다음 인증 프로필 등 상세 정보 확인

에이전트별 설정

특정 에이전트가 사용할 인증 프로필의 우선순위를 auth-profiles.json에 저장할 수 있습니다.

# 우선순위 확인
openclaw models auth order get --provider anthropic

# 우선순위 설정
openclaw models auth order set --provider anthropic anthropic:default

# 설정 초기화
openclaw models auth order clear --provider anthropic

특정 에이전트를 지정하려면 --agent <id> 플래그를 추가하고, 생략하면 기본 에이전트에 적용됩니다.

설정 과정에서 도움이 더 필요하다면 AI Setup Assistant에게 물어보세요.

다음 단계

• /concepts/oauth: 전체 OAuth 흐름과 저장 구조 이해하기
• Help: 환경 변수 상속(env.shellEnv, ~/.openclaw/.env)에 대한 상세 정보
• /automation/auth-monitoring: 자동화 스크립트(systemd/Termux) 활용법