OpenClaw X

通过本地API控制您的X/Twitter账户。

前提条件

1. 1. 从 GitHub Release 下载可执行文件
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=keyword&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: Hello world}

回复推文：

bash
curl -X POST http://localhost:19816/tweet \
-H Content-Type: application/json \
-d {text: Reply content, replyto: originaltweet_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. 1. 显示我时间线上的最新内容
2. 搜索关于AI Agents的最新推文
3. 发布一条推文说：多么美好的一天！
4. 点赞这条推文 https://x.com/xxx/status/123
5. 查看 @elonmusk 发布了什么
6. 收藏这条推文