Twitter 帖子

使用 OAuth 1.0a 认证通过官方的 Twitter/X API v2 发布推文。

先决条件

必须设置四个环境变量。从developer.x.com获取它们：

TWITTER_CONSUMER_KEY=<API Key>
TWITTER_CONSUMER_SECRET=<API Key Secret>
TWITTER_ACCESS_TOKEN=<Access Token>
TWITTER_ACCESS_TOKEN_SECRET=<Access Token Secret>

可选：

• HTTPS_PROXY— HTTP 代理 URL（例如http://127.0.0.1:7897），适用于需要代理的地区
• TWITTER_DRY_RUN=1— 仅验证并打印，不实际发布

设置

将凭据存储为环境变量。建议：添加到 OpenClaw 实例配置中或在 shell 配置文件中导出。切勿在 SKILL.md 或脚本中硬编码密钥。

如果用户尚未设置 OAuth，请引导他们：

1. 前往developer.x.com→ 仪表板 → 创建应用
2. 设置应用权限至读取与写入
3. 前往密钥与令牌选项卡
4. 复制API密钥、API密钥密钥
5. 生成访问令牌和访问令牌密钥（确保具备读取+写入权限）
6. 若门户仅显示读取权限，请使用基于PIN码的OAuth流程：
   • 调用POST /oauth/request_token附带参数oauth_callback=oob
   • 用户打开https://api.twitter.com/oauth/authorize?oauth_token=<令牌>
   • 用户提供PIN码
   • 调用POST /oauth/access_token将PIN码作为oauth_verifier

使用方式

所有命令通过exec执行。脚本路径：scripts/tweet.js（相对于此技能目录）。

单条推文

node scripts/tweet.js "Your tweet content here"

回复推文

node scripts/tweet.js --reply-to 1234567890 "Reply text"

引用推文

node scripts/tweet.js --quote 1234567890 "Your commentary"

推文线程（多条推文）

node scripts/tweet.js --thread "First tweet" "Second tweet" "Third tweet"

输出

JSON 输出到标准输出：

{"ok":true,"id":"123456789","url":"https://x.com/i/status/123456789","remaining":"99","limit":"100"}

出错时：{"ok":false,"error":"..."}

字符限制

• 每条推文最多 280 加权字符
• CJK 字符（中文/日文/韩文）按2个字符计算
• URL 按23个字符计算，无论其实际长度如何
• 脚本在发布前会自动验证；若超出限制则拒绝发布

速率限制

• 100 条推文 / 15 分钟每个用户（OAuth 1.0a）
• 3,000 条推文 / 月基础计划（$200/月）
• 检查剩余输出中的字段，用于监控配额

提示

• 对于来自Notion/数据库的内容：先获取文本，然后通过管道传递给tweet.js
• 对于基于cron的自动发布：使用exec并设置环境变量，解析JSON输出来确认成功
• 线程模式按顺序发布推文；每条推文会自动回复前一条
• 结合--thread与--reply-to以在现有推文下附加一个线程