Skip to content

Repository files navigation

ClawDeck 🦞

Your own private AI assistant, running entirely on your Mac — no cloud, no subscription, no one else's servers.

ClawDeck is a setup wizard + dashboard for NanoClaw, a self-hosted AI assistant. Point it at your machine, click through a five-step wizard, and you have a real assistant reachable on Telegram (or Discord), running in an isolated container on hardware you own — never a terminal, never a config file.

Status: early build. ClawDeck works end-to-end today, but it hasn't had a packaged public release yet — see Getting it below for where things currently stand.

Why local

Your assistant can read files and run tasks you give it, so it needs real access to do useful work. Instead of trusting that to someone else's cloud, ClawDeck runs the whole thing — the assistant, its memory, its container sandbox — on your own Mac. Nothing is exposed to the internet unless you explicitly connect a channel (Telegram, Discord) or your own Tailscale network for remote access from another device you own.

What it does

  • Guided setup — a five-step wizard (Welcome → System check → Connect your AI → Connect Telegram → Finish) gets a working assistant running without ever touching a terminal, including one-click installers for the runtimes it needs (Docker, pnpm) where that's possible.
  • Multi-bot — one root assistant plus specialist branches it can hand work off to, managed from a tree view.
  • Real chat, real transcripts — the dashboard's Chat tab renders the assistant's actual Claude Code session (markdown, tool calls, file diffs), not a flattened log.
  • Folder access — give a bot read/write access to a specific folder on your Mac, sandboxed through NanoClaw's own mount allowlist.
  • GitHub push — connect a fine-grained personal access token once; tell a bot what to push to in plain chat.
  • Remote access — reach your own dashboard from another device on your Tailscale network (a phone, a laptop) without opening anything to the public internet.

Requirements

  • A Mac running macOS 13 (Ventura) or later.
  • Intel or Apple Silicon — ClawDeck ships as a universal binary. (Note: Apple Silicon hasn't been verified on real hardware yet as of this build; see the project's own tracking notes if that matters for your use case.)
  • Docker Desktop — the wizard's System Check step detects this and, where possible, offers a one-click install.

Getting it

A signed, notarized release isn't available yet — ClawDeck ships unsigned for now (no Apple Developer Program enrollment), so macOS's Gatekeeper will flag it on first open. That's expected, not a sign anything's broken:

  1. Download ClawDeck-<version>-universal.dmg, open it, drag ClawDeck to Applications.
  2. Right-click ClawDeck.app in Applications → Open → confirm in the dialog that appears. (A plain double-click will refuse to open it the first time — this is the one extra step an unsigned app requires, only needed once.)
  3. Follow the setup wizard.

Until there's a packaged release published, building from source is the way to run this:

git clone https://github.com/RobbieKaras/clawdeck.git
cd clawdeck/electron
npm install
npm start          # runs the app directly
# or:
npm run build       # produces a real .app / .dmg via electron-builder

How it's built

  • app/ — the actual product: an Express server + a single-page dashboard (app/public/index.html). This is what ClawDeck has always been, and it runs standalone with plain node server.js if you'd rather skip Electron entirely.
  • electron/ — a thin native macOS shell around app/. It makes sure the dashboard is installed and running as a persistent background service (so closing the window never stops your bots), and gives it a real Dock icon, menu-bar tray, and native window instead of a browser tab.
  • ClawDeck doesn't fork NanoClaw — it wraps it, keeping any required patches as a thin, documented, re-appliable overlay so upgrades stay possible.

Privacy

No account, no signup, no ClawDeck-run servers of any kind. Your Anthropic/API keys and any connected secrets live in NanoClaw's own local vault. The dashboard itself has no authentication — it's designed for one person, on their own machine, and is explicitly not meant to be exposed beyond a private Tailscale network.

License

MIT

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages