OpenClaw Config Edit: Panduan Lengkap Persediaan & Konfigurasi (2026)

Ringkasan

Rujukan pantas untuk arahan konfigurasi OpenClaw yang paling biasa:

# Buka editor konfigurasi
openclaw config edit

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

# Lihat konfigurasi semasa
openclaw config show

# Sahkan dan betulkan isu konfigurasi
openclaw doctor
openclaw doctor --fix

# Set semula ke lalai
openclaw config reset

Apa Itu OpenClaw?

OpenClaw ialah rangka kerja pembantu AI sumber terbuka yang menghubungkan model bahasa besar ke saluran pemesejan seperti WhatsApp, Discord, Telegram, dan Slack. Ia menyokong pelbagai penyedia model — OpenAI, Anthropic, Ollama (model tempatan), Google, dan lain-lain — serta boleh dilanjutkan dengan kemahiran dan pemalam tersuai.

Teras OpenClaw ialah sistem konfigurasinya. Hampir semua perkara — saluran yang aktif, model yang digunakan, kemahiran yang dimuatkan — dikawal melalui fail konfigurasi. Menguasai openclaw config edit adalah kunci untuk menjalankan OpenClaw mengikut kehendak anda.

openclaw config edit: Asas

Membuka Editor Konfigurasi

Arahan utama untuk mengkonfigurasi OpenClaw ialah:

openclaw config edit

Ini membuka fail konfigurasi anda dalam editor terminal lalai (biasanya nano, vim, atau apa sahaja yang ditetapkan pada $EDITOR). Fail konfigurasi biasanya terletak di ~/.openclaw/config.yaml atau ~/.config/openclaw/config.yaml bergantung pada pemasangan anda.

Struktur Fail Konfigurasi

Fail konfigurasi OpenClaw berformat YAML dan disusun dalam bahagian:

# Konfigurasi model
model:
  provider: openai        # openai, anthropic, ollama, google
  name: gpt-4o            # rentetan pengecam model
  temperature: 0.7
  max_tokens: 4096

# Konfigurasi saluran
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: ""

# Kemahiran dan pemalam
skills:
  - web_search
  - calculator
  - weather

# Pertuturan-ke-teks
stt:
  provider: whisper
  model: whisper-1

# Prompt sistem
system_prompt: "You are a helpful assistant."

Menetapkan Nilai Individu

Daripada mengedit keseluruhan fail, anda boleh menetapkan nilai konfigurasi individu dari baris arahan:

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

Ini berguna untuk skrip atau perubahan pantas tanpa membuka editor.

Menyediakan Saluran

WhatsApp

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

# 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"

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

Discord

Persediaan Discord lebih mudah — anda hanya memerlukan token bot dari Portal Pembangun Discord.

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

Telegram

Telegram memerlukan token bot daripada @BotFather:

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

Telegram menyokong mod undian dan webhook. Undian lebih mudah untuk pembangunan (tiada URL awam diperlukan):

openclaw config set channels.telegram.mode polling

Untuk pengeluaran, gunakan mod webhook:

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 (disyorkan) atau Events API:

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 disyorkan kerana ia tidak memerlukan URL awam.

Mengkonfigurasi Penyedia Model

OpenAI

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

Tetapkan kunci API anda sebagai pemboleh ubah persekitaran (jangan letakkan dalam fail konfigurasi):

export OPENAI_API_KEY="sk-..."

Anthropic (Claude)

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

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

Ollama (Model Tempatan)

Di sinilah OpenClaw bersinar untuk pengguna yang mementingkan privasi. Ollama membolehkan anda menjalankan model secara tempatan tanpa kunci API atau data meninggalkan mesin anda.

# Pasang Ollama dahulu
# https://ollama.ai

# Muat turun model
ollama pull llama3.3

# Konfigurasi 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"

Google (Gemini)

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

export GOOGLE_API_KEY="..."

xAI (Grok)

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

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

Ralat Konfigurasi Biasa dan Penyelesaian

Ralat: "Unknown config key"

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

Ini biasanya bermakna ada kesilapan taip dalam kunci konfigurasi. Semak ejaan anda. Kesilapan biasa:

