X（Twitter）个人分析

监控您的 X 账号——帖子、互动、提及、关注者。阅读任意推文。专为每日简报和自我监督设计。

触发条件

当用户提出以下问题时使用此技能：

• 他们的 X / Twitter 帖子、时间线或互动情况
• 提及、回复，以及在 X 上谈论他们的人
• 关注者数量、个人资料统计数据、关注者增长情况
• “我的 X 上发生了什么？” / “我的帖子表现如何？”
• “检查我的 Twitter 提及” / “有新的回复吗？”
• 早晨简报 / 每日社交媒体摘要
• “我在 X 上待得太久了吗？” / 自我监督检查
• 阅读特定推文或话题线（用户发送推文链接）
• “@someone 说了什么？” / 阅读他人推文
• 收藏或保存推文以备后用
• X/Twitter 分析或表现数据

前置要求

请先运行设置流程（从 ~/.openclaw/.env 导入凭证，或交互式提示输入）：

uv run scripts/x_setup.py

命令

简报 — 综合早晨摘要

# 完整简报：你的帖子 + 提及 + 个人资料（最近 24 小时，约 $0.02）
uv run scripts/x_briefing.py

# 自定义回顾周期
uv run scripts/x_briefing.py --hours 48

# 预览费用
uv run scripts/x_briefing.py --dry-run

时间线 — 你的帖子与互动数据

# 最近的帖子及互动指标
uv run scripts/x_timeline.py recent

# 最近 5 条帖子
uv run scripts/x_timeline.py recent --max 5

# 最近 24 小时内的帖子
uv run scripts/x_timeline.py recent --hours 24

# 按互动量排序的热门帖子（来自本地存储，不调用 API）
uv run scripts/x_timeline.py top --days 7

# 刷新某条推文的指标
uv run scripts/x_timeline.py refresh TWEET_ID

# 自我监督检查 — 当前是否正在使用 X？
uv run scripts/x_timeline.py activity

提及 — 谁在提及你或与你互动

# 最近的提及
uv run scripts/x_mentions.py recent

# 最近 24 小时内的提及
uv run scripts/x_mentions.py recent --hours 24

# 带上下文的提及（显示对方回复的内容 — 费用更高）
uv run scripts/x_mentions.py recent --context

阅读 — 获取任意推文或话题线

# 通过链接阅读推文
uv run scripts/x_read.py https://x.com/user/status/123456

# 通过纯 ID 阅读
uv run scripts/x_read.py 123456

# 获取完整话题线
uv run scripts/x_read.py 123456 --thread

# 预览费用
uv run scripts/x_read.py --dry-run https://x.com/user/status/123456

收藏 — 保存与管理

# 列出你的收藏
uv run scripts/x_bookmarks.py list

# 收藏一条帖子
uv run scripts/x_bookmarks.py add TWEET_ID

# 移除收藏
uv run scripts/x_bookmarks.py remove TWEET_ID

用户资料 — 统计数据与关注者追踪

# 你的个人资料统计数据
uv run scripts/x_user.py me

# 跟踪关注者变化趋势
uv run scripts/x_user.py me --track

# 查找其他用户
uv run scripts/x_user.py lookup someuser

设置与支出

# 验证凭证
uv run scripts/x_setup.py --check

# 显示配置（敏感信息已隐藏）
uv run scripts/x_setup.py --show

# 每周支出摘要
uv run scripts/x_setup.py --spend-report

# 30 天支出报告
uv run scripts/x_setup.py --spend-report --days 30

# 设置预算模式
uv run scripts/x_setup.py --budget-mode relaxed

# 打印版本号
uv run scripts/x_setup.py --version

成本控制标志（所有脚本通用）

# 预览费用但不执行 API 调用
uv run scripts/x_timeline.py --dry-run recent

# 覆盖预算限制
uv run scripts/x_timeline.py --force recent

# 跳过所有预算检查和警告
uv run scripts/x_timeline.py --no-budget recent

工作流

早晨简报

uv run scripts/x_briefing.py

一条命令即可替代分别运行时间线、提及和用户信息。费用约 $0.02。

自我监督检查

uv run scripts/x_timeline.py activity

当用户应专注工作时使用，可查看其上次发帖时间及活跃程度。若发现使用过度，可进行提醒。

每周回顾

uv run scripts/x_timeline.py top --days 7
uv run scripts/x_user.py me --track

代理指南 — 使用任何命令前请务必阅读

每条命令都会产生真实费用。 X API 按请求计费。请遵循以下规则以降低使用成本：

规则

1. 在一次对话中不要重复调用同一命令，除非用户明确要求获取最新数据。脚本会本地缓存数据——如果本会话中已执行过 recent 命令，可直接引用已有结果。

1. **对于重复问题，优先使用 top 而非 recent**。top 从本地存储读取，免费（$0）；而 recent 会调用 API，费用为 $0.005。

1. **默认情况下不要对提及内容使用 --context**。该选项每次回复线程都会额外增加 $0.005 的成本。仅当用户明确询问“他们是在回复什么？”时才添加。

1. **快速检查时使用 --max 5**。默认值为 10-20。若用户只需摘要，应减少拉取数量。

1. **简报场景使用 --hours 24**。用户仅需了解“今天发生了什么”时，无需拉取完整时间线。

1. 绝不未经提示就运行所有脚本。当用户询问“我的 X 上发生了什么？”时，应使用 x_briefing.py，而非分别运行三个命令。

1. **进行责任核查时，仅使用 activity 命令**。它仅需一次 API 调用。不要同时拉取提及和资料信息——这会使成本增加三倍。

1. **top 和 refresh 是你的得力助手**。top 免费（来自本地数据），refresh TWEET_ID 仅更新单条推文（$0.005）。当用户询问“我上一条帖子情况如何？”时，应使用此方式，而非重新拉取整个时间线。

1. 注意每日支出总额。每次命令输出都会显示“今日支出：$X.XXX”。若接近预算上限，请在继续调用前告知用户。

1. 绝不自行循环或重试。若命令失败（如 402 错误、限流等），应报告错误，不得自动重试。

1. **x_read.py 会缓存推文**——若用户再次询问同一推文，数据已在本地存储中，无需重新获取。

1. **晨间简报使用 x_briefing.py**，而非分别运行时间线、提及和用户信息。它更便宜（$0.02 vs $0.02 的三项独立调用），且输出更清晰。

成本参考

预算模式

用户可通过 x_setup.py --budget-mode 设置预算控制模式：

• guarded（默认）：在 50% / 80% / 100% 时发出警告，达到上限时阻止调用
• relaxed：在 50% / 80% / 100% 时发出警告，但从不阻止
• unlimited：无警告，无阻止

预算层级

用户在设置阶段已设定每日预算。脚本将在达到限制时发出警告并阻止调用：

• lite：$0.03/天（约一次简报）
• standard：$0.10/天（约 3–5 次检查）
• intense：$0.25/天（约 10 次以上检查）

若被阻止，应告知用户：“每日 X API 预算已达上限。可使用 --force 强制执行，或等待明日。”

不要做的事

• 不要为了“获取最新数据”而随意运行命令 —— 仅在用户需要时才拉取
• 不要使用 --no-cache，除非用于调试
• 不要在循环中对多个账户调用 user lookup
• 不要刷新每条推文的指标 —— 仅在用户明确询问特定推文表现时才刷新
• 不要将 recent + mentions + user 合并到一次响应中 —— 应使用 x_briefing.py 替代