# Openclaw X

> 操控你的 X/Twitter 账号——查看时间线、搜索推文、发推、点赞、转推、收藏。

- Skill: `bosshuman/openclaw-x` (Agent Skill, multi-file: 11 files)
- Install (CLI): `npx skillmds@latest add bosshuman/openclaw-x`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bosshuman/openclaw-x/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: bosshuman (https://skillmd.com/u/bosshuman)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/bosshuman/openclaw-x

---


# OpenClaw X

通过本地 API 操控你的 X/Twitter 账号。

## 前置要求

1. 从 [GitHub Release](https://github.com/bosshuman/openclaw-x/releases) 下载对应平台的可执行文件
2. 从 Chrome 导出 X 的 cookies（使用 Cookie-Editor 扩展），保存为 `cookies.json` 放在可执行文件同目录
3. 运行可执行文件，确保服务已启动：`http://localhost:19816`

## 可用操作

### 1. 获取首页时间线

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

返回最新的推文列表，包含内容、作者、媒体 URL 等。

### 2. 获取推文详情

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

支持传入推文 ID 或完整 URL（如 `https://x.com/user/status/123456`）。

### 3. 搜索推文

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

参数：
- `q`：搜索关键词（必填）
- `sort`：`Latest`（最新）或 `Top`（热门），默认 Latest
- `count`：结果数量，默认 20

### 4. 发推文

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

回复推文：

```bash
curl -X POST http://localhost:19816/tweet \
  -H "Content-Type: application/json" \
  -d '{"text": "回复内容", "reply_to": "原推文ID"}'
```

### 5. 点赞推文

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

### 6. 转推

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

### 7. 收藏推文

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

### 8. 获取用户信息

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

返回用户名、头像、简介、粉丝数等。

### 9. 获取用户推文

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

## 常见使用场景

1. "帮我看看我的时间线有什么新推"
2. "搜索关于 AI Agent 的最新推文"
3. "发一条推文说：今天天气真好"
4. "帮我点赞这条推文 https://x.com/xxx/status/123"
5. "看看 @elonmusk 最近发了什么"
6. "帮我收藏这条推文"