메인 콘텐츠로 건너뛰기

​
API usage & costs

이 문서는 API 키를 사용할 수 있는 기능과 그 비용이 어디에 표시되는지를 정리합니다. OpenClaw 기능 중 provider 사용량이나 유료 API 호출을 발생시킬 수 있는 항목에 초점을 둡니다.

​
Where costs show up (chat + CLI)

세션별 비용 스냅샷
  • /status는 현재 세션의 모델, 컨텍스트 사용량, 마지막 응답 토큰 수를 표시합니다.
  • 모델이 API-key auth를 사용하면 /status는 마지막 응답의 추정 비용도 표시합니다.
메시지별 비용 푸터
  • /usage full은 모든 응답 뒤에 사용량 푸터를 붙이며, 여기에 추정 비용도 포함됩니다(API key 전용).
  • /usage tokens는 토큰만 표시합니다. OAuth 흐름에서는 달러 비용을 숨깁니다.
CLI usage windows (provider quotas)
  • openclaw status --usage와 openclaw channels list는 provider usage windows를 표시합니다. 이는 메시지별 비용이 아니라 quota 스냅샷입니다.
자세한 내용과 예시는 Token use & costs를 참고하세요.

​
How keys are discovered

OpenClaw는 다음 위치에서 자격 증명을 찾을 수 있습니다.
  • Auth profiles (auth-profiles.json에 저장되며 agent별로 관리)
  • Environment variables (OPENAI_API_KEY, BRAVE_API_KEY, FIRECRAWL_API_KEY 등)
  • Config (models.providers.*.apiKey, tools.web.search.*, tools.web.fetch.firecrawl.*, memorySearch.*, talk.apiKey)
  • Skills (skills.entries.<name>.apiKey), 필요하면 키를 skill 프로세스 환경으로 내보낼 수 있습니다.

​
Features that can spend keys

​
1) Core model responses (chat + tools)

모든 응답과 tool call은 현재 모델 provider(OpenAI, Anthropic 등)를 사용합니다. 이것이 사용량과 비용의 주요 원천입니다. 가격 설정은 Models, 표시 방식은 Token use & costs를 참고하세요.

​
2) Media understanding (audio/image/video)

수신된 미디어는 응답 실행 전에 요약 또는 전사될 수 있습니다. 이 과정에서 모델/provider API를 사용합니다.
  • Audio: OpenAI / Groq / Deepgram (이제 키가 있으면 자동 활성화)
  • Image: OpenAI / Anthropic / Google
  • Video: Google
Media understanding을 참고하세요. semantic memory search는 원격 provider를 설정한 경우 embedding API를 사용합니다.
  • memorySearch.provider = "openai" → OpenAI embeddings
  • memorySearch.provider = "gemini" → Gemini embeddings
  • memorySearch.provider = "voyage" → Voyage embeddings
  • memorySearch.provider = "mistral" → Mistral embeddings
  • memorySearch.provider = "ollama" → Ollama embeddings (로컬/자체 호스팅, 일반적으로 호스팅 API 과금 없음)
  • 로컬 embeddings 실패 시 원격 provider로 선택적 fallback 가능
memorySearch.provider = "local"을 사용하면 로컬에만 유지할 수 있으며 API 사용도 없습니다. Memory를 참고하세요.

​
4) Web search tool

web_search는 API key를 사용하며 provider에 따라 사용 요금이 발생할 수 있습니다.
  • Brave Search API: BRAVE_API_KEY 또는 tools.web.search.apiKey
  • Gemini (Google Search): GEMINI_API_KEY
  • Grok (xAI): XAI_API_KEY
  • Kimi (Moonshot): KIMI_API_KEY 또는 MOONSHOT_API_KEY
  • Perplexity Search API: PERPLEXITY_API_KEY
Brave Search 무료 크레딧: Brave 각 요금제에는 매월 갱신되는 무료 크레딧 5가포함됩니다.Search플랜은요청1,000건당5가 포함됩니다. Search 플랜은 요청 1,000건당 5이므로, 별도 과금 없이 월 1,000건을 처리할 수 있습니다. 예상치 못한 비용을 피하려면 Brave 대시보드에서 사용 한도를 설정하세요. Web tools를 참고하세요.

​
5) Web fetch tool (Firecrawl)

web_fetch는 API key가 있으면 Firecrawl을 호출할 수 있습니다.
  • FIRECRAWL_API_KEY 또는 tools.web.fetch.firecrawl.apiKey
Firecrawl이 설정되지 않았으면, 이 도구는 direct fetch + readability로 fallback 하며 유료 API는 사용하지 않습니다. Web tools를 참고하세요.

​
6) Provider usage snapshots (status/health)

일부 상태 명령은 quota window나 auth health를 표시하기 위해 provider usage endpoint를 호출합니다. 일반적으로 호출량은 적지만 provider API를 사용합니다.
  • openclaw status --usage
  • openclaw models status --json
Models CLI를 참고하세요.

​
7) Compaction safeguard summarization

compaction safeguard는 세션 히스토리를 현재 모델로 요약할 수 있으며, 실행 시 provider API를 호출합니다. Session management + compaction을 참고하세요.

​
8) Model scan / probe

openclaw models scan은 OpenRouter 모델을 probe할 수 있으며, probing이 활성화되어 있으면 OPENROUTER_API_KEY를 사용합니다. Models CLI를 참고하세요.

​
9) Talk (speech)

Talk 모드는 설정되어 있으면 ElevenLabs를 호출할 수 있습니다.
  • ELEVENLABS_API_KEY 또는 talk.apiKey
Talk mode를 참고하세요.

​
10) Skills (third-party APIs)

Skills는 skills.entries.<name>.apiKey에 apiKey를 저장할 수 있습니다. skill이 해당 키를 외부 API에 사용하면, 그 skill의 provider 정책에 따라 비용이 발생할 수 있습니다. Skills를 참고하세요.