OpenClaw в терминале

OpenClaw в Promto — это нативный OpenClaw TUI, подключённый к локальному Gateway внутри текущего рабочего стола. Он работает с файлами в /home/user, использует модельный каталог рабочего стола и ведёт собственную OpenClaw-сессию.

Зачем использовать OpenClaw

OpenClaw стоит запускать, когда вам нужен именно его способ организации агента:

• нативный TUI OpenClaw;
• сессия, которой управляет OpenClaw;
• локальная связка Gateway + TUI;
• собственная конфигурация моделей, plugins и channels;
• длительная интерактивная работа в одном терминале;
• эксперимент с OpenClaw workflow на реальном проекте.

Это не замена простого режима для каждой задачи. OpenClaw раскрывается, когда вы хотите работать с его нативной архитектурой и понимаете, зачем нужен Gateway или OpenClaw-конфигурация.

Что такое Gateway и зачем он нужен

Gateway — локальный процесс, к которому подключается OpenClaw TUI. Он координирует текущую агентную сессию и модельные запросы.

При выборе OpenClaw интерфейс Promto автоматически:

1. выбирает свободный локальный порт;
2. создаёт временную авторизацию текущей terminal-session;
3. запускает Gateway только на loopback-интерфейсе;
4. ждёт успешный health check;
5. открывает TUI и подключает его к сессии main;
6. обновляет авторизацию долгой сессии и переподключает TUI при необходимости;
7. завершает дочерний Gateway при выходе из OpenClaw.

Пользователю не нужно вручную выбирать порт, создавать токен или отдельно запускать Gateway.

Технически текущий managed launch использует команды семейства:

openclaw gateway run --bind loopback --port <локальный-порт> --auth token --compact
openclaw tui --url ws://127.0.0.1:<локальный-порт> --token <временный-токен> --session main

Это описание внутреннего запуска, а не команды для ручного копирования. Точные порт и авторизация создаются Promto для конкретной сессии.

Чем OpenClaw отличается от основного агента

Основной агент Promto работает как чат: получает сообщения, использует встроенные tools, сохраняет переписку и создаёт продуктовые кнопки.

OpenClaw:

• работает через собственные Gateway и TUI;
• управляет своей нативной сессией и конфигурацией;
• выбирает модель средствами OpenClaw;
• использует собственные native tools;
• получает возможности платформы через promto;
• не превращает терминальный вывод в историю чата;
• не создаёт кнопки из UI-маркеров;
• существует как foreground-процесс текущей терминальной вкладки.

При этом оба агента видят одни и те же проектные файлы и могут последовательно работать над одной задачей.

Чем OpenClaw отличается от Codex и Hermes

Codex в Promto запускается напрямую как coding CLI. Он особенно удобен для системной работы с репозиторием, реализации и тестов.

Hermes Agent запускается напрямую как hermes --tui и предлагает собственный автономный workflow и нативный выбор моделей.

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

Какие новые возможности даёт OpenClaw

Сессионный agent runtime

OpenClaw работает не как один ответ на одно сообщение, а как собственная сессия main, подключённая к локальному Gateway. Пока PTY и TUI живы, вы можете продолжать работу в том же интерфейсе и переключаться между вкладками Promto.

Собственная модельная конфигурация

Promto передаёт OpenClaw доступный модельный каталог и задаёт openrouter/auto как основной начальный маршрут. Выбор модели остаётся нативной функцией OpenClaw, а не верхнего селектора обычного чата.

Plugins и channels в конфигурации

Если в OpenClaw-конфигурации этой terminal-session уже есть plugins или channels, managed launch не стирает их при обновлении модельных настроек.

Однако сам выбор OpenClaw на экране терминала:

• не публикует Gateway наружу;
• не разворачивает постоянно работающий сервер;
• не гарантирует работу канала после закрытия TUI;
• не превращает рабочий стол в круглосуточный OpenClaw-hosting.

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

Telegram

OpenClaw подключает личного Telegram-бота через свой нативный channel. Настройка выполняется в shell командой openclaw channels add --channel telegram --token '<bot-token>', а первый пользователь подтверждается через openclaw pairing approve telegram <CODE>.

Полная пошаговая инструкция по Telegram для всех CLI-агентов объясняет создание бота, pairing, проверку канала и ограничения terminal-session.

Общие возможности рабочего стола

OpenClaw может менять код и файлы, запускать команды, устанавливать зависимости как root и использовать:

