Grok Bot

Grok Bot pairs with your Inbox from Settings and answers in its threads from the cloud. Your reply starts a run of its routine through the routine’s webhook.

Cloud agents · Paired in Settings → Cloud agents and reached through the relay

Set it up

Install Plannotator 0.28.63 or newer on your computer. The same command updates an older one.

curl -fsSL https://plannotator.ai/install.sh | bash
Open the Inbox. In Settings → Cloud agents press Pair a cloud agent, pick Grok Bot and give it a name.

plannotator inbox

You should see One message to copy, under the name you gave it. It is shown only this once.
Copy the message and send it to Grok Bot.

You should see Grok Bot installs plannotator, keeps the pairing and tells you it is connected. Settings shows Connected · last seen and when.
Grok Bot adds a webhook to its routine and asks you for it. Open the routine in the Grok Bot desktop app, Webhook section. In Settings → Cloud agents press Add wake address and paste POST to and the key.

You should see Send a test answers A run started. See Grok Bot's chat.
In Grok Bot open Settings → General → Auto-review and under Custom Rules add an Allow automatically rule for running plannotator inbox call in this routine. Without it a woken run stops and waits for your approval.

Other ways

Without a webhook

Leave the wake address empty. Grok Bot sets up a schedule that starts it, for example every 5 minutes, and answers when you wrote. Your message waits until its next run.

Check it works

Write to it from New message in the Inbox. To lists it by the name you gave it.

You should see Under your message the thread reads Woke … · run started · see Grok Bot's chat, and Grok Bot answers in the same thread.

Troubleshooting

Settings has no Cloud agents: It appears once this computer has reached the relay. Check that the computer is online and open Settings again.
Grok Bot says it couldn’t connect: It names a code. invalid_pairing: the pairing was cut off, so press New pairing and send the new message whole. pairing_removed or pairing_without_relay: press New pairing and send the new message. relay_unreachable: the network it runs on blocks the relay’s host. computer_asleep: your computer is asleep or offline, and the setup is fine.
A woken run stops and waits for approval: Add the Auto-review rule from step 5. Some versions show it under Settings → General → Bot → Auto-review.
Your message waits until Grok Bot’s next run: It has no wake address, so it sees your message when its schedule next starts it. Add the routine’s webhook in Settings → Cloud agents.
The thread says … refused its key. Nothing was started.: The routine’s key changed. Paste the new key where Settings asks for it. Your waiting replies go when you save it.
The thread says … is at its hourly limit: The routine refused more runs for now. The Inbox wakes it again at the time the line shows.
The thread says … did not answer in time: The webhook gave no answer in 15 seconds. A run may have started, so the Inbox doesn’t send it again.
The Inbox doesn’t open: Read ~/.plannotator/inbox/inbox.log. Stop a stuck Inbox process and run plannotator inbox again.

What works

Inbox tool Through the relay
Reply wakes it With a webhook
Start from Inbox No
Permission cards No

Plan review No
Code review No
Annotate No
Ask this session No

A thread wakes Grok Bot at most once a minute. Replies inside that minute go together, oldest first.
Files you attach in the Inbox don’t reach Grok Bot. A wake says how many there are.
Grok Bot reads only the threads you give it.
Your computer must be awake for Grok Bot to read. What it sends while the computer sleeps is posted when it is back, within 30 days.

Examples

Write to Grok Bot from New message in the Inbox. Its routine wakes and answers in the thread.
Ask Grok Bot to send you a question with options and pick one in the Inbox.

Every agent