Q13. Claude CLI로 연결하면 tool calling이 왜 안 되나요?

질문: “Claude CLI로 연결했더니 슬랙이랑 다른 tool 호출이 안 되는데… 이게 OpenClaw를 쓰는 의미가 있나요?” / “auth-profiles.json 보면 type이 ‘token’으로 나오는데 이게 맞는 건가요?”

오늘 덕후방에서 여러 분이 같은 삽질을 하고 계셨어요. 한 분은 한 시간 가까이 고생하시다가 결국 설정을 다 지우고 처음부터 다시 하셨고, 다른 분들은 auth-profiles.json을 들여다보며 “이게 맞는 건지” 서로 물어보고 있었어요.

이 혼란의 근원은 딱 하나예요 — Claude 연결 방식이 3가지나 있고, 방식마다 할 수 있는 것이 달라요.

🗝️ auth-profiles.json이 뭔가요?

OpenClaw를 설치하면 ~/.openclaw/agents/main/agent/auth-profiles.json 파일이 생겨요. 여기에 “어떤 AI 모델에 어떻게 연결했는지” 정보가 저장돼요.

파일을 열면 이런 식으로 생겼어요:

{
  "anthropic:default": {
    "type": "token",
    "provider": "anthropic",
    "token": "sk-ant-oat01-..."
  }
}

여기서 type 값이 연결 방식을 나타내고, 이게 바로 오늘 이야기의 핵심이에요.

🔀 연결 방식 3가지 비교

방식	type 값	어떻게 연결?	tool calling	구독으로 사용?
OAuth 구독 연결	`oauth`	`claude auth login` (브라우저 로그인)	✅ 전체 지원	✅ (Claude Max/Pro 구독)
Setup Token 연결	`token`	`claude setup-token` 후 토큰 붙여넣기	✅ 전체 지원	✅ (구독 토큰)
Claude CLI 연결	`claude-cli`	OpenClaw 설정에서 “Anthropic Claude CLI” 선택	❌ 불가	-

🚨 “Claude CLI 방식”의 함정

OpenClaw 초기 설정 화면에서 이런 선택지가 나와요:

Anthropic auth method
  ● Anthropic API key
  ○ Anthropic Claude CLI
  ○ Anthropic token (paste setup-token)
  ○ Back

여기서 **“Anthropic Claude CLI”**를 선택하면 어떻게 될까요?

OpenClaw가 직접 Anthropic API를 호출하는 게 아니라, 로컬에 설치된 claude CLI 프로세스를 호출해서 답변을 받아오는 방식으로 동작해요.

왜 tool calling이 안 될까요?

Tool calling(슬랙 보내기, 파일 읽기, 웹 검색 등)은 OpenClaw가 AI 모델에게 “이 도구들을 사용할 수 있어”라고 알려줘야 해요. 그런데 Claude CLI 방식은 중간에 claude 프로세스가 껴있어서 OpenClaw가 직접 도구 목록을 전달할 수 없어요.

쉽게 비유하면:

직접 연결(API/token): 오픈클로 → 클로드에게 직접 “이 도구 써서 슬랙 보내줘”
CLI 경유 연결: 오픈클로 → claude 프로세스 → 클로드 (중간에서 도구 정보가 사라짐)

✅ 그럼 어떻게 연결해야 하나요?

방법 1: Setup Token (가장 간단, 구독자 추천)

Claude 구독(Max/Pro)이 있으면 이 방법이 제일 편해요.

# 터미널에서
claude setup-token

명령어를 치면 브라우저가 열리면서 토큰을 받을 수 있어요. 이 토큰을 OpenClaw 설정에서 “Anthropic token (paste setup-token)” 선택 후 붙여넣으면 돼요.

설정 후 auth-profiles.json이 이렇게 되면 정상이에요:

{
  "anthropic:default": {
    "type": "token",
    "provider": "anthropic",
    "token": "sk-ant-oat01-..."
  }
}

방법 2: OAuth 로그인 (브라우저 로그인)

claude auth login

브라우저 팝업에서 Anthropic 계정으로 로그인하면 type: "oauth"로 연결돼요. Setup Token과 기능은 동일해요.

방법 3: API 키 (종량제)

Anthropic Console에서 API 키를 발급받아 연결하는 방식. type: "token"으로 표시되지만 과금 방식이 달라요 (구독 X, 사용량 기반 과금).

💡 오늘 덕후방에서 나온 꿀팁

오늘 대화 중에 나온 실전 정보예요:

“type이 oauth냐 token이냐”보다 중요한 건 tool calling이 되는지 여부 — 설정 후 슬랙에 테스트 메시지 보내봐서 확인하세요
홈브루로 재설치 — 설정이 꼬였다 싶으면 ~/.openclaw/agents/main/agent/auth-profiles.json 파일 삭제 후 OpenClaw 재시작하고 처음부터 다시 설정하는 게 빠를 때도 있어요
텔레그램으로 먼저 테스트 — 슬랙 설정이 복잡하면 텔레그램으로 먼저 연결해서 tool calling이 되는지 빠르게 확인하고, 그 후에 슬랙 연결하는 것도 방법이에요

🤔 “샌드박싱하면 OpenClaw 쓰는 이유가 없지 않나요?”

오늘 이런 이야기도 나왔어요. 샌드박스 모드(tool 제한 모드)로 OpenClaw를 쓰면 결국 ChatGPT 웹 채팅과 뭐가 다르냐는 의문이죠.

맞는 말이에요. OpenClaw의 가치는 tool calling에 있어요. 슬랙 연동, 파일 읽기, 웹 검색, 크론잡 자동화… 이런 게 다 안 된다면 단순 채팅 앱과 다를 게 없어요. 그래서 tool calling이 되는 연결 방식으로 세팅하는 게 중요해요.

한 줄 정리

Anthropic Claude CLI 방식 선택 → tool calling 불가.
API key 또는 token (setup-token) 방식 선택 → tool calling 정상 작동.

설정 화면에서 “Claude CLI” 대신 **“API key”나 “token”**을 선택하세요. 그게 다예요 🐈‍⬛

이 Q&A는 2026년 3월 30일 덕후방 실시간 대화에서 여러 분이 동시에 경험한 삽질을 정리한 내용이에요.