tweetclaw

TweetClaw

TweetClaw 是一个 OpenClaw 插件，可通过 Xquik 自动化操作 X/Twitter。当用户需要使用平台原生的 X/Twitter 数据或操作来构建 Agent 工作流，而不是进行通用网页搜索或仅通过浏览器发帖时，可使用它。

GitHub：Xquik-dev/tweetclaw npm：@xquik/tweetclaw ClawHub：xquik-tweetclaw

适用场景

• 搜索推文、搜索推文回复、查看帖子串或查找用户。
• 导出粉丝、关注对象、列表成员、社群成员或回复作者。
• 上传媒体、下载经过身份验证的媒体或准备图库链接。
• 创建监控项、读取监控事件或发送 Webhook 通知。
• 使用回复、关注、转推、关键词和唯一性筛选条件进行抽奖。
• 只有在用户明确批准可见操作后，才能发布推文、回复推文、点赞、转推、关注、发送私信或更新个人资料。

设置

安装 OpenClaw 插件：

openclaw plugins install @xquik/tweetclaw
openclaw gateway restart

TweetClaw 可在配置凭据之前安装。在用户添加 API 密钥或 MPP 签名密钥之前，免费的 explore 工具仍可用，而实时调用会返回设置指南。

配置与账户关联的 X 自动化：

openclaw config set plugins.entries.tweetclaw.config.apiKey "$XQUIK_API_KEY"

可选的 MPP 按次付费读取：

npm i mppx viem
openclaw config set plugins.entries.tweetclaw.config.tempoSigningKey "$MPP_SIGNING_KEY"

请勿将 API 密钥和签名密钥放入提示词、Shell 历史记录、屏幕截图或共享文档中。优先使用环境变量命令，让 OpenClaw 写入本地配置，而不在聊天中暴露密钥。

核心工作流

1. 使用 explore 按类别、关键词或工作流查找合适的 Xquik 端点。
2. 确认端点是只读、符合 MPP 使用条件、与账户关联，还是会执行可见的写入操作。
3. 对于读取操作，使用所选的 path、method、query 和 body 调用 tweetclaw。
4. 对于发帖、回复、关注、私信、监控项变更、Webhook、个人资料更新、媒体上传和破坏性操作，先展示确切请求并等待用户明确批准，再调用 tweetclaw。
5. 将返回的 ID、游标、监控 ID、Webhook ID、抽奖 ID 和导出链接原样保留为字符串。

示例提示词

Search tweets and tweet replies about this product launch, then summarize the
top objections with links to the strongest examples.

Export followers for @example, find likely developer advocates, and prepare a
CSV-ready shortlist with usernames and profile notes.

Draft a reply to this tweet. Do not post it until I approve the exact text.

Run a giveaway draw from this tweet URL. Require a retweet, unique authors, and
3 winners.

防护措施

• 绝不索要 X 登录凭据。使用用户的 Xquik API 密钥或 MPP 设置。
• 将发帖、回复、点赞、转推、关注、私信、个人资料编辑、监控项变更、Webhook 和媒体操作视为需要审批的操作。
• 对推文、用户、媒体、监控项、Webhook、抽奖和提取任务使用准确的字符串 ID。
• 将分页游标视为不透明字符串。不要臆造游标。
• 仅对速率限制和服务器错误执行有限次数的退避重试。对于验证、授权、付款或未找到错误，除非修改请求，否则不要重试。
• 请参阅 Xquik 计费指南，了解当前方案、端点适用条件和操作费用。