OpenClaw Config Edit: Полное руководство по настройке и конфигурации (2026)
Освойте команды openclaw config edit для WhatsApp, Discord, Telegram, Ollama и других. Пошаговое руководство по настройке каналов, моделей, провайдеров и исправлению типичных ошибок конфигурации OpenClaw.
Краткое содержание
Быстрая справка по наиболее распространенным командам конфигурации 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 — это фреймворк AI-ассистента с открытым исходным кодом, который подключает большие языковые модели к каналам обмена сообщениями, таким как WhatsApp, Discord, Telegram и Slack. Он поддерживает множество провайдеров моделей — OpenAI, Anthropic, Ollama (локальные модели), Google и другие — и может быть расширен пользовательскими навыками и плагинами.
Ядро 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:
provider: openai # openai, anthropic, ollama, google
name: gpt-4o # строка идентификатора модели
temperature: 0.7
max_tokens: 4096
# Конфигурация каналов
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:
- web_search
- calculator
- weather
# Распознавание речи
stt:
provider: whisper
model: whisper-1
# Системный промпт
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
Это полезно для скриптов или быстрых изменений без открытия редактора.
Be first to build with AI
Y Build is the AI-era operating system for startups. Join the waitlist and get early access.
Настройка каналов
Интеграция с WhatsApp требует аккаунта Meta Business и доступа к API WhatsApp Business.
# Включить канал 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 вебхука
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 как переменную окружения (не помещайте в файл конфигурации):
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) и базовый 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 использует OpenAI-совместимый API
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
Отключает каналы с отсутствующими учетными данными, исправляет известные проблемы форматирования и предлагает ручные исправления для проблем, которые не может решить автоматически.
Расширенная конфигурация
Пользовательские навыки
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
Конфигурация распознавания речи (STT)
Для поддержки голосовых сообщений в WhatsApp и Telegram:
stt:
provider: whisper # whisper, deepgram, google
model: whisper-1
language: auto # автоопределение или укажите "en", "ru" и т.д.
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
Часто задаваемые вопросы
Где хранится файл конфигурации 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 и аналитика. Без файлов конфигурации. Без терминала. Просто создавайте и выпускайте. Начать бесплатно →Источники:
Be first to build with AI
Y Build is the AI-era operating system for startups. Join the waitlist and get early access.