Autonomous social media management for X/Twitter using only OpenClaw native tools. Use when a user wants to automate X posting, generate content, track engag...
---
name: social-media-agent
version: 1.1.0
description: Autonomous social media management for X/Twitter using only OpenClaw native tools. Use when a user wants to automate X posting, generate content, track engagement, or build an audience. Triggers on requests about tweets, social media strategy, X engagement, content calendars, or growing a following. No API keys required โ uses browser automation and web_fetch.
homepage: https://x.com/
tags:
- twitter
- x
- social-media
- automation
- content-calendar
- posting
- engagement
- browser-automation
- audience-growth
- no-api-key
- scheduling
- content-generation
metadata: {"clawdbot":{"emoji":"๐ฆ","category":"social","os":["linux","darwin","win32"]}}
# Social Media Agent
Manage an X/Twitter account autonomously using only OpenClaw's built-in tools. No external APIs, no npm packages, no API keys needed.
## Core Tools
- `browser` โ Post tweets, engage with posts, take screenshots
- `web_fetch` โ Scrape profiles, trending topics, news for content
- `sessions_spawn` โ Run content generation in parallel
- `cron` โ Schedule regular posting and engagement
- `memory_search` / files โ Track what was posted, engagement stats
## Posting a Tweet
1. Ensure Chrome is running with remote debugging OR use OpenClaw's built-in browser
2. Navigate to x.com/compose/post
3. Take a snapshot to find the text input
4. Type the tweet text
5. Click the Post button
6. Verify with another snapshot
```
browser open โ x.com/compose/post
browser snapshot โ find textbox ref
browser act โ click textbox ref
browser act โ type tweet text
browser snapshot โ find Post button ref
browser act โ click Post button
```
**Important timing:** Wait 3-4 seconds after page loads before interacting.
## Content Generation Strategy
### Content Pillars
Rotate through these categories for balanced content:
| Pillar | % | Examples |
|--------|---|---------|
| Industry Insights | 40% | AI news commentary, tech analysis |
| Building in Public | 30% | Progress updates, behind-the-scenes |
| Philosophy/Thought | 20% | Hot takes, provocative questions |
| Engagement/Humor | 10% | Memes, replies, community interaction |
### Content Pipeline
1. **Research:** Use `web_fetch` on news sites (theverge.com, techcrunch.com, news.ycombinator.com)
2. **Generate:** Spawn a content-agent via `sessions_spawn` with research results
3. **Store:** Save drafts in `memory/tweet-drafts-YYYY-MM-DD.json`
4. **Review:** Check drafts for quality, brand consistency
5. **Post:** Use browser automation to publish
6. **Track:** Log posted tweets in `memory/social-log.json`
### Draft Format
```json
{
"text": "Tweet text under 280 chars",
"topic": "What it's about",
"hook": "Why it might engage"
}
```
## Engagement Strategy
### Posting Rules
- **Max 3-5 tweets per day** โ Quality over quantity
- **Min 45 seconds between actions** โ Avoid rate limiting
- **No spam** โ Genuine engagement only
- **Track everything** โ Log all posts and engagement
### Growing Followers
1. Post consistently (daily)
2. Engage with relevant accounts (reply, quote tweet)
3. Use trending topics when relevant
4. Be authentic โ no generic AI responses
## Scheduling with Cron
Set up automated posting schedules:
```
Morning post: cron expr "0 9 * * *" โ Industry insight
Afternoon post: cron expr "0 15 * * *" โ Building update
Evening post: cron expr "0 21 * * *" โ Hot take
```
Use `sessionTarget: "isolated"` with `payload.kind: "agentTurn"` for autonomous posting.
## Anti-Patterns (Avoid)
- Do NOT post more than 5 tweets per day (looks spammy)
- Do NOT use generic engagement ("Great post!" "So true!")
- Do NOT post without reading the content you're commenting on
- Do NOT use API keys when browser automation works
- Do NOT build external tools when OpenClaw native suffices
## Analytics Tracking
Track engagement in `memory/social-log.json`:
```json
{
"date": "2026-02-08",
"posted": 3,
"platform": "x",
"handle": "@YourHandle",
"tweets": [
{"text": "...", "time": "09:00", "topic": "ai-news"}
]
}
```
Review weekly: What topics got most engagement? Adjust strategy accordingly.
## Quick Reference
For detailed content templates and examples, see [references/content-templates.md](references/content-templates.md).
---
## Changelog
### v1.1.0 (2026-04-13)
- Added `tags`, `homepage`, `version`, `metadata` fields
- Improved discoverability on ClawHub
### v1.0.0 (2026-04-11)
- Initial release
don't have the plugin yet? install it then click "run inline in claude" again.