본문으로 건너뛰기

API Keys 取得가이드

OpenClaw 需要至少一個 LLM 提供者的 API Key 才能運作。本가이드將逐步教你如何取得各大 LLM 提供者的 API Key,以及在 OpenClaw 中的설정 방법。

비용 안내

使用 LLM API 會產生費用。每個提供者的計費方式不同,請在申請前確認價格。大部分提供者都有免費額度供初始테스트使用。


빠른 비교표

提供者推薦模型免費額度每百萬 Token 價格(約)適合場景
OpenAIGPT-5.2 Codex有限額$2-15通用對話、程式碼生成
AnthropicClaude Opus 4.6有限額$3-15長文分析、複雜推理
GoogleGemini 2.5 Pro免費額度較高$1-7多模態、性價比高
DeepSeekDeepSeek-V3價格極低$0.1-0.5預算導向、中文優化
Ollama (本機)各種開源模型完全免費$0(僅硬體成本)離線使用、隱私優先

OpenAI API Key

申請步驟

  1. 前往 platform.openai.com
  2. 註冊계정或登入現有계정
  3. 點選左側選單的 API Keys
  4. 點選 Create new secret key
  5. 為 Key 命名(例如 openclaw-production
  6. 複製並安全저장 Key(只會顯示一次)

在 OpenClaw 中설정

在 OpenClaw 的설정 파일中加入:

llm:
provider: openai
api_key: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
model: gpt-5.2-codex

或使用環境變數:

export OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

費用控管建議

  • 설정每月用量上限(Monthly Budget)
  • 使用 Usage Dashboard 모니터링消耗
  • 開發테스트時使用較便宜的模型(如 GPT-4o-mini)
API Key 보안

絕對不要將 API Key 제출到 Git repository 或分享給他人。建議使用環境變數或專門的 secrets manager 來管理。


Anthropic API Key

申請步驟

  1. 前往 console.anthropic.com
  2. 註冊계정(需要電話號碼검증)
  3. 進入 SettingsAPI Keys
  4. 點選 Create Key
  5. 複製並安全저장

在 OpenClaw 中설정

llm:
provider: anthropic
api_key: sk-ant-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
model: claude-opus-4-6

或環境變數:

export ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

推薦用法

Claude 模型特別擅長:

  • 長文脈絡理解:最高支援 1M token context window
  • 複雜推理任務:多步驟邏輯分析
  • 程式碼審查:精確的程式碼分析與建議

Google Gemini API Key

申請步驟

  1. 前往 aistudio.google.com
  2. 使用 Google 계정登入
  3. 點選 Get API Key
  4. 選擇或생성 Google Cloud Project
  5. 複製生成的 API Key

在 OpenClaw 中설정

llm:
provider: google
api_key: AIzaxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
model: gemini-2.5-pro

特色功能

  • 多模態支援(圖片、영상、音訊)
  • 免費額度相對充裕
  • 與 Google Workspace 整合良好

DeepSeek API Key

申請步驟

  1. 前往 platform.deepseek.com
  2. 註冊계정(支援중국手機號碼)
  3. 進入控制台,找到 API Keys 區域
  4. 생성新的 Key 並複製

在 OpenClaw 中설정

llm:
provider: deepseek
api_key: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
model: deepseek-v3

適用場景

  • 預算有限:價格僅為 OpenAI 的 1/10 到 1/30
  • 中文場景:針對中文做過特別優化
  • 중국사용자:無需翻牆即可使用
중국 특별 설명

DeepSeek 是중국사용자的首選 LLM 提供者,因為無需翻牆且價格極低。但請注意,國有엔터프라이즈使用 AI 服務可能有額外컴플라이언스要求。詳見 中國生態系統


Ollama(本機模型)

설치步驟

Ollama 不需要 API Key,因為它在你的本機電腦上運行開源模型。

  1. 前往 ollama.com 다운로드설치
  2. 설치完成後,拉取模型:
ollama pull llama3.3
ollama pull deepseek-r1:32b
  1. 在 OpenClaw 中설정:
llm:
provider: ollama
base_url: http://localhost:11434
model: llama3.3

優缺點

優點缺點
完全免費需要較強的硬體(GPU)
데이터不離開本機模型能力通常不如雲端
無需網路連線大模型啟動較慢
無 API 限流需自行管理模型업데이트

多模型설정策略

OpenClaw 支援同時설정多個 LLM 提供者,並根據任務類型自動選擇最適合的模型:

llm:
default_provider: anthropic
default_model: claude-opus-4-6

routing:
- task: code_generation
provider: openai
model: gpt-5.2-codex
- task: casual_chat
provider: deepseek
model: deepseek-v3
- task: image_analysis
provider: google
model: gemini-2.5-pro
- task: offline_fallback
provider: ollama
model: llama3.3
省錢策略

將日常閒聊交給 DeepSeek 或 Ollama 處理,僅在需要高品質推理時才使用 Claude 或 GPT。這樣可以大幅降低每月的 API 費用。


API Key 安全最佳實踐

  1. 使用環境變數:不要將 Key 直接寫在설정 파일中
  2. 定期輪換:每 90 天更換一次 API Key
  3. 설정用量上限:在每個提供者的控制台설정月度預算
  4. 最小권한原則:如果提供者支援,為 Key 설정最小必要권한
  5. 모니터링異常用量:定期檢查 API 使用量儀表板
유출 대응

如果你的 API Key 不小心外洩(例如제출到 GitHub),請立即:

  1. 在提供者控制台撤銷該 Key
  2. 생성新的 Key
  3. 檢查帳單確認是否有異常消費
  4. 審查 Git 歷史並清理敏感데이터

관련 페이지