Работа с API X с помощью xurl
Используйте утилиту командной строки xurl для публикации, ответов, поиска, отправки личных сообщений, загрузки медиафайлов и вызовов необработанных эндпоинтов API v2 X прямо из терминала.
Что понадобится
- Для работы должен быть доступен бинарный файл xurl — его можно установить через brew (xdevplatform/tap/xurl) или npm (@xdevplatform/xurl).
Как применить
Проверьте аутентификацию с помощью xurl auth status. Аргумент POST_ID может представлять собой полный URL https://x.com/<user>/status/<id>.
Значение POST_ID, используемое в командах-ярлыках, также может быть полным URL https://x.com/<user>/status/<id>.
Для работы с API X используйте xurl. Команды-ярлыки возвращают данные в формате JSON; режим «сырых данных» подходит для любых эндпоинтов v2.
Никогда не читайте, не выводите, не обобщайте, не загружайте и не анализируйте содержимое ~/.xurl.
Никогда не просите пользователя вставлять токены или секретные данные в чат.
Не выполняйте команды аутентификации с встроенными секретами.
Не используйте --verbose в сессиях агента — это может привести к утечке заголовков аутентификации.
Проверьте статус аутентификации с помощью xurl auth status.
Стандартные ярлыки охватывают публикацию, чтение, поиск, временные ленты, лайки, репосты, закладки, подписки, блокировки, молчание и личные сообщения.
xurl post "Hello world!"
xurl reply POST_ID "Nice."
xurl quote POST_ID "My take"
xurl delete POST_ID
xurl read POST_ID
xurl search "query" -n 20
xurl whoami
xurl user @handle
xurl timeline -n 20
xurl mentions -n 10
xurl like POST_ID
xurl unlike POST_ID
xurl repost POST_ID
xurl unrepost POST_ID
xurl bookmark POST_ID
xurl unbookmark POST_ID
xurl followers -n 20
xurl following -n 20
xurl follow @handle
xurl unfollow @handle
xurl block @handle
xurl unblock @handle
xurl mute @handle
xurl unmute @handle
xurl dm @handle "message"
xurl dms -n 10
Команды для загрузки медиафайлов.
xurl media upload image.jpg
xurl media upload clip.mp4
xurl media status MEDIA_ID
xurl post "caption" --media-id MEDIA_ID
Видеофайлы могут требовать предварительной обработки; уточните статус через media status.
Команды для управления аутентификацией и приложениями.
xurl auth status
xurl auth apps list
xurl auth default
xurl auth default APP_NAME USERNAME
xurl auth apps remove APP_NAME
xurl --app APP_NAME /2/users/me
xurl --auth oauth2 /2/users/me
Режим необработанного API для эндпоинтов, не покрытых ярлыками.
xurl /2/users/me
xurl -X POST /2/tweets -d '{"text":"Hello world!"}'
xurl '/2/tweets/search/recent?query=openclaw&max_results=10'
Используйте режим необработанных данных, если эндпоинт не поддерживается ярлыками. Для сложных JSON-данных храните их во временных файлах.
Ошибка 401/403 указывает на проблемы с аутентификацией, правами доступа или несоответствие приложения; проверьте xurl auth status.
Ошибка 429 означает, что превышен лимит запросов; следует сделать паузу.
При сбоях загрузки медиафайлов проверьте тип и размер файла, а также статус его обработки.
Источник: openclaw/openclaw и участники проекта. Лицензия: MIT.
Copyright (c) 2026 OpenClaw Foundation
Перевод и редакционная адаптация: ClawCases.
>Ресурсы
>Похожие юзкейсы
Арбитр разрешения конфликтов слияния агентов
Разрешает конфликт слияния Git между ветками двух агентов в качестве беспристрастной третьей стороны: нейтральный арбитр, который принимает обе версии изменений и указанные намерения, после чего формирует итоговый результат слияния, не перезаписывая ни одну из сторон.
Автоматизация данных и действий X (Twitter) через Hermes
Плагин Hermes Tweet устанавливается как дополнение к Hermes Agent, регистрируя набор инструментов hermes-tweet с функциями поиска, чтения и выполнения действий для эндпоинтов X, а также предоставляя скиллы и команды вроде /xstatus и /xtrends для проверки статуса аккаунта и трендов.
Автоматические заметки и задачи по итогам встреч
Преобразуйте любую расшифровку встречи в структурированные заметки с решениями и задачами, а также автоматически создавайте задачи в вашем инструменте управления проектами.