XReply — AI 推文生成器

使用 AI 以您的个人风格生成、定时和发布推文。浏览热门内容获取灵感，管理您的待发推文队列，并跟踪账单与配额使用情况。

身份验证

所有工具均需设置环境变量 XREPLY_TOKEN——该值为来自 XreplyAI 设置页面的 JWT Token。当您在技能配置中设置该变量后，OpenClaw 将自动注入此 Token。

MCP 服务端

XReply 的 MCP 服务端已发布至 npm，包名为 @xreplyai/mcp。您可通过 mcporter 调用工具：

mcporter call 'npx @xreplyai/mcp'  [param:value ...]

查看所有可用工具及其参数：

mcporter list 'npx @xreplyai/mcp' --all-parameters

工具列表

内容发现

xreply_viral_library

浏览高互动推文（获赞 ≥100）以获取创作灵感。支持按细分领域（niche）、关键词及时间范围筛选。需 Pro 或 BYOK 订阅方可使用。

mcporter call 'npx @xreplyai/mcp' xreply_viral_library
mcporter call 'npx @xreplyai/mcp' xreply_viral_library niche:ai sort:top_engaged
mcporter call 'npx @xreplyai/mcp' xreply_viral_library niche:saas query:pricing time_range:7d
mcporter call 'npx @xreplyai/mcp' xreply_viral_library niche:startups sort:recent page:2

参数说明：

• niche（可选）：ai | saas | marketing | productivity | startups | growth
• sort（可选）：top_engaged（默认）| recent
• query（可选）：在推文正文中进行关键词搜索
• time_range（可选）：7d | 30d
• page（可选）：页码，每页返回 20 条结果（默认为第 1 页）

内容生成

xreply_posts_generate

生成一条符合用户个人风格的 AI 推文，并自动保存为草稿。返回生成的正文内容及已保存的推文 ID。每次调用计入日配额（免费版 5 条/日，Pro 版 100 条/日）。

mcporter call 'npx @xreplyai/mcp' xreply_posts_generate
mcporter call 'npx @xreplyai/mcp' xreply_posts_generate topic:"my SaaS hit 1000 users"
mcporter call 'npx @xreplyai/mcp' xreply_posts_generate topic:"lessons from year 1" angle:story_arc
mcporter call 'npx @xreplyai/mcp' xreply_posts_generate angle:one_liner

参数说明：

• topic（可选）：推文主题或提示词（最长 280 字符）
• angle（可选）：one_liner | list | question | story_arc | paragraph | my_voice

xreply_posts_generate_batch

批量生成多条 AI 推文。每条推文均单独计入日配额——若配额紧张，请先调用 billing 相关接口确认余额。例如：一次生成 9 条将耗尽免费账户当日全部配额。

mcporter call 'npx @xreplyai/mcp' xreply_posts_generate_batch category:personalized count:5
mcporter call 'npx @xreplyai/mcp' xreply_posts_generate_batch category:trending count:3
mcporter call 'npx @xreplyai/mcp' xreply_posts_generate_batch category:viral count:9

参数说明：

• category（必填）：personalized | trending | viral
• count（必填）：要生成的推文数量（1–9，不可超过当日剩余配额）

推文管理

xreply_posts_list

列出队列中的全部推文——包括草稿、已定时及近期发布的推文。返回推文 ID、正文内容、状态及定时发布时间。

mcporter call 'npx @xreplyai/mcp' xreply_posts_list

无参数。

xreply_posts_create

保存一条推文草稿。该推文不会立即发布，须显式调用 xreply_posts_publish 才会发布。

mcporter call 'npx @xreplyai/mcp' xreply_posts_create body:"Your tweet text here"
mcporter call 'npx @xreplyai/mcp' xreply_posts_create body:"Tweet text" auto_rt_hours:24

参数说明：

• body（必填）：推文正文（最长 280 字符）
• auto_rt_hours（可选）：发布后自动转发（Retweet）的小时数（如 24）

xreply_posts_edit

编辑推文的正文、定时发布时间或自动转发设置。无法编辑状态为 processing 或 posted 的推文。

mcporter call 'npx @xreplyai/mcp' xreply_posts_edit id:123 body:"Updated tweet text"
mcporter call 'npx @xreplyai/mcp' xreply_posts_edit id:123 'scheduled_at:2026-03-15T09:00:00Z'
mcporter call 'npx @xreplyai/mcp' xreply_posts_edit id:123 body:"New text" auto_rt_hours:48

参数说明：

• id（必填）：推文 ID（整型）
• body（可选）：新的正文内容（最长 280 字符）
• scheduled_at（可选）：ISO 8601 格式的时间字符串；省略表示保持原定时时间不变；如需取消定时，请直接省略该字段，推文将恢复为草稿状态
• auto_rt_hours（可选）：发布后自动转发的小时数；省略表示保持原设置不变

xreply_posts_delete

删除一条推文。无法删除状态为 processing 或 posted 的推文。

mcporter call 'npx @xreplyai/mcp' xreply_posts_delete id:123

参数说明：

• id（必填）：推文 ID（整型）

发布

xreply_posts_publish

将推文发布或定时发布至 X/Twitter 平台。要求已绑定 X 账户。最大定时天数取决于当前订阅计划。

mcporter call 'npx @xreplyai/mcp' xreply_posts_publish id:123
mcporter call 'npx @xreplyai/mcp' xreply_posts_publish id:123 'scheduled_at:2026-03-15T09:00:00Z'

参数说明：

• id（必填）：推文 ID（整型）
• scheduled_at（可选）：ISO 8601 格式的定时时间；省略则立即发布

上下文信息

xreply_billing_status

获取当前订阅等级（free / byok / pro）、配额使用情况、日限制及订阅详情。

mcporter call 'npx @xreplyai/mcp' xreply_billing_status

无参数。

xreply_voice_status

获取语音档案（voice profile）状态——包括是否已完成分析、已分析推文数量、配置的 AI 提供商以及写作风格摘要。

mcporter call 'npx @xreplyai/mcp' xreply_voice_status

无参数。

xreply_preferences_get

获取当前推文生成偏好设置——语气（tone）、表情符号（emoji）使用策略及默认结构（structure）。

mcporter call 'npx @xreplyai/mcp' xreply_preferences_get

无参数。

xreply_preferences_set

更新推文生成偏好设置。仅需提供需要修改的字段即可。

mcporter call 'npx @xreplyai/mcp' xreply_preferences_set tone:witty
mcporter call 'npx @xreplyai/mcp' xreply_preferences_set tone:professional include_emoji:false
mcporter call 'npx @xreplyai/mcp' xreply_preferences_set structure:story_arc

参数说明：

• tone（可选）：auto | casual | professional | witty | empathetic
• include_emoji（可选）：true | false
• structure（可选）：one_liner | paragraph | question | list | story_arc

xreply_rules_list

列出在生成过程中应用的自定义写作规则——例如“永不使用话题标签（hashtags）”、“结尾必须是问句”。需 Pro 或 BYOK 订阅方可使用。

mcporter call 'npx @xreplyai/mcp' xreply_rules_list

无参数。

工作流示例

生成并定时发布一条推文

1. mcporter call 'npx @xreplyai/mcp' xreply_posts_generate topic:"ship fast, learn faster" angle:story_arc
   → 返回 { body: "...", post: { id: 42, ... } }
2. mcporter call 'npx @xreplyai/mcp' xreply_posts_publish id:42 'scheduled_at:2026-03-12T09:00:00Z'

浏览热门内容获取灵感，再生成推文

1. mcporter call 'npx @xreplyai/mcp' xreply_viral_library niche:saas sort:top_engaged
   → 浏览热门推文格式
2. mcporter call 'npx @xreplyai/mcp' xreply_posts_generate topic:"inspired by those formats" angle:list

规划一周推文

1. mcporter call 'npx @xreplyai/mcp' xreply_billing_status
   → 在执行大批量生成前检查剩余配额
2. mcporter call 'npx @xreplyai/mcp' xreply_posts_generate_batch category:personalized count:7
   → 生成 7 条草稿
3. mcporter call 'npx @xreplyai/mcp' xreply_posts_list
   → 查看队列内容
4. mcporter call 'npx @xreplyai/mcp' xreply_posts_edit id:101 'scheduled_at:2026-03-11T09:00:00Z'
   mcporter call 'npx @xreplyai/mcp' xreply_posts_edit id:102 'scheduled_at:2026-03-12T09:00:00Z'
   → 逐条设定发布时间

编辑并发布现有草稿

1. mcporter call 'npx @xreplyai/mcp' xreply_posts_list
   → 查找草稿 ID
2. mcporter call 'npx @xreplyai/mcp' xreply_posts_edit id:55 body:"Revised tweet text"
3. mcporter call 'npx @xreplyai/mcp' xreply_posts_publish id:55

错误处理

Token 已过期：若工具返回 401 错误，则表明 XREPLY_TOKEN 已失效（Token 有效期为 30 天）。请提示用户前往 XreplyAI 设置页面获取新 Token，并在 OpenClaw 配置中更新。

配额已用尽：若生成操作返回配额错误（例如 “Daily generation quota exhausted”），请先调用 xreply_billing_status 查询当前限额，并告知用户。配额每日午夜重置。

批量生成配额不足：若 xreply_posts_generate_batch 返回 quota_insufficient: true，请将 count 参数调整为响应中显示的 available 值，或提示用户确认操作。

定时时间超出范围：若定时操作返回校验失败错误，则所请求的发布时间超出了当前订阅计划允许的最大定时天数。请调用 xreply_billing_status 查询 max_schedule_days 字段，并建议用户选择更早的时间。

无法编辑或删除：状态为 processing 或 posted 的推文不可编辑或删除。请调用 xreply_posts_list 查询当前状态。

热门库需 Pro 权限：若 xreply_viral_library 或 xreply_rules_list 返回 403 错误，请告知用户这些功能需 Pro 或 BYOK 订阅方可使用。