Repository navigation
Inbox: wake a paired cloud agent by its webhook (step 1) - #3138
Merged
Merged
Conversation
Settings → Devices → Cloud agents pairs a Claude Code routine, a Grok Bot
routine or any webhook: a name, the address and the key. The agent is then
a live session in New message's To, and a message or reply to it POSTs its
webhook with the key as Bearer (Claude: { text }; Grok Bot and Other: JSON).
At most one wake per thread per minute, held replies bundled; only a 200 is
started; a timeout is never resent; 5xx retries; 429 waits for Retry-After;
a refused key waits for a new one. The thread says "Woke <name> · run
started" with the run link, or why not. The address and key live only in
inbox/cloud-agents.json (0600) and never reach an answer, event or log.
Claude-Session: https://claude.ai/code/session_01VJ6b1oES3jfkCyDmf8uKzv
Each kind of cloud agent has its own host (cloud-claude, cloud-grok, cloud), so its mark and name follow as every agent's do: a Claude Code routine keeps Claude Code's mark and rig, a Grok Bot routine shows Grok Bot's mark (the x.ai/bot hero mark's paths, eyes as holes), any other webhook the cloud. In the sidebar the Grok Bot mark is a rig whose eyes glance to a side and back every 8 to 20 s, paused off screen and still under reduced motion, as the owner approved. Claude-Session: https://claude.ai/code/session_01VJ6b1oES3jfkCyDmf8uKzv
…agents The shared parts' ib- classes need their rule in the Inbox's own sheet (inbox-thread-css.test.ts), and with phones off Devices now holds Over your tailnet and Cloud agents. Claude-Session: https://claude.ai/code/session_01VJ6b1oES3jfkCyDmf8uKzv
…theme A fixed near-black circle and white eyes on the mark and its sidebar rig, with a thin ring of the text colour at 30% so it holds on dark grounds. Claude-Session: https://claude.ai/code/session_01VJ6b1oES3jfkCyDmf8uKzv
…./inbox-cloud Devices.tsx: main's guest prop on the tailnet block, and the Cloud agents section after it. Claude-Session: https://claude.ai/code/session_01VJ6b1oES3jfkCyDmf8uKzv
Main's guard: every name in INBOX_HOST_NAMES is in INBOX_WAKE_AGENT_NAMES. Claude-Session: https://claude.ai/code/session_01VJ6b1oES3jfkCyDmf8uKzv
Host names and the wake line's name list: main's OpenClaw, then the cloud hosts. Claude-Session: https://claude.ai/code/session_01VJ6b1oES3jfkCyDmf8uKzv
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This is step 1 of "Pair a cloud agent": the one-way wake. The Inbox can now wake a Claude Code routine, a Grok Bot routine, or any other webhook when you write to it. The agent can't post back into the thread yet; that comes in later steps. For now it answers where it works, such as a pull request or its own run.
What you see
Rules
Secrets
inbox/cloud-agents.json(0600).Bun Inbox only. The Inbox has no Pi twin.
The phone's door has no settings route, so a phone cannot pair or test an agent. It can still write to one and sees the same line.
Tests
packages/server/inbox-cloud-wake.test.ts, against a stub webhook on loopback: the request on New message and on a reply, bundling inside the minute, a timeout never resent, 5xx then 429 then started, the key never leaking, and Remove stopping wakes.tests/e2e/inbox-cloud-wake.spec.ts: pair, Send a test, New message, then the Woke line.Marks
https://claude.ai/code/session_01VJ6b1oES3jfkCyDmf8uKzv