Panduan Konfigurasi

Semua pengaturan OpenClaw terpusat di satu file konfigurasi. Yuk, pelajari cara menyesuaikannya.

📄 Lokasi File Konfigurasi

File konfigurasi utama OpenClaw terletak di:

~/.openclaw/openclaw.json

Di sini, ~ berarti direktori home pengguna. Misalnya di macOS, path lengkapnya biasanya /Users/nama-pengguna/.openclaw/openclaw.json.

💡 Tips: .openclaw adalah folder tersembunyi (folder yang namanya diawali titik secara default tidak terlihat). Di macOS Finder, tekan Command + Shift + . untuk menampilkan file tersembunyi. Di Linux, gunakan perintah ls -a untuk melihatnya.

⚙️ Pengaturan Konfigurasi Utama

Berikut pengaturan yang paling sering digunakan dalam file konfigurasi:

Pemilihan Model AI

Atur model AI default yang digunakan:

{
  "model": {
    "provider": "anthropic",
    "name": "claude-sonnet-4-20250514",
    "api_key": "sk-ant-..."
  }
}

Kamu bisa mengubah provider menjadi "openai", "deepseek", atau "google", lalu isi nama model dan API key yang sesuai.

Manajemen Sesi

Kontrol perilaku percakapan AI:

{
  "session": {
    "max_history": 50,
    "timeout_minutes": 30,
    "system_prompt": "Kamu adalah asisten AI yang helpful..."
  }
}

max_history — Berapa banyak riwayat pesan yang disimpan per percakapan
timeout_minutes — Berapa menit tanpa interaksi sebelum percakapan baru dimulai otomatis
system_prompt — "Pengaturan karakter" AI, kamu bisa menyesuaikan kepribadian AI-nya

Konfigurasi Channel

Atur informasi koneksi untuk setiap platform chat:

{
  "channels": {
    "telegram": {
      "enabled": true,
      "bot_token": "123456:ABC-DEF..."
    },
    "discord": {
      "enabled": true,
      "bot_token": "MTIz..."
    }
  }
}

🔄 Hot Reload

OpenClaw mendukung hot reload, artinya setelah kamu mengubah file konfigurasi, tidak perlu me-restart OpenClaw, perubahan akan terdeteksi dan diterapkan secara otomatis.

Sederhananya: kamu cukup mengedit dan menyimpan file konfigurasi, OpenClaw akan otomatis menggunakan pengaturan baru, sangat praktis!

ℹ️ Catatan: Beberapa pengaturan inti (seperti nomor port) mungkin masih perlu restart manual. Tapi sebagian besar pengaturan (seperti pergantian model, konfigurasi channel) bisa di-hot reload.