用于所有 X/Twitter 操作的主路由技能——阅读、调研、发帖、互动。根据任务自动路由至相应子工具,覆盖阅读等功能。
X Master Skill —— Master Routing for X/Twitter 操作是一项面向实际任务的技能,主要用于这个技能是所有 X/Twitter 工作的单一切入点;首先读它, 然后根据任务向正确的子工具路径。
从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
本技能是所有 X/Twitter 相关工作的唯一入口点。请先通读本文档,再根据具体任务将请求路由至正确的子工具。严禁直接发起对 x.com 的原始抓取请求;严禁凭猜测进行路由决策。
对 x.com 或 twitter.com URL 执行 web_fetch 将静默失败或返回无效内容。
阅读推文内容时,必须始终使用 fxtwitter:
https://api.fxtwitter.com/{username}/status/{tweet_id}
请从 x.com URL 中提取 username 和 tweet_id:
https://x.com/example/status/1234567890 → api.fxtwitter.com/example/status/1234567890https://twitter.com/example/status/1234567890 → 同样适用该模式此为硬性规则,无任何例外。完整说明详见 references/fxtwitter-pattern.md。
本技能将发布类操作路由至一个或多个 X 账号。使用前,请先配置目标账号:
| 配置类型 | 含义 | 是否需要人工审批? |
|---|---|---|
| 单账号模式 | 所有发布内容均发送至同一账号 | 是 —— 始终需要。发布前必须获得人工审批。 |
| 多账号模式 | 依据内容类型自动路由至不同账号 | 是 —— 始终需要。发布前须确认账号选择与文案内容。 |
| 仅草稿模式(Draft-only mode) | 仅生成草稿,永不自动发布 | 推荐新用户启用。请先熟悉工作流。 |
黄金法则:禁止在 X 上自主发布内容。务必先生成草稿,并在人工审批通过后方可发布。
发布流程如下:
工具: 通过 web_fetch 调用 fxtwitter API
适用场景: 你拥有一个 x.com / twitter.com 链接,且需获取其内容
调用方式:
web_fetch("https://api.fxtwitter.com/{username}/status/{id}")
响应中包含: 完整文本、作者信息、互动数据(engagement stats)、媒体资源 URL,以及通过 reply_to 字段提供的上下文线程信息
若 fxtwitter 不可用(返回 5xx 错误或超时):回退至 x-research-skill 获取推文内容。
工具: xai-grok-search 技能
适用场景: “人们正在如何讨论 X?”、“围绕 Y 搜索 X”、“实时舆情快照”、“突发新闻背景分析”
注意事项:
工具: x-research-skill
适用场景: 需跨大量推文研究某一主题、追踪对话脉络、理解话语深度,或缓存结果供后续复用
支持能力: 按账号句柄(handle)筛选、按互动量(engagement)排序、保存结果以供重复调用
工具: last30days-skill
适用场景: “关于 X 主题近期有哪些热门趋势?”,理解 Reddit + X + HN + YouTube 等平台共同塑造的文化现象
触发条件: 趋势研究请求、话题热度分析
工具: 自定义发布脚本(参见 Setup 章节)
适用场景: 所有发布类操作。发布前始终需获得人工审批。
发布流程:
严禁跳过审批环节。 即便你认为已获授权,也必须在执行前再次确认最终文案内容。
工具: x-engage 技能
适用场景: 你的账号收到提及、回复或其他形式的互动
注意事项:
工具: xurl 技能(或你已配置的 X API 客户端)
适用场景: 特定 API 操作 —— 如关注者管理、数据分析、批量操作等未被上述技能覆盖的场景
前提要求: 环境中已正确配置 X OAuth 凭据
拿到一个 x.com URL? → 阅读内容:使用 fxtwitter(严禁直接 web_fetch) 需要在 X 上搜索公共讨论? → 实时舆情快照:xai-grok-search → 深度线程上下文:x-research-skill → 最近 30 天跨平台趋势:last30days-skill 需要发布/回复? → 先写草稿 → 获取人工审批 → 执行发布脚本 收到提及/回复? → 使用 x-engage(自动生成草稿,等待审批) 需要原始 API 访问权限? → 使用 xurl 或你已配置的 X API 客户端
| 资源名称 | 位置 | 用途 |
|---|---|---|
| fxtwitter 使用模式 | references/fxtwitter-pattern.md |
如何及为何使用 fxtwitter;错误处理指南 |
| 算法情报(Algorithm intelligence) | references/algo-intel.md |
2026 年 X 排名信号、互动权重、运营策略 |
| 技能依赖项 | README.md § Sub-Skills | 需安装哪些子技能及其适用场景 |
| 账号配置模板 | config/accounts.json.example |
发布功能配置的起点文件 |
| 发布脚本 | scripts/x-post.js(如已打包) |
执行经审批通过的发布操作 |
| xurl 技能文档 | ~/.openclaw/skills/xurl/ 或 clawhub |
直连 X API v2 的使用说明 |
| x-engage 技能文档 | ~/.openclaw/skills/x-engage/ 或 clawhub |
提及处理全流程说明 |
若你正从旧版 X 智能体(agent)迁移,请注意以下变更:
| 工具 / 模式 | 状态 | 替代方案 |
|---|---|---|
| Herald/Barker 智能体 | 已弃用 —— 专用 X 智能体稳定性差 | x-engage 技能可处理提及 |
| x-twitter-api npm 包 | 已删除 —— 第三方重复实现 | xurl(官方第一方 SDK) |
| x-react.js / x-poll.js | 已归档 —— 独立的互动脚本 | 功能已由 xurl 覆盖 |
| 直接对 x.com 执行 web_fetch | 从未稳定可用 | fxtwitter(强制使用) |
完整细节请参阅 references/algo-intel.md
⚠️ 关于机器人 / AI 账号的重要说明: 上述互动权重仅适用于人类账号。AI 助手或机器人账号受算法差异化加权。有关机器人账号的具体策略,请参阅
references/algo-intel.md中的 “Strategy by Account Type” 章节。
⚠️ 时效性提醒: 当前算法数据最后验证日期为 2026-03-13。若今日日期已晚于 2026-06-13,请在依赖具体权重前,检查
references/algo-intel.md是否存在更新版本。
本技能专为 AI 智能体设计,旨在确保 X/Twitter 工作被准确路由。你可以根据自身需求调整账号路由逻辑与审批流程,但必须严格保留 fxtwitter 强制规则及任务路由器的整体结构。
版本:1.0.0 | 许可证:MIT
相关专题
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 134万人学习
共49课时 | 82.5万人学习