Перейти к основному содержанию
Если вы настраиваете OpenClaw впервые, начните с раздела Начало работы. Подробности об онбординге см. в разделе Онбординг (CLI).

​
Кратко

Выберите рабочий процесс настройки в зависимости от того, как часто вы хотите получать обновления и хотите ли запускать Gateway самостоятельно:
  • Индивидуальная настройка живет вне репозитория: храните конфигурацию и рабочую область в ~/.openclaw/openclaw.json и ~/.openclaw/workspace/, чтобы обновления репозитория их не затрагивали.
  • Стабильный рабочий процесс (рекомендуется большинству): установите приложение для macOS и позвольте ему запускать встроенный Gateway.
  • Рабочий процесс на переднем крае (dev): запустите Gateway самостоятельно через pnpm gateway:watch, затем позвольте приложению macOS подключиться в локальном режиме.

​
Предварительные требования (из исходного кода)

  • Рекомендуется Node 24 (Node 22 LTS, сейчас 22.19+, все еще поддерживается)
  • Для checkout из исходного кода требуется pnpm. В режиме разработки OpenClaw загружает встроенные plugins из пакетов рабочей области pnpm extensions/*, поэтому корневой npm install не подготавливает полное дерево исходного кода.
  • Docker (необязательно; только для контейнерной настройки/e2e - см. Docker)

​
Стратегия индивидуальной настройки (чтобы обновления не вредили)

Если вам нужна «настройка на 100% под меня» и простые обновления, храните свои изменения в:
  • Конфигурация: ~/.openclaw/openclaw.json (JSON/похоже на JSON5)
  • Рабочая область: ~/.openclaw/workspace (skills, prompts, memories; сделайте ее приватным git-репозиторием)
Первичная инициализация один раз: 
openclaw setup
Изнутри этого репозитория используйте локальную точку входа CLI: 
openclaw setup
Если глобальная установка еще отсутствует, запустите через pnpm openclaw setup.

​
Запуск Gateway из этого репозитория

После pnpm build можно запустить упакованный CLI напрямую: 
node openclaw.mjs gateway --port 18789 --verbose

​
Стабильный рабочий процесс (сначала приложение macOS)

  1. Установите и запустите OpenClaw.app (строка меню).
  2. Завершите контрольный список онбординга/разрешений (запросы TCC).
  3. Убедитесь, что Gateway находится в режиме Local и запущен (приложение управляет им).
  4. Свяжите поверхности (пример: WhatsApp):
openclaw channels login
  1. Проверка работоспособности:
openclaw health
Если онбординг недоступен в вашей сборке:
  • Выполните openclaw setup, затем openclaw channels login, затем запустите Gateway вручную (openclaw gateway).

​
Рабочий процесс на переднем крае (Gateway в терминале)

Цель: работать над TypeScript Gateway, получать горячую перезагрузку и держать UI приложения macOS подключенным.

​
0) (Необязательно) Запустите приложение macOS из исходного кода тоже

Если вы также хотите использовать приложение macOS на переднем крае: 
./scripts/restart-mac.sh

​
1) Запустите dev Gateway

pnpm install
# First run only (or after resetting local OpenClaw config/workspace)
pnpm openclaw setup
pnpm gateway:watch
gateway:watch запускает или перезапускает процесс наблюдения Gateway в именованной сессии tmux и автоматически подключается из интерактивных терминалов. Неинтерактивные оболочки остаются отсоединенными и печатают tmux attach -t openclaw-gateway-watch-main; используйте OPENCLAW_GATEWAY_WATCH_ATTACH=0 pnpm gateway:watch, чтобы интерактивный запуск оставался отсоединенным, или pnpm gateway:watch:raw для режима наблюдения на переднем плане. Наблюдатель перезагружается при релевантных изменениях исходного кода, конфигурации и метаданных встроенных plugins. Если наблюдаемый Gateway завершится во время запуска, gateway:watch один раз выполнит openclaw doctor --fix --non-interactive и повторит попытку; задайте OPENCLAW_GATEWAY_WATCH_AUTO_DOCTOR=0, чтобы отключить этот проход исправления только для разработки. pnpm openclaw setup — это одноразовый шаг инициализации локальной конфигурации/рабочей области для свежего checkout. pnpm gateway:watch не пересобирает dist/control-ui, поэтому повторно выполните pnpm ui:build после изменений в ui/ или используйте pnpm ui:dev при разработке Control UI.

​
2) Направьте приложение macOS на ваш запущенный Gateway

В OpenClaw.app:
  • Режим подключения: Local Приложение подключится к запущенному Gateway на настроенном порту.

​
3) Проверьте

  • В приложении статус Gateway должен показывать “Используется существующий gateway …”
  • Или через CLI:
openclaw health

​
Частые ошибки

  • Неверный порт: WS Gateway по умолчанию использует ws://127.0.0.1:18789; держите приложение и CLI на одном порту.
  • Где хранится состояние:
    • Состояние канала/провайдера: ~/.openclaw/credentials/
    • Профили аутентификации модели: ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
    • Сессии: ~/.openclaw/agents/<agentId>/sessions/
    • Логи: /tmp/openclaw/

​
Карта хранения учетных данных

Используйте это при отладке аутентификации или принятии решения, что резервировать:
  • WhatsApp: ~/.openclaw/credentials/whatsapp/<accountId>/creds.json
  • Токен бота Telegram: config/env или channels.telegram.tokenFile (только обычный файл; symlinks отклоняются)
  • Токен бота Discord: config/env или SecretRef (провайдеры env/file/exec)
  • Токены Slack: config/env (channels.slack.*)
  • Списки разрешенных для сопряжения:
    • ~/.openclaw/credentials/<channel>-allowFrom.json (учетная запись по умолчанию)
    • ~/.openclaw/credentials/<channel>-<accountId>-allowFrom.json (учетные записи не по умолчанию)
  • Профили аутентификации модели: ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
  • Файловая полезная нагрузка секретов (необязательно): ~/.openclaw/secrets.json
  • Импорт устаревшего OAuth: ~/.openclaw/credentials/oauth.json Подробнее: Безопасность.

​
Обновление (без разрушения вашей настройки)

  • Держите ~/.openclaw/workspace и ~/.openclaw/ как «ваши материалы»; не помещайте личные prompts/config в репозиторий openclaw.
  • Обновление исходного кода: git pull + pnpm install + продолжайте использовать pnpm gateway:watch.

​
Linux (пользовательский сервис systemd)

Установки Linux используют пользовательский сервис systemd. По умолчанию systemd останавливает пользовательские сервисы при выходе/простое, что завершает Gateway. Онбординг пытается включить lingering за вас (может запросить sudo). Если он все еще выключен, выполните: 
sudo loginctl enable-linger $USER
Для постоянно включенных или многопользовательских серверов рассмотрите системный сервис вместо пользовательского сервиса (lingering не нужен). См. runbook Gateway с примечаниями по systemd.

​
Связанная документация