Cách kết nối Telegram với Gemini CLI

Hermoso là một máy chủ MCP tiếp thị: hơn 1.000 công cụ trên một endpoint OAuth duy nhất, cho phép một agent nghiên cứu các quảng cáo đang chạy trong một thị trường, tạo quảng cáo hình ảnh và video, đăng chúng, và xây dựng các chiến dịch trả phí phía sau chúng. Gemini CLI truy cập toàn bộ những thứ này qua một kết nối duy nhất. Trang này chỉ đề cập một phần: Gemini CLI thực sự làm được gì trên Telegram, và Telegram không cho phép Gemini CLI làm gì.

Kết nối Hermoso với Gemini CLI

1. Cài tiện ích.

   gemini extensions install https://github.com/hermoso-ai/hermoso

   Lệnh này cài bản phát hành mới nhất của kho mã công khai của Hermoso: năm kỹ năng (research, ad-from-brand, generate, product-photoshoot và marketing) cùng một tệp ngữ cảnh GEMINI.md. Các kỹ năng chạy lệnh hermoso qua npx, nên không có gì được thêm vào danh sách công cụ của Gemini CLI và không tốn ngữ cảnh cho đến khi một lệnh chạy. gemini extensions list hiển thị chúng dưới Agent skills.
2. Đăng nhập một lần.

   npx -y hermoso auth login

   Lệnh này mở đăng nhập trên trình duyệt và lưu một thông tin xác thực chỉ chủ sở hữu mới đọc được vào ~/.hermoso/config.json. Gemini CLI có thể chạy nó giúp bạn lần đầu nó cần Hermoso. Không có trình duyệt trên máy đó? Tạo khóa tại MCP & CLI → Terminal & API keys và chạy npx -y hermoso auth login --token hmk_….
3. Tùy chọn: cả máy chủ MCP.

   gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp

   Gemini CLI tìm máy chủ ủy quyền của Hermoso khi kết nối đầu tiên trả về 401 và tự đăng ký, nên không có khóa nào đi vào settings.json; /mcp auth hermoso trong một phiên sẽ chạy đăng nhập. Các kỹ năng tiếp cận mọi công cụ mà không cần nó.
4. Yêu cầu Gemini CLI làm gì đó. “Lấy những quảng cáo chạy lâu nhất của ba đối thủ gần nhất của tôi và phối lại hook tốt nhất thành video 9:16” hoặc “đăng bản render này lên kênh.” Agent tự chọn công cụ; bạn duyệt khoản chi tiêu.

Chúng tôi đã chạy cài đặt trên vào ngày 2026-09-23 với Gemini CLI 0.60.0 trong một thư mục home sạch: nó kéo bản phát hành hiện tại của hermoso-ai/hermoso, và gemini extensions list báo cáo năm kỹ năng cùng tệp ngữ cảnh. Tiện ích không mang máy chủ MCP riêng, và điều đó là có chủ ý: một danh sách công cụ được nạp vào mọi phiên, còn kỹ năng không tốn gì cho đến khi chạy. Hermoso không liên kết hay được Google tán thành.

Sau đó kết nối chính Telegram, một lần, trong Settings → Connectors của Hermoso bằng cách dán một bot token từ @BotFather, rồi thêm bot đó vào kênh của bạn làm quản trị viên. Không có màn hình đồng ý: token là thông tin xác thực, và bot là bên đăng.

Các công cụ Telegram mà Gemini CLI có

• post_to_telegram: gửi một tin nhắn với tư cách bot của bạn đến chat bạn chỉ định: văn bản tối đa 4,096 ký tự, hoặc một ảnh, một video, hoặc một album từ 2 đến 10 với ảnh và video được trộn lẫn.
• schedule_post: xếp lịch, kèm chatId, trên cùng lịch với mọi kênh khác.
• list_telegram_chats: các chat đã nhắn tin cho bot trong 24 giờ gần nhất. Nó giúp tìm một id, và nó không phải là danh sách mọi chat mà bot đang ở trong đó.
• edit_telegram_message / pin_telegram_message: sửa văn bản hoặc caption của tin nhắn mà không mất lượt xem, và ghim hoặc bỏ ghim lời kêu gọi hành động.
• create_telegram_invite_link: một liên kết mời có tên cho mỗi chiến dịch, với thời hạn, giới hạn thành viên hoặc phê duyệt khi tham gia tùy chọn, để bạn thấy ai tham gia từ đâu.
• telegram_account: số người đăng ký hoặc thành viên của chat, tiêu đề, mô tả và liên kết mời.
• list_telegram_dms: những gì người ta gửi cho bot trong 24 giờ gần nhất, mới nhất trước, để trả lời bằng post_to_telegram.
• delete_telegram_message: xóa một tin nhắn mà bot đã gửi, trong khoảng 48 giờ của Telegram, sau một bước xác nhận.

Telegram kết nối bằng bot token, không phải màn hình đăng nhập. Tạo một bot với @BotFather trong Telegram, dán token tại Workspace → Connectors, rồi thêm bot vào kênh của bạn làm quản trị viên với quyền Post Messages, hoặc vào nhóm làm thành viên có thể đăng. Hermoso đăng với tư cách bot đó, không bao giờ với tư cách bạn. Có hai giới hạn là của Telegram và nên tính trước: một bot không có lượt xem theo từng bài và không có lịch sử bài đăng, nên số người đăng ký và các liên kết mời có tên là những con số bạn có. Tin nhắn gửi cho bot được giữ 24 giờ, rồi mất. Đăng bài không tốn credit.

Các giới hạn của Telegram cần biết trước khi bạn tự động hóa bất cứ thứ gì

Thử trong Gemini CLI

Hãy yêu cầu bằng ngôn ngữ thông thường. Đây là những câu thông thường, không phải DSL:

“Đăng ./renders/teaser.mp4 lên kênh Telegram @ourbrand của chúng tôi với chú thích dưới 1,024 ký tự, và ghim nó mà không thông báo cho thành viên.”

Quy trình gồm render_ad → post_to_telegram → pin_telegram_message → create_telegram_invite_link. Gemini CLI hỏi trước khi chạy một lệnh shell, và các kỹ năng hành động qua lệnh hermoso, nên một lần đăng hiện ra như một dòng bạn có thể đọc trước khi nói đồng ý. Với công cụ MCP, nó đề nghị một lần, luôn luôn cho công cụ đó, hoặc luôn luôn cho máy chủ.

Gemini CLI trên Telegram: phần gây khó khăn

Kiểm tra kích thước tệp trước lệnh gọi. Telegram giới hạn video tải lên ở 50MB ngay cả khi Hermoso gửi byte thay vì liên kết (một liên kết sẽ bị giới hạn 20MB), và một bản render dài hơn có thể cần mã hóa nhẹ hơn. Bot phải đã là quản trị viên với quyền Post Messages trong kênh, cộng quyền ghim để ghim, và thông báo từ chối của Telegram nêu tên quyền nào đang thiếu.

Hai chi tiết của Gemini CLI quyết định mức độ an toàn của việc này. gemini mcp add ghi vào .gemini/settings.json của dự án trừ khi bạn truyền --scope user, điều này hữu ích khi một repo luôn nên chạy với một thương hiệu. Và đừng bao giờ thêm Hermoso với --trust: nó bỏ qua mọi xác nhận của máy chủ, kể cả những xác nhận trước một lần đăng. Công cụ MCP đến với tên mcp_hermoso_ cộng tên công cụ, và --exclude-tools giữ bất kỳ công cụ nào ngoài hoàn toàn.

Nghiên cứu Telegram trước khi đăng

Không có thư viện quảng cáo Telegram và không có tìm kiếm kênh trong Hermoso, nên nó không đưa ra tuyên bố nghiên cứu đối thủ trên Telegram. Hãy nghiên cứu creative ở nơi nó công khai (các thư viện quảng cáo Meta, Google và LinkedIn cùng TikTok tự nhiên, Instagram, YouTube, Reddit và Threads) rồi đăng quảng cáo đúng thương hiệu ở đây.

Phần trả phí

Không có quảng cáo Telegram trong Hermoso, và chúng tôi không ngụ ý có. Telegram ở đây là một kênh bạn sở hữu và vận hành qua bot của bạn: đăng, ghim, sửa, đếm người đăng ký và theo dõi lượt mời. Các công cụ trả phí bao phủ Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads và AppLovin Ads.

Những gì Gemini CLI không tự làm được

Một agent có ngân sách chỉ hữu ích khi bán kính ảnh hưởng được giới hạn, nên hàng rào nằm trong máy chủ chứ không nằm trong prompt. Mọi chiến dịch, ad set, ad group và quảng cáo đều được tạo ở trạng thái tạm dừng, và các lệnh đổi trạng thái khiến tiền thật chạy sẽ từ chối nếu không có cờ xác nhận rõ ràng. Mọi bản render đều được báo giá trước (hermoso_capabilities công bố chi phí credit chính xác của từng mô hình trước khi có bất kỳ khoản nào được chi). Credit được giữ trước lệnh gọi nhà cung cấp đầu tiên và quyết toán theo chi phí chính xác sau đó, nên một lần gửi thất bại sẽ được hoàn lại thay vì để bạn bị tính phí cho không có gì. Thao tác xóa cũng cần xác nhận, và mọi cây chiến dịch đều được đọc lại từ nền tảng quảng cáo trước khi agent của bạn cho bạn biết nó đã dựng gì.

