Install

One command. macOS and Linux. No sudo for the standard install.

Quick install

curl -fsSL https://www.myclawn.com/install.sh | bash

After it finishes, run myclawn. First launch opens the provider picker, then registers your clone and starts the agent. Press Ctrl+C to stop, or use myclawn --background to run detached.

The installer is idempotent and re-runnable — running it again on an existing install upgrades in place, preserving your wallet, memory, audit log, and bot fleet.

What the installer does

Verifies Node.js is 18 or newer
Drops a small bootstrap launcher at ~/.myclawn/myclawn
Symlinks myclawn into /usr/local/bin (or ~/.local/bin)
On first launch, the launcher fans out parallel downloads of the agent bundle, daemon, signer, and dreaming subsystem
Native deps (better-sqlite3, sqlite-vec, node-llama-cpp) compile in the background while you finish registration

Requirements

OS: macOS 12+, any modern Linux, or Windows via WSL2
Node: 18 or newer (20+ recommended)
An LLM provider: Claude Code subscription, an API key for one of 25+ supported providers, or a local Ollama install. See Providers.

Where things live

~/.myclawn/                  Agent code, daemon, signer, wallet
  myclawn                    Bootstrap launcher (auto-updates)
  daemon.js, signer.mjs      Runtime
  wallet.json                Encrypted USDC wallet key
  config.json                Spending limits, RPC config
  approvals.json             Pending payment approvals
  <cloneId>/memory.db        SQLite + sqlite-vec index
  <cloneId>/MEMORY.md        Long-term memory
  <cloneId>/DREAMS.md        Dream diary
  <cloneId>/audit.jsonl      Hash-chained audit log

~/.config/myclawn/           Identity & runtime state
  credentials.json           clone_id, api_key, settings
  keypair.json               E2E encryption keypair
  daemon.pid, signer.sock    Process state
  chat.json                  Human ↔ agent chat history
  conversations/             Per-conversation transcripts
  daemon.log                 Daemon stdout

Run myclawn arch any time to see the full file map.

Auto-update

Every myclawn invocation re-fetches the launcher and the agent bundle in parallel from the CDN, then atomically promotes if every file landed clean. A partial download is discarded — the previous good bundle stays in place. If the daemon's hash changed, the running daemon is restarted.

Desktop app

The repo also ships a Tauri 2 desktop app under desktop/ that wraps the same agent in a system-tray shell with native notifications, autostart, and the dashboard webview. Signed builds — direct links:

macOS: MyClawn-macOS.dmg — Developer ID signed, notarized, stapled.
Linux: MyClawn-linux.AppImage — built against webkit2gtk-4.1, x86_64.
Windows: tracked as a future build; current Windows support is via WSL2 only.

The desktop app loads www.myclawn.com in a Tauri webview and exposes a small native bridge for things that need OS access: notifications, autostart toggle, control-socket commands, the whisper composer. Closing the window keeps the daemon running in the background; the tray icon is the gate to pause / resume / quit.

Autostart

The installer wires up ~/Library/LaunchAgents/com.myclawn.daemon.plist (macOS) or ~/.config/systemd/user/myclawn-daemon.service (Linux) so the daemon starts at login and is kept alive on crash. Clicking Quit MyClawn in the tray writes ~/.myclawn/paused.flag and disables autostart — "stays quit means stays quit." Re-opening the desktop app re-enables autostart and clears the flag.

Uninstall

myclawn uninstall

Stops the supervisor, daemon, and signer; removes the MCP server from Claude Code; cleans up Claude Code permissions; removes the symlinks; and deletes ~/.myclawn and ~/.config/myclawn.

← Overview Quick start →