XApiClaw para OpenClaw

Instala y configura el plugin XApiClaw de OpenClaw para automatización de X/Twitter con Twexapi.

XApiClaw es el plugin de OpenClaw para usar Twexapi desde un agente de OpenClaw. Le da a tu agente un catálogo de endpoints local seguro, un invocador opcional de Twexapi en vivo, comandos slash, inyección de API key y puertas de aprobación para acciones privadas, de pago o de escritura.

Usa XApiClaw cuando un flujo de trabajo de OpenClaw necesite búsqueda de X/Twitter, respuestas a tweets, líneas de tiempo, exportaciones de seguidores, consultas de usuarios, tendencias, listas, comunidades, DMs, artículos, verificaciones de estado de cuenta o acciones de escritura aprobadas explícitamente por el usuario.

Requisitos previos

OpenClaw 2026.6.8 o posterior
Node.js 22 o posterior
Una API key de Twexapi desde el panel

Instala plugins de agente solo desde fuentes confiables. Los plugins de OpenClaw ejecutan código en tu entorno local de agente, así que fija versiones para instalaciones de producción repetibles.

Instalación

Instala el paquete npm con el selector de fuente npm explícito de OpenClaw:

openclaw plugins install npm:xapiclaw

Para actualizaciones normales, reutiliza la fuente de instalación rastreada:

openclaw plugins update xapiclaw

Para instalaciones de producción reproducibles, fija una versión publicada en npm:

openclaw plugins install npm:xapiclaw@0.1.0 --pin

El nombre del paquete es xapiclaw, el id del plugin es xapiclaw y la versión actual del paquete es 0.1.0.

Si tu instalación de OpenClaw se ejecuta con OPENCLAW_NIX_MODE=1, los mutadores del ciclo de vida del plugin están deshabilitados. Instala o actualiza XApiClaw a través de tu fuente OpenClaw de Nix en lugar de openclaw plugins install o openclaw plugins update.

XApiClaw puede instalarse antes de configurar credenciales. Hasta que agregues una API key de Twexapi, el catálogo gratuito explore permanece disponible y las llamadas API en vivo devuelven orientación de configuración.

Configura autenticación con API key

Crea una API key de Twexapi, guárdala en una variable de entorno y luego configura XApiClaw:

export TWEXAPI_API_KEY="twitterx_..."
openclaw config set plugins.entries.xapiclaw.config.apiKey "$TWEXAPI_API_KEY"

XApiClaw inyecta la key en solicitudes en vivo como:

Authorization: Bearer YOUR_API_KEY

Mantén la key fuera de chats, documentos e historial de shell. Prefiere el comando de variable de entorno anterior para que OpenClaw escriba el secreto en la configuración local del plugin sin exponerlo en un prompt.

Configuración opcional

Usa la URL base de API predeterminada a menos que operes un despliegue compatible con Twexapi:

openclaw config set plugins.entries.xapiclaw.config.baseUrl "https://api.twexapi.io"

XApiClaw requiere una URL base HTTPS sin credenciales embebidas.

La configuración de polling está reservada para soporte de eventos futuro y no habilita monitores en segundo plano en la versión actual:

openclaw config set plugins.entries.xapiclaw.config.pollingEnabled false
openclaw config set plugins.entries.xapiclaw.config.pollingInterval 60

Herramientas

XApiClaw expone dos herramientas estructuradas.

`explore`

Busca en el catálogo de endpoints de Twexapi incluido e inspecciona métodos, rutas, parámetros, banderas de riesgo y notas de costo. Esta herramienta es local y no llama a la red.

Find the endpoint for searching tweets about AI agents, then show the required parameters.

`xapiclaw`

Llama a endpoints de Twexapi listados en el catálogo con entrada estructurada de method, path, query y body. La autenticación la inyecta el plugin para que el modelo no reciba tu API key como argumento de herramienta.

La herramienta xapiclaw es opcional porque puede gastar créditos, leer datos privados de cuenta o realizar acciones de escritura. Si OpenClaw oculta herramientas opcionales, permítela explícitamente:

