hermes-tweet

Hermes Tweet

Hermes Tweet 为 Hermes Agent 增加了一套 X/Twitter 工具集，适用于社交倾听、账号研究、发布监控、支持分流、抽奖审查，以及需要将私有或状态变更操作保持明确、受控的工作流。

适用场景

当用户想要执行以下操作时，可以使用该技能：

将 Hermes Tweet 安装到 Hermes Agent 运行时
发现可用的 X/Twitter 读取与操作路由
读取 X/Twitter 账号、推文、趋势、监控或搜索数据
在起草回复或营销活动前汇总公开信号
将私有和状态变更操作保持在 operator 明确意图的门控之后

安装配置

通过 Hermes 安装并启用插件：

hermes plugins install Xquik-dev/hermes-tweet --enable

Hermes 在安装和更新期间会扫描插件，应查看每一条警告。危险判定会阻止安装或禁用更新。

在 Hermes 运行时主机上设置 API key：

export XQUIK_API_KEY="<your-key>" export HERMES_TWEET_ENABLE_ACTIONS="false"

在只读优先的会话中，保持 HERMES_TWEET_ENABLE_ACTIONS 为 false。只有在执行已批准的私有读取、写入、监控、Webhook、抽取、抽奖或媒体操作时，才将其设为 true。

输入

在选择路由前，先询问以下输入：

目标：研究、监控、支持分流、抽奖审查或操作准备
目标对象：账号 handle、推文 URL、关键词、列表、监控或趋势
时间窗口和时效性需求
是否有私有或状态变更操作在范围内
确认 Hermes 运行时已配置 XQUIK_API_KEY

工作流

使用 tweet_explore 搜索内置端点目录，找到匹配的路由。

选择目录路由后，通过 tweet_read 读取公开 X/Twitter 数据。

只有在明确批准后，才使用 tweet_action 执行私有或状态变更路由。

将 API key 保存在环境变量或 Hermes 运行时 env 文件中。

不要将凭证粘贴到提示词、issue、PR 评论或工具输入中。

当用户要求的是营销活动、监控、支持或抽奖工作流，而不是单次读取时，加载相应的工作流模式。

工具模型

工具 | 用途

tweet_explore | 在不使用 API key 的情况下搜索内置端点目录。

tweet_read | 在已设置 XQUIK_API_KEY 时，调用目录中列出的公开只读端点。

tweet_action | 仅在启用 action gating 时，调用私有读取、写入、监控、Webhook、抽取、抽奖和媒体操作。

输出格式

返回简洁的操作性输出：

Summary:

检查了什么以及为什么

Read routes:

Action plan:

提议的私有或状态变更操作，每一项都等待明确批准

Next check:

后续路由或监控频率（如有用）

使用示例

在起草回复前研究账号：

使用 Hermes Tweet 检查 @example 最近的公开上下文，以便起草回复。保持 actions 禁用。

监控发布关键词：

跟踪今天关于 "Example Launch" 的 X/Twitter 提及。总结主题和值得注意的账号。不要发布。

准备受控发帖：

起草一条发布推文，并列出你将使用的确切 tweet_action 调用。在任何操作路由前等待批准。

记录结构化路由备注：

{ "objective": "support-triage", "route": "/api/v1/x/search", "action_gate": "disabled", "approval_required": true }

故障排查

如果只出现 tweet_explore，请在 Hermes 运行时主机上配置 XQUIK_API_KEY，并重新加载或重启当前 Hermes 会话。

如果 action 路由不可用，请保持公开读取独立进行。仅在已批准的私有或状态变更操作中，将 HERMES_TWEET_ENABLE_ACTIONS=true。

如果路由不匹配，请再次使用 tweet_explore，并选择目录中列出的路径，而不是猜测端点。

最佳实践

将 Hermes Tweet 视为 Hermes 原生的 X/Twitter 层，而不是通用 API 包装器。

默认保持研究只读。在创建或修改监控前要求批准。

在私有或状态变更调用前，使用 Desktop 或 gateway operator 审核。

在调用 tweet_read 或 tweet_action 前，验证确切的目录路径。

环境变更后，重启 gateway、cron 或长期运行的 Hermes 会话。

另见

social-publishing 插件与 Hermes Tweet 互补，可用于广泛的多平台发布。Hermes Tweet 专注于 Hermes Agent 的 X/Twitter 工具集及其只读优先、审批门控的运营模式。

当路由边界不清晰时，请参阅端点和审批契约。官方指南见 https://github.com/Xquik-dev/hermes-tweet#readme。

技能介绍