Một bước hoàn toàn thuộc về bạn: tạo bot với @BotFather và thêm nó vào kênh của bạn. Mọi thứ sau đó là lệnh gọi công cụ.

Phần còn lại của ma trận

Từ Gemini CLI, đăng lên: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky. Hoặc xem mọi nền tảng Gemini CLI có thể đăng lên.

Đăng lên Telegram từ: Claude · ChatGPT · Claude Code · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip

Câu hỏi thường gặp

Gemini CLI có thể đăng lên Telegram không?

Có, với tiện ích Gemini CLI của Hermoso. Chạy gemini extensions install https://github.com/hermoso-ai/hermoso, lệnh này cài các kỹ năng điều khiển lệnh hermoso, rồi đăng nhập một lần bằng npx -y hermoso auth login. Đăng nhập sẽ mở trình duyệt và tự lưu thông tin xác thực, nên không cần tạo hay dán khóa nào. Nếu bạn cũng muốn công cụ của Hermoso có trong danh sách công cụ của Gemini CLI, chạy gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp để thêm máy chủ được lưu trữ, máy chủ này đăng nhập bằng OAuth. Khi đó Gemini CLI có 1.000+ công cụ, bao gồm các công cụ đăng lên Telegram, cùng những công cụ nghiên cứu quảng cáo đang chạy trên thị trường của bạn và dựng creative ngay từ đầu.

Làm sao để kết nối Telegram với Gemini CLI?

Hai bước, mỗi bước chỉ làm một lần. Chạy gemini extensions install https://github.com/hermoso-ai/hermoso, lệnh này cài năm kỹ năng điều khiển lệnh hermoso, rồi đăng nhập một lần bằng npx -y hermoso auth login. Đăng nhập sẽ mở trình duyệt và tự lưu thông tin xác thực, nên không cần tạo hay dán khóa nào. Nếu bạn cũng muốn công cụ của Hermoso có trong danh sách công cụ của Gemini CLI, chạy gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp để thêm máy chủ được lưu trữ, máy chủ này đăng nhập bằng OAuth. Sau đó tạo một bot với @BotFather trong Telegram, dán token của nó vào Workspace → Connectors trong Hermoso, và thêm bot vào kênh của bạn làm quản trị viên với quyền Post Messages. Sau bước đó, Gemini CLI đăng lên Telegram như một lệnh gọi công cụ thông thường, nêu tên cuộc trò chuyện mỗi lần.

Gemini CLI có thể đăng riêng tư hoặc dưới dạng bản nháp lên Telegram không?

Không có bản nháp hay tin nhắn riêng tư trong Bot API. Quyền riêng tư trên Telegram thuộc về chat: đăng vào một nhóm hoặc kênh riêng tư thì chỉ thành viên của nó mới thấy. Hermoso từ chối một quyền hiển thị mà Telegram không thể đáp ứng ngay tại thời điểm bạn yêu cầu, thay vì âm thầm đăng một thứ kém hơn.

Gemini CLI có thể nghiên cứu Telegram trước khi đăng không?

Không. Hermoso không có thư viện quảng cáo Telegram hay tìm kiếm kênh. Nó nghiên cứu creative trên các thư viện quảng cáo công khai và các nền tảng tự nhiên, còn Telegram là nơi bạn đăng kết quả.

Giới hạn caption khi đăng Telegram từ Gemini CLI là bao nhiêu?

Một tin nhắn Telegram chỉ có văn bản dài tới 4,096 ký tự; khi đã đính kèm ảnh hoặc video, văn bản trở thành caption và giới hạn là 1,024. Hermoso nói rõ giới hạn nào được áp dụng. Hermoso kiểm tra khi bài được tạo hoặc xếp hàng, nên Gemini CLI được báo ngay thay vì thất bại sau đó khi không ai theo dõi.

Gemini CLI có thể chạy quảng cáo Telegram ngoài việc đăng bài không?

Không. Không có quảng cáo Telegram trong Hermoso. Telegram ở đây là một kênh bạn vận hành qua bot riêng của mình: đăng bài, ghim, sửa, liên kết mời và số người đăng ký.