Twitter 自动驾驶

面向在 OpenClaw 上运行的 AI Agent 的端到端 Twitter/X 自动化方案。

要求与范围

凭证（全部设为环境变量）

依赖项

• tweepy（通过 pip 安装）

读写文件列表

功能范围

• ⚠️ 向 Twitter/X 发布推文（公开、真实世界影响）
• 读写本地草稿与日志文件
• 可通过 cron 自主运行（通过检查 MODE.md 控制行为）

配置步骤

1. 获取 API 密钥

1. 访问 developer.x.com → 创建 Project 与 App
2. 将 App 权限设置为 Read and Write
3. 生成以下密钥：API Key、API Secret、Access Token、Access Token Secret
4. 生成 Bearer Token：curl -u "API_KEY:API_SECRET" -d "grant_type=client_credentials" "https://api.twitter.com/oauth2/token"

2. 设置环境变量

TWITTER_API_KEY=your_api_key
TWITTER_API_SECRET=your_api_secret
TWITTER_ACCESS_TOKEN=your_access_token
TWITTER_ACCESS_SECRET=your_access_token_secret
TWITTER_BEARER_TOKEN=your_bearer_token

3. 安装依赖项

pip install tweepy

使用方法

所有命令均通过 scripts/tweet.py 执行：

# 发布推文（若超过 280 字符则自动拆分为 Thread）
python tweet.py post "your tweet text here"

# 回复某条推文
python tweet.py reply TWEET_ID "your reply"

# 引用转发（Quote Tweet）
python tweet.py quote TWEET_ID "your take"

# 转发（Retweet）
python tweet.py retweet TWEET_ID

# 删除推文
python tweet.py delete TWEET_ID

# 关注 / 取消关注
python tweet.py follow @username
python tweet.py unfollow @username

# 检查提及（@mentions）
python tweet.py mentions

# 查看账号统计信息
python tweet.py me

长推文 → 自动拆分为 Thread

免费 API 套餐限制单条推文最多 280 字符。post 命令会在文本超过 280 字符时，按句子边界自动将其拆分为 Thread。

如需手动构造 Thread，可在 Python 中调用 thread 函数：

from tweet import thread
thread(["Tweet 1", "Tweet 2", "Tweet 3"])

草稿工作流

适用于需人工审核后才发布推文的 Agent：

1. 创建 twitter/MODE.md 文件，内容为 DRAFT 或 AUTO
2. 创建 twitter/drafts/pending.md 文件，用于暂存待审草稿
3. 在 cron 任务中，先检查 MODE.md 再决定后续动作：
   • DRAFT → 将推文追加至 pending.md 并通知人工审核
   • AUTO → 直接发布，并将日志写入 twitter/logs/

注意事项

• 免费套餐限制：单条推文最多 280 字符；发布频次受限（约 50 条/天写入，读取操作亦有配额限制）
• 关注/读取返回 401 错误：必须提供 Bearer Token（OAuth 2.0），仅 OAuth 1.0a 密钥不足以支持这些操作
• 长推文返回 403 错误：免费套餐拒绝超过 280 字符的推文 —— 请使用自动 Thread 功能
• Shell 参数转义问题：避免通过 Shell 参数传递含引号等特殊字符的推文内容；复杂文本建议直接调用 Python 接口
• 频次限制：批量操作（如批量关注、Thread 发布）之间应加入 time.sleep(1) 避免触发限流

内容策略

详见 references/content-strategy.md 中完整的推文写作手册：

• X 算法解析（互动优先级、高峰时段、停留时长）
• 6 种开头钩子公式及示例（加粗强调、具体结果导向、悬念缺口、故事引入、模式打断、提问引导）
• 6 类推文格式（清单体、反共识观点、前后对比、方法框架、普适体验、填空式）
• 文案写作框架（PAS、BAB、AIDA）
• Thread 结构模板（7–8 条为黄金长度）
• 增长策略（30 天子主题计划、回复策略、80/20 原则）
• 面向 AI Agent 的专项提示

详见 references/strategy-templates.md 中的内容支柱定义、互动策略手册与 cron 调度模板。

实战经验总结（来自真实运行）

1. 发布「构建成果」的 AI 账号更易涨粉；仅分享「思考过程」的账号难以获得关注。
2. 主动与 AI Agent 社区互动——他们会回关并参与讨论。
3. 早期高发布频率至关重要（每日 5–10+ 条，含回复）。
4. 自嘲式幽默效果优于励志语录。
5. 新账号务必启用草稿模式（DRAFT）——一条不当推文可能严重损害信任度。
6. 发布前务必检查 twitter/posted-log.md —— cron 任务可能因语义相似重复发布同一主题内容。比对核心观点，而非仅匹配字面文本。
7. 在推文中直接提人类协作者的真实姓名（例如 “Alex”），而非笼统称 “my human”，更具人情味与可信度。
8. 每条已发布推文都必须完整记录至 twitter/posted-log.md，包含全文、ID、日期与来源。