OpenClaw-konfiguroinnin muokkaus: Täydellinen asennusopas (2026)
Kattava OpenClaw-konfiguroinnin muokkausopas WhatsAppille, Discordille, Telegramille ja Ollamalle. Kopioi ja liitä komennot kanavien, mallien ja tarjoajien määrittämiseen. Yleiset konfigurointivirheet korjattu.
Tiivistelmä
Pikaopas yleisimpiin OpenClaw-konfigurointikomentoihin:
# Open the config editor
openclaw config edit
# Set a specific value
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o
# View current config
openclaw config show
# Validate and fix config issues
openclaw doctor
openclaw doctor --fix
# Reset to defaults
openclaw config reset
Mikä on OpenClaw?
OpenClaw on avoimen lähdekoodin AI-avustajakehys, joka yhdistää suuret kielimallit viestintäkanaviin, kuten WhatsApp, Discord, Telegram ja Slack. Se tukee useita mallitarjoajia — OpenAI, Anthropic, Ollama (paikalliset mallit), Google ja muita — ja sitä voidaan laajentaa mukautetuilla taidoilla ja plugineilla.
OpenClaw’n ydin on sen konfigurointijärjestelmä. Lähes kaikkea — mitkä kanavat ovat aktiivisia, mitä mallia käytetään, mitkä taidot on ladattu — hallitaan konfigurointitiedostojen kautta. Komennon openclaw config edit hallitseminen on avain OpenClaw’n saamiseksi toimimaan haluamallasi tavalla.
openclaw config edit: Perusteet
Konfigurointieditorin avaaminen
Ensisijainen komento OpenClaw’n konfiguroimiseen on:
openclaw config edit
Tämä avaa konfigurointitiedostosi terminaalin oletuseditorissa (yleensä nano, vim tai mikä tahansa $EDITOR-muuttujaan on asetettu). Konfigurointitiedosto sijaitsee yleensä polussa ~/.openclaw/config.yaml tai ~/.config/openclaw/config.yaml asennuksestasi riippuen.
Konfigurointitiedoston rakenne
OpenClaw-konfigurointitiedosto on YAML-muotoinen ja jaettu osioihin:
# 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."
Yksittäisten arvojen asettaminen
Koko tiedoston muokkaamisen sijaan voit asettaa yksittäisiä arvoja komentoriviltä:
openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6
openclaw config set model.temperature 0.5
Tämä on hyödyllistä skriptauksessa tai nopeissa muutoksissa ilman editorin avaamista.
Kanavien määrittäminen
WhatsApp-integraatio vaatii Meta Business -tilin ja WhatsApp Business API -pääsyn.
# Enable WhatsApp channel
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"
# Set the webhook URL
openclaw config set channels.whatsapp.webhook_url "https://your-domain.com/webhook/whatsapp"
Discord
Discord-asennus on yksinkertaisempi — tarvitset vain bot-tokenin Discord Developer Portalista.
openclaw config set channels.discord.enabled true
openclaw config set channels.discord.bot_token "YOUR_DISCORD_BOT_TOKEN"
Telegram
Telegram vaatii bot-tokenin @BotFatherilta:
openclaw config set channels.telegram.enabled true
openclaw config set channels.telegram.bot_token "YOUR_TELEGRAM_BOT_TOKEN"
Telegram tukee sekä polling- että webhook-tiloja. Polling on helpompi kehityskäytössä (julkista URL-osoitetta ei tarvita):
openclaw config set channels.telegram.mode polling
Tuotantokäyttöön käytä webhook-tilaa:
openclaw config set channels.telegram.mode webhook
openclaw config set channels.telegram.webhook_url "https://your-domain.com/webhook/telegram"
Slack
Slack-integraatio käyttää Socket Modea (suositeltu) tai Events APIa:
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 on suositeltu, koska se ei vaadi julkista URL-osoitetta.
Mallitarjoajien määrittäminen
OpenAI
openclaw config set model.provider openai
openclaw config set model.name gpt-4o
Aseta API-avaimesi ympäristömuuttujaksi (älä laita sitä konfigurointitiedostoon):
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 (Paikalliset mallit)
Tämä on alue, jossa OpenClaw loistaa yksityisyydestä tarkoille käyttäjille. Ollama antaa sinun ajaa malleja paikallisesti ilman API-avaimia tai datan lähtemistä koneeltasi.
# Install Ollama first
# https://ollama.ai
# Pull a model
ollama pull llama3.3
# Configure OpenClaw to use 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) ja base URL täsmää. Ollaman oletusportti on 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 käyttää OpenAI-yhteensopivaa APIa
openclaw config set model.name grok-4.1
openclaw config set model.base_url "https://api.x.ai/v1"
export OPENAI_API_KEY="xai-..." # Käytä xAI-avainta OpenAI-tarjoajan kanssa
Yleiset konfigurointivirheet ja korjaukset
Virhe: "Unknown config key"
Error: Unknown config key 'chanels.whatsapp.enabled'
Tämä tarkoittaa yleensä kirjoitusvirhettä konfigurointiavaimessa. Tarkista oikeinkirjoitus. Yleisiä virheitä:
chanels→channelsprovidr→providertelgram→telegram
Aja
openclaw config show nähdäksesi kaikki kelvolliset avaimet.
Virhe: "Channel auto-enabled without credentials"
Jotkut OpenClaw-versiot ottavat kanavat automaattisesti käyttöön, kun asetat kirjautumistiedot, vaikka et olisi erikseen ottanut niitä käyttöön. Tämä voi aiheuttaa käynnistysvirheitä, jos tiedot ovat puutteelliset.
Korjaus:# Explicitly disable channels you're not using
openclaw config set channels.whatsapp.enabled false
openclaw config set channels.discord.enabled false
openclaw config set channels.slack.enabled false
Virhe: "Model provider not configured"
Error: Model provider 'anthropic' requires ANTHROPIC_API_KEY
Sinun on asetettava vastaava ympäristömuuttuja. OpenClaw ei tarkoituksella tallenna API-avaimia konfigurointitiedostoon turvallisuussyistä.
Korjaus: Lisää API-avain kuoriprofiiliisi (~/.bashrc, ~/.zshrc) tai käytä .env-tiedostoa:
echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc
source ~/.zshrc
openclaw doctorin käyttö
openclaw doctor -komento tarkistaa koko konfiguraatiosi ja raportoi ongelmista:
openclaw doctor
Esimerkki tulosteesta:
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.
--fix-lippu yrittää ratkaista ongelmat automaattisesti:
openclaw doctor --fix
Tämä poistaa käytöstä kanavat, joilta puuttuu kirjautumistiedot, korjaa tunnetut muotoiluongelmat ja ehdottaa manuaalisia korjauksia ongelmiin, joita se ei pysty ratkaisemaan automaattisesti.
Edistynyt konfigurointi
Mukautetut taidot (Skills)
OpenClaw tukee mukautettuja taitoja (plugineja), jotka laajentavat avustajan kykyjä:
skills:
- web_search
- calculator
- weather
- custom_skill:
path: ./my-skills/custom_tool.py
config:
api_key_env: CUSTOM_API_KEY
Tai komentorivin kautta:
openclaw skills add web_search
openclaw skills add ./my-skills/custom_tool.py
openclaw skills list
openclaw skills remove calculator
Puheesta tekstiksi (STT) -konfigurointi
Ääniviestitukea varten WhatsAppissa ja Telegramissa:
stt:
provider: whisper # whisper, deepgram, google
model: whisper-1
language: auto # auto-detect or specify "en", "es", etc.
openclaw config set stt.provider whisper
openclaw config set stt.model whisper-1
Tuya-älykotien integraatio
OpenClaw voi ohjata Tuya-yhteensopivia älykotilaitteita:
tuya:
enabled: true
access_id: "YOUR_TUYA_ACCESS_ID"
access_key: "YOUR_TUYA_ACCESS_KEY"
endpoint: "https://openapi.tuyaus.com"
Tämä antaa sinun ohjata valoja, kytkimiä, termostaatteja ja muita Tuya-laitteita luonnollisen kielen komennoilla mistä tahansa yhdistetystä kanavasta.
Useat mallikonfiguraatiot
Voit määrittää mallien esiasetuksia ja vaihtaa niiden välillä:
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
# or switch at runtime
openclaw --model fast
Usein kysytyt kysymykset
Missä OpenClaw-konfigurointitiedosto säilytetään?
Oletussijainti on ~/.openclaw/config.yaml. Joissakin asennuksissa se voi olla polussa ~/.config/openclaw/config.yaml. Aja openclaw config show --path nähdäksesi tarkan sijainnin.
Voinko käyttää OpenClaw’ta ilman pilvi-APIa?
Kyllä. Määritä Ollama mallitarjoajaksesi ja käytä Telegramia polling-tilassa. Tämä antaa sinulle täysin paikallisen ja yksityisen AI-avustajan, jolloin data ei lähde koneeltasi.
Miten päivitän OpenClaw’n?
pip install --upgrade openclaw
# or
npm update -g openclaw
Päivityksen jälkeen aja openclaw doctor tarkistaaksesi mahdolliset muutokset konfiguroinnin muodossa.
Voinko käyttää useita kanavia samanaikaisesti?
Kyllä. Ota käyttöön niin monta kanavaa kuin haluat — OpenClaw käsittelee ne rinnakkain. Jokainen kanava jakaa saman mallin ja taitojen konfiguraation.
Miten palautan konfiguraation oletusasetuksiin?
openclaw config reset
Tämä ylikirjoittaa konfigurointitiedostosi oletusmallilla. Ota varmuuskopio nykyisestä konfiguraatiostasi ensin, jos tarpeen.
Haluatko jotain yksinkertaisempaa?
OpenClaw on tehokas, mutta vaatii terminaalin käyttöä ja manuaalista konfigurointia. Jos haluat rakentaa ja julkaista AI-pohjaisia tuotteita hallitsematta itse konfigurointitiedostoja, mallitarjoajia ja kanavaintegraatioita:
Y Build hoitaa koko pakan — julkaisun, tuotevideot, AI SEO:n ja analytiikan. Ei konfigurointitiedostoja. Ei terminaalia. Rakenna ja julkaise vain. Aloita ilmaiseksi →Lähteet: