Edit Konfigurasi OpenClaw: Panduan Penyiapan Lengkap (2026)

Q: Di mana file konfigurasi OpenClaw disimpan?

Lokasi default adalah ~/.openclaw/config.yaml. Pada beberapa instalasi, lokasinya mungkin di ~/.config/openclaw/config.yaml. Jalankan openclaw config show --path untuk melihat lokasi pastinya.

Q: Bagaimana cara memperbarui OpenClaw?

```bash pip install --upgrade openclaw

Q: Bagaimana cara meriset konfigurasi saya ke default?

```bash openclaw config reset ```

TL;DR

Referensi cepat untuk perintah konfigurasi OpenClaw yang paling umum:

bash

# Buka editor konfigurasi
openclaw config edit

# Atur nilai spesifik
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o

# Lihat konfigurasi saat ini
openclaw config show

# Validasi dan perbaiki masalah konfigurasi
openclaw doctor
openclaw doctor --fix

# Reset ke pengaturan default
openclaw config reset

Apa Itu OpenClaw?

OpenClaw adalah framework asisten AI open-source yang menghubungkan model bahasa besar (LLM) ke saluran pesan seperti WhatsApp, Discord, Telegram, dan Slack. Ia mendukung berbagai penyedia model — OpenAI, Anthropic, Ollama (model lokal), Google, dan banyak lagi — serta dapat diperluas dengan skill dan plugin kustom.

Inti dari OpenClaw adalah sistem konfigurasinya. Hampir semuanya — saluran mana yang aktif, model mana yang digunakan, skill mana yang dimuat — dikendalikan melalui file konfigurasi. Menguasai openclaw config edit adalah kunci untuk membuat OpenClaw berjalan sesuai keinginan Anda.

openclaw config edit: Dasar-Dasar

Membuka Editor Konfigurasi

Perintah utama untuk mengonfigurasi OpenClaw adalah:

bash

openclaw config edit

Ini akan membuka file konfigurasi Anda di editor terminal default (biasanya nano, vim, atau apa pun yang diatur pada $EDITOR). File konfigurasi biasanya terletak di ~/.openclaw/config.yaml atau ~/.config/openclaw/config.yaml tergantung pada instalasi Anda.

Struktur File Konfigurasi

File konfigurasi OpenClaw berformat YAML dan diatur ke dalam beberapa bagian:

yaml

# Model configuration
model:
  provider: openai        # openai, anthropic, ollama, google
  name: gpt-4o            # model identifier string
  temperature: 0.7
  max_tokens: 4096

# Channel configuration
channels:
  whatsapp:
    enabled: false
    phone_number_id: ""
    access_token: ""
  discord:
    enabled: false
    bot_token: ""
  telegram:
    enabled: false
    bot_token: ""
  slack:
    enabled: false
    bot_token: ""
    app_token: ""

# Skills and plugins
skills:
  - web_search
  - calculator
  - weather

# Speech-to-text
stt:
  provider: whisper
  model: whisper-1

# System prompt
system_prompt: "You are a helpful assistant."

Mengatur Nilai Individu

Alih-alih mengedit file lengkap, Anda dapat mengatur nilai konfigurasi individu dari baris perintah:

bash

openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6
openclaw config set model.temperature 0.5

Ini sangat berguna untuk pembuatan skrip atau perubahan cepat tanpa harus membuka editor.

Menyiapkan Saluran

Integrasi WhatsApp memerlukan akun Meta Business dan akses WhatsApp Business API.

bash

# Aktifkan saluran WhatsApp
openclaw config set channels.whatsapp.enabled true
openclaw config set channels.whatsapp.phone_number_id "YOUR_PHONE_NUMBER_ID"
openclaw config set channels.whatsapp.access_token "YOUR_ACCESS_TOKEN"
openclaw config set channels.whatsapp.verify_token "YOUR_VERIFY_TOKEN"

Masalah umum: WhatsApp memerlukan URL webhook. Anda perlu mengekspos OpenClaw ke internet menggunakan reverse proxy (nginx, Caddy) atau layanan tunnel (ngrok, Cloudflare Tunnel).

bash

# Atur URL webhook
openclaw config set channels.whatsapp.webhook_url "https://your-domain.com/webhook/whatsapp"

Discord

Penyiapan Discord lebih sederhana — Anda hanya memerlukan bot token dari Discord Developer Portal.

bash

openclaw config set channels.discord.enabled true
openclaw config set channels.discord.bot_token "YOUR_DISCORD_BOT_TOKEN"

Tip: Pastikan bot Discord Anda telah mengaktifkan "Message Content" privileged intent di Developer Portal, jika tidak, bot tidak akan bisa membaca pesan.

Telegram memerlukan bot token dari @BotFather:

bash

openclaw config set channels.telegram.enabled true
openclaw config set channels.telegram.bot_token "YOUR_TELEGRAM_BOT_TOKEN"

Telegram mendukung mode polling dan webhook. Polling lebih mudah untuk pengembangan (tidak memerlukan URL publik):

bash

openclaw config set channels.telegram.mode polling

Untuk produksi, gunakan mode webhook:

bash

openclaw config set channels.telegram.mode webhook
openclaw config set channels.telegram.webhook_url "https://your-domain.com/webhook/telegram"

Slack

Integrasi Slack menggunakan Socket Mode (direkomendasikan) atau Events API:

bash

openclaw config set channels.slack.enabled true
openclaw config set channels.slack.bot_token "xoxb-YOUR-BOT-TOKEN"
openclaw config set channels.slack.app_token "xapp-YOUR-APP-TOKEN"

Socket Mode direkomendasikan karena tidak memerlukan URL publik.

Mengonfigurasi Penyedia Model

OpenAI

bash

openclaw config set model.provider openai
openclaw config set model.name gpt-4o

Atur API key Anda sebagai variabel lingkungan (jangan letakkan di dalam file konfigurasi):

bash

export OPENAI_API_KEY="sk-..."

Anthropic (Claude)

bash

openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6

bash

export ANTHROPIC_API_KEY="sk-ant-..."

Ollama (Model Lokal)

Di sinilah OpenClaw bersinar bagi pengguna yang peduli dengan privasi. Ollama memungkinkan Anda menjalankan model secara lokal tanpa API key atau data yang keluar dari mesin Anda.

bash

# Instal Ollama terlebih dahulu
# https://ollama.ai

# Unduh model
ollama pull llama3.3

# Konfigurasikan OpenClaw untuk menggunakan Ollama
openclaw config set model.provider ollama
openclaw config set model.name llama3.3
openclaw config set model.base_url "http://localhost:11434"

Masalah umum: Jika OpenClaw tidak dapat terhubung ke Ollama, pastikan Ollama sedang berjalan (ollama serve) dan base URL sudah sesuai. Port default Ollama adalah 11434.

Google (Gemini)

bash

openclaw config set model.provider google
openclaw config set model.name gemini-2.5-pro

bash

export GOOGLE_API_KEY="..."

xAI (Grok)

bash

openclaw config set model.provider openai   # xAI menggunakan API yang kompatibel dengan OpenAI
openclaw config set model.name grok-4.1
openclaw config set model.base_url "https://api.x.ai/v1"

bash

export OPENAI_API_KEY="xai-..."   # Gunakan key xAI dengan penyedia OpenAI

Kesalahan Konfigurasi Umum dan Perbaikannya

Kesalahan: "Unknown config key"

Error: Unknown config key 'chanels.whatsapp.enabled'

Ini biasanya berarti ada kesalahan ketik pada kunci konfigurasi. Periksa ejaan Anda. Kesalahan umum:

chanels → channels

providr → provider

telgram → telegram

Jalankan openclaw config show untuk melihat semua kunci yang valid.

Kesalahan: "Channel auto-enabled without credentials"

Beberapa versi OpenClaw mengaktifkan saluran secara otomatis saat Anda mengatur kredensial, bahkan jika Anda belum mengaktifkannya secara eksplisit. Ini dapat menyebabkan kegagalan startup jika kredensial tidak lengkap.

Perbaikan:

bash

# Nonaktifkan saluran yang tidak Anda gunakan secara eksplisit
openclaw config set channels.whatsapp.enabled false
openclaw config set channels.discord.enabled false
openclaw config set channels.slack.enabled false

Kesalahan: "Model provider not configured"

Error: Model provider 'anthropic' requires ANTHROPIC_API_KEY

Anda perlu mengatur variabel lingkungan yang sesuai. OpenClaw sengaja tidak menyimpan API key di dalam file konfigurasi untuk alasan keamanan.

Perbaikan: Tambahkan API key ke profil shell Anda (~/.bashrc, ~/.zshrc) atau gunakan file .env:

bash

echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc
source ~/.zshrc

Menggunakan openclaw doctor

Perintah openclaw doctor memvalidasi seluruh konfigurasi Anda dan melaporkan masalah:

bash

openclaw doctor

Contoh output:

Checking configuration...
  ✓ Config file found
  ✓ Model provider configured
  ✗ WhatsApp: enabled but missing access_token
  ✗ Discord: bot token invalid format
  ✓ Telegram: configured correctly
  ✓ Ollama: connection successful

2 issues found. Run 'openclaw doctor --fix' to attempt auto-fix.

Flag --fix mencoba menyelesaikan masalah secara otomatis:

bash

openclaw doctor --fix

Ini akan menonaktifkan saluran dengan kredensial yang hilang, memperbaiki masalah format yang diketahui, dan menyarankan perbaikan manual untuk masalah yang tidak dapat diselesaikan secara otomatis.

Konfigurasi Lanjutan

Skill Kustom

OpenClaw mendukung skill kustom (plugin) yang memperluas kemampuan asisten:

yaml

skills:
  - web_search
  - calculator
  - weather
  - custom_skill:
      path: ./my-skills/custom_tool.py
      config:
        api_key_env: CUSTOM_API_KEY

Atau melalui baris perintah:

bash

openclaw skills add web_search
openclaw skills add ./my-skills/custom_tool.py
openclaw skills list
openclaw skills remove calculator

Konfigurasi Speech-to-Text (STT)

Untuk dukungan pesan suara di WhatsApp dan Telegram:

yaml

stt:
  provider: whisper          # whisper, deepgram, google
  model: whisper-1
  language: auto             # deteksi otomatis atau tentukan "en", "id", dll.

bash

openclaw config set stt.provider whisper
openclaw config set stt.model whisper-1

Integrasi Tuya Smart Home

OpenClaw dapat mengontrol perangkat smart home yang kompatibel dengan Tuya:

yaml

tuya:
  enabled: true
  access_id: "YOUR_TUYA_ACCESS_ID"
  access_key: "YOUR_TUYA_ACCESS_KEY"
  endpoint: "https://openapi.tuyaus.com"

Ini memungkinkan Anda mengontrol lampu, sakelar, termostat, dan perangkat Tuya lainnya melalui perintah bahasa alami di saluran mana pun yang terhubung.

Konfigurasi Beberapa Model

Anda dapat mendefinisikan preset model dan beralih di antaranya:

yaml

models:
  default:
    provider: openai
    name: gpt-4o
  fast:
    provider: ollama
    name: llama3.3
  reasoning:
    provider: anthropic
    name: claude-opus-4-6

bash

openclaw config set model.active default
# atau beralih saat runtime
openclaw --model fast

Pertanyaan yang Sering Diajukan (FAQ)

Di mana file konfigurasi OpenClaw disimpan?

Lokasi default adalah ~/.openclaw/config.yaml. Pada beberapa instalasi, lokasinya mungkin di ~/.config/openclaw/config.yaml. Jalankan openclaw config show --path untuk melihat lokasi pastinya.

Dapatkah saya menggunakan OpenClaw tanpa API cloud apa pun?

Ya. Konfigurasikan Ollama sebagai penyedia model Anda dan gunakan Telegram dalam mode polling. Ini memberi Anda asisten AI yang sepenuhnya lokal dan pribadi tanpa ada data yang meninggalkan mesin Anda.

Bagaimana cara memperbarui OpenClaw?

bash

pip install --upgrade openclaw
# atau
npm update -g openclaw

Setelah memperbarui, jalankan openclaw doctor untuk memeriksa adanya perubahan format konfigurasi.

Dapatkah saya menjalankan beberapa saluran secara bersamaan?

Ya. Aktifkan saluran sebanyak yang Anda inginkan — OpenClaw menanganinya secara bersamaan. Setiap saluran berbagi konfigurasi model dan skill yang sama.

Bagaimana cara meriset konfigurasi saya ke default?

bash

openclaw config reset

Ini akan menimpa file konfigurasi Anda dengan templat default. Cadangkan konfigurasi Anda yang ada terlebih dahulu jika diperlukan.

Ingin Sesuatu yang Lebih Sederhana?

OpenClaw sangat bertenaga tetapi memerlukan kenyamanan menggunakan terminal dan konfigurasi manual. Jika Anda ingin membangun dan meluncurkan produk bertenaga AI tanpa harus mengelola file konfigurasi, penyedia model, dan integrasi saluran sendiri:

Y Build menangani seluruh tumpukan teknologi (full stack) — deployment, video produk, AI SEO, dan analitik. Tanpa file konfigurasi. Tanpa terminal. Cukup bangun dan luncurkan. Mulai gratis →

Sumber:

TL;DR

Referensi cepat untuk perintah konfigurasi OpenClaw yang paling umum:

bash

# Buka editor konfigurasi
openclaw config edit

# Atur nilai spesifik
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o

# Lihat konfigurasi saat ini
openclaw config show

# Validasi dan perbaiki masalah konfigurasi
openclaw doctor
openclaw doctor --fix

# Reset ke pengaturan default
openclaw config reset

Apa Itu OpenClaw?

openclaw config edit: Dasar-Dasar

Membuka Editor Konfigurasi

Perintah utama untuk mengonfigurasi OpenClaw adalah:

bash

openclaw config edit

Struktur File Konfigurasi

File konfigurasi OpenClaw berformat YAML dan diatur ke dalam beberapa bagian:

yaml

# Model configuration
model:
  provider: openai        # openai, anthropic, ollama, google
  name: gpt-4o            # model identifier string
  temperature: 0.7
  max_tokens: 4096

# Channel configuration
channels:
  whatsapp:
    enabled: false
    phone_number_id: ""
    access_token: ""
  discord:
    enabled: false
    bot_token: ""
  telegram:
    enabled: false
    bot_token: ""
  slack:
    enabled: false
    bot_token: ""
    app_token: ""

# Skills and plugins
skills:
  - web_search
  - calculator
  - weather

# Speech-to-text
stt:
  provider: whisper
  model: whisper-1

# System prompt
system_prompt: "You are a helpful assistant."

Mengatur Nilai Individu

Alih-alih mengedit file lengkap, Anda dapat mengatur nilai konfigurasi individu dari baris perintah:

bash

openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6
openclaw config set model.temperature 0.5

Ini sangat berguna untuk pembuatan skrip atau perubahan cepat tanpa harus membuka editor.

Menyiapkan Saluran

Integrasi WhatsApp memerlukan akun Meta Business dan akses WhatsApp Business API.

bash

# Aktifkan saluran WhatsApp
openclaw config set channels.whatsapp.enabled true
openclaw config set channels.whatsapp.phone_number_id "YOUR_PHONE_NUMBER_ID"
openclaw config set channels.whatsapp.access_token "YOUR_ACCESS_TOKEN"
openclaw config set channels.whatsapp.verify_token "YOUR_VERIFY_TOKEN"

Masalah umum: WhatsApp memerlukan URL webhook. Anda perlu mengekspos OpenClaw ke internet menggunakan reverse proxy (nginx, Caddy) atau layanan tunnel (ngrok, Cloudflare Tunnel).

bash

# Atur URL webhook
openclaw config set channels.whatsapp.webhook_url "https://your-domain.com/webhook/whatsapp"

Discord

Penyiapan Discord lebih sederhana — Anda hanya memerlukan bot token dari Discord Developer Portal.

bash

openclaw config set channels.discord.enabled true
openclaw config set channels.discord.bot_token "YOUR_DISCORD_BOT_TOKEN"

Tip: Pastikan bot Discord Anda telah mengaktifkan "Message Content" privileged intent di Developer Portal, jika tidak, bot tidak akan bisa membaca pesan.

Telegram memerlukan bot token dari @BotFather:

bash

openclaw config set channels.telegram.enabled true
openclaw config set channels.telegram.bot_token "YOUR_TELEGRAM_BOT_TOKEN"

Telegram mendukung mode polling dan webhook. Polling lebih mudah untuk pengembangan (tidak memerlukan URL publik):

bash

openclaw config set channels.telegram.mode polling

Untuk produksi, gunakan mode webhook:

bash

openclaw config set channels.telegram.mode webhook
openclaw config set channels.telegram.webhook_url "https://your-domain.com/webhook/telegram"

Slack

Integrasi Slack menggunakan Socket Mode (direkomendasikan) atau Events API:

bash

openclaw config set channels.slack.enabled true
openclaw config set channels.slack.bot_token "xoxb-YOUR-BOT-TOKEN"
openclaw config set channels.slack.app_token "xapp-YOUR-APP-TOKEN"

Socket Mode direkomendasikan karena tidak memerlukan URL publik.

Mengonfigurasi Penyedia Model

OpenAI

bash

openclaw config set model.provider openai
openclaw config set model.name gpt-4o

Atur API key Anda sebagai variabel lingkungan (jangan letakkan di dalam file konfigurasi):

bash

export OPENAI_API_KEY="sk-..."

Anthropic (Claude)

bash

openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6

bash

export ANTHROPIC_API_KEY="sk-ant-..."

Ollama (Model Lokal)

Di sinilah OpenClaw bersinar bagi pengguna yang peduli dengan privasi. Ollama memungkinkan Anda menjalankan model secara lokal tanpa API key atau data yang keluar dari mesin Anda.

bash

# Instal Ollama terlebih dahulu
# https://ollama.ai

# Unduh model
ollama pull llama3.3

# Konfigurasikan OpenClaw untuk menggunakan Ollama
openclaw config set model.provider ollama
openclaw config set model.name llama3.3
openclaw config set model.base_url "http://localhost:11434"

Masalah umum: Jika OpenClaw tidak dapat terhubung ke Ollama, pastikan Ollama sedang berjalan (ollama serve) dan base URL sudah sesuai. Port default Ollama adalah 11434.

Google (Gemini)

bash

openclaw config set model.provider google
openclaw config set model.name gemini-2.5-pro

bash

export GOOGLE_API_KEY="..."

xAI (Grok)

bash

openclaw config set model.provider openai   # xAI menggunakan API yang kompatibel dengan OpenAI
openclaw config set model.name grok-4.1
openclaw config set model.base_url "https://api.x.ai/v1"

bash

export OPENAI_API_KEY="xai-..."   # Gunakan key xAI dengan penyedia OpenAI

Kesalahan Konfigurasi Umum dan Perbaikannya

Kesalahan: "Unknown config key"

Error: Unknown config key 'chanels.whatsapp.enabled'

Ini biasanya berarti ada kesalahan ketik pada kunci konfigurasi. Periksa ejaan Anda. Kesalahan umum:

chanels → channels

providr → provider

telgram → telegram

Jalankan openclaw config show untuk melihat semua kunci yang valid.

Kesalahan: "Channel auto-enabled without credentials"

Perbaikan:

bash

# Nonaktifkan saluran yang tidak Anda gunakan secara eksplisit
openclaw config set channels.whatsapp.enabled false
openclaw config set channels.discord.enabled false
openclaw config set channels.slack.enabled false

Kesalahan: "Model provider not configured"

Error: Model provider 'anthropic' requires ANTHROPIC_API_KEY

Anda perlu mengatur variabel lingkungan yang sesuai. OpenClaw sengaja tidak menyimpan API key di dalam file konfigurasi untuk alasan keamanan.

Perbaikan: Tambahkan API key ke profil shell Anda (~/.bashrc, ~/.zshrc) atau gunakan file .env:

bash

echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc
source ~/.zshrc

Menggunakan openclaw doctor

Perintah openclaw doctor memvalidasi seluruh konfigurasi Anda dan melaporkan masalah:

bash

openclaw doctor

Contoh output:

Checking configuration...
  ✓ Config file found
  ✓ Model provider configured
  ✗ WhatsApp: enabled but missing access_token
  ✗ Discord: bot token invalid format
  ✓ Telegram: configured correctly
  ✓ Ollama: connection successful

2 issues found. Run 'openclaw doctor --fix' to attempt auto-fix.

Flag --fix mencoba menyelesaikan masalah secara otomatis:

bash

openclaw doctor --fix

Ini akan menonaktifkan saluran dengan kredensial yang hilang, memperbaiki masalah format yang diketahui, dan menyarankan perbaikan manual untuk masalah yang tidak dapat diselesaikan secara otomatis.

Konfigurasi Lanjutan

Skill Kustom

OpenClaw mendukung skill kustom (plugin) yang memperluas kemampuan asisten:

yaml

skills:
  - web_search
  - calculator
  - weather
  - custom_skill:
      path: ./my-skills/custom_tool.py
      config:
        api_key_env: CUSTOM_API_KEY

Atau melalui baris perintah:

bash

openclaw skills add web_search
openclaw skills add ./my-skills/custom_tool.py
openclaw skills list
openclaw skills remove calculator

Konfigurasi Speech-to-Text (STT)

Untuk dukungan pesan suara di WhatsApp dan Telegram:

yaml

stt:
  provider: whisper          # whisper, deepgram, google
  model: whisper-1
  language: auto             # deteksi otomatis atau tentukan "en", "id", dll.

bash

openclaw config set stt.provider whisper
openclaw config set stt.model whisper-1

Integrasi Tuya Smart Home

OpenClaw dapat mengontrol perangkat smart home yang kompatibel dengan Tuya:

yaml

tuya:
  enabled: true
  access_id: "YOUR_TUYA_ACCESS_ID"
  access_key: "YOUR_TUYA_ACCESS_KEY"
  endpoint: "https://openapi.tuyaus.com"

Ini memungkinkan Anda mengontrol lampu, sakelar, termostat, dan perangkat Tuya lainnya melalui perintah bahasa alami di saluran mana pun yang terhubung.

Konfigurasi Beberapa Model

Anda dapat mendefinisikan preset model dan beralih di antaranya:

yaml

models:
  default:
    provider: openai
    name: gpt-4o
  fast:
    provider: ollama
    name: llama3.3
  reasoning:
    provider: anthropic
    name: claude-opus-4-6

bash

openclaw config set model.active default
# atau beralih saat runtime
openclaw --model fast

Pertanyaan yang Sering Diajukan (FAQ)

Di mana file konfigurasi OpenClaw disimpan?

Lokasi default adalah ~/.openclaw/config.yaml. Pada beberapa instalasi, lokasinya mungkin di ~/.config/openclaw/config.yaml. Jalankan openclaw config show --path untuk melihat lokasi pastinya.

Dapatkah saya menggunakan OpenClaw tanpa API cloud apa pun?

Bagaimana cara memperbarui OpenClaw?

bash

pip install --upgrade openclaw
# atau
npm update -g openclaw

Setelah memperbarui, jalankan openclaw doctor untuk memeriksa adanya perubahan format konfigurasi.

Dapatkah saya menjalankan beberapa saluran secara bersamaan?

Ya. Aktifkan saluran sebanyak yang Anda inginkan — OpenClaw menanganinya secara bersamaan. Setiap saluran berbagi konfigurasi model dan skill yang sama.

Bagaimana cara meriset konfigurasi saya ke default?

bash

openclaw config reset

Ini akan menimpa file konfigurasi Anda dengan templat default. Cadangkan konfigurasi Anda yang ada terlebih dahulu jika diperlukan.

Ingin Sesuatu yang Lebih Sederhana?

Y Build menangani seluruh tumpukan teknologi (full stack) — deployment, video produk, AI SEO, dan analitik. Tanpa file konfigurasi. Tanpa terminal. Cukup bangun dan luncurkan. Mulai gratis →

Sumber: