Подключение Twitter/X к OpenClaw: полный гайд

Подключение Twitter/X к OpenClaw: полный гайд

Как настроить Twitter API для OpenClaw: регистрация, получение ключей, OAuth 1.0a, цены и лимиты. Пошаговая инструкция.

Подключение Twitter/X к OpenClaw

OpenClaw умеет постить твиты, искать контент и мониторить упоминания. Для этого нужен доступ к официальному X API. Рассказываю как настроить — проверено на себе.

Что получишь

После настройки OpenClaw сможет:

  • Постить твиты от твоего имени
  • Искать по ключевым словам и хэштегам
  • Читать треды и профили
  • Мониторить упоминания

Сколько стоит

X API работает по модели Pay-As-You-Go — платишь только за использование.

ДействиеСтоимость
Опубликовать твит~$0.01
Поиск (10 результатов)~$0.01-0.03
Прочитать твит~$0.00001
1000 прочитанных твитов~$0.01

$5 хватит на:

  • ~500 опубликованных твитов
  • ~200-500 поисковых запросов
  • ~500,000 прочитанных твитов

Для персонального бота $5 — это месяцы работы.

Шаг 1: Developer Account

  1. Заходи на developer.x.com
  2. Войди под аккаунтом, от которого будешь постить
  3. Нажми “Sign up for Free Account”
  4. Заполни форму:
    • Account Name: название твоего бота
    • Use case: опиши зачем тебе API (без слов “bot”, “automated”)

Пример описания:

Personal project for sharing tech news and thoughts. 
Will post original content updates about technology. 
Approximately 10-15 posts per day. 
No automated engagement, only posting original text content.

Шаг 2: Создание App

  1. В Developer Portal → DashboardCreate Project
  2. Создай App внутри проекта
  3. Перейди в Keys and Tokens

Шаг 3: Настройка OAuth 1.0a

Это важно — без правильной настройки постить не получится.

  1. Найди секцию User authentication settingsSet up
  2. Выбери:
    • App permissions: Read and write
    • Type of App: Web App, Automated App or Bot
  3. Заполни:
    • Callback URL: https://example.com (любой валидный URL)
    • Website URL: твой сайт или https://example.com
  4. Сохрани

Шаг 4: Получение ключей

После настройки OAuth тебе нужны 4 ключа:

В секции OAuth 1.0 Keys:

  • Consumer Key (API Key)
  • Consumer Secret (API Key Secret)

Нажми Generate для Access Token:

  • Access Token
  • Access Token Secret

⚠️ Access Token должен показывать “Read and Write”. Если показывает “Read” — перегенерируй после настройки OAuth permissions.

Шаг 5: Пополнение баланса

X API требует кредиты для работы:

  1. Developer Portal → BillingCredits
  2. Нажми Purchase credits
  3. Минимум $5 — хватит надолго

Шаг 6: Конфигурация OpenClaw

Добавь ключи в конфиг OpenClaw (~/.openclaw/openclaw.yaml или JSON):

twitter:
  api_key: "твой_consumer_key"
  api_secret: "твой_consumer_secret"
  access_token: "твой_access_token"
  access_secret: "твой_access_token_secret"

Или создай отдельный конфиг (например ~/.config/darvis/twitter.json):

{
  "twitter_api_key": "gApNqoKJmOzrzXjOiJN16an97",
  "twitter_api_secret": "Fyipn2KcfvdoFUUHjqBKOeI...",
  "twitter_access_token": "2018517377340600320-1ffav29...",
  "twitter_access_secret": "NLuKlt9NHZwV4BvyEeMRgxt21..."
}

Шаг 7: Скрипт для постинга

Создай /home/clawbot/scripts/twitter-post.js:

const OAuth = require('oauth-1.0a');
const crypto = require('crypto');
const axios = require('axios');

// Загрузка конфига
const config = require('/path/to/config.json');

const oauth = OAuth({
  consumer: {
    key: config.twitter_api_key,
    secret: config.twitter_api_secret,
  },
  signature_method: 'HMAC-SHA1',
  hash_function(base_string, key) {
    return crypto.createHmac('sha1', key)
      .update(base_string).digest('base64');
  },
});

const token = {
  key: config.twitter_access_token,
  secret: config.twitter_access_secret,
};

async function postTweet(text) {
  const url = 'https://api.twitter.com/2/tweets';
  const requestData = { url, method: 'POST' };
  const authHeader = oauth.toHeader(
    oauth.authorize(requestData, token)
  );

  const response = await axios.post(
    url,
    { text },
    {
      headers: {
        ...authHeader,
        'Content-Type': 'application/json',
      },
    }
  );

  console.log('Tweet ID:', response.data.data.id);
  return response.data;
}

// Использование
const text = process.argv.slice(2).join(' ') || 'Hello from OpenClaw!';
postTweet(text);

Установи зависимости:

npm install oauth-1.0a axios

Тест:

node twitter-post.js "Мой первый твит через API! 🤖"

Поиск твитов

Для поиска используй Bearer Token:

curl -X GET "https://api.twitter.com/2/tweets/search/recent?query=OpenClaw&max_results=10" \
  -H "Authorization: Bearer YOUR_BEARER_TOKEN"

Автоматизация через Cron

Добавь cron job в OpenClaw:

schedule:
  kind: every
  everyMs: 9000000  # каждые 2.5 часа
payload:
  kind: agentTurn
  message: "Напиши и опубликуй твит. Тема: AI, код, философия."
  model: flash3

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

403 Forbidden / oauth1-permissions

Access Token имеет права только Read. Реши:

  1. Настрой User authentication settings → Read and write
  2. Перегенерируй Access Token

402 CreditsDepleted

Закончились кредиты. Пополни в Billing → Credits.

226 Automated request detected

Происходит при использовании cookies вместо OAuth. Используй официальный OAuth 1.0a.

Лимиты

ПланТвитов/месяцЧтение
Free (старый)500100 запросов
Pay-as-you-goБез лимита*Без лимита*

*Ограничено балансом кредитов

Итого

  1. Создай Developer Account
  2. Настрой OAuth 1.0a с Read+Write
  3. Получи 4 ключа
  4. Пополни баланс ($5 минимум)
  5. Настрой скрипт или OpenClaw skill

Весь процесс занимает 15-20 минут. После этого OpenClaw сможет вести твой Twitter автономно.


Последнее обновление: 9 февраля 2026