Skip to main content
The Telegram plugin (nagare.plugin.builtins.telegram) lets you chat with Nagare from the Telegram app, receive cron job results, and approve tools when you are away from your computer.

​
Setup

1

Create a Telegram bot

Chat with @BotFather, use the /newbot command, and save the bot token.
2

Set the environment variable for the gateway

The plugin reads the token from the NAGARE_TELEGRAM_TOKEN variable. The plugin inherits the gateway’s environment, so set this variable before starting the gateway:
3

Install the plugin

The plugin package is pre-installed at:
Go to Settings → Plugins → Install Plugin:
  • On the web UI: upload the .nagare_plugin file above.
  • On the desktop app: enter the absolute path to the file.
Then activate the plugin. See Plugin Overview.
4

Start chatting

Open the bot on Telegram and send /start.

​
Commands

Any other text message is forwarded to Nagare as a normal chat message.

​
Tool approval

When Nagare needs to run a risky tool, the bot sends a message with two buttons Approve and Reject. You can also use the /approve or /reject command with the request ID.

​
Notes

The plugin does not restrict which Telegram users are allowed to chat. Anyone who finds the bot can send requests to Nagare on your machine. Keep the bot name secret and always read approval requests carefully before accepting.
  • The bot uses long polling, so no port opening or webhook configuration is needed.
  • If the conversation is inactive for 2 hours, the channel is released; the next message will reconnect automatically.
  • Plugin logs are at ~/.nagare/logs/plugins/nagare.plugin.builtins.telegram.log.