🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί twitter-aisa
πŸ¦€ ClawHub

twitter-aisa

by @bibaofeng

Twitter/X command center for research, monitoring, watchlists, and approved posting through AIsa. Use when: the user needs one flagship skill for trend track...

Versionv1.0.5
Downloads580
#requires-oauth-token#requires-sensitive-credentials#posts-externally#clawhub
TERMINAL
clawhub install twitter-aisa

πŸ“– About This Skill

name: openclaw-twitter description: 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. homepage: https://openclaw.ai author: 0xjordansg-yolo user-invocable: true requires: bins: - python3 env: - AISA_API_KEY metadata: openclaw: emoji: "🐦" requires: bins: - python3 env: - AISA_API_KEY primaryEnv: AISA_API_KEY files: - "scripts/*" - "references/*"

OpenClaw Twitter

Runtime-focused release bundle 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 {baseDir}/scripts/twitter_client.py user-info --username elonmusk
python3 {baseDir}/scripts/twitter_client.py search --query "AI agents" --type Latest
python3 {baseDir}/scripts/twitter_client.py trends --woeid 1
python3 {baseDir}/scripts/twitter_oauth_client.py status
python3 {baseDir}/scripts/twitter_oauth_client.py authorize
python3 {baseDir}/scripts/twitter_oauth_client.py post --text "Hello from OpenClaw"

    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.

    • ClawHub Suspicious Review Notes

    These points summarize the common reasons similar skills are marked Suspicious and how this release addresses them:

  • 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 release bundle is runtime-only: it keeps SKILL.md, scripts/, and the posting reference, while omitting non-runtime files such as README.md and _meta.json.
  • 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 OpenClaw.

    • Release Bundle Notes

  • scripts/twitter_client.py preserves the read API surface from the original bundle.
  • scripts/twitter_oauth_client.py preserves OAuth and posting behavior from the original bundle.
  • This package is optimized for publication metadata and upload safety, not for changing runtime logic.

    • ⚑ When to Use

    TriggerAction
    - 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`.

    βš™οΈ Configuration

    export AISA_API_KEY="your-key"

    All network calls go to https://api.aisa.one/apis/v1/....