OpenClaw Config Edit: Full Setup Guide (2026)
Повний посібник із редагування конфігурації OpenClaw для WhatsApp, Discord, Telegram та Ollama. Копіюйте та вставляйте команди для налаштування каналів, моделей та провайдерів. Виправлення поширених помилок конфігурації.
TL;DR
Коротка довідка за найпоширенішими командами конфігурації OpenClaw:
# Відкрити редактор конфігурації
openclaw config edit
# Встановити конкретне значення
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o
# Переглянути поточну конфігурацію
openclaw config show
# Перевірити та виправити проблеми конфігурації
openclaw doctor
openclaw doctor --fix
# Скинути до значень за замовчуванням
openclaw config reset
Що таке OpenClaw?
OpenClaw — це open-source фреймворк для AI-асистентів, який підключає великі мовні моделі до каналів обміну повідомленнями, таких як WhatsApp, Discord, Telegram та Slack. Він підтримує декілька провайдерів моделей — OpenAI, Anthropic, Ollama (локальні моделі), Google та інші — і може бути розширений за допомогою власних навичок (skills) та плагінів.
Основою OpenClaw є його система конфігурації. Майже все — які канали активні, яку модель використовувати, які навички завантажені — керується через файли конфігурації. Опанування openclaw config edit є ключем до того, щоб OpenClaw працював саме так, як вам потрібно.
openclaw config edit: Основи
Відкриття редактора конфігурації
Основна команда для налаштування OpenClaw:
openclaw config edit
Ця команда відкриває ваш файл конфігурації у термінальному редакторі за замовчуванням (зазвичай nano, vim або будь-якому іншому, встановленому у змінній $EDITOR). Файл конфігурації зазвичай знаходиться за шляхом ~/.openclaw/config.yaml або ~/.config/openclaw/config.yaml залежно від вашої інсталяції.
Структура файлу конфігурації
Файл конфігурації OpenClaw має формат 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."
Встановлення окремих значень
Замість редагування всього файлу, ви можете встановлювати окремі значення конфігурації через командний рядок:
openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6
openclaw config set model.temperature 0.5
Це корисно для скриптів або швидких змін без відкриття редактора.
Налаштування каналів
Інтеграція з WhatsApp потребує акаунту Meta Business та доступу до WhatsApp Business API.
# Увімкнути канал 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"
# Встановити URL-адресу webhook
openclaw config set channels.whatsapp.webhook_url "https://your-domain.com/webhook/whatsapp"
Discord
Налаштування Discord простіше — вам потрібен лише токен бота з Discord Developer Portal.
openclaw config set channels.discord.enabled true
openclaw config set channels.discord.bot_token "YOUR_DISCORD_BOT_TOKEN"
Telegram
Для Telegram потрібен токен бота від @BotFather:
openclaw config set channels.telegram.enabled true
openclaw config set channels.telegram.bot_token "YOUR_TELEGRAM_BOT_TOKEN"
Telegram підтримує режими polling та webhook. Режим polling легший для розробки (не потрібна публічна URL-адреса):
openclaw config set channels.telegram.mode polling
Для продакшену використовуйте режим webhook:
openclaw config set channels.telegram.mode webhook
openclaw config set channels.telegram.webhook_url "https://your-domain.com/webhook/telegram"
Slack
Інтеграція зі Slack використовує Socket Mode (рекомендовано) або 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 рекомендований, оскільки він не потребує публічної URL-адреси.
Налаштування провайдерів моделей
OpenAI
openclaw config set model.provider openai
openclaw config set model.name gpt-4o
Встановіть ваш API key як змінну оточення (не кладіть його у файл конфігурації):
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 (Локальні моделі)
Це те, де OpenClaw найкраще підходить для користувачів, які дбають про приватність. Ollama дозволяє запускати моделі локально без API-ключів або передачі даних за межі вашої машини.
# Спочатку встановіть Ollama
# https://ollama.ai
# Завантажте модель
ollama pull llama3.3
# Налаштуйте OpenClaw для використання 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) і base URL збігається. Порт за замовчуванням для Ollama — 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 використовує API, сумісний з 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-..." # Використовуйте ключ xAI з провайдером OpenAI
Поширені помилки конфігурації та їх виправлення
Помилка: "Unknown config key"
Error: Unknown config key 'chanels.whatsapp.enabled'
Зазвичай це означає друкарську помилку в ключі конфігурації. Перевірте написання. Типові помилки:
chanels→channelsprovidr→providertelgram→telegram
Запустіть
openclaw config show, щоб побачити всі валідні ключі.
Помилка: "Channel auto-enabled without credentials"
Деякі версії OpenClaw автоматично вмикають канали, коли ви встановлюєте облікові дані, навіть якщо ви їх явно не вмикали. Це може спричинити збої під час запуску, якщо облікові дані неповні.
Виправлення:# Явно вимкніть канали, які ви не використовуєте
openclaw config set channels.whatsapp.enabled false
openclaw config set channels.discord.enabled false
openclaw config set channels.slack.enabled false
Помилка: "Model provider not configured"
Error: Model provider 'anthropic' requires ANTHROPIC_API_KEY
Вам потрібно встановити відповідну змінну оточення. OpenClaw навмисно не зберігає API-ключі у файлі конфігурації з міркувань безпеки.
Виправлення: Додайте API-ключ до вашого профілю оболонки (~/.bashrc, ~/.zshrc) або використовуйте файл .env:
echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc
source ~/.zshrc
Використання openclaw doctor
Команда openclaw doctor перевіряє всю вашу конфігурацію та повідомляє про проблеми:
openclaw doctor
Приклад виводу:
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 намагається вирішити проблеми автоматично:
openclaw doctor --fix
Це вимкне канали з відсутніми обліковими даними, виправить відомі помилки форматування та запропонує ручні виправлення для проблем, які неможливо вирішити автоматично.
Розширені налаштування
Користувацькі навички (Skills)
OpenClaw підтримує власні навички (плагіни), які розширюють можливості асистента:
skills:
- web_search
- calculator
- weather
- custom_skill:
path: ./my-skills/custom_tool.py
config:
api_key_env: CUSTOM_API_KEY
Або через командний рядок:
openclaw skills add web_search
openclaw skills add ./my-skills/custom_tool.py
openclaw skills list
openclaw skills remove calculator
Конфігурація Speech-to-Text (STT)
Для підтримки голосових повідомлень у WhatsApp та Telegram:
stt:
provider: whisper # whisper, deepgram, google
model: whisper-1
language: auto # auto-detect або вкажіть "en", "uk" тощо.
openclaw config set stt.provider whisper
openclaw config set stt.model whisper-1
Інтеграція з розумним будинком Tuya
OpenClaw може керувати пристроями розумного будинку, сумісними з Tuya:
tuya:
enabled: true
access_id: "YOUR_TUYA_ACCESS_ID"
access_key: "YOUR_TUYA_ACCESS_KEY"
endpoint: "https://openapi.tuyaus.com"
Це дозволяє керувати освітленням, вимикачами, термостатами та іншими пристроями Tuya за допомогою команд природною мовою у будь-якому підключеному каналі.
Конфігурації декількох моделей
Ви можете визначити пресети моделей та перемикатися між ними:
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
# або перемикайтеся під час виконання
openclaw --model fast
Часті запитання (FAQ)
Де зберігається файл конфігурації OpenClaw?
Місце за замовчуванням — ~/.openclaw/config.yaml. У деяких інсталяціях він може бути за шляхом ~/.config/openclaw/config.yaml. Запустіть openclaw config show --path, щоб побачити точне розташування.
Чи можу я використовувати OpenClaw без хмарного API?
Так. Налаштуйте Ollama як провайдера моделі та використовуйте Telegram у режимі polling. Це дасть вам повністю локального, приватного AI-асистента, дані якого не залишають вашу машину.
Як оновити OpenClaw?
pip install --upgrade openclaw
# або
npm update -g openclaw
Після оновлення запустіть openclaw doctor, щоб перевірити наявність змін у форматі конфігурації.
Чи можу я запустити кілька каналів одночасно?
Так. Увімкніть стільки каналів, скільки забажаєте — OpenClaw обробляє їх паралельно. Кожен канал використовує ту саму конфігурацію моделі та навичок.
Як скинути конфігурацію до значень за замовчуванням?
openclaw config reset
Це перезапише ваш файл конфігурації шаблоном за замовчуванням. Спочатку зробіть резервну копію існуючої конфігурації, якщо це необхідно.
Бажаєте чогось простішого?
OpenClaw потужний, але потребує навичок роботи з терміналом та ручного налаштування. Якщо ви хочете створювати та випускати продукти на базі AI без самостійного керування файлами конфігурації, провайдерами моделей та інтеграціями каналів:
Y Build бере на себе весь цикл — розгортання, відео продуктів, AI SEO та аналітику. Жодних файлів конфігурації. Жодного терміналу. Просто створюйте та запускайте. Почати безкоштовно →Джерела: