Cara Menghubungkan OpenClaw
dengan AI API (OpenAI, Gemini, atau Local LLM)

Pendahuluan

OpenClaw tanpa AI itu seperti mobil tanpa mesin. Bisa jalan, tapi ga akan maksimal. Kekuatan sebenarnya dari OpenClaw baru keluar kalau dia terhubung dengan AI model yang bisa berpikir, menganalisis, dan membuat keputusan cerdas.

Di artikel ini, kita akan bahas cara menghubungkan OpenClaw dengan berbagai AI API—mulai dari cloud provider seperti OpenAI dan Google Gemini, sampai setup local LLM yang jalan di VPS sendiri. Semua dijelaskan step by step dengan contoh kode yang bisa langsung dipakai.

Pilihan AI Provider untuk OpenClaw

OpenClaw mendukung berbagai AI provider. Pilihan tergantung kebutuhan dan budget kamu:

Untuk mulai, saya sarankan pakai cloud API dulu (OpenAI atau Gemini). Kalau sudah nyaman dan butuh kontrol penuh atau hemat biaya jangka panjang, baru migrasi ke local LLM.

Integrasi dengan OpenAI GPT

OpenAI GPT (ChatGPT API) adalah pilihan paling populer karena kualitas output yang konsisten dan dokumentasi lengkap.

1. Dapatkan API Key OpenAI

Daftar di platform.openai.com dan buat API key baru. OpenAI kasih free credit $5 untuk akun baru (cukup untuk testing).

2. Tambahkan API Key ke .env

cd ~/openclaw
nano .env

Tambahkan:

# OpenAI Configuration
OPENAI_API_KEY=sk-proj-xxxxxxxxxxxxxxxxxx
OPENAI_MODEL=gpt-4o-mini
OPENAI_MAX_TOKENS=2000
OPENAI_TEMPERATURE=0.7

3. Edit Konfigurasi AI Provider

nano config/ai-providers.json

{
  "default": "openai",
  "providers": {
    "openai": {
      "enabled": true,
      "apiKey": "${OPENAI_API_KEY}",
      "model": "${OPENAI_MODEL}",
      "maxTokens": 2000,
      "temperature": 0.7,
      "timeout": 30000
    }
  }
}

4. Restart OpenClaw

pm2 restart openclaw

Integrasi dengan Google Gemini

Google Gemini punya free tier yang sangat generous (60 request per menit gratis). Cocok banget buat testing atau project kecil-menengah.

1. Dapatkan API Key Gemini

Akses Google AI Studio dan buat API key. Prosesnya cepat, ga perlu verifikasi kartu kredit.

2. Konfigurasi di .env

# Google Gemini Configuration
GEMINI_API_KEY=AIzaSyxxxxxxxxxxxxxxxxxxxxxxx
GEMINI_MODEL=gemini-1.5-flash
GEMINI_MAX_TOKENS=2000

3. Update ai-providers.json

{
  "default": "gemini",
  "providers": {
    "gemini": {
      "enabled": true,
      "apiKey": "${GEMINI_API_KEY}",
      "model": "${GEMINI_MODEL}",
      "maxTokens": 2000,
      "timeout": 30000
    }
  }
}

Model yang disarankan:

• gemini-1.5-flash — cepat, murah, cocok automation
• gemini-1.5-pro — lebih pintar, lebih mahal

Integrasi dengan Claude AI (Anthropic)

Claude punya context window yang sangat besar (hingga 200k tokens) dan bagus untuk reasoning task kompleks.

1. Setup API Key

Daftar di console.anthropic.com dan dapatkan API key.

2. Konfigurasi

# Claude Configuration
CLAUDE_API_KEY=sk-ant-xxxxxxxxxxxxx
CLAUDE_MODEL=claude-3-5-sonnet-20241022
CLAUDE_MAX_TOKENS=4000

3. ai-providers.json

{
  "providers": {
    "claude": {
      "enabled": true,
      "apiKey": "${CLAUDE_API_KEY}",
      "model": "${CLAUDE_MODEL}",
      "maxTokens": 4000
    }
  }
}

Setup Local LLM dengan Ollama

Kalau kamu mau privacy penuh, no API cost, dan kontrol total, local LLM adalah pilihan terbaik. Kita akan pakai Ollama karena paling mudah di-setup.

1. Install Ollama di VPS

curl -fsSL https://ollama.com/install.sh | sh

2. Download Model

# Model ringan untuk testing (2GB RAM)
ollama pull llama3.2:3b

# Model lebih pintar (8GB RAM)
ollama pull llama3.1:8b

# Model terbaik (16GB+ RAM)
ollama pull llama3.1:70b

Pilih model sesuai RAM VPS kamu. Untuk VPS 4GB, pakai llama3.2:3b sudah cukup.

3. Jalankan Ollama sebagai Service

ollama serve

Ollama akan jalan di http://localhost:11434

4. Konfigurasi OpenClaw untuk Ollama

# Ollama Configuration
OLLAMA_API_URL=http://localhost:11434
OLLAMA_MODEL=llama3.2:3b

5. ai-providers.json

{
  "default": "ollama",
  "providers": {
    "ollama": {
      "enabled": true,
      "apiUrl": "${OLLAMA_API_URL}",
      "model": "${OLLAMA_MODEL}",
      "timeout": 60000
    }
  }
}

Multi-Provider Setup (Advanced)

Untuk production-grade system, kamu bisa setup multiple provider sekaligus dengan fallback mechanism.

Konfigurasi Multi-Provider

{
  "default": "openai",
  "fallback": ["gemini", "ollama"],
  "providers": {
    "openai": {
      "enabled": true,
      "apiKey": "${OPENAI_API_KEY}",
      "model": "gpt-4o-mini",
      "maxTokens": 2000,
      "priority": 1
    },
    "gemini": {
      "enabled": true,
      "apiKey": "${GEMINI_API_KEY}",
      "model": "gemini-1.5-flash",
      "maxTokens": 2000,
      "priority": 2
    },
    "ollama": {
      "enabled": true,
      "apiUrl": "http://localhost:11434",
      "model": "llama3.2:3b",
      "priority": 3
    }
  },
  "loadBalancing": {
    "enabled": true,
    "strategy": "round-robin"
  }
}

Dengan setup ini:

• Request pertama ke OpenAI
• Kalau OpenAI down/error, fallback ke Gemini
• Kalau semua cloud API gagal, pakai Ollama (local)
• Load balancing round-robin untuk distribusi beban

Testing Koneksi AI

Setelah konfigurasi selesai, wajib test koneksi untuk memastikan semua jalan.

1. Test via API Endpoint

curl -X POST http://localhost:3000/api/ai/test \
  -H "Authorization: Bearer your-auth-token" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Hello, are you working?"}'

Response sukses:

{
  "status": "success",
  "provider": "openai",
  "model": "gpt-4o-mini",
  "response": "Yes, I'm working perfectly!",
  "latency": 1250
}

2. Test via CLI

npm run test:ai

3. Check Logs

pm2 logs openclaw --lines 50

Kalau ada error, biasanya muncul di sini.

Best Practices

1. Cost Optimization

• Pakai model yang sesuai — jangan pakai GPT-4 kalau GPT-4o-mini cukup
• Set max tokens — limit response biar ga boros
• Cache response — simpan hasil untuk request yang sama
• Batch request — gabungkan multiple task jadi satu call

2. Performance

• Set timeout proper — 30 detik untuk cloud, 60 detik untuk local
• Use streaming — untuk response cepat di UI
• Monitor latency — ganti provider kalau terlalu lambat

3. Security

• Jangan hardcode API key — selalu pakai .env
• Rotate key berkala — minimal 3 bulan sekali
• Set rate limit — hindari abuse
• Log sensitive data — jangan log full prompt/response

VPS yang Cocok untuk AI Workload

Kalau pakai cloud API (OpenAI, Gemini), VPS standar cukup. Tapi kalau mau jalanin local LLM, butuh spek yang lebih tinggi.

FAQ

AI provider mana yang paling murah?

Google Gemini punya free tier paling generous (60 req/menit gratis). Untuk paid, Groq paling murah per token. Tapi kalau long-term dan high volume, Ollama (local) paling hemat karena gratis selamanya.

Bisa pakai multiple AI provider sekaligus?

Bisa! OpenClaw support multi-provider dengan fallback mechanism. Kalau provider pertama error, otomatis switch ke backup.

Berapa RAM minimal untuk jalanin Ollama?

Tergantung model. Model 3B butuh minimal 4GB RAM, model 7B butuh 8GB, model 13B butuh 16GB. Tambah 2GB untuk overhead sistem.

Apakah local LLM sebagus cloud API?

Untuk model kecil (< 13B), cloud API masih lebih bagus. Tapi model local 70B+ bisa setara atau bahkan lebih baik, plus kontrol penuh dan privacy terjaga.

Bagaimana cara monitoring biaya AI API?

OpenAI dan Anthropic punya dashboard usage. Set budget limit dan alert. Untuk OpenClaw, bisa enable logging token usage dan buat dashboard monitoring sendiri.

Kesimpulan

Menghubungkan OpenClaw dengan AI API adalah langkah krusial untuk unlock automation yang benar-benar intelligent. Dengan setup yang benar, OpenClaw bisa:

• Analisis data dan buat keputusan cerdas
• Generate code, script, dan konfigurasi otomatis
• Respond terhadap kondisi dinamis
• Self-healing kalau ada error

Pilihan provider tergantung kebutuhan:

• Testing/Prototype → Google Gemini (free tier)
• Production kecil-menengah → OpenAI GPT-4o-mini
• High volume/privacy → Local LLM via Ollama
• Enterprise/Critical → Multi-provider dengan fallback

👉 Langkah Selanjutnya

AI yang powerful butuh server yang stabil.