--- title: "XApiClaw para OpenClaw" description: "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](https://twexapi.io/dashboard) 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: ```bash openclaw plugins install npm:xapiclaw ``` Para actualizaciones normales, reutiliza la fuente de instalación rastreada: ```bash openclaw plugins update xapiclaw ``` Para instalaciones de producción reproducibles, fija una versión publicada en npm: ```bash 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: ```bash 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: ```http 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: ```bash 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: ```bash 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. ```txt 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: ```bash 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. ```txt 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. ```txt 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. ```txt 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. ```txt 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. ```txt 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: ```bash 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`: ```bash 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`: ```bash 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: ```txt /xstatus ``` Luego prueba un flujo de trabajo de lectura: ```txt 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](/guides/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. ## Referencias - [Repositorio GitHub de XApiClaw](https://github.com/twexapi-dev/xapiclaw) - [Metadatos del registro npm de XApiClaw](https://registry.npmjs.org/xapiclaw) - [Documentación de Twexapi](https://docs.twexapi.io) - [Autenticación de Twexapi](/authentication) - [OpenClaw](https://github.com/openclaw/openclaw) - [MCP Server](/mcp/overview)