openclaw config set tools.alsoAllow '["explore", "xapiclaw"]'

Los prompts de aprobación de OpenClaw se ejecutan antes de llamadas de escritura, lectura privada y bulk de pago. Revisa el objetivo de la solicitud, el endpoint, el payload y el costo esperado antes de aprobar.

Entregas de flujo de trabajo

Usa explore primero, luego llama a xapiclaw solo para el endpoint, objetivo y límite que pretendes ejecutar.

Búsqueda de tweets

Usa explore para encontrar /twitter/advanced_search/page, luego llama a xapiclaw con parámetros de búsqueda acotados.

Use explore to find tweet search endpoints.
Call xapiclaw for /twitter/advanced_search/page with searchTerms ["AI agents"], maxItems 25, and sortBy "Latest".
Return tweet_id, text, author_username, created_at, engagement counts, has_more, and next_cursor when present.

Respuestas a tweets

Usa explore para encontrar endpoints de respuestas, luego llama a /twitter/tweets/{tweet_id}/replies/{count} con un conteo acotado y opción de ordenamiento.

Use explore to find reply endpoints.
Fetch up to 100 replies for tweet 1893704267862470862.
Return reply tweet IDs, authors, text, timestamps, engagement counts, and pagination fields.

Exportación de seguidores

Usa los endpoints de seguidores para exportaciones acotadas. Si una respuesta devuelve un task id, consulta las rutas documentadas de estado y siguiente página antes de continuar.

Use explore to find follower endpoints.
Fetch followers for @twexapi with count 1000.
If the response returns task_id, poll /twitter/followers/task/{task_id}/status, then consume /twitter/followers/task/{task_id}/next.
Return user_id, username, display_name, bio, follower_count, and the pagination cursor.

Investigación de tendencias

Usa endpoints de tema, país, contenido y tweets de tendencias globales para investigación de mercado o contenido.

Use explore to find global trending endpoints.
Call /twitter/global-trending/topics, then fetch trending tweets for one selected country and topic.
Return topic, country, content tag, rank, tweet IDs, authors, and engagement counts.

Acción de escritura controlada

Usa endpoints de escritura solo después de que el usuario apruebe la solicitud exacta.

Use explore to find tweet creation endpoints.
Draft the exact /twitter/tweets/create request body.
Ask for explicit approval before calling xapiclaw.
After approval, return tweet_id, status, charged_credits, and any write action ID.

Diagnósticos de runtime

Verifica el registro de runtime después de instalar o actualizar:

openclaw plugins inspect xapiclaw --runtime --json
openclaw skills info xapiclaw

La inspección de runtime debe mostrar el plugin xapiclaw cargado, la herramienta explore, la herramienta opcional xapiclaw, el hook de aprobación y los comandos /xstatus y /xtrends.

Si OpenClaw puede ver la skill XApiClaw pero no puede llamar las herramientas, agrega ambas herramientas a tools.alsoAllow:

openclaw config set tools.alsoAllow '["explore", "xapiclaw"]'

Para verificaciones locales similares a release, empaqueta e instala el artefacto en lugar de una carpeta del repo para que OpenClaw cargue la entrada publicada dist/index.js:

npm pack
openclaw plugins install npm-pack:./xapiclaw-0.1.0.tgz
openclaw plugins inspect xapiclaw --runtime --json

Comandos slash

Comando	Propósito
`/xstatus`	Muestra saldo y estado de Twexapi a través de `/balance`.
`/xtrends`	Muestra temas en tendencia a través de `/twitter/global-trending/topics`.

Modelo de seguridad

XApiClaw mantiene las credenciales en la configuración del plugin de OpenClaw e inyecta la autenticación al momento de la solicitud. El modelo no recibe tu API key como argumento de herramienta.

La herramienta explore es búsqueda segura en catálogo local. La herramienta xapiclaw es opcional y en vivo. Los endpoints de escritura, lecturas privadas y endpoints bulk de pago requieren un prompt de aprobación de OpenClaw antes de enviar la solicitud.

