chirp

chirp — это CLI-инструмент для работы с X (Twitter), построенный на базе браузерного инструмента OpenClaw. Он позволяет взаимодействовать с социальной сетью без использования официального API и выступает альтернативой bird CLI в средах без Homebrew.

Основные возможности

• Просмотр ленты (timeline)
• Публикация твитов
• Лайки, ретвиты и ответы
• Поиск по X (Twitter)
• Просмотр профилей
• Подписка и отписка от пользователей

Как это работает

chirp использует браузерную автоматизацию через OpenClaw. Агент запускает браузерный профиль, открывает нужную страницу X (Twitter) и анализирует DOM-структуру страницы.

Перед каждым действием создаётся snapshot страницы — компактное представление интерфейса. На его основе определяется нужный элемент (например, кнопка или поле ввода), после чего выполняется действие.

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

Требования

• Установленный OpenClaw с включённым browser tool
• Настроенный браузерный профиль openclaw
• Аккаунт X (Twitter) с выполненным входом

Для headless-серверов требуется виртуальный дисплей (например, Xvfb).

Первичная настройка

Перед началом работы необходимо один раз выполнить вход в аккаунт через браузер:

browser action=start profile=openclaw
browser action=open profile=openclaw targetUrl="https://x.com/login"

После этого сессия будет сохранена и использоваться в дальнейших операциях.

Примеры использования

Поиск:

browser action=open profile=openclaw targetUrl="https://x.com/search?q=keyword&src=typed_query"
browser action=snapshot profile=openclaw compact=true

Переход к профилю:

browser action=open profile=openclaw targetUrl="https://x.com/username"
browser action=snapshot profile=openclaw compact=true

Подписка: найти кнопку Follow через snapshot и выполнить клик по её ref.

Ключевые принципы

• Сначала snapshot — затем любое действие
• ref элементов всегда нужно получать заново
• Использование compact=true снижает расход токенов
• Каждый твит представлен как элемент article в DOM

Траблшутинг

• Браузер не запускается — проверить Xvfb и переменную DISPLAY
• Не получается войти — открыть /login и выполнить вход вручную
• Кнопка Post не активна — проверить, введён ли текст
• Ограничения (rate limit) — подождать и повторить попытку

Сравнение с bird CLI

• bird CLI требует Homebrew, chirp — только браузер
• bird использует API, chirp — интерфейс (UI)
• chirp может быть медленнее, но проще в установке
• авторизация в chirp происходит через браузерную сессию

Установка

openclaw skill install https://github.com/zizi-cat/chirp

chirp — удобный способ автоматизировать работу с X (Twitter) через браузер, особенно если доступ к API ограничен или нежелателен. :