Wire the bot token into the desktop app. The app launches the bot process and keeps it running while the app is open.
Paste the token
- Open the desktop app → Settings (gear icon).
- In the Telegram section, paste the BotFather token into Telegram Bot Token.
- Click Save.
The token is stored, but the bot does not start yet. Reload the app (quit and reopen it) — the bot process is launched at startup, so it only picks up a new or changed token after a restart.
Verify the connection
Open Telegram, find your bot, send /start. The bot responds with a welcome message and the current active board.
If nothing happens:
- The token might be wrong — re-copy from BotFather and re-paste.
- The desktop app might not have spawned the bot — restart the app.
- Network blocks Telegram — bots use
api.telegram.org. If your network blocks Telegram, the bot cannot connect.
Bot stays alive with the app
The bot process is a child of the desktop app. When you quit the app, the bot disconnects. There is no separate launcher — to keep the bot running, keep the app open.
If you want the bot online 24/7, run the desktop app on a machine that stays on (a Mac mini, a home server, a VPS).
Adding extra bots
You can run more than one bot at the same time. The token at the top is the Default bot — it is the one used for everything automatic (notifications, media the agent sends when you haven’t picked another bot). Extra bots are mainly for connecting different terminals to different chats.
- In Settings → Telegram, below the Default token, click + Add extra TG bots.
- Give the bot a name (e.g.
Bot 1) and paste a separate BotFather token. Each bot needs its own token — you cannot reuse one token for two bots. - Add as many as you need, rename them, or remove one with the × button.
- Click Save and restart the app. Each configured bot starts as its own process.
Once you have extra bots, the bot icon in a board’s terminal toolbar opens a small menu so you can choose which bot that terminal shares with — see Controlling the Terminal. Different terminals can be connected to different bots at the same time.
Each bot keeps its own chat/board state, so linking a chat in one bot does not affect the others. Extra bots are full bots — they respond to all the same commands as the Default bot.
Disconnect
Empty the Telegram Bot Token field in Settings → Save. The bot process stops; the bot stops responding in Telegram. To stop an extra bot, clear its token or remove its row, then Save and restart.
The token itself is deleted from local settings; you would need to re-paste it from BotFather to reconnect.
Leave a Reply