Hermoso 是一个营销 MCP 服务器：一个 OAuth 端点提供 922+ 个工具，让智能体可以调研某个市场中正在投放的广告、生成成品图片和视频广告、发布它们，并搭建背后的付费广告系列。Gemini CLI 通过一个连接就能使用全部功能。本页只讲其中的一部分：Gemini CLI 在 Telegram 上究竟能做什么，以及 Telegram 不允许它做什么。
将 Hermoso 连接到 Gemini CLI
- 安装扩展。
它会安装 Hermoso 公开仓库的最新发布版本：五个技能（research、ad-from-brand、generate、product-photoshoot 和 marketing），外加一个gemini extensions install https://github.com/hermoso-ai/hermosoGEMINI.md上下文文件。这些技能通过npx运行hermoso命令，因此不会向 Gemini CLI 的工具列表中添加任何内容，在命令运行之前也不占用上下文。gemini extensions list会将它们显示在 Agent skills 下。 - 登录一次。
它会打开浏览器登录，并将仅限所有者访问的凭证保存到npx -y hermoso auth login~/.hermoso/config.json。Gemini CLI 在首次需要 Hermoso 时可以替你运行它。该机器上没有浏览器？请在 MCP & CLI → 终端与 API 密钥下创建一个密钥，然后运行npx -y hermoso auth login --token hmk_…。 - 可选：同时添加 MCP 服务器。
当首次连接返回 401 时，Gemini CLI 会找到 Hermoso 的授权服务器并自行注册，因此无需在gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcpsettings.json中填写任何密钥；在会话中运行/mcp auth hermoso即可完成登录。没有它，技能也能调用所有工具。 - 向 Gemini CLI 提出需求。“调研我三个最主要竞争对手跑得最久的广告，并把最好的钩子改编成 9:16 的视频”，或者“把这条渲染好的视频发布到频道上”。由智能体挑选工具；花费由你批准。
我们于 2026-09-23 在干净的主目录中，针对 Gemini CLI 0.60.0 运行了上述安装：它拉取了 hermoso-ai/hermoso 的当前发布版本，gemini extensions list 显示了这五个技能和上下文文件。该扩展本身不附带 MCP 服务器，这是有意为之：工具列表会加载到每个会话中，而技能在运行之前不产生任何开销。Hermoso 与 Google 没有隶属关系，也未获得其认可。
然后在 Hermoso 的 设置 → 连接器 中连接 Telegram 本身，只需一次：粘贴来自 @BotFather 的机器人令牌，并将该机器人添加为你频道的管理员。没有授权页面：令牌就是凭证，而机器人是发布者。
Gemini CLI 可以使用的 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 无从得知，也从不猜测。 |
在 Gemini CLI 中试一试
用日常语言提出需求即可。这些都是普通句子，不是某种专用语法：
“把 ./renders/teaser.mp4 发布到我们的 Telegram 频道 @ourbrand，附带不超过 1,024 个字符的说明，并置顶且不通知成员。”
这一流程依次调用 render_ad → post_to_telegram → pin_telegram_message → create_telegram_invite_link。Gemini CLI 在运行 shell 命令前会先询问，技能通过 hermoso 命令执行操作，因此每次发布都会显示为一行可读的命令，你可以先看清再确认。对于 MCP 工具，它会提供三个选项：仅这一次允许、对该工具始终允许，或对整个服务器始终允许。
Gemini CLI 在 Telegram 上：真正棘手的部分
调用前先检查文件大小。即使 Hermoso 直接发送文件内容而不是链接，Telegram 对上传视频的限制仍为 50MB（若改用链接则上限为 20MB），较长的渲染可能需要更轻的编码。机器人必须已在频道中以管理员身份拥有“发布消息”权限，若要置顶还需有置顶权限，Telegram 的拒绝提示会指明缺少的是哪一项。
有两个 Gemini CLI 细节决定了这件事有多安全。除非你传入 --scope user，否则 gemini mcp add 会写入项目的 .gemini/settings.json，当一个仓库应该始终对应一个品牌时，这一点很有用。永远不要用 --trust 添加 Hermoso：它会跳过该服务器的所有确认，包括发布前的确认。MCP 工具会以 mcp_hermoso_ 加工具名的形式出现，而 --exclude-tools 可以将其中任何一个完全排除在外。
发布前先调研 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。
Gemini CLI 自己无法完成的事
一个掌握预算的智能体，只有在影响范围有界的情况下才有用，所以这道围栏设在服务器里，而不是提示词里。每个广告系列、广告组、广告分组和广告都以暂停状态创建，而会真正动用资金的状态切换，若没有明确的确认标记就拒绝执行。每次渲染前都会先报价（hermoso_capabilities 会在任何花费发生之前公布每个模型的确切积分成本）。积分在第一次调用服务商之前就会预留，之后按确切成本结算，因此派发失败会退款，而不是让你白白付费。删除操作同样需要确认；并且在智能体告诉你它搭建了什么之前，每个广告系列结构都会从广告平台回读。
有一步是刻意留给你的：通过 @BotFather 创建机器人，并把它添加到你的频道。之后的一切都是工具调用。
其余的矩阵
从 Gemini CLI 发布到： Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky。或查看 Gemini CLI 可发布的全部平台。
从以下工具发布到 Telegram： Claude · ChatGPT · Claude Code · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip
常见问题
Gemini CLI 能发布到 Telegram 吗？
可以，通过 Hermoso 的 Gemini CLI 扩展实现。运行 gemini extensions install https://github.com/hermoso-ai/hermoso，这会添加五个驱动 hermoso 命令的 Hermoso 技能，然后用 npx -y hermoso auth login 登录一次。登录会打开浏览器并自行保存凭证，因此无需创建也无需粘贴任何密钥。如果你还希望在 Gemini CLI 自己的工具列表中看到 Hermoso 的工具，可以运行 gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp 添加托管服务器，它通过 OAuth 登录。之后 Gemini CLI 就拥有 922+ 个工具，包括可以发布到 Telegram 的工具，以及调研你所在市场正在投放的广告并从头渲染创意的工具。
如何将 Telegram 连接到 Gemini CLI？
两个步骤，各做一次。运行 gemini extensions install https://github.com/hermoso-ai/hermoso，这会添加五个驱动 hermoso 命令的 Hermoso 技能，然后用 npx -y hermoso auth login 登录一次。登录会打开浏览器，并由它自行保存凭证，因此无需创建或粘贴任何密钥。如果你还想在 Gemini CLI 自己的工具列表中使用 Hermoso 的工具，运行 gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp 添加托管服务器，它通过 OAuth 登录。然后在 Telegram 中用 @BotFather 创建机器人，把它的令牌粘贴到 Hermoso 的“设置 → 连接器”下，并把机器人添加为频道管理员，授予“发布消息”权限。之后，Gemini CLI 会像普通工具调用一样发布到 Telegram，每次都会指明聊天。
Gemini CLI 能以私密或草稿形式发布到 Telegram 吗？
Bot API 中没有草稿或私密消息。Telegram 的隐私属于聊天本身：发到私密群组或频道，只有其成员能看到。如果你要求的可见性 Telegram 目前无法实现，Hermoso 会在你提出请求的那一刻拒绝，而不是悄悄发布一个权限更低的版本。
Gemini CLI 能在发帖之前研究 Telegram 吗？
没有。Hermoso 没有 Telegram 广告库或频道搜索。它在公共广告库和有机平台上研究创意，而 Telegram 则是发布结果的地方。
从 Gemini CLI 发布到 Telegram 时的文案字数上限是多少？
纯文字的 Telegram 消息最多 4,096 个字符；一旦附加照片或视频，文字就变成说明文字，上限为 1,024 个字符。Hermoso 会说明适用的是哪一个限制。该限制在帖子创建或排队时即执行，因此 Gemini CLI 会立即收到通知，而不是之后在无人关注时才失败。
Gemini CLI 能在发帖之外投放 Telegram 广告吗？
没有。Hermoso 中没有 Telegram 广告。这里的 Telegram 是你通过自己的机器人运营的渠道：发帖、置顶、编辑、邀请链接和订阅者数量。