• chanels → channels


• providr → provider


• telgram → telegram

Ralat: "Channel auto-enabled without credentials"

Sesetengah versi OpenClaw mengaktifkan saluran secara automatik apabila anda menetapkan kelayakan, walaupun anda tidak mengaktifkannya secara eksplisit. Ini boleh menyebabkan kegagalan permulaan jika kelayakan tidak lengkap.

# Nyahaktifkan saluran yang tidak digunakan secara eksplisit
openclaw config set channels.whatsapp.enabled false
openclaw config set channels.discord.enabled false
openclaw config set channels.slack.enabled false

Ralat: "Model provider not configured"

Error: Model provider 'anthropic' requires ANTHROPIC_API_KEY

Anda perlu menetapkan pemboleh ubah persekitaran yang sepadan. OpenClaw sengaja tidak menyimpan kunci API dalam fail konfigurasi atas sebab keselamatan.

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

Menggunakan openclaw doctor

Arahan openclaw doctor mengesahkan keseluruhan konfigurasi anda dan melaporkan isu:

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.

Bendera --fix cuba menyelesaikan isu secara automatik:

openclaw doctor --fix

Ini akan menyahaktifkan saluran dengan kelayakan yang hilang, membetulkan isu format yang diketahui, dan mencadangkan penyelesaian manual untuk masalah yang tidak dapat diselesaikan secara automatik.

Konfigurasi Lanjutan

Kemahiran Tersuai

OpenClaw menyokong kemahiran tersuai (pemalam) yang memperluaskan keupayaan pembantu:

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

Atau melalui baris arahan:

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

Konfigurasi Pertuturan-ke-Teks (STT)

Untuk sokongan mesej suara di WhatsApp dan Telegram:

stt:
  provider: whisper          # whisper, deepgram, google
  model: whisper-1
  language: auto             # kesan automatik atau nyatakan "en", "ms", dll.

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

Integrasi Rumah Pintar Tuya

OpenClaw boleh mengawal peranti rumah pintar serasi Tuya:

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

Ini membolehkan anda mengawal lampu, suis, termostat, dan peranti Tuya lain melalui arahan bahasa semula jadi di mana-mana saluran yang disambungkan.

Konfigurasi Pelbagai Model

Anda boleh menentukan pratetap model dan bertukar antaranya:

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

openclaw config set model.active default
# atau tukar semasa jalan
openclaw --model fast

Soalan Lazim

Di manakah fail konfigurasi OpenClaw disimpan?

Lokasi lalai ialah ~/.openclaw/config.yaml. Pada sesetengah pemasangan ia mungkin di ~/.config/openclaw/config.yaml. Jalankan openclaw config show --path untuk melihat lokasi tepat.

Bolehkah saya menggunakan OpenClaw tanpa sebarang API awan?

Ya. Konfigurasi Ollama sebagai penyedia model anda dan gunakan Telegram dalam mod undian. Ini memberi anda pembantu AI tempatan sepenuhnya dan peribadi tanpa data meninggalkan mesin anda.

Bagaimana saya mengemas kini OpenClaw?

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

Selepas mengemas kini, jalankan openclaw doctor untuk memeriksa sebarang perubahan format konfigurasi.

Bolehkah saya menjalankan pelbagai saluran serentak?

Ya. Aktifkan seberapa banyak saluran yang anda mahu — OpenClaw mengendalikannya secara serentak. Setiap saluran berkongsi konfigurasi model dan kemahiran yang sama.

Bagaimana saya menetapkan semula konfigurasi ke lalai?

openclaw config reset

Ini menulis ganti fail konfigurasi anda dengan templat lalai. Sandarkan konfigurasi sedia ada anda dahulu jika perlu.

Mahukan Sesuatu Yang Lebih Mudah?

OpenClaw berkuasa tetapi memerlukan keselesaan terminal dan konfigurasi manual. Jika anda ingin membina dan menghantar produk berkuasa AI tanpa menguruskan fail konfigurasi, penyedia model, dan integrasi saluran sendiri:

• OpenClaw GitHub Repository
• OpenClaw Documentation
• Ollama Installation Guide
• WhatsApp Business API Docs