bosshuman/openclaw-x

OpenClaw X

Controla tu cuenta de X/Twitter mediante una API local.

Requisitos previos

1. Descarga el ejecutable correspondiente a tu plataforma desde GitHub Release
2. Exporta las cookies de X desde Chrome (usando la extensión Cookie-Editor) y guárdalas como cookies.json en el mismo directorio del ejecutable
3. Ejecuta el binario y asegúrate de que el servicio esté iniciado: http://localhost:19816

Operaciones disponibles

1. Obtener la cronología de inicio

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

Devuelve la lista de tweets más recientes, incluyendo contenido, autor, URL de medios, etc.

2. Obtener detalles de un tweet

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

Acepta el ID del tweet o la URL completa (por ejemplo, https://x.com/user/status/123456).

3. Buscar tweets

curl "http://localhost:19816/search?q=palabra_clave&sort=Latest&count=20"

Parámetros:

• q: palabra clave de búsqueda (obligatorio)
• sort: Latest (más recientes) o Top (populares), por defecto Latest
• count: número de resultados, por defecto 20

4. Publicar un tweet

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

Responder a un tweet:

curl -X POST http://localhost:19816/tweet \
  -H "Content-Type: application/json" \
  -d '{"text": "Contenido de la respuesta", "reply_to": "ID_del_tweet_original"}'

5. Dar like a un tweet

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

6. Retuitear

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

7. Guardar un tweet en favoritos

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

8. Obtener información de un usuario

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

Devuelve nombre de usuario, avatar, biografía, número de seguidores, etc.

9. Obtener tweets de un usuario

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

Escenarios de uso comunes

1. "Mira qué hay de nuevo en mi cronología"
2. "Busca los tweets más recientes sobre AI Agent"
3. "Publica un tweet que diga: Hoy hace buen tiempo"
4. "Dale like a este tweet https://x.com/xxx/status/123"
5. "Mira qué ha publicado @elonmusk últimamente"
6. "Guarda este tweet en favoritos"