OpenClaw: быстрый старт

Используйте следующую команду для установки в один клик.

macOS/Linux：

curl -fsSL https://openclaw.ai/install.sh | bash

Windows（PowerShell）：

iwr -useb https://openclaw.ai/install.ps1 | iex

Руководство по началу работы

После установки запустите Onboarding, чтобы завершить первоначальную настройку. Это самый важный шаг:

openclaw onboard --install-daemon

Мастер Onboarding настраивает аутентификацию, настройки Gateway и дополнительные каналы.:

  • Настройка аутентификации: Задайте Gateway Token или Password для защиты конечной точки API
  • Настройка поставщика моделей: Выберите и настройте вашу LLM (например, Anthropic API Key)
  • Настройка каналов (необязательно): Подключите чат-каналы, такие как Telegram Bot и WhatsApp
  • Установка системной службы：--install-daemonпараметр для включения запуска Gateway при загрузке

Основные операции с Gateway

Gateway — это основной процесс OpenClaw; все функции зависят от его работы:

# 查看 Gateway 状态
openclaw gateway status

# 在前台运行（适合调试）
openclaw gateway --port 18789

# 详细日志模式
openclaw gateway --port 18789 --verbose

# 强制占用端口并启动（解决端口冲突）
openclaw gateway --force

# 重启 Gateway
openclaw gateway restart

# 停止 Gateway
openclaw gateway stop

# 查看实时日志
openclaw logs --follow

Доступ к Control UI

Control UI — это визуальный интерфейс управления OpenClaw:

# 打开 Control UI（自动在浏览器中打开）
openclaw dashboard

Или перейдите напрямую: http://127.0.0.1:18789/。

Основные функции Control UI:

  • Интерфейс чата: Не нужно настраивать какой-либо канал; общайтесь с ИИ прямо в браузере
  • Мониторинг состояния: Просмотр состояния работоспособности Gateway и состояния подключения каналов
  • Управление сессиями: Просмотр и управление историей бесед по разным каналам

Теперь можно начать общение на странице:

🚀 Быстрый способ начать работу
Откройте Control UI и начните общаться напрямую — не нужно настраивать ни один Channel! Это самый быстрый способ убедиться, что OpenClaw работает правильно.

Справочник по основным командам

Команда Описание
openclaw doctor Комплексная проверка работоспособности и попытка исправить проблемы конфигурации
openclaw health Быстрая проверка работоспособности
openclaw status Просмотр общего статуса Gateway и каналов
openclaw gateway status Просмотр статуса процесса Gateway
openclaw gateway status --deep Глубокая проверка статуса (включает RPC-пробы)
openclaw gateway run Запуск Gateway в foreground
openclaw gateway start Запуск службы Gateway в фоновом режиме
openclaw gateway stop Остановить службу Gateway
openclaw gateway restart Перезапустить службу Gateway
openclaw gateway probe Проверка подключения и статуса Gateway
openclaw gateway discover Обнаружить LAN или удалённый Gateway
openclaw gateway call health Вызвать эндпоинт проверки работоспособности Gateway
openclaw channels status --probe Проверить состояние подключения всех каналов
openclaw dashboard Открыть панель управления в браузере
openclaw logs --follow Отслеживать вывод журнала в реальном времени
openclaw onboard Повторно запустить мастер начальной настройки
openclaw secrets reload Горячая перезагрузка конфигурации Secrets

Механизм горячей перезагрузки Gateway

OpenClaw поддерживает горячую перезагрузку конфигурации, по умолчанию —hybridРежимы:

gateway.reload.mode Описание поведения
off Автоматическая перезагрузка отсутствует, требуется ручной перезапуск
hot Применять только безопасные изменения (без прерывания соединения)
restart Перезапускать Gateway при любом изменении
hybrid(по умолчанию) Применять на лету то, что можно применить на лету, автоматически перезапускать то, что требует перезапуска

TUI: терминальный интерфейс чата

Помимо браузерного Control UI, OpenClaw также предоставляет интерактивный интерфейс, работающий полностью в терминале —TUI（терминальный интерфейс）браузер не нужен, вы можете общаться напрямую даже при подключении к серверу по SSH.

Быстрый старт

# 第一步：确保 Gateway 已运行
openclaw gateway

# 第二步：打开 TUI
openclaw tui

Подключиться к удалённому Gateway:

openclaw tui --url ws://<host>:<port> --token <gateway-token>

# 如果 Gateway 使用密码鉴权
openclaw tui --url ws://<host>:<port> --password <password>

Макет интерфейса

После запуска TUI вы увидите четыре области:

Область Содержание
Заголовок (верхняя панель) URL подключения, текущий агент, текущая сессия
Журнал чата (область сообщений) Сообщения пользователя, ответы ИИ, системные уведомления, карточки вызовов инструментов
Строка состояния (строка статуса) Состояние подключения / выполнения (подключение / выполнение / потоковая передача / простой / ошибка)
Нижний колонтитул (нижняя панель) Состояние подключения + Агент + Сессия + модель + Количество токенов

Область заголовка:

Нижняя область:

Горячие клавиши

Горячие клавиши Особенности
Enter Отправить сообщение
Esc Прервать текущий запуск
Ctrl+C Очистить ввод (двойное нажатие для выхода)
Ctrl+D Выйти из TUI
Ctrl+L Открыть выбор модели
Ctrl+G Открыть выбор агента
Ctrl+P Открыть выбор сессии
Ctrl+O Переключить развёртывание / сворачивание вывода инструментов
Ctrl+T Переключить отображение размышлений (перезагружает историю)

Основные слэш-команды

Использование/Вызов команд:

Основные команды:

/help                          # 查看帮助
/status                        # 查看连接状态
/agent <id>                    # 切换 Agent
/session <key>                 # 切换 Session
/model <provider/model>        # 切换模型（如 /model anthropic/claude-sonnet-4-6）
/think <off|minimal|low|medium|high>   # 设置思考深度
/deliver <on|off>              # 开启/关闭消息投递到 Provider
/new                           # 重置当前 Session
/abort                         # 中止当前运行
/exit                          # 退出 TUI

Локальные команды оболочки

В поле ввода, с!в качестве префикса можно напрямую выполнять локальные команды оболочки:

!ls -la          # 列出当前目录
!cat log.txt     # 查看文件内容

⚠️ TUI при первом использовании в каждом сеансе,!запросит подтверждение авторизации; после отказа в этом сеансе!он будет недоступен.

Параметры запуска

Параметр Описание Значение по умолчанию
--url <url> WebSocket-адрес шлюза Прочитать конфигурацию илиws://127.0.0.1:<port>
--token <token> Аутентификация по токену шлюза —
--password <password> Аутентификация по паролю шлюза —
--session <key> Указать сеанс main
--deliver Включить доставку сообщений при запуске Отключено по умолчанию
--thinking <level> Переопределить уровень размышлений —
--history-limit <n> Количество записей истории для загрузки 200
--timeout-ms <ms> Тайм-аут агента Считывает agents.defaults.timeoutSeconds

Связанные материалы

Другие связанные материалы приведены ниже:

Другие расширения