Twitter
Runtime-focused skill package for Twitter/X search and posting through the AISA relay.
When to use
- The user wants to read profiles, timelines, mentions, followers, tweet search results, trends, lists, communities, or Spaces.
- The user wants to draft or publish posts after completing OAuth without sharing passwords.
- The task needs a Python client for repeatable Twitter/X automation backed by
AISA_API_KEY.
When NOT to use
- The user needs cookie extraction, browser credential scraping, or direct password login.
- The workflow must avoid sending requests, OAuth state, or approved media through
api.aisa.one.
- The request is for likes, follows, or other engagement actions not covered by this package.
Quick Reference
- Required env:
AISA_API_KEY
- Read client:
./scripts/twitter_client.py
- Post workflow guide:
./references/post_twitter.md
Setup
export AISA_API_KEY="your-key"
All network calls go to https://api.aisa.one/apis/v1/....
Capabilities
- Read user data, timelines, mentions, followers, followings, verified followers, and follow relationships.
- Search tweets and users, inspect replies, quotes, retweeters, thread context, and Spaces.
- Publish text, image, and video posts after explicit OAuth approval.
- Split long posts into threaded chunks when the publish script needs it.
Common Commands
python3 scripts/twitter_client.py user-info --username elonmusk
python3 scripts/twitter_client.py search --query "AI agents" --type Latest
python3 scripts/twitter_client.py trends --woeid 1
python3 scripts/twitter_oauth_client.py status
python3 scripts/twitter_oauth_client.py authorize
python3 scripts/twitter_oauth_client.py post --text "Hello from AIsa"
Posting Workflow
When the user asks to send, publish, reply, or quote on X/Twitter, follow ./references/post_twitter.md.
- Return the authorization link first when posting is not yet approved.
- Use
--media-file only for user-provided workspace files.
- Do not invent captions, remote URLs, or extra media attachments.
Runtime Boundary
- The package is relay-based: read calls, OAuth requests, and approved media uploads go to
api.aisa.one.
- The package is API-key-first: it requires
AISA_API_KEY and does not ask for passwords, cookies, CT0, or other legacy secrets.
- The package does not include cache sync, self-install logic, home-directory persistence, browser-cookie extraction, or external agent CLI wrappers.
- Browser opening is optional and not the default workflow; returning the authorization link is the preferred path for this release.
1---2name: openclaw-twitter-33description: Search X/Twitter profiles, tweets, trends, lists, communities, and Spaces through the AISA relay, then publish approved posts with OAuth. Use when: the user asks for Twitter/X research, monitoring, or posting without sharing passwords. Supports read APIs, authorization links, and media-aware posting.4---56# Twitter78Runtime-focused skill package for Twitter/X search and posting through the AISA relay.910## When to use1112- The user wants to read profiles, timelines, mentions, followers, tweet search results, trends, lists, communities, or Spaces.13- The user wants to draft or publish posts after completing OAuth without sharing passwords.14- The task needs a Python client for repeatable Twitter/X automation backed by `AISA_API_KEY`.1516## When NOT to use1718- The user needs cookie extraction, browser credential scraping, or direct password login.19- The workflow must avoid sending requests, OAuth state, or approved media through `api.aisa.one`.20- The request is for likes, follows, or other engagement actions not covered by this package.2122## Quick Reference2324- Required env: `AISA_API_KEY`25- Read client: `./scripts/twitter_client.py`26- Post workflow guide: `./references/post_twitter.md`2728## Setup2930```bash31export AISA_API_KEY="your-key"32```3334All network calls go to `https://api.aisa.one/apis/v1/...`.3536## Capabilities3738- Read user data, timelines, mentions, followers, followings, verified followers, and follow relationships.39- Search tweets and users, inspect replies, quotes, retweeters, thread context, and Spaces.40- Publish text, image, and video posts after explicit OAuth approval.41- Split long posts into threaded chunks when the publish script needs it.4243## Common Commands4445```bash46python3 scripts/twitter_client.py user-info --username elonmusk47python3 scripts/twitter_client.py search --query "AI agents" --type Latest48python3 scripts/twitter_client.py trends --woeid 149python3 scripts/twitter_oauth_client.py status50python3 scripts/twitter_oauth_client.py authorize51python3 scripts/twitter_oauth_client.py post --text "Hello from AIsa"52```5354## Posting Workflow5556When the user asks to send, publish, reply, or quote on X/Twitter, follow `./references/post_twitter.md`.5758- Return the authorization link first when posting is not yet approved.59- Use `--media-file` only for user-provided workspace files.60- Do not invent captions, remote URLs, or extra media attachments.6162## Runtime Boundary6364- The package is relay-based: read calls, OAuth requests, and approved media uploads go to `api.aisa.one`.65- The package is API-key-first: it requires `AISA_API_KEY` and does not ask for passwords, cookies, `CT0`, or other legacy secrets.66- The package does not include cache sync, self-install logic, home-directory persistence, browser-cookie extraction, or external agent CLI wrappers.67- Browser opening is optional and not the default workflow; returning the authorization link is the preferred path for this release.
baofeng-tech