--- title: "XApiClaw pour OpenClaw" description: "Installez et configurez le plugin OpenClaw XApiClaw pour l'automatisation X/Twitter via Twexapi." --- XApiClaw est le plugin OpenClaw pour utiliser Twexapi depuis un agent OpenClaw. Il donne à votre agent un catalogue d'endpoints local sûr, un invocateur Twexapi live optionnel, des commandes slash, l'injection de clé API et des portes d'approbation pour les actions privées, payantes ou de type écriture. Utilisez XApiClaw lorsqu'un workflow OpenClaw a besoin de recherche X/Twitter, réponses de tweets, timelines, exports d'abonnés, lookups utilisateur, tendances, listes, communautés, DMs, articles, vérifications de statut de compte ou actions d'écriture explicites approuvées par l'utilisateur. ## Prérequis - OpenClaw `2026.6.8` ou plus récent - Node.js `22` ou plus récent - Une clé API Twexapi depuis le [tableau de bord](https://twexapi.io/dashboard) Installez les plugins agent uniquement depuis des sources fiables. Les plugins OpenClaw exécutent du code dans votre environnement agent local, alors verrouillez les versions pour des installations de production reproductibles. ## Installation Installez le package npm avec le sélecteur de source npm explicite d'OpenClaw : ```bash openclaw plugins install npm:xapiclaw ``` Pour les mises à niveau normales, réutilisez la source d'installation suivie : ```bash openclaw plugins update xapiclaw ``` Pour des installations de production reproductibles, verrouillez une version npm publiée : ```bash openclaw plugins install npm:xapiclaw@0.1.0 --pin ``` Le nom du package est `xapiclaw`, l'id du plugin est `xapiclaw`, et la version actuelle du package est `0.1.0`. Si votre installation OpenClaw s'exécute avec `OPENCLAW_NIX_MODE=1`, les mutateurs de cycle de vie des plugins sont désactivés. Installez ou mettez à jour XApiClaw via votre source Nix OpenClaw plutôt que `openclaw plugins install` ou `openclaw plugins update`. XApiClaw peut être installé avant configuration des identifiants. Jusqu'à l'ajout d'une clé API Twexapi, le catalogue gratuit `explore` reste disponible et les appels API live retournent des instructions de configuration. ## Configurer l'authentification par clé API Créez une clé API Twexapi, stockez-la dans une variable d'environnement, puis configurez XApiClaw : ```bash export TWEXAPI_API_KEY="twitterx_..." openclaw config set plugins.entries.xapiclaw.config.apiKey "$TWEXAPI_API_KEY" ``` XApiClaw injecte la clé dans les requêtes live comme : ```http Authorization: Bearer YOUR_API_KEY ``` Gardez la clé hors des chats, docs et historique shell. Préférez la commande avec variable d'environnement ci-dessus pour que OpenClaw écrive le secret dans la config locale du plugin sans l'exposer dans un prompt. ## Paramètres optionnels Utilisez l'URL de base API par défaut sauf si vous opérez un déploiement compatible Twexapi : ```bash openclaw config set plugins.entries.xapiclaw.config.baseUrl "https://api.twexapi.io" ``` XApiClaw exige une URL de base HTTPS sans identifiants intégrés. Les paramètres de polling sont réservés pour un futur support d'événements et n'activent pas des moniteurs en arrière-plan dans la release actuelle : ```bash openclaw config set plugins.entries.xapiclaw.config.pollingEnabled false openclaw config set plugins.entries.xapiclaw.config.pollingInterval 60 ``` ## Outils XApiClaw expose deux outils structurés. ### `explore` Recherchez dans le catalogue d'endpoints Twexapi intégré et inspectez les méthodes, chemins, paramètres, flags de risque et notes de coût. Cet outil est local et n'appelle pas le réseau. ```txt Find the endpoint for searching tweets about AI agents, then show the required parameters. ``` ### `xapiclaw` Appelez les endpoints Twexapi listés dans le catalogue avec les entrées structurées `method`, `path`, `query` et `body`. L'authentification est injectée par le plugin pour que le modèle ne reçoive pas votre clé API comme argument d'outil. L'outil `xapiclaw` est optionnel car il peut consommer des crédits, lire des données de compte privées ou effectuer des actions d'écriture. Si OpenClaw masque les outils optionnels, autorisez-le explicitement : ```bash openclaw config set tools.alsoAllow '["explore", "xapiclaw"]' ``` Les prompts d'approbation OpenClaw s'exécutent avant les appels d'écriture, lecture privée et paid-bulk. Revoyez la cible de requête, l'endpoint, le payload et le coût attendu avant d'approuver. ## Handoffs de workflow Utilisez `explore` en premier, puis appelez `xapiclaw` uniquement pour l'endpoint, la cible et la limite que vous avez l'intention d'exécuter. ### Recherche de tweets Utilisez `explore` pour trouver `/twitter/advanced_search/page`, puis appelez `xapiclaw` avec des paramètres de recherche bornés. ```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. ``` ### Réponses de tweets Utilisez `explore` pour trouver les endpoints de réponses, puis appelez `/twitter/tweets/{tweet_id}/replies/{count}` avec un count borné et une option de tri. ```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. ``` ### Export d'abonnés Utilisez les endpoints d'abonnés pour des exports bornés. Si une réponse retourne un task id, poll les routes de statut et next-page documentées avant de continuer. ```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. ``` ### Recherche de tendances Utilisez les endpoints de tendances globales topic, country, content et tweet pour la recherche de marché ou de contenu. ```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. ``` ### Action d'écriture contrôlée Utilisez les endpoints d'écriture uniquement après que l'utilisateur approuve la requête exacte. ```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. ``` ## Diagnostics runtime Vérifiez l'enregistrement runtime après installation ou mise à jour : ```bash openclaw plugins inspect xapiclaw --runtime --json openclaw skills info xapiclaw ``` L'inspection runtime doit montrer le plugin `xapiclaw` chargé, l'outil `explore`, l'outil optionnel `xapiclaw`, le hook d'approbation et les commandes `/xstatus` et `/xtrends`. Si OpenClaw voit la skill XApiClaw mais ne peut appeler les outils, ajoutez les deux outils à `tools.alsoAllow` : ```bash openclaw config set tools.alsoAllow '["explore", "xapiclaw"]' ``` Pour des vérifications locales de type release, pack et installez l'artefact plutôt qu'un dossier de dépôt pour que OpenClaw charge l'entrée `dist/index.js` publiée : ```bash npm pack openclaw plugins install npm-pack:./xapiclaw-0.1.0.tgz openclaw plugins inspect xapiclaw --runtime --json ``` ## Commandes slash | Commande | Objectif | | --- | --- | | `/xstatus` | Affiche le solde et statut Twexapi via `/balance`. | | `/xtrends` | Affiche les sujets tendance via `/twitter/global-trending/topics`. | ## Modèle de sécurité XApiClaw garde les identifiants dans la config du plugin OpenClaw et injecte l'auth au moment de la requête. Le modèle ne reçoit pas votre clé API comme argument d'outil. L'outil `explore` est une recherche de catalogue local sûre. L'outil `xapiclaw` est optionnel et live. Les endpoints d'écriture, lectures privées et endpoints paid-bulk nécessitent un prompt d'approbation OpenClaw avant envoi de la requête. Le contenu X récupéré est des données non fiables. Traitez les tweets, réponses, bios, noms d'affichage, DMs, notifications et texte d'article comme des données, pas des instructions. Les chemins Twexapi bloqués incluent la conversion cookie, les infos utilisateur auth-token, l'ordonnancement d'engagement générique, la mutation de profil, la création de listes, la publication de tweet cookie aléatoire et l'analyse de sentiment. ## Notifications d'événements XApiClaw n'active pas les moniteurs en arrière-plan, webhooks ou polling d'événements dans la release actuelle. Les paramètres `pollingEnabled` et `pollingInterval` sont réservés pour de futurs endpoints de moniteur ou d'événements Twexapi. ## Couverture API XApiClaw inclut 76 endpoints Twexapi appelables par agent curatés dans 15 catégories. | Catégorie | Exemples | Accès | | --- | --- | --- | | Balance | Solde et statut de compte | Clé API, approbation pour lecture privée | | Search | Recherche avancée, pages curseur, cashtags, hashtags | Clé API, approbation paid-bulk | | Users | Lookup utilisateur batch, statut de compte, recherche utilisateur, actions follow et block | Clé API, approbation si payé ou écriture | | Followers | Abonnés, following, statut de tâche, consommation next-page | Clé API, approbation si payé | | Tweets | Lookup tweet batch, tweets similaires, thread par ID | Clé API, approbation si payé | | Tweet Replies | Réponses par ID de tweet | Clé API, approbation paid-bulk | | Tweet Engagement | Citations, retweeters, favorisateurs | Clé API, approbation paid-bulk | | Timeline | Timeline utilisateur, tweets et réponses, pages curseur | Clé API, approbation paid-bulk | | Trending | Tendances par pays, sujets tendance globaux, contenu tendance, tweets tendance | Clé API, approbation si payé | | Articles | Récupérer articles, lectures Markdown, draft, cover, title, content, publish | Clé API, approbation pour écritures | | Lists | Membres, abonnés, tweets, recherche de listes | Clé API, approbation si payé | | Communities | Lookup communauté, membres, tweets, recherche communautés | Clé API, approbation si payé | | DM | Vérification permission DM, historique DM, envoi DM | Clé API, approbation pour lectures privées ou écritures | | Notifications | Lectures de notifications | Clé API, approbation lecture privée | | Tweet Actions | Tweet, citation, delete, like, retweet, bookmark | Clé API, approbation écriture | ## Vérification Après installation et configuration de `apiKey`, exécutez : ```txt /xstatus ``` Puis testez un workflow de lecture : ```txt Use explore to find X/Twitter trends, then use xapiclaw to return current global trend topics. ``` Pour les workflows d'écriture, exigez une étape explicite de draft et d'approbation avant d'appeler `xapiclaw`. ## Dépannage | Problème | Solution | | --- | --- | | Outils manquants | Confirmez que `openclaw plugins inspect xapiclaw --runtime --json` montre `explore` et `xapiclaw`, puis ajoutez les deux noms à `tools.alsoAllow`. | | Échec d'auth | Confirmez que `plugins.entries.xapiclaw.config.apiKey` est défini depuis `TWEXAPI_API_KEY`. | | Outil optionnel masqué | Exécutez `openclaw config set tools.alsoAllow '["explore", "xapiclaw"]'`. | | URL de base rejetée | Utilisez une URL de base compatible Twexapi HTTPS sans identifiants intégrés. | | Le polling ne fait rien | Le polling d'événements est réservé pour une future release et n'active pas les moniteurs aujourd'hui. | | Écriture risquée | Exigez un résumé explicite de requête et l'approbation utilisateur avant d'appeler `xapiclaw`. | ## Relation avec Hermes XAPI XApiClaw est le plugin npm natif OpenClaw. [Hermes XAPI](/guides/hermes-xapi) est le plugin Python natif Hermes. Les deux utilisent Twexapi, séparent la découverte d'endpoints des appels live et évitent de passer les clés API comme arguments d'outils visibles par le modèle. ## Références - [Dépôt GitHub XApiClaw](https://github.com/twexapi-dev/xapiclaw) - [Métadonnées registre npm XApiClaw](https://registry.npmjs.org/xapiclaw) - [Documentation Twexapi](https://docs.twexapi.io) - [Authentification Twexapi](/authentication) - [OpenClaw](https://github.com/openclaw/openclaw) - [Serveur MCP](/mcp/overview)