Cookie-based Twitter/X automation toolkit (timeline, notifications, posting, follow ops) for OpenClaw agents.
---
name: twitter-agent-skill
description: "Cookie-based Twitter/X automation toolkit (timeline, notifications, posting, follow ops) for OpenClaw agents."
metadata:
openclaw:
emoji: "🐦"
requires:
bins: ["python", "git"]
---
# twitter-agent-skill
## Summary
Async Twitter/X client and scripts that rely on auth_token + ct0 cookies (no official API keys). Supports:
- Home timeline fetch + summary (`scripts/timeline_summary.py`).
- Notifications fetch + signal analysis (`scripts/fetch_notifications.py`, `scripts/analyze_signal.py`).
- Posting and follow automation via env-driven account labels (`scripts/post_custom_tweet.py`, `scripts/follow_account.py`).
- Full async client (`twitter_api/`) with modules for tweets, users, relationships, DMs, etc.
## Setup
1. `pip install -r requirements.txt` (Python 3.10+).
2. Copy `.env.example` → `.env` and fill cookies per account (auth_token + ct0 from logged-in sessions).
3. Run scripts from repo root, e.g.:
```
python scripts/timeline_summary.py
python scripts/post_custom_tweet.py account_a "hello"
python scripts/follow_account.py thenfter07
```
## Notes
- Env variable names are generic (`ACCOUNT_A_AUTH_TOKEN`, etc.); rename as needed and adjust `ACCOUNT_ENV` dicts in the scripts.
- Respect Twitter/X ToS and do not spam.
- Designed for GanClaw social ops, but neutral enough for other agents to reuse.
don't have the plugin yet? install it then click "run inline in claude" again.