bosshuman/openclaw-x

OpenClaw X

Contrôlez votre compte X/Twitter via une API locale.

Prérequis

1. Téléchargez l’exécutable correspondant à votre plateforme depuis GitHub Release
2. Exportez les cookies de X depuis Chrome (à l’aide de l’extension Cookie-Editor), enregistrez-les sous cookies.json dans le même répertoire que l’exécutable
3. Lancez l’exécutable et assurez-vous que le service est opérationnel : http://localhost:19816

Actions disponibles

1. Obtenir le fil d’actualité

curl http://localhost:19816/timeline?count=20

Retourne la liste des tweets les plus récents, avec le contenu, l’auteur, les URLs des médias, etc.

2. Obtenir les détails d’un tweet

curl http://localhost:19816/tweet/{tweet_id}

Accepte l’ID du tweet ou une URL complète (ex. https://x.com/user/status/123456).

3. Rechercher des tweets

curl "http://localhost:19816/search?q=mot-clé&sort=Latest&count=20"

Paramètres :

• q : mot-clé de recherche (obligatoire)
• sort : Latest (plus récents) ou Top (tendances), par défaut Latest
• count : nombre de résultats, par défaut 20

4. Publier un tweet

curl -X POST http://localhost:19816/tweet \
  -H "Content-Type: application/json" \
  -d '{"text": "Bonjour le monde"}'

Répondre à un tweet :

curl -X POST http://localhost:19816/tweet \
  -H "Content-Type: application/json" \
  -d '{"text": "Contenu de la réponse", "reply_to": "ID_du_tweet_original"}'

5. Liker un tweet

curl -X POST http://localhost:19816/tweet/{tweet_id}/like

6. Retweeter un tweet

curl -X POST http://localhost:19816/tweet/{tweet_id}/retweet

7. Mettre un tweet en favori

curl -X POST http://localhost:19816/tweet/{tweet_id}/bookmark

8. Obtenir les informations d’un utilisateur

curl http://localhost:19816/user/{nom_utilisateur}

Retourne le nom d’utilisateur, l’avatar, la bio, le nombre d’abonnés, etc.

9. Obtenir les tweets d’un utilisateur

curl http://localhost:19816/user/{nom_utilisateur}/tweets?count=20

Scénarios d’usage courants

1. « Montre-moi mon fil d’actualité avec les nouveaux tweets. »
2. « Recherche les tweets récents sur les agents IA. »
3. « Publie un tweet : Quel beau temps aujourd’hui ! »
4. « Like ce tweet : https://x.com/xxx/status/123 »
5. « Regarde ce que @elonmusk a posté récemment. »
6. « Mets ce tweet en favori. »