Telegram commands
Send /help to the bot for this list. Anything that is not a command is a question for the
owl (Asking the owl). Commands answer at once and involve no model, except where
the table says.
| Command | What it does |
|---|---|
/status |
The network right now: health, devices answering, the internet, what is open. Instant. |
/audit |
A full audit by the owl, and its digest, now: the dashboard's Audit now. (/check works too.) |
/security |
What is left to decide, from every check, by severity: the Security tab's To decide. |
/updates |
What is waiting to be updated, pending reboots, known vulnerabilities, from the last morning check. |
/backups |
Each machine's last backup on the store, and the next run. |
/sites |
Every site: devices up, the ones down by name, unknown devices on its network. |
/week |
The weekly review, now. Uses the owl for its note. |
/reboot <device> |
Propose a reboot of one device. The proposal, with its Approve button, is the answer. |
/upgrade <machine> |
Propose updating a Linux machine (apt) or a MikroTik (RouterOS). Approve to run it. |
/pause <device> |
No alerts for a device you switched off on purpose; it is still pinged and graphed. Several at once: /pause tv, boiler. |
/resume <device> |
Its alerts back on. /resume all ends every pause. |
/paused |
What is paused, since when, and whether it answers. |
/memory |
The notes the owl keeps. |
/remember <text> |
Add a note, as written. |
/forget <number> |
Delete a note. Several: /forget 3, 5. |
/model |
Whether the owl is on. /model off puts it to sleep (no diagnoses, answers or reviews; alerts and digests go on); /model on wakes it. |
/new |
Start a new conversation. The bot otherwise keeps the last few questions for 6 hours. |
/password |
Set the dashboard's password, when config.yaml has none. The bot asks for it and deletes your message at once. A new one logs every browser out and lifts a lock. |
Naming a device
Commands that take a device accept any part of its name or its address: /pause tv,
/reboot ap porch, /reboot 192.168.88.3. When several devices match, the bot lists them
and asks which. /resume looks among the paused devices first, so /resume shelly finds the
one paused Shelly, not eleven.
The buttons
Proposals arrive with ✅ Approve and ✖️ Reject. Pressing one is the decision: an
approved action is checked against the device again, then runs (or, in shadow mode, is only
recorded), and the same message is edited with what happened. A proposal nobody answers
expires after actions.expire_min minutes and its buttons go away. Only the people in
telegram.chat.allowed_user_ids (by default, the owner of the private chat) can press them.
Edit this page on GitHub.