API Keys 取得가이드
OpenClaw 需要至少一個 LLM 提供者的 API Key 才能運作。本가이드將逐步教你如何取得各大 LLM 提供者的 API Key,以及在 OpenClaw 中的설정 방법。
비용 안내
使用 LLM API 會產生費用。每個提供者的計費方式不同,請在申請前確認價格。大部分提供者都有免費額度供初始테스트使用。
빠른 비교표
| 提供者 | 推薦模型 | 免費額度 | 每百萬 Token 價格(約) | 適合場景 |
|---|---|---|---|---|
| OpenAI | GPT-5.2 Codex | 有限額 | $2-15 | 通用對話、程式碼生成 |
| Anthropic | Claude Opus 4.6 | 有限額 | $3-15 | 長文分析、複雜推理 |
| Gemini 2.5 Pro | 免費額度較高 | $1-7 | 多模態、性價比高 | |
| DeepSeek | DeepSeek-V3 | 價格極低 | $0.1-0.5 | 預算導向、中文優化 |
| Ollama (本機) | 各種開源模型 | 完全免費 | $0(僅硬體成本) | 離線使用、隱私優先 |
OpenAI API Key
申請步驟
- 前往 platform.openai.com
- 註冊계정或登入現有계정
- 點選左側選單的 API Keys
- 點選 Create new secret key
- 為 Key 命名(例如
openclaw-production) - 複製並安全저장 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
申請步驟
- 前往 console.anthropic.com
- 註冊계정(需要電話號碼검증)
- 進入 Settings → API Keys
- 點選 Create Key
- 複製並安全저장
在 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
申請步驟
- 前往 aistudio.google.com
- 使用 Google 계정登入
- 點選 Get API Key
- 選擇或생성 Google Cloud Project
- 複製生成的 API Key
在 OpenClaw 中설정
llm:
provider: google
api_key: AIzaxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
model: gemini-2.5-pro
特色功能
- 多模態支援(圖片、영상、音訊)
- 免費額度相對充裕
- 與 Google Workspace 整合良好
DeepSeek API Key
申請步驟
- 前往 platform.deepseek.com
- 註冊계정(支援중국手機號碼)
- 進入控制台,找到 API Keys 區域
- 생성新的 Key 並複製
在 OpenClaw 中설정
llm:
provider: deepseek
api_key: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
model: deepseek-v3
適用場景
- 預算有限:價格僅為 OpenAI 的 1/10 到 1/30
- 中文場景:針對中文做過特別優化
- 중국사용자:無需翻牆即可使用
중국 특별 설명
DeepSeek 是중국사용자的首選 LLM 提供者,因為無需翻牆且價格極低。但請注意,國有엔터프라이즈使用 AI 服務可能有額外컴플라이언스要求。詳見 中國生態系統。
Ollama(本機模型)
설치步驟
Ollama 不需要 API Key,因為它在你的本機電腦上運行開源模型。
- 前往 ollama.com 다운로드설치
- 설치完成後,拉取模型:
ollama pull llama3.3
ollama pull deepseek-r1:32b
- 在 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 安全最佳實踐
- 使用環境變數:不要將 Key 直接寫在설정 파일中
- 定期輪換:每 90 天更換一次 API Key
- 설정用量上限:在每個提供者的控制台설정月度預算
- 最小권한原則:如果提供者支援,為 Key 설정最小必要권한
- 모니터링異常用量:定期檢查 API 使用量儀表板
유출 대응
如果你的 API Key 不小心外洩(例如제출到 GitHub),請立即:
- 在提供者控制台撤銷該 Key
- 생성新的 Key
- 檢查帳單確認是否有異常消費
- 審查 Git 歷史並清理敏感데이터