Yorozu

Yorozu is an end-to-end-encrypted chat channel for OpenClaw: a native app for iPhone, iPad and Mac that talks to your own OpenClaw agent. OpenClaw runs the agent, sessions, memory and cron; Yorozu only carries messages.

Components

• plugins/openclaw-yorozu: the TypeScript channel plugin inside the OpenClaw Gateway. Holds the host keys and connects out to the relay.
• apps/relay: the relay, a Cloudflare Worker that passes sealed frames between plugin and devices and sends push.
• apps/ios: the SwiftUI client for iPhone, iPad and Mac (Tuist project).
• packages/YorozuWire: the shared Swift wire package.
• apps/mcp: a read-only help MCP server for AI agents (docs/help-mcp.md).
• apps/web: the website, yorozu.yumi.to (Astro on Cloudflare): pnpm --filter @yorozu/web dev|build|test; deploys on merge (deploy-web.yml).

Install

openclaw plugins install --link plugins/openclaw-yorozu --force --accept-capabilities
openclaw gateway restart
openclaw yorozu pair          # scan the QR, or paste the link, in the app

Full steps, config keys and troubleshooting: docs/setup.md.

Build

mise install                                     # Tuist, pinned in mise.toml
swift build --package-path packages/YorozuWire   # the wire package
scripts/build_native.sh [--restart]              # the Mac app, into /Applications/Yorozu.app
pnpm install && pnpm --filter @yorozu/relay test # the relay's typecheck and tests

Compile checks, releases and CI: docs/release.md.

Docs

• Status
• Architecture
• Setup
• Release
• Plugin reference
• Help MCP server: lets an AI agent answer Yorozu setup and usage questions
• OpenClaw channel SDK facts
• Wire contract
• Owner decisions
• Working rules

License

MIT, see LICENSE.