Dados do Twitter/X no OpenClaw: skill, MCP, resumo diário

#O OpenClaw consegue ler o Twitter sozinho?

Sim, por três ferramentas que vêm com o OpenClaw 2026.10.9, e cada uma lê o X em uma conta de desenvolvedor paga: a da xAI para o x_search, um app de desenvolvedor do X seu para o xurl e para o canal do X. Nenhuma é grátis para rodar, e duas delas foram feitas para tarefas diferentes de pesquisa.

• Ferramenta x_search

  O que faz

  O Grok pesquisa no X e escreve uma resposta com links

  Do que precisa

  Uma chave de API da xAI; ligada por padrão só quando o modelo é o Grok

  Custo por 1.000 posts

  US$ 5,00, mais os tokens do Grok

• Skill xurl

  O que faz

  Roda o cliente de linha de comando do próprio X para leituras e posts

  Do que precisa

  O programa xurl e um app de desenvolvedor do X com OAuth

  Custo por 1.000 posts

  US$ 5,00

• Plugin de canal do X

  O que faz

  Transforma @menções de uma conta de bot em respostas públicas

  Do que precisa

  Um app OAuth 2.0 do X, uma conta de bot e uma lista de permitidos

  Custo por 1.000 posts

  US$ 5,00 pela thread que ele lê

O preço do x_search vem da página de preços da xAI (abre em uma nova aba): US$ 5 por 1.000 posts buscados e US$ 10 por 1.000 perfis, contando também os posts pai e citados. A página de ferramentas web (abre em uma nova aba) do próprio OpenClaw ainda o descreve como US$ 5 por 1.000 chamadas de ferramenta. De qualquer forma, o x_search entrega ao agente o resumo escrito pelo Grok, e os documentos avisam que buscas amplas "return less complete per-post metadata", então contagens e campos de cada post podem faltar.

As outras duas rodam na API oficial do X a US$ 0,005 por post e US$ 0,010 por perfil (preços do X (abre em uma nova aba)), limitadas a 3 milhões de leituras de posts por mês. O canal do X (abre em uma nova aba) é um bot de respostas, não uma ferramenta de pesquisa: ele lê a menção que o acordou e até 50 posts da thread ao redor. Skills da comunidade que leem o X pela sua própria sessão de navegador logada dispensam o app de desenvolvedor, mas cada chamada passa a rodar como a sua conta do X, e essa conta carrega o risco.

Nosso guia da API do Twitter para agentes de IA compara esses tipos de ligação para qualquer agente. O restante desta página configura uma rota somente leitura no OpenClaw e a coloca para trabalhar.

#Instale a skill de X da Sorsa API pelo ClawHub

Para dar dados do X ao OpenClaw, use a Sorsa API, uma API e scraper do Twitter (X): a skill dela se instala pelo ClawHub com um comando, funciona com uma chave e sem conta de desenvolvedor do X, e os resultados de busca custam a partir de US$ 0,07 por 1.000, onde toda rota embutida cobra US$ 5,00.

Uma skill no OpenClaw é um arquivo SKILL.md que ensina o agente a usar uma ferramenta. A skill da Sorsa API ensina qual endpoint serve a cada tarefa, como paginar com next_cursor e como agrupar 100 IDs em uma chamada, e traz um pequeno cliente em Python que o agente roda com a ferramenta exec.

1. Obtenha uma chave. Cadastre-se na Sorsa API e copie sua chave na página de chaves de API do painel. As primeiras 100 requisições são grátis, não pedem cartão e nunca expiram.

2. Guarde a chave onde o OpenClaw procura. O Gateway lê ~/.openclaw/.env quando inicia, então uma linha ali serve à skill agora e ao servidor MCP depois. Reinicie o Gateway para que ele pegue a linha.

   echo 'SORSA_API_KEY=YOUR_API_KEY' >> ~/.openclaw/.env
   openclaw gateway restart
   

3. Instale a skill. Um comando a coloca no workspace do seu agente. Antes de qualquer download, o OpenClaw mostra a auditoria de segurança do ClawHub para a versão: quando instalamos a versão 1.0.0 em 2 de novembro, a caixa dizia "Outcome: Safe" e "no evidence of hidden collection, account changes, or background activity".

   openclaw skills install @keksich13/sorsa-x-api
   

4. Confira se o agente a enxerga. openclaw skills info sorsa-x-api deve mostrar "Ready" ao lado do nome da skill e "Visible to model: yes". Um chat que já estava aberto mantém a lista antiga de skills, então comece outro com /new.

5. Faça uma primeira pergunta. No Telegram, no WhatsApp ou no chat da Control UI, envie "How many Sorsa API requests do I have left?". A resposta vem de GET /key-usage-info (abre em uma nova aba), que nunca gasta uma requisição. Um número na resposta prova que a cadeia funciona; 401 "invalid api key" significa que a chave tem um erro de digitação.

