OpenClaw Config Edit: Полное руководство по настройке (2026)

Q: Где хранится файл конфигурации OpenClaw?

По умолчанию он находится в ~/.openclaw/config.yaml. В некоторых случаях он может быть в ~/.config/openclaw/config.yaml. Выполните openclaw config show --path, чтобы увидеть точное местоположение.

Q: Как обновить OpenClaw?

```bash pip install --upgrade openclaw

Q: Как сбросить настройки до заводских?

```bash openclaw config reset ```

TL;DR

Краткий справочник наиболее часто используемых команд OpenClaw для работы с конфигурацией:

bash

# Открыть редактор конфигурации
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 — это опенсорсный фреймворк для создания ИИ-ассистентов, который подключает большие языковые модели к каналам обмена сообщениями, таким как WhatsApp, Discord, Telegram и Slack. Он поддерживает множество провайдеров моделей — OpenAI, Anthropic, Ollama (локальные модели), Google и другие — и может быть расширен с помощью пользовательских навыков (skills) и плагинов.

Ядром OpenClaw является его система конфигурации. Почти всё — какие каналы активны, какую модель использовать, какие навыки загружены — управляется через файлы конфигурации. Освоение команды openclaw config edit — это ключ к тому, чтобы OpenClaw работал именно так, как вам нужно.

openclaw config edit: Основы

Открытие редактора конфигурации

Основная команда для настройки OpenClaw:

bash

openclaw config edit

Эта команда открывает файл конфигурации в текстовом редакторе терминала по умолчанию (обычно nano, vim или тот, что указан в переменной $EDITOR). Файл конфигурации обычно находится по пути ~/.openclaw/config.yaml или ~/.config/openclaw/config.yaml в зависимости от вашей установки.

Структура файла конфигурации

Файл конфигурации OpenClaw использует формат YAML и разбит на разделы:

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

# Speech-to-text (преобразование речи в текст)
stt:
  provider: whisper
  model: whisper-1

# Системный промпт
system_prompt: "You are a helpful assistant."

Установка отдельных значений

Вместо редактирования всего файла целиком, вы можете устанавливать отдельные значения конфигурации через командную строку:

bash

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.

bash

# Включить канал 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"

Распространенная проблема: WhatsApp требует URL-адрес вебхука. Вам нужно открыть доступ к OpenClaw из интернета, используя обратный прокси (nginx, Caddy) или туннельный сервис (ngrok, Cloudflare Tunnel).

bash

# Установить URL вебхука
openclaw config set channels.whatsapp.webhook_url "https://your-domain.com/webhook/whatsapp"

Discord

Настройка Discord проще — вам просто нужен токен бота из Discord Developer Portal.

bash

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

Совет: Убедитесь, что для вашего Discord-бота в Developer Portal включен параметр "Message Content Intent", иначе он не сможет читать сообщения.

Для Telegram требуется токен бота от @BotFather:

bash

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

Telegram поддерживает режимы polling и webhook. Polling проще для разработки (не нужен публичный URL):

bash

openclaw config set channels.telegram.mode polling

Для использования в продакшене используйте режим webhook:

bash

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:

bash

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

bash

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

Установите API-ключ как переменную окружения (не храните его в файле конфигурации):

bash

export OPENAI_API_KEY="sk-..."

Anthropic (Claude)

bash

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

bash

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

Ollama (Локальные модели)

Здесь OpenClaw проявляет себя лучше всего для пользователей, заботящихся о конфиденциальности. Ollama позволяет запускать модели локально без использования API-ключей и передачи данных вовне.

bash

# Сначала установите 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"

Распространенная проблема: Если OpenClaw не может подключиться к Ollama, убедитесь, что Ollama запущена (ollama serve) и base_url указан верно. Порт Ollama по умолчанию — 11434.

Google (Gemini)

bash

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

bash

export GOOGLE_API_KEY="..."

xAI (Grok)

bash

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"

bash

export OPENAI_API_KEY="xai-..."   # Используйте ключ xAI с провайдером openai

Распространенные ошибки конфигурации и их решение

Ошибка: "Unknown config key"

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

Обычно это означает опечатку в ключе конфигурации. Проверьте написание. Частые ошибки:

chanels → channels

providr → provider

telgram → telegram

Запустите openclaw config show, чтобы увидеть все доступные ключи.

Ошибка: "Channel auto-enabled without credentials"

Некоторые версии OpenClaw автоматически включают каналы при установке учетных данных, даже если вы их явно не включали. Это может привести к сбоям при запуске, если данные заполнены не полностью.

Решение:

bash

# Явно отключите каналы, которые вы не используете
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:

bash

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

Использование openclaw doctor

Команда openclaw doctor проверяет всю вашу конфигурацию и сообщает о проблемах:

bash

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 пытается решить проблемы автоматически:

bash

openclaw doctor --fix

Это отключит каналы с недостающими учетными данными, исправит известные ошибки форматирования и предложит варианты ручного исправления проблем, которые нельзя решить автоматически.

Расширенная настройка

Пользовательские навыки (Skills)

OpenClaw поддерживает пользовательские навыки (плагины), расширяющие возможности ассистента:

yaml

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

Или через командную строку:

bash

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:

yaml

stt:
  provider: whisper          # whisper, deepgram, google
  model: whisper-1
  language: auto             # автоопределение или указание "ru", "en" и т.д.

bash

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

Интеграция с умным домом Tuya

OpenClaw может управлять устройствами умного дома, совместимыми с Tuya:

yaml

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

Это позволяет управлять светом, выключателями, термостатами и другими устройствами Tuya с помощью команд на естественном языке в любом подключенном канале.

Множественные конфигурации моделей

Вы можете определить пресеты моделей и переключаться между ними:

yaml

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

bash

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. Это даст вам полностью локального и приватного ИИ-ассистента, данные которого не покидают вашу машину.

Как обновить OpenClaw?

bash

pip install --upgrade openclaw
# или
npm update -g openclaw

После обновления запустите openclaw doctor, чтобы проверить изменения в формате конфигурации.

Можно ли запустить несколько каналов одновременно?

Да. Вы можете включить столько каналов, сколько захотите — OpenClaw обрабатывает их параллельно. Все каналы используют одну и ту же конфигурацию модели и навыков.

Как сбросить настройки до заводских?

bash

openclaw config reset

Это перезапишет ваш файл конфигурации шаблоном по умолчанию. Перед этим сделайте резервную копию текущего конфига, если это необходимо.

Хотите чего-то попроще?

OpenClaw мощен, но требует навыков работы с терминалом и ручной настройки. Если вы хотите создавать и запускать продукты на базе ИИ, не занимаясь настройкой файлов, провайдеров и интеграций самостоятельно:

Y Build берет на себя весь стек — деплой, создание видео продукта, AI SEO и аналитику. Никаких конфигов. Никакого терминала. Просто создавайте и запускайте. Начать бесплатно →

Источники:

TL;DR

Краткий справочник наиболее часто используемых команд OpenClaw для работы с конфигурацией:

bash

# Открыть редактор конфигурации
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 config edit: Основы

Открытие редактора конфигурации

Основная команда для настройки OpenClaw:

bash

openclaw config edit

Структура файла конфигурации

Файл конфигурации OpenClaw использует формат YAML и разбит на разделы:

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

# Speech-to-text (преобразование речи в текст)
stt:
  provider: whisper
  model: whisper-1

# Системный промпт
system_prompt: "You are a helpful assistant."

Установка отдельных значений

bash

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.

bash

# Включить канал 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"

bash

# Установить URL вебхука
openclaw config set channels.whatsapp.webhook_url "https://your-domain.com/webhook/whatsapp"

Discord

Настройка Discord проще — вам просто нужен токен бота из Discord Developer Portal.

bash

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

Для Telegram требуется токен бота от @BotFather:

bash

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

Telegram поддерживает режимы polling и webhook. Polling проще для разработки (не нужен публичный URL):

bash

openclaw config set channels.telegram.mode polling

Для использования в продакшене используйте режим webhook:

bash

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:

bash

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

bash

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

Установите API-ключ как переменную окружения (не храните его в файле конфигурации):

bash

export OPENAI_API_KEY="sk-..."

Anthropic (Claude)

bash

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

bash

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

Ollama (Локальные модели)

bash

# Сначала установите 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"

Google (Gemini)

bash

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

bash

export GOOGLE_API_KEY="..."

xAI (Grok)

bash

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"

bash

export OPENAI_API_KEY="xai-..."   # Используйте ключ xAI с провайдером openai

Распространенные ошибки конфигурации и их решение

Ошибка: "Unknown config key"

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

Обычно это означает опечатку в ключе конфигурации. Проверьте написание. Частые ошибки:

chanels → channels

providr → provider

telgram → telegram

Запустите openclaw config show, чтобы увидеть все доступные ключи.

Ошибка: "Channel auto-enabled without credentials"

Решение:

bash

# Явно отключите каналы, которые вы не используете
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

Решение: Добавьте API-ключ в профиль вашей оболочки (~/.bashrc, ~/.zshrc) или используйте файл .env:

bash

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

Использование openclaw doctor

Команда openclaw doctor проверяет всю вашу конфигурацию и сообщает о проблемах:

bash

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 пытается решить проблемы автоматически:

bash

openclaw doctor --fix

Расширенная настройка

Пользовательские навыки (Skills)

OpenClaw поддерживает пользовательские навыки (плагины), расширяющие возможности ассистента:

yaml

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

Или через командную строку:

bash

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:

yaml

stt:
  provider: whisper          # whisper, deepgram, google
  model: whisper-1
  language: auto             # автоопределение или указание "ru", "en" и т.д.

bash

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

Интеграция с умным домом Tuya

OpenClaw может управлять устройствами умного дома, совместимыми с Tuya:

yaml

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

Множественные конфигурации моделей

Вы можете определить пресеты моделей и переключаться между ними:

yaml

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

bash

openclaw config set model.active default
# или переключиться при запуске
openclaw --model fast

Часто задаваемые вопросы

Где хранится файл конфигурации OpenClaw?

Можно ли использовать OpenClaw без облачных API?

Как обновить OpenClaw?

bash

pip install --upgrade openclaw
# или
npm update -g openclaw

После обновления запустите openclaw doctor, чтобы проверить изменения в формате конфигурации.

Можно ли запустить несколько каналов одновременно?

Как сбросить настройки до заводских?

bash

openclaw config reset

Хотите чего-то попроще?

Источники: