apx-telegram

Configure Telegram bot channels, project pinning, and agent routing for APX.

6|1|Updated May 8, 2026
One-click install
npx skills add https://github.com/agentprojectcontext/apx --skill apx-telegram-agentprojectcontext
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: apx-telegram
Source: https://github.com/agentprojectcontext/apx/tree/main/src/core/runtime-skills/apx-telegram
Command: npx skills add https://github.com/agentprojectcontext/apx --skill apx-telegram-agentprojectcontext

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up Telegram bots in APX is error-prone because credentials only work inside the channels[] array, and routing messages to the right project or agent requires understanding APX's pinning model. This Skill provides the exact config shape, CLI commands, and pitfalls so bots are wired correctly the first time. ## Core Features & Use Cases - Channel management: Add, list, update, and remove Telegram channels with bot tokens, chat IDs, and per-channel project or agent pinning via the apx telegram CLI. - Master agent routing: Route incoming messages on a channel to a specific project agent (e.g., a reviewer or support persona) instead of the default super-agent. - Contacts, roles, and media: Manage a global contact roster with role-based tool gating, and send photos or voice messages through the daemon HTTP API. - Use Case: You run separate bots for a client project and personal notifications. Create two channels, pin the client bot to the acme project with a reviewer agent, and keep the personal bot on the default super-agent. ## Quick Start Ask the agent to add a Telegram channel named clientes with your bot token and chat ID, pinned to the acme project and routed to the reviewer agent.

Frequently Asked Questions about apx-telegram

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a Telegram bot channel in APX?▼

Run apx telegram channel add interactively, or pass flags: apx telegram channel add clientes --bot-token <T> --chat-id <C> --project acme --agent reviewer. Credentials must live in the channels[] array, not at the telegram root.

How do I route Telegram messages to a specific agent?▼

Set route_to_agent on the channel with apx telegram channel set <name> --agent <slug>. Incoming messages are dispatched in-process to that agent using its AGENT.md and memory, with text in and text out and no tools.

Why is my Telegram bot token not working in APX?▼

APX ignores telegram.bot_token and telegram.chat_id written at the config root and drops them on load. Always configure tokens inside channels[] using the apx telegram channel commands, then verify with apx telegram channel show.

Can I run multiple Telegram bots with one APX instance?▼

Yes, channels[] supports multiple bot_token and chat_id pairs, including different bots or the same bot across chats. APX polls each channel in parallel, and project or agent pinning is configured per channel.

Why did my Telegram channel stop auto-replying?▼

The respond_with_engine flag controls auto-replies per channel. If it is set to false, the channel receives messages but never responds; re-enable it with apx telegram channel set <name> --respond-engine true.

How do I send photos or voice messages through APX Telegram?▼

There is no dedicated CLI subcommand for media. POST to the daemon endpoints /api/telegram/send_photo or /api/telegram/send_voice with the daemon token, passing the file path, channel name, and optional caption or duration.