openclaw-x

# OpenClaw X

Control your X/Twitter account via a local API.

## Prerequisites

1. Download the executable from [GitHub Release](https://github.com/bosshuman/openclaw-x/releases)
2. Export your X cookies from Chrome (using Cookie-Editor extension), save as `cookies.json` in the same directory
3. Run the executable, ensure the service is running at `http://localhost:19816`

## Available Actions

### 1. Get Home Timeline

```bash
curl http://localhost:19816/timeline?count=20
```

Returns the latest tweets including content, author, media URLs, etc.

### 2. Get Tweet Details

```bash
curl http://localhost:19816/tweet/{tweet_id}
```

Supports both tweet ID and full URL (e.g. `https://x.com/user/status/123456`).

### 3. Search Tweets

```bash
curl "http://localhost:19816/search?q=keyword&sort=Latest&count=20"
```

Parameters:
- `q`: Search keyword (required)
- `sort`: `Latest` or `Top`, default Latest
- `count`: Number of results, default 20

### 4. Post a Tweet

```bash
curl -X POST http://localhost:19816/tweet \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello world"}'
```

Reply to a tweet:

```bash
curl -X POST http://localhost:19816/tweet \
  -H "Content-Type: application/json" \
  -d '{"text": "Reply content", "reply_to": "original_tweet_id"}'
```

### 5. Like a Tweet

```bash
curl -X POST http://localhost:19816/tweet/{tweet_id}/like
```

### 6. Retweet

```bash
curl -X POST http://localhost:19816/tweet/{tweet_id}/retweet
```

### 7. Bookmark a Tweet

```bash
curl -X POST http://localhost:19816/tweet/{tweet_id}/bookmark
```

### 8. Get User Info

```bash
curl http://localhost:19816/user/{username}
```

Returns username, avatar, bio, follower count, etc.

### 9. Get User Tweets

```bash
curl http://localhost:19816/user/{username}/tweets?count=20
```

## Common Use Cases

1. "Show me what's new on my timeline"
2. "Search for the latest tweets about AI Agents"
3. "Post a tweet saying: What a beautiful day!"
4. "Like this tweet https://x.com/xxx/status/12...