Hermoso 是一个营销 MCP 服务器:一个 OAuth 端点提供 922+ 个工具,让智能体可以调研某个市场中正在投放的广告、生成成品图片和视频广告、发布它们,并搭建背后的付费广告系列。Codex 通过一个连接就能使用全部功能。本页只讲其中的一部分:Codex 在 Telegram 上究竟能做什么,以及 Telegram 不允许它做什么。
将 Hermoso 连接到 Codex
- 一条命令,无需密钥。
Codex 会读取 Hermoso 公开仓库中的市场文件,并安装其五项技能(research、ad-from-brand、generate、product-photoshoot 和 marketing)。这些技能通过codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermosonpx运行hermoso命令,因此不会向你的会话加载任何工具列表,在命令运行之前也不占用上下文。 - 只需登录一次。
它会打开浏览器进行登录,并将仅限所有者访问的凭证保存在npx -y hermoso auth login~/.hermoso/config.json中。如果该机器没有浏览器(例如 CI 或容器),请在 MCP & CLI → 终端与 API 密钥 中创建一个密钥,然后运行npx -y hermoso auth login --token hmk_…。密钥拥有真实的花费权限,请像对待密码一样对待它。 - 可选:同时配置 MCP 服务器。
这会把服务器写入codex mcp add hermoso -- npx -y hermoso mcp~/.codex/config.toml,并读取同一份已保存的凭证,因此文件中不包含任何密钥。想使用托管端点?运行codex mcp add hermoso --url https://app.hermoso.ai/mcp,然后运行codex mcp login hermoso完成 OAuth 登录。无论哪种方式,技能都能调用全部工具。 - 向 Codex 提出需求。“调研我三个最主要竞争对手跑得最久的广告,并把最好的钩子改编成 9:16 的视频”,或者“把这条渲染好的视频发布到频道上”。由智能体挑选工具;花费由你批准。
Codex 将 MCP 服务器保存在 ~/.codex/config.toml 中,或在受信任的项目中保存在 .codex/config.toml 中,而且该文件是 TOML 而非 JSON:直接复制 mcpServers 代码块无法加载,手写的条目应为 [mcp_servers.hermoso],其中 command = "npx",args = ["-y", "hermoso", "mcp"]。末尾的 mcp 不可省略:只写 npx -y hermoso 而没有子命令,会打印帮助信息后退出。Codex 读取插件市场时使用的是 Claude Code 所用的同一 .claude-plugin 布局,这也是同一个仓库能在两者中安装的原因。
然后在 Hermoso 的 设置 → 连接器 中连接 Telegram 本身,只需一次:粘贴来自 @BotFather 的机器人令牌,并将该机器人添加为你频道的管理员。没有授权页面:令牌就是凭证,而机器人是发布者。
Codex 可以使用的 Telegram 工具
post_to_telegram:以你的机器人身份向你指定的聊天发送消息:最多 4,096 个字符的文字,或一张照片、一个视频,或 2 至 10 项的相册(照片和视频可混合)。schedule_post:附带其chatId进行排队,与其他所有渠道在同一日历上。list_telegram_chats:过去 24 小时内向机器人发过消息的聊天。它有助于查找 ID,但它不是机器人所在的所有聊天的列表。edit_telegram_message / pin_telegram_message:修正消息的文字或文案而不丢失其浏览量,以及置顶或取消置顶行动号召。create_telegram_invite_link:为每个活动创建一个命名的邀请链接,可选择设置有效期、成员上限或入群审批,以便你看清谁从哪里加入。telegram_account:聊天的订阅者或成员数量、标题、描述和邀请链接。list_telegram_dms:过去 24 小时内发给机器人的内容,最新的在前,便于用post_to_telegram回复。delete_telegram_message:在 Telegram 的 48 小时窗口内删除机器人发出的消息,并需经过确认步骤。
Telegram 使用机器人令牌连接,而不是登录页面。在 Telegram 中通过 @BotFather 创建机器人,在 设置 → 连接器 中粘贴其令牌,然后将机器人以具有“发布消息”权限的管理员身份添加到你的频道,或以可以发帖的成员身份添加到群组。Hermoso 以该机器人身份发布,绝不以你的身份发布。Telegram 自身有两个限制,规划时需要留意:机器人拿不到每条帖子的浏览量,也没有帖子历史,因此订阅者数和命名邀请链接就是你能拿到的数据;发给机器人的消息会保留 24 小时,之后就消失了。发布不消耗积分。
在自动化任何操作之前,值得了解的 Telegram 限制
| 文字 | Telegram 消息最多 4,096 个字符,但一旦附加了照片或视频就只有 1,024 个,因为文字会变成说明文字。该限制在帖子创建或排队时即执行,因此超长帖子会在你仍在场时被拒绝,方便你修改,而不是在发出途中被悄悄截断。 |
|---|---|
| 可见性 | 已发送或未发送,没有草稿、未列出或私密形式。谁能看到,由聊天决定:“发到私密群组或频道,只有其成员能看到。”silent 会静默发送、不带提示音,但不会改变谁能看到这条消息。 |
| 轮播 | 2 至 10 项的相册,照片和视频可以混合。这两个边界都是 Telegram 自己的规定,来自 Bot API 的 sendMediaGroup(“必须包含 2-10 项”),混合也是它的规定。相册只显示一条文案,位于第一项上。Hermoso 上传文件而不是传递链接,这将 Telegram 的上限提高到每张照片 10MB、每个视频 50MB。 |
| 使用哪个账户 | chatId,每条帖子都必填:公开频道的 @用户名或数字 ID(超级群组或频道以 -100 开头)。Bot API 没有列出机器人所在聊天的方法,因此 Hermoso 无从得知,也从不猜测。 |
在 Codex 中试一试
用日常语言提出需求即可。这些都是普通句子,不是某种专用语法:
“非交互模式:每个工作日上午 8 点,将当天的优惠以静默方式连同商品图片发布到 @ourdeals,并以 JSON 格式输出消息 ID。”
这会依次执行 render_ad → post_to_telegram → pin_telegram_message → create_telegram_invite_link。交互使用时,Codex 会在运行前显示该调用。非交互使用时没有人可以确认,因此在任何发布或花费的步骤上,都值得专门设计应对方式。
Codex 在 Telegram 上:真正棘手的部分
把 chatId 放在配置中,而不是交给提示去猜测。schedule_post 会像携带 Pinterest 画板那样为每条帖子携带它,而没有它的排队 Telegram 帖子会在入队时被拒绝。silent 会在不发出提示音的情况下送达,适合发布在人们会一直打开的频道中的每日帖子。它不会改变谁能看到这条消息;这由聊天本身决定。
对于无人值守运行,相较于完整的工具清单,请优先使用带 --json 的 hermoso CLI。它占用的上下文要少得多,也更便于断言。
发布前先调研 Telegram
Hermoso 中没有 Telegram 广告库,也没有频道搜索,因此它不声称在 Telegram 上做竞争对手研究。请在创意公开可见的地方进行研究(Meta、Google 和 LinkedIn 广告库,加上有机的 TikTok、Instagram、YouTube、Reddit 和 Threads),然后在这里发布成品广告。
付费部分
Hermoso 中没有 Telegram 广告,我们也不暗示有。这里的 Telegram 是你通过自己的机器人运营的频道:发布、置顶、编辑、统计订阅者并跟踪邀请。付费工具涵盖 Meta、Google Ads、Microsoft Advertising、Reddit Ads、LinkedIn、Pinterest、X Ads、TikTok Ads、Snapchat Ads、ChatGPT Ads、Apple Search Ads 和 AppLovin Ads。
Codex 自己无法完成的事
一个掌握预算的智能体,只有在影响范围有界的情况下才有用,所以这道围栏设在服务器里,而不是提示词里。每个广告系列、广告组、广告分组和广告都以暂停状态创建,而会真正动用资金的状态切换,若没有明确的确认标记就拒绝执行。每次渲染前都会先报价(hermoso_capabilities 会在任何花费发生之前公布每个模型的确切积分成本)。积分在第一次调用服务商之前就会预留,之后按确切成本结算,因此派发失败会退款,而不是让你白白付费。删除操作同样需要确认;并且在智能体告诉你它搭建了什么之前,每个广告系列结构都会从广告平台回读。
有一步是刻意留给你的:通过 @BotFather 创建机器人,并把它添加到你的频道。之后的一切都是工具调用。
其余的矩阵
从 Codex 发布到: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky。或查看 Codex 可发布的全部平台。
从以下工具发布到 Telegram: Claude · ChatGPT · Claude Code · Cursor · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · 从命令行投放广告
常见问题
Codex 能发布到 Telegram 吗?
可以,通过 Hermoso 的 Codex 插件。运行 codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso,即可安装 Hermoso 的技能,然后用 npx -y hermoso auth login 登录一次。登录会打开浏览器并自行保存凭证,无需创建密钥,也无需粘贴。如需同时使用 MCP 服务器,请运行 codex mcp add hermoso -- npx -y hermoso mcp。随后 Codex 便拥有 922+ 个工具,包括发布到 Telegram 的工具,以及研究你所在市场正在投放的广告并从头渲染创意的工具。
如何将 Telegram 连接到 Codex?
两个步骤,各做一次。运行 codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso,即可安装 Hermoso 的技能,然后用 npx -y hermoso auth login 登录一次。登录会打开浏览器并自行保存凭证,无需创建密钥,也无需粘贴。如需同时使用 MCP 服务器,请运行 codex mcp add hermoso -- npx -y hermoso mcp。然后通过 @BotFather 在 Telegram 中创建机器人,把它的令牌粘贴到 Hermoso 的 设置 → 连接器 中,并把机器人加为频道管理员,授予“发布消息”权限。之后,Codex 发布到 Telegram 就像普通的工具调用一样,每次都会指明聊天。
Codex 能发布 Telegram 轮播吗?
可以,作为 2 至 10 项的相册,照片和视频可以混合,这是 Telegram 自己对 sendMediaGroup 的规定。相册只带一条文案,位于第一项上。无论哪种方式,Codex 调用的都是同一个发布工具;无法承载轮播的渠道会被拒绝,并附上真实原因。
从 Codex 发布到 Telegram 要花多少钱?
发布到 Telegram 不消耗积分,因为 Telegram 不对每次调用收费。积分用于生成创意。方案为每月 $29、$69 和 $149,分别包含 1,200、3,000 和 7,000 积分,每个功能在包括 Free 在内的所有方案中都可用。唯一的例外是企业版 SSO。
Codex 需要我的 Telegram 密码吗?
不会。Telegram 通过你在 @BotFather 中创建的机器人连接,Hermoso 只持有该机器人的令牌,因此 Codex 始终以机器人身份发布,绝不以你的个人 Telegram 账号身份。你随时可以在 @BotFather 中撤销该令牌,而且它绝不会交给模型。
Codex 能为 Telegram 帖子设定未来的发布时间吗?
可以。schedule_post 会把它排进与其他所有渠道共用的同一个日历,如果文案需要不同,还可以为该渠道设置单独的文案;list_scheduled 和 cancel_scheduled 可以读取并撤回它。Telegram 是可以排队的十一个渠道之一。