Постинг в X из OpenClaw

Что OpenClaw умеет с calmposts

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

Инструменты calmposts проходят через профили инструментов и политику инструментов OpenClaw, как и любые другие, а инструкции, которые calmposts отправляет при подключении, OpenClaw передаёт агенту: сначала посмотреть аккаунты, предпочитать очередь или черновик, никогда не отвечать, не подписываться и не писать в личку.

MCP-сервер для X (Twitter) даёт OpenClaw 11 инструментов — тех же, что и любому другому клиенту:

Настройка calmposts в OpenClaw

Сначала проверьте ключ

Создайте ключ в calmposts в разделе «API и MCP» (он показывается один раз) и запросите у сервера список инструментов. Список из 11 инструментов значит, что адрес и ключ верны; 401 — ключ неверный или отправлен без «Bearer ».

curl -s https://calmposts.com/mcp \
  -H "Authorization: Bearer cp_live_…" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
# 200 {"jsonrpc":"2.0","id":1,"result":{"tools":[…]}}

Способ 1: openclaw mcp set, ключ в .env

Две команды на машине, где работает Gateway.

1. Создайте ключ в calmposts в разделе «API и MCP» и положите его в ~/.openclaw/.env — OpenClaw читает этот файл при запуске:

   CALMPOSTS_API_KEY=cp_live_…

2. Сохраните сервер со ссылкой на ключ, а не с самим ключом. Не убирайте transport: без него OpenClaw использует SSE.

   openclaw mcp set calmposts '{"url":"https://calmposts.com/mcp","transport":"streamable-http","headers":{"Authorization":"Bearer ${CALMPOSTS_API_KEY}"}}'

3. Проверьте вживую: doctor проверит запись, подключится и покажет 11 инструментов calmposts.

   openclaw mcp doctor calmposts --probe

Способ 2: Прямо в openclaw.json

Та же запись в файле настроек; Gateway подхватит изменение на лету.

1. Добавьте calmposts в mcp.servers в ~/.openclaw/openclaw.json:

   {
     "mcp": {
       "servers": {
         "calmposts": {
           "url": "https://calmposts.com/mcp",
           "transport": "streamable-http",
           "headers": {"Authorization": "Bearer ${CALMPOSTS_API_KEY}"}
         }
       }
     }
   }

2. Выполните openclaw mcp doctor calmposts --probe. В Control UI сервер теперь виден в Settings → MCP, где его можно выключить или удалить.

Вход: ключ или OAuth

OpenClaw отправляет статические заголовки в каждом запросе, и заголовок Authorization несёт ключ calmposts. Пишите его как Bearer ${CALMPOSTS_API_KEY}: OpenClaw подставит переменную при чтении конфига, а doctor не ругается на ссылку так, как ругается на токен, записанный буквально.

Имена переменных должны быть в верхнем регистре — как CALMPOSTS_API_KEY. Отсутствующая переменная остаётся неподставленной, OpenClaw предупреждает, а calmposts отвечает 401.

OpenClaw поддерживает и OAuth для HTTP-серверов (auth: "oauth" и openclaw mcp login), и тогда статические заголовки Authorization игнорируются. Здесь используется ключ — с ним страница и проверена.

Как проверить, что всё работает

• openclaw mcp doctor calmposts --probe сообщает, что сервер доступен, и показывает 11 инструментов.
• openclaw mcp status --verbose показывает calmposts включённым, с его URL и транспортом.
• Спросите агента «Какие у меня сегодня лимиты в calmposts?» — он вызовет get_limits.
• Попросите черновик и найдите его в разделе «Посты» calmposts, с источником mcp.

Что попросить

Просите своими словами — агент сам выберет инструменты. Хорошо работают такие просьбы:

• «Поставь эту ссылку в мою очередь X на завтрашнее утро с комментарием в одну строку».
• «Сделай версии для X и Bluesky из заметки, которую я только что прислал, и сохрани обе черновиками в calmposts».
• «Что запланировано в calmposts на этой неделе? Прочитай мне список».
• «Набросай короткий тред-итог того, что я постил на этой неделе, и оставь его мне на одобрение».

Соцсети, треды и одобрение

Посты уходят в X и Bluesky. В X и Bluesky тред выходит цепочкой ответов. Скоро: Threads и LinkedIn.

Пишете один раз — выходит везде: агент передаёт один текст для всех выбранных аккаунтов. Если текст длиннее, чем разрешает соцсеть, calmposts публикует его там тредом из постов, каждый из которых помещается: делит по абзацу, затем по предложению, затем по пробелу, ничего не нумерует и не добавляет. Правила каждой соцсети и квоты тарифа проверяются до сохранения поста, а ошибка возвращается с указанием поля, так что агент может поправить текст и повторить.

По умолчанию посты агента ждут вас: они возвращаются со статусом pending_approval, и вы одобряете или отклоняете каждый в приложении, в Telegram или из письма calmposts. Владелец рабочего пространства может разрешить агентам публиковать самим; для этого и пространство, и API-ключ должны быть переключены на публикацию. X ждёт, что у аккаунта, который постит автоматически, стоит метка Automated (Settings → Your account → Account information → Automation).

Какие соцсети уже работают→

Лимиты и стоимость

• Агентам нужен платный тариф: на Free нет API-ключей и нельзя одобрить подключение приложения. API-ключей по тарифам: Pro 3 · Advanced 10 · Agency 25.
• Посты агента считаются так же, как ваши. Постов в день: Pro 20 · Advanced 100 · Agency 300. Постов со ссылкой в месяц: Pro 30 · Advanced 300 · Agency 600. Каждый пост треда считается отдельно.
• Ссылки считаются отдельно, потому что X берёт с каждого приложения $0,015 за пост и $0,20 за пост со ссылкой. Плата X входит в тариф: свой аккаунт разработчика X и свой счёт за X API не нужны.
• Попробовать: 7 дней бесплатно. Нужна карта. 5 постов со ссылкой за пробный период.
• Каждый ключ может сделать 60 запросов в минуту, MCP и REST вместе; дальше сервер отвечает 429 с Retry-After.

Тарифы→

Что важно знать про OpenClaw

• transport: "streamable-http" обязателен: без него OpenClaw подключается по SSE, а SSE у calmposts нет.
• Не храните ключ в openclaw.json: doctor предупреждает о чувствительных заголовках, записанных буквально, а ссылка вроде ${CALMPOSTS_API_KEY} после префикса Bearer проходит.
• Чтобы дать агенту только часть инструментов, добавьте toolFilter.include, например ["list_*", "get_*", "create_post"], или запретите отдельные инструменты для сессии в + → Connectors → Tool access.
• Если calmposts недоступен, OpenClaw повторяет попытки в фоне: сначала через 30 секунд, затем вдвое дольше, до 10 минут; ходы вашего агента этого не ждут.

Без MCP: REST API

Всё, что делают инструменты, доступно и обычными REST-запросами к /api/v1 с тем же ключом. Это удобно для скрипта или шага, который умеет только HTTP. calmposts публикует через своё одобренное приложение X, поэтому ключи X API для запроса не нужны.

export CALMPOSTS_API_KEY=cp_live_…
curl -H "Authorization: Bearer $CALMPOSTS_API_KEY" https://calmposts.com/api/v1/accounts
curl -X POST https://calmposts.com/api/v1/posts \
  -H "Authorization: Bearer $CALMPOSTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"parts":[{"text":"Calm posts, scheduled."}],"targets":[{"account_id":"ACCOUNT_ID"}],"schedule":{"mode":"queue"}}'

Документация REST API→

Документация OpenClaw, по которой написана страница

• OpenClaw docs: Connect MCP servers
• OpenClaw docs: Transports and OAuth
• OpenClaw docs: MCP client registry
• OpenClaw docs: Environment variables

calmposts — независимый сервис, он не связан с создателями OpenClaw и не одобрен ими. Названия продуктов принадлежат их владельцам.