名称： twitter-openclaw
描述： 与 Twitter/X 交互——读取推文、搜索、发帖、点赞、转发并管理时间线。
user-invocable: true
元数据： {"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":"安装 twclaw (npm)"}]}}

twitter-openclaw 🐦‍⬛

通过 OpenClaw 与 Twitter/X 的帖子、时间线和用户进行交互。

认证

需要将 Twitter API Bearer Token 设置为 TWITTER_BEARER_TOKEN。

如需进行写操作（发帖、点赞、转发），可选择性设置 TWITTER_API_KEY 和 TWITTER_API_SECRET。

运行 twclaw auth-check 以验证凭据。

命令

读取

twclaw read <推文链接或ID>          # 读取单条推文及其完整元数据
twclaw thread <推文链接或ID>        # 读取完整的对话线程
twclaw replies <推文链接或ID> -n 20 # 列出对某条推文的回复
twclaw user <@用户名>               # 显示用户资料信息
twclaw user-tweets <@用户名> -n 20  # 用户最近的推文

时间线

twclaw home -n 20                   # 首页时间线
twclaw mentions -n 10               # 你的提及
twclaw likes <@用户名> -n 10        # 用户点赞的推文

搜索

twclaw search "查询词" -n 10         # 搜索推文
twclaw search "from:elonmusk AI" -n 5 # 使用运算符搜索
twclaw search "#热门话题" --recent   # 仅显示近期推文
twclaw search "查询词" --popular     # 仅显示热门推文

趋势

twclaw trending                     # 全球趋势话题
twclaw trending --woeid 23424977    # 特定地区的趋势

发帖

twclaw tweet "你好世界"                           # 发布一条推文
twclaw reply <推文链接或ID> "好帖！"              # 回复一条推文
twclaw quote <推文链接或ID> "有意思的观点"        # 引用推文
twclaw tweet "看看这个" --media 图片.png          # 带媒体的推文

互动

twclaw like <推文链接或ID>          # 点赞一条推文
twclaw unlike <推文链接或ID>        # 取消点赞
twclaw retweet <推文链接或ID>       # 转发
twclaw unretweet <推文链接或ID>     # 取消转发
twclaw bookmark <推文链接或ID>      # 收藏一条推文
twclaw unbookmark <推文链接或ID>    # 取消收藏

关注

twclaw follow <@用户名>             # 关注用户
twclaw unfollow <@用户名>           # 取消关注用户
twclaw followers <@用户名> -n 20    # 列出粉丝
twclaw following <@用户名> -n 20    # 列出正在关注的人

列表

twclaw lists                           # 你的列表
twclaw list-timeline <列表ID> -n 20    # 列表中的推文
twclaw list-add <列表ID> <@用户名>     # 将用户添加到列表
twclaw list-remove <列表ID> <@用户名>  # 从列表中移除用户

输出选项

--json          # JSON 格式输出
--plain         # 纯文本，无格式
--no-color      # 禁用 ANSI 颜色
-n <数量>       # 结果数量（默认：10）
--cursor <值>   # 用于翻页的分页游标
--all           # 获取所有页面（谨慎使用）

OpenClaw 使用指南

• 读取推文时，始终显示：作者、用户名、正文、时间戳、互动数据。
• 对于线程，按时间顺序呈现推文。
• 搜索时，用关键指标简洁地总结结果。
• 在执行发帖/点赞/转发等操作前，请与用户确认。
• 存在速率限制——请分散批量操作。
• 需要程序化处理输出时，使用 --json 选项。

故障排除

401 未授权

检查 TWITTER_BEARER_TOKEN 是否已设置且有效。

429 超出速率限制

等待后重试。Twitter API 在每 15 分钟窗口内有严格的速率限制。

总结：在 Twitter/X 上读取、搜索、发帖和互动。执行写操作前务必确认。