Hermes Tweet
Hermes Tweet 为 Hermes Agent 添加了 X/Twitter 工具集。它可用于社交监听、账户研究、发布监控、支持工单分类、抽奖审计以及那些私有或状态变更操作需要保持明确受控的工作流。
何时使用此脚本
当用户希望进行以下操作时使用此脚本：
- 在 Hermes Agent 运行时中安装 Hermes Tweet
- 发现可用的 X/Twitter 读取和操作路由
- 读取 X/Twitter 账户、推文、趋势、监控或搜索数据
- 在起草回复或活动策划前总结公开信号
- 确保私有和状态变更操作在操作者显式意图下才能执行
设置
通过 Hermes 安装并启用插件：
hermes plugins install Xquik-dev/hermes-tweet --enable
Hermes 在安装和更新期间会扫描插件。请检查每条警告。 危险判定会阻止安装或禁用更新。
在 Hermes 运行时主机上设置 API 密钥：
export XQUIK_API_KEY="<your-key>"
export HERMES_TWEET_ENABLE_ACTIONS="false"
对于只读会话，请保持 HERMES_TWEET_ENABLE_ACTIONS 为 false。仅当需要执行已获批准的私有读取、写入、监控、Webhook、提取、绘图或媒体操作时，才将其设置为 true。
输入
在选择路由之前，请询问以下输入：
- 目标：研究、监控、支持工单分类、抽奖审计或操作准备
- 目标：账户句柄、推文 URL、关键词、列表、监控项或趋势
- 时间窗口和新鲜度要求
- 是否涉及任何私有或状态变更操作
- 确认 Hermes 运行时已设置
XQUIK_API_KEY
工作流
- 使用
tweet_explore搜索内置端点目录以找到匹配的路由。 - 选择目录路由后，通过
tweet_read读取公开的 X/Twitter 数据。 - 仅在显式批准后，使用
tweet_action执行私有或状态变更路由。 - 将 API 密钥存储在环境变量或 Hermes 运行时环境文件中。
- 不要将凭据粘贴到提示、问题、PR 评论或工具输入中。
- 当用户要求的是活动、监控、支持或抽奖工作流（而非单次读取）时，请加载工作流模式。
工具模型
| 工具 | 用途 |
|---|---|
tweet_explore | 搜索内置端点目录，无需使用 API 密钥。 |
tweet_read | 当 XQUIK_API_KEY 已设置时，调用目录中列出的公共只读端点。 |
tweet_action | 仅在操作门控启用时，调用私有读取、写入、监控、Webhook、提取、绘图和媒体操作。 |
输出格式
返回简洁的操作输出：
总结：
- 检查了什么以及原因
读取路由：
- 目录路径、输入和结果总结
操作计划：
- 提议的私有或状态变更操作，每个都等待显式批准
下一步检查：
- 后续路由或监控频率（如有用）
使用示例
在起草回复前研究一个账户：
使用 Hermes Tweet 检查 @example 最近的公开上下文，然后再起草回复。
保持操作禁用。
监控一个发布关键词：
跟踪 X/Twitter 上今天对“Example Launch”的提及。
总结主题和重要账户。不要发帖。
准备一个受控的帖子：
起草一条发布推文，并列出你将使用的确切 tweet_action 调用。
在任何操作路由执行前等待批准。
捕获结构化的路由备注：
{
"objective": "support-triage",
"route": "/api/v1/x/search",
"action_gate": "disabled",
"approval_required": true
}
故障排除
- 如果只显示
tweet_explore，请在 Hermes 运行时主机上配置XQUIK_API_KEY并重新加载或重启当前 Hermes 会话。 - 如果操作路由不可用，请将公共读取操作分开进行。仅对已批准的私有或状态变更操作设置
HERMES_TWEET_ENABLE_ACTIONS=true。 - 如果路由不匹配，请再次使用
tweet_explore并选择目录中列出的路径，而不是猜测端点。
最佳实践
- 将 Hermes Tweet 视为 Hermes 原生的 X/Twitter 层，而不是通用的 API 包装器。
- 默认情况下保持研究为只读。在创建或更改监控项之前需要批准。
- 在进行私有或状态变更调用之前，使用桌面端或网关操作者审查。
- 在调用
tweet_read或tweet_action之前，验证确切的目录路径。 - 环境变量更改后，重启网关、cron 或长时间运行的 Hermes 会话。
参见
social-publishing 插件与 Hermes Tweet 互补，用于广泛的多平台发布。Hermes Tweet 专注于 Hermes Agent 的 X/Twitter 工具集及其只读优先、操作需审批的运行模式。
当路由边界不清楚时，请参阅端点和审批合同。请参阅官方指南：https://github.com/Xquik-dev/hermes-tweet#readme。