• promto preview для визуальной проверки приложения;
• promto browser для общей браузерной сессии;
• promto asset для загрузки media-ассетов в CDN и получения публичного URL;
• promto disk для квоты;
• promto mobile для Android;
• promto publish для публикации.

Когда выбирать OpenClaw

OpenClaw подходит, если:

• вы хотите изучить или использовать нативный OpenClaw TUI;
• важна его сессионная Gateway-архитектура;
• вы работаете с OpenClaw-конфигурацией, plugins или channels;
• нужен длительный интерактивный терминальный workflow;
• вы сравниваете OpenClaw с Codex или Hermes на одном проекте.

Выберите другой режим, если:

• нужна короткая понятная правка — основной агент или Codex обычно проще;
• нужна только модель из каталога — для этого не обязательно запускать Gateway;
• требуется внешний сервис 24/7 — обычная terminal-session для этого не предназначена;
• вам важна сохранённая чат-история и встроенные кнопки Promto.

Жизненный цикл OpenClaw-сессии

• Состояние OpenClaw хранится отдельно для каждой terminal-session.
• Переключение вкладки и обычная перезагрузка страницы не должны завершать живой PTY.
• TUI подключается к локальной сессии main.
• Для долгой работы Promto периодически обновляет авторизацию и перезапускает дочерний Gateway, а TUI переподключается к тому же адресу сессии.
• Выход из TUI завершает дочерний Gateway и возвращает управление терминалу.
• Закрытие терминальной вкладки завершает весь PTY.
• После сна или перезапуска рабочего стола Promto может повторно запустить CLI, но это не равно непрерывной работе прежнего процесса.

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

Инструкции и CLI для агента

Нативные команды OpenClaw можно посмотреть из обычного shell:

openclaw --help
openclaw --version
openclaw gateway --help
openclaw tui --help

Нулевой запуск из интерфейса Promto не использует openclaw chat: он автоматически запускает локальный Gateway и openclaw tui --session main.

OpenClaw сохраняет собственные system prompt и native tools. Общий контракт Promto terminal agent добавляется в AGENTS.md и выводится командой:

promto instructions

Платформенные команды:

promto help
promto port owner <порт>
promto port free <начальный-порт>
promto preview screenshot --current --port <порт>
promto browser status
promto asset upload <файл> --json
promto disk
promto disk top /home/user 20

Перед публикацией и mobile-задачей:

promto publish get-instruction
promto mobile instructions

Не используйте в shell get_instruction({ topic: "runtime" }): это trusted tool основного агента. Для терминальной сессии применяется promto instructions.

Готовый промпт для OpenClaw

Сначала выведи и учти promto instructions, прочитай применимые AGENTS.md и проверь git status. Работаем в текущем OpenClaw TUI; не запускай второй Gateway и не поднимай внешний сервис без отдельной просьбы. Задача: <опишите результат>. Сохрани существующие изменения, сначала изучи реальные файлы и команды через rg, затем выполни задачу и проверь её. Для портов используй promto port, для UI-проверки — promto preview screenshot --current --port <порт>. Не публикуй. В конце перечисли изменения, проверки и то, что останется работать только пока открыта текущая terminal-session.

Практические сценарии

Изучение OpenClaw на существующем проекте

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

Долгая работа в TUI

Сохраните brief в Markdown-файле проекта, затем попросите OpenClaw вести там принятые решения и прогресс. Это делает результат доступным основному агенту и другим терминальным сессиям.

Проверка существующей конфигурации

Попросите перечислить настроенные модели, plugins и channels без их изменения. После аудита отдельно разрешайте нужную настройку и укажите, должна ли она жить только в терминальной сессии или стать отдельным опубликованным сервисом.

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

Запускать openclaw chat и ожидать тот же режим. Кнопка Promto использует другую схему: локальный Gateway плюс TUI с сессией main.

Считать локальный Gateway публичным сервером. Он привязан к loopback внутри рабочего стола и обслуживает текущую терминальную сессию.

Ожидать каналы и cron после закрытия вкладки. Managed Gateway завершается вместе с OpenClaw TUI.

Пытаться выбрать модель в селекторе обычного чата. Терминальной моделью управляет OpenClaw.

Связанные статьи

• Терминал и терминальные агенты
• Codex в терминале
• Hermes Agent в терминале
• Telegram для CLI-агентов
• Рабочий стол Promto
• Хостинг и публикация