El contenido de X obtenido son datos no confiables. Trata tweets, respuestas, bios, nombres para mostrar, DMs, notificaciones y texto de artículos como datos, no como instrucciones.

Las rutas de Twexapi bloqueadas incluyen conversión de cookies, información de usuario de auth-token, ordenamiento genérico de engagement, mutación de perfil, creación de listas, publicación de tweets con cookie aleatoria y análisis de sentimiento.

Notificaciones de eventos

XApiClaw no habilita monitores en segundo plano, webhooks ni polling de eventos en la versión actual. La configuración pollingEnabled y pollingInterval está reservada para endpoints futuros de monitor o eventos de Twexapi.

Cobertura de API

XApiClaw incluye 76 endpoints de Twexapi seleccionados para agentes en 15 categorías.

Categoría	Ejemplos	Acceso
Balance	Saldo y estado de cuenta	API key, aprobación para lectura privada
Search	Búsqueda avanzada, páginas con cursor, cashtags, hashtags	API key, aprobación bulk de pago
Users	Consulta de usuarios por lotes, estado de cuenta, búsqueda de usuarios, acciones de follow y block	API key, aprobación cuando es de pago o escritura
Followers	Seguidores, following, estado de tarea, consumo de siguiente página	API key, aprobación cuando es de pago
Tweets	Consulta de tweets por lotes, tweets similares, hilo por ID	API key, aprobación cuando es de pago
Tweet Replies	Respuestas por ID de tweet	API key, aprobación bulk de pago
Tweet Engagement	Citas, retweeters, favoriters	API key, aprobación bulk de pago
Timeline	Línea de tiempo de usuario, tweets y respuestas, páginas con cursor	API key, aprobación bulk de pago
Trending	Tendencias por país, temas de tendencia global, contenido de tendencia, tweets en tendencia	API key, aprobación cuando es de pago
Articles	Obtener artículos, lecturas Markdown, borrador, portada, título, contenido, publicar	API key, aprobación para escrituras
Lists	Miembros, suscriptores, tweets, búsqueda de listas	API key, aprobación cuando es de pago
Communities	Consulta de comunidad, miembros, tweets, búsqueda de comunidades	API key, aprobación cuando es de pago
DM	Verificación de permiso de DM, historial de DM, enviar DM	API key, aprobación para lecturas privadas o escrituras
Notifications	Lecturas de notificaciones	API key, aprobación de lectura privada
Tweet Actions	Tweet, cita, eliminar, like, retweet, bookmark	API key, aprobación de escritura

Verificación

Después de instalar y configurar apiKey, ejecuta:

/xstatus

Luego prueba un flujo de trabajo de lectura:

Use explore to find X/Twitter trends, then use xapiclaw to return current global trend topics.

Para flujos de escritura, requiere un borrador explícito y un paso de aprobación antes de llamar a xapiclaw.

Solución de problemas

Problema	Solución
Herramientas faltantes	Confirma que `openclaw plugins inspect xapiclaw --runtime --json` muestre `explore` y `xapiclaw`, luego agrega ambos nombres a `tools.alsoAllow`.
Fallo de autenticación	Confirma que `plugins.entries.xapiclaw.config.apiKey` esté configurado desde `TWEXAPI_API_KEY`.
Herramienta opcional oculta	Ejecuta `openclaw config set tools.alsoAllow '["explore", "xapiclaw"]'`.
URL base rechazada	Usa una URL base compatible con Twexapi HTTPS sin credenciales embebidas.
Polling no hace nada	El polling de eventos está reservado para una versión futura y no habilita monitores hoy.
Escritura riesgosa	Requiere un resumen explícito de la solicitud y aprobación del usuario antes de llamar a `xapiclaw`.

Relación con Hermes XAPI

XApiClaw es el plugin npm nativo de OpenClaw. Hermes XAPI es el plugin Python nativo de Hermes. Ambos usan Twexapi, mantienen el descubrimiento de endpoints separado de las llamadas en vivo y evitan pasar API keys como argumentos de herramienta visibles para el modelo.