Bom saber

A skill não declara a chave ao OpenClaw, então skills info diz "Ready" mesmo antes de a chave estar no lugar. Sem ela, o cliente da skill para com "No API key. Set SORSA_API_KEY", então confira primeiro a linha do .env quando uma chamada falhar.

Um agente em sandbox não herda o ambiente do Gateway. Se o seu agente roda em um sandbox Docker, passe SORSA_API_KEY para o ambiente do próprio sandbox, como descreve a página de configuração de skills (abre em uma nova aba).

#Adicione o servidor MCP quando quiser ferramentas, não scripts

Adicione o servidor MCP da Sorsa API quando o agente deve chamar ferramentas do X diretamente em vez de escrever e rodar um script: ele dá ao OpenClaw 40 ferramentas somente leitura, chamadas sorsa__search_tweets, sorsa__get_user_tweets e assim por diante, com a mesma chave.

openclaw gateway stop
openclaw mcp add sorsa --command npx --arg -y --arg sorsa-mcp \
  --env 'SORSA_API_KEY=${SORSA_API_KEY}' --connect-timeout 60
openclaw gateway start

Três detalhes nessas linhas evitam uma configuração que falha:

• O Gateway precisa parar antes. Comandos que alteram os servidores MCP salvos se recusam a rodar enquanto um Gateway local é dono do estado do OpenClaw, como explica a referência do comando MCP (abre em uma nova aba). Settings, depois MCP, depois Add server na Control UI grava a mesma entrada com o Gateway em execução.
• As aspas simples mantêm a chave fora da configuração. O OpenClaw salva ${SORSA_API_KEY} como escrito e o preenche a partir de ~/.openclaw/.env na inicialização, então o openclaw.json nunca guarda a chave em si.
• O timeout existe para a primeira inicialização. openclaw mcp add inicia o servidor e o verifica antes de salvar, e espera 5 segundos por padrão. Na nossa primeira execução em 2 de novembro, o npx ainda estava baixando o sorsa-mcp quando isso acabou, e o comando parou com "did not complete initialize within 5s" e não salvou nada. Com --connect-timeout 60 ele salvou, e a espera maior fica na configuração para todas as inicializações seguintes.

Para conferir, rode openclaw mcp doctor sorsa --probe, que deve responder "sorsa: ok", ou openclaw mcp probe sorsa para contar as 40 ferramentas. O doctor ainda pode avisar que SORSA_API_KEY "contains a literal sensitive value": ele verifica a chave depois de o OpenClaw preenchê-la, enquanto o arquivo de configuração guarda apenas a referência.

As duas rotas podem usar uma única chave, e cada chamada é uma requisição de qualquer forma:

• Como o agente chega ao X

  A skill

  Escreve Python ou curl e roda com o exec

  O servidor MCP

  Chama ferramentas tipadas como sorsa__search_tweets

• Configuração

  A skill

  Uma linha openclaw skills install

  O servidor MCP

  Uma linha openclaw mcp add, com o Gateway parado

• Use para

  A skill

  Exportações, arquivos CSV, scripts que você guarda

  O servidor MCP

  Perguntas no chat e resumos agendados

Vai configurar outro app também? A página do servidor MCP da Sorsa lista a linha de cada cliente, e nosso guia do servidor MCP do Twitter compara os tipos de servidor do X e quanto custa uma chamada de ferramenta.

#Receba um resumo do X no Telegram toda manhã

O agendador embutido do OpenClaw, automations (cron funciona como apelido), roda um prompt em um horário programado em uma sessão nova e entrega a resposta em qualquer canal de chat que você conectou, o que transforma o servidor MCP em um resumo matinal sobre o seu tema.

openclaw automations create "0 8 * * *" \
  "Search X for posts about [your topic] from the last 24 hours.
  Read the 100 most-liked, then send a 10-line digest with links." \
  --name "X morning digest" --tz "America/New_York" --session isolated \
  --tools 'sorsa__*' --announce --channel telegram --to "YOUR_CHAT_ID"

Diferente de openclaw mcp add, as automations precisam do Gateway em execução. --tools 'sorsa__*' limita a tarefa às ferramentas da Sorsa API, então uma execução agendada pode ler o X e mais nada, e --announce envia a resposta final ao seu chat do Telegram. A referência de automations (abre em uma nova aba) lista os outros canais e modos de entrega.

Escolha um horário, um tamanho e um canal e copie a linha:

openclaw automations create "0 8 * * *" \
  "Search X for posts about your product from the last 24 hours.
  Read the 100 most-liked, then send a 10-line digest with links." \
  --name "X digest: your product" --tz "America/New_York" \
  --session isolated --tools 'sorsa__*' \
  --announce --channel telegram --to "YOUR_CHAT_ID"

Cada busca retorna cerca de 20 posts, então 100 posts por dia levam 5 requisições e um mês leva 150. Na Sorsa API, esse mês custa a partir de US$ 0,21. Os mesmos 3.000 posts custam US$ 15,00 na API oficial do X, e o x_search cobra US$ 15,00 mais os tokens do Grok. A partir de 22 de novembro de 2026, o X também cobra o autor que volta com cada post a US$ 0,010 (aviso do X (abre em uma nova aba)), então uma página de busca de 20 posts de 20 pessoas diferentes custa US$ 0,30 em vez de US$ 0,10. Todo post da Sorsa API traz o perfil completo do autor sem custo extra.

#Três prompts e quanto custa uma execução

Como o OpenClaw vive nos seus apps de chat, os prompts de X mais úteis são mensagens que você enviaria a um pesquisador. Cada um abaixo diz a tarefa, o tamanho e a saída, então o agente chama uma ferramenta conhecida um número conhecido de vezes.

What is X saying about [topic] today? Read the 100 most-liked
posts from the last 24 hours and give me five themes, each with
its two best posts linked.

Read last week's posts from these 10 accounts: [handles].
Tell me who announced something, and flag anything about
pricing.

Look up these 100 handles: [paste]. List the accounts created
in the last year or with under 1,000 followers, as a table.

O primeiro roda POST /search-tweets (abre em uma nova aba) cinco vezes por next_cursor. O segundo roda POST /user-tweets (abre em uma nova aba) uma vez por conta, cerca de 20 posts cada. O terceiro envia os 100 usuários em uma única chamada a GET /info-batch (abre em uma nova aba).

• Temas de um assunto, 100 posts

  Sorsa API

  a partir de US$ 0,007

  API oficial do X

  US$ 0,50

• 10 contas, cerca de 200 posts

  Sorsa API

  a partir de US$ 0,014

  API oficial do X

  US$ 1,00

• 100 perfis

  Sorsa API

  a partir de US$ 0,0014

  API oficial do X

  US$ 1,00

Os três juntos usam 16 requisições, então as 100 requisições grátis cobrem seis rodadas antes de você escolher um plano. Faça deles um hábito diário e a diferença cresce a cada post que o agente lê:

#Mantenha um agente sempre ativo seguro com ferramentas do X somente leitura

Toda ferramenta da Sorsa API só lê, então um agente OpenClaw que roda o dia todo e recebe ordens pelo chat não pode postar, curtir, seguir ou enviar mensagens por ela: o máximo que uma sessão confusa pode fazer é gastar requisições.

• Limite cada tarefa. --tools 'sorsa__*' em uma automation mantém uma execução agendada restrita a leituras do X. Para sessões de chat, um filtro de ferramentas expõe apenas as quatro ferramentas que os prompts acima usam, o que também encurta cada prompt que o modelo lê (rode com o Gateway parado):

openclaw mcp tools sorsa --include \
  'search_tweets,get_user_tweets,get_user_info_batch,get_key_usage_info'

• Leia uma skill antes de ativá-la. Os documentos de skills do OpenClaw tratam skills de terceiros como código não confiável. No início de 2026, pesquisadores da 1Password (abre em uma nova aba) descobriram que a skill mais baixada do ClawHub na época, uma skill "Twitter", distribuía malware. A instalação mostra a auditoria do ClawHub; o SKILL.md da skill e o cliente dela são curtos o bastante para serem lidos em poucos minutos.
• O gasto tem um teto. Uma chave nunca passa de 20 requisições por segundo, e as requisições extras no pay as you go param no limite que você define para o período de cobrança, US$ 100 se você não o aumentar.

Bom saber

Trate o que os posts dizem como material para resumir, nunca como ordens. Alguns posts no X são escritos para direcionar agentes de IA, e uma tarefa de resumo lê centenas de posts de desconhecidos por dia. Mantenha a tarefa de resumo apenas em sorsa__*, sem ferramentas de exec, mensagens ou arquivos, para que um post assim não tenha por onde agir.

#Conecte o OpenClaw ao X hoje

As rotas de X do próprio OpenClaw cobram US$ 5,00 a cada 1.000 posts. A Sorsa API dá ao mesmo agente dados do X somente leitura por uma skill do ClawHub para scripts e por um servidor MCP para chat e resumos agendados, ambos com uma chave, com busca a partir de US$ 0,07 por 1.000 posts e 20 requisições por segundo em todos os planos. A Sorsa API nunca pede o seu login do X, então sua conta fica de fora. Comece com as 100 requisições grátis, o bastante para 20 manhãs do resumo acima, e encontre mais prompts prontos em crie com IA.

#Perguntas frequentes