| name | twitter-openclaw |
| description | Interact with Twitter/X — read tweets, search, post, like, retweet, and manage your timeline. |
| user-invocable | true |
| metadata | {"openclaw":{"emoji":"🐦⬛","skillKey":"twitter-openclaw","primaryEnv":"TWITTER_BEARER_TOKEN","requires":{"bins":["twclaw"],"env":["TWITTER_BEARER_TOKEN"]},"install":[{"id":"npm","kind":"node","package":"twclaw","bins":["twclaw"],"label":"Install twclaw (npm)"}]}} |
twitter-openclaw 🐦⬛
Interact with Twitter/X posts, timelines, and users from OpenClaw.
Authentication
Requires a Twitter API Bearer Token set as TWITTER_BEARER_TOKEN.
Optionally set TWITTER_API_KEY and TWITTER_API_SECRET for write operations (post, like, retweet).
Run twclaw auth-check to verify credentials.
Commands
Reading
twclaw read <tweet-url-or-id>
twclaw thread <tweet-url-or-id>
twclaw replies <tweet-url-or-id> -n 20
twclaw user <@handle>
twclaw user-tweets <@handle> -n 20
Timelines
twclaw home -n 20
twclaw mentions -n 10
twclaw likes <@handle> -n 10
Search
twclaw search "query" -n 10
twclaw search "from:elonmusk AI" -n 5
twclaw search "#trending" --recent
twclaw search "query" --popular
Trending
twclaw trending
twclaw trending --woeid 23424977
Posting
twclaw tweet "hello world"
twclaw reply <tweet-url-or-id> "great thread!"
twclaw quote <tweet-url-or-id> "interesting take"
twclaw tweet "look at this" --media image.png
Engagement
twclaw like <tweet-url-or-id>
twclaw unlike <tweet-url-or-id>
twclaw retweet <tweet-url-or-id>
twclaw unretweet <tweet-url-or-id>
twclaw bookmark <tweet-url-or-id>
twclaw unbookmark <tweet-url-or-id>
Following
twclaw follow <@handle>
twclaw unfollow <@handle>
twclaw followers <@handle> -n 20
twclaw following <@handle> -n 20
Lists
twclaw lists
twclaw list-timeline <list-id> -n 20
twclaw list-add <list-id> <@handle>
twclaw list-remove <list-id> <@handle>
Output Options
--json
--plain
--no-color
-n <count>
--cursor <val>
--all
Guidelines for OpenClaw
- When reading tweets, always show: author, handle, text, timestamp, engagement counts.
- For threads, present tweets in chronological order.
- When searching, summarize results concisely with key metrics.
- Before posting/liking/retweeting, confirm the action with the user.
- Rate limits apply — space out bulk operations.
- Use
--json when you need to process output programmatically.
Troubleshooting
401 Unauthorized
Check that TWITTER_BEARER_TOKEN is set and valid.
429 Rate Limited
Wait and retry. Twitter API has strict rate limits per 15-minute window.
TL;DR: Read, search, post, and engage on Twitter/X. Always confirm before write actions.