Suntingan Konfigurasi OpenClaw: Panduan Persediaan Penuh (2026)
Panduan lengkap suntingan konfigurasi OpenClaw untuk WhatsApp, Discord, Telegram, dan Ollama. Salin-tampal arahan untuk mengkonfigurasi saluran, model, dan penyedia. Ralat konfigurasi umum diperbaiki.
TL;DR
Rujukan pantas untuk arahan konfigurasi OpenClaw yang paling biasa:
# Buka editor konfigurasi
openclaw config edit
# Tetapkan nilai spesifik
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
# Tetapkan semula ke lalai
openclaw config reset
Apa Itu OpenClaw?
OpenClaw ialah rangka kerja pembantu AI sumber terbuka yang menyambungkan model bahasa besar kepada saluran pemesejan seperti WhatsApp, Discord, Telegram, dan Slack. Ia menyokong pelbagai penyedia model — OpenAI, Anthropic, Ollama (model tempatan), Google, dan banyak lagi — serta boleh dilanjutkan dengan kemahiran dan pemalam tersuai.
Teras OpenClaw ialah sistem konfigurasinya. Hampir semua perkara — saluran mana yang aktif, model mana yang hendak digunakan, kemahiran mana yang dimuatkan — dikawal melalui fail konfigurasi. Menguasai openclaw config edit adalah kunci untuk membolehkan OpenClaw berjalan mengikut kehendak anda.
openclaw config edit: Asas
Membuka Editor Konfigurasi
Arahan utama untuk mengkonfigurasi OpenClaw ialah:
openclaw config edit
Ini akan membuka fail konfigurasi anda dalam editor terminal lalai anda (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 mengikut bahagian:
# 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."
Menetapkan Nilai Individu
Daripada menyunting fail penuh, anda boleh menetapkan nilai konfigurasi individu melalui 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 penskripan atau perubahan pantas tanpa membuka editor.
Menetapkan Saluran
Integrasi WhatsApp memerlukan akaun Meta Business dan akses WhatsApp Business API.
# Dayakan 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 adalah lebih mudah — anda hanya memerlukan bot token daripada Discord Developer Portal.
openclaw config set channels.discord.enabled true
openclaw config set channels.discord.bot_token "YOUR_DISCORD_BOT_TOKEN"
Telegram
Telegram memerlukan bot token daripada @BotFather:
openclaw config set channels.telegram.enabled true
openclaw config set channels.telegram.bot_token "YOUR_TELEGRAM_BOT_TOKEN"
Telegram menyokong kedua-dua mod polling dan webhook. Polling adalah lebih mudah untuk pembangunan (tidak memerlukan URL awam):
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 letakkannya 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 menyerlah bagi pengguna yang mementingkan privasi. Ollama membolehkan anda menjalankan model secara tempatan tanpa kunci API atau data keluar dari mesin anda.
# Pasang Ollama terlebih 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"
ollama serve) dan base URL adalah sepadan. Port lalai Ollama ialah 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 Umum dan Penyelesaian
Ralat: "Unknown config key"
Error: Unknown config key 'chanels.whatsapp.enabled'
Ini biasanya bermaksud terdapat kesilapan ejaan pada kunci konfigurasi. Periksa ejaan anda. Kesilapan biasa:
chanels→channelsprovidr→providertelgram→telegram
Jalankan
openclaw config show untuk melihat semua kunci yang sah.
Ralat: "Channel auto-enabled without credentials"
Sesetengah versi OpenClaw mengaktifkan saluran secara automatik apabila anda menetapkan kredensial, walaupun anda tidak mengaktifkannya secara eksplisit. Ini boleh menyebabkan kegagalan permulaan jika kredensial tidak lengkap.
Penyelesaian:# Nyahdayakan saluran yang anda tidak gunakan 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.
Penyelesaian: Tambahkan kunci API ke profil shell anda (~/.bashrc, ~/.zshrc) atau gunakan fail .env:
echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc
source ~/.zshrc
Menggunakan openclaw doctor
Arahan openclaw doctor mengesahkan keseluruhan konfigurasi anda dan melaporkan sebarang 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 menyahdayakan saluran yang kehilangan kredensial, membetulkan isu pemformatan yang diketahui, dan mencadangkan pembetulan 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 Ucapan-ke-Teks (STT)
Untuk sokongan mesej suara pada WhatsApp dan Telegram:
stt:
provider: whisper # whisper, deepgram, google
model: whisper-1
language: auto # auto-detect 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 yang serasi dengan 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 dalam mana-mana saluran yang disambungkan.
Pelbagai Konfigurasi 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 runtime
openclaw --model fast
Soalan Lazim
Di manakah fail konfigurasi OpenClaw disimpan?
Lokasi lalai ialah ~/.openclaw/config.yaml. Pada sesetengah pemasangan, ia mungkin berada di ~/.config/openclaw/config.yaml. Jalankan openclaw config show --path untuk melihat lokasi tepatnya.
Bolehkah saya menggunakan OpenClaw tanpa sebarang API awan?
Ya. Konfigurasikan Ollama sebagai penyedia model anda dan gunakan Telegram dalam mod polling. Ini memberikan anda pembantu AI tempatan yang tertutup sepenuhnya tanpa data keluar dari mesin anda.
Bagaimanakah cara untuk mengemas kini OpenClaw?
pip install --upgrade openclaw
# atau
npm update -g openclaw
Selepas mengemas kini, jalankan openclaw doctor untuk menyemak sebarang perubahan format konfigurasi.
Bolehkah saya menjalankan beberapa saluran secara serentak?
Ya. Dayakan seberapa banyak saluran yang anda mahu — OpenClaw mengendalikannya secara serentak. Setiap saluran berkongsi konfigurasi model dan kemahiran yang sama.
Bagaimanakah cara untuk menetapkan semula konfigurasi saya ke lalai?
openclaw config reset
Ini akan menulis ganti fail konfigurasi anda dengan templat lalai. Sandarkan konfigurasi sedia ada anda terlebih dahulu jika perlu.
Mahukan Sesuatu Yang Lebih Mudah?
OpenClaw sangat berkuasa tetapi memerlukan keselesaan menggunakan terminal dan konfigurasi manual. Jika anda ingin membina dan melancarkan produk berkuasa AI tanpa perlu menguruskan fail konfigurasi, penyedia model, dan integrasi saluran sendiri:
Y Build menguruskan keseluruhan tindanan (stack) — penggunaan, video produk, AI SEO, dan analitik. Tiada fail konfigurasi. Tiada terminal. Bina dan lancarkan sahaja. Mula secara percuma →Sumber: