# 🦞 Clawdbot — Personal AI Assistant

# 🦞 Moltbot — Personal AI Assistant

<p align="center">

<img src="https://raw.githubusercontent.com/clawdbot/clawdbot/main/docs/whatsapp-clawd.jpg" alt="Clawdbot" width="400">

<img src="https://raw.githubusercontent.com/moltbot/moltbot/main/docs/whatsapp-clawd.jpg" alt="Clawdbot" width="400">

</p>

<p align="center">

<strong>EXFOLIATE! EXFOLIATE!</strong>

</p>

<p align="center">

<a href="https://github.com/clawdbot/clawdbot/actions/workflows/ci.yml?branch=main"><img src="https://img.shields.io/github/actions/workflow/status/clawdbot/clawdbot/ci.yml?branch=main&style=for-the-badge" alt="CI status"></a>

<a href="https://github.com/clawdbot/clawdbot/releases"><img src="https://img.shields.io/github/v/release/clawdbot/clawdbot?include_prereleases&style=for-the-badge" alt="GitHub release"></a>

<a href="https://deepwiki.com/clawdbot/clawdbot"><img src="https://img.shields.io/badge/DeepWiki-clawdbot-111111?style=for-the-badge" alt="DeepWiki"></a>

<a href="https://github.com/moltbot/moltbot/actions/workflows/ci.yml?branch=main"><img src="https://img.shields.io/github/actions/workflow/status/moltbot/moltbot/ci.yml?branch=main&style=for-the-badge" alt="CI status"></a>

<a href="https://github.com/moltbot/moltbot/releases"><img src="https://img.shields.io/github/v/release/moltbot/moltbot?include_prereleases&style=for-the-badge" alt="GitHub release"></a>

<a href="https://deepwiki.com/moltbot/moltbot"><img src="https://img.shields.io/badge/DeepWiki-moltbot-111111?style=for-the-badge" alt="DeepWiki"></a>

<a href="https://discord.gg/clawd"><img src="https://img.shields.io/discord/1456350064065904867?label=Discord&logo=discord&logoColor=white&color=5865F2&style=for-the-badge" alt="Discord"></a>

<a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="MIT License"></a>

</p>

**Clawdbot** is a *personal AI assistant* you run on your own devices.

**Moltbot** is a *personal AI assistant* you run on your own devices.

It answers you on the channels you already use (WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, iMessage, Microsoft Teams, WebChat), plus extension channels like BlueBubbles, Matrix, Zalo, and Zalo Personal. It can speak and listen on macOS/iOS/Android, and can render a live Canvas you control. The Gateway is just the control plane — the product is the assistant.

If you want a personal, single-user assistant that feels local, fast, and always-on, this is it.

[Website](https://molt.bot) · [Docs](https://docs.molt.bot) · [Getting Started](https://docs.molt.bot/start/getting-started) · [Updating](https://docs.molt.bot/install/updating) · [Showcase](https://docs.molt.bot/start/showcase) · [FAQ](https://docs.molt.bot/start/faq) · [Wizard](https://docs.molt.bot/start/wizard) · [Nix](https://github.com/clawdbot/nix-clawdbot) · [Docker](https://docs.molt.bot/install/docker) · [Discord](https://discord.gg/clawd)

[Website](https://molt.bot) · [Docs](https://docs.molt.bot) · [Getting Started](https://docs.molt.bot/start/getting-started) · [Updating](https://docs.molt.bot/install/updating) · [Showcase](https://docs.molt.bot/start/showcase) · [FAQ](https://docs.molt.bot/start/faq) · [Wizard](https://docs.molt.bot/start/wizard) · [Nix](https://github.com/moltbot/nix-clawdbot) · [Docker](https://docs.molt.bot/install/docker) · [Discord](https://discord.gg/clawd)

Preferred setup: run the onboarding wizard (`clawdbot onboard`). It walks through gateway, workspace, channels, and skills. The CLI wizard is the recommended path and works on **macOS, Linux, and Windows (via WSL2; strongly recommended)**.

Preferred setup: run the onboarding wizard (`moltbot onboard`). It walks through gateway, workspace, channels, and skills. The CLI wizard is the recommended path and works on **macOS, Linux, and Windows (via WSL2; strongly recommended)**.

Works with npm, pnpm, or bun.

New install? Start here: [Getting started](https://docs.molt.bot/start/getting-started)

- **beta**: prerelease tags (`vYYYY.M.D-beta.N`), npm dist-tag `beta` (macOS app may be missing).

- **dev**: moving head of `main`, npm dist-tag `dev` (when published).

Switch channels (git + npm): `clawdbot update --channel stable|beta|dev`.

Switch channels (git + npm): `moltbot update --channel stable|beta|dev`.

Details: [Development channels](https://docs.molt.bot/install/development-channels).

## From source (development)

Prefer `pnpm` for builds from source. Bun is optional for running TypeScript directly.

```bash

git clone https://github.com/clawdbot/clawdbot.git

cd clawdbot

git clone https://github.com/moltbot/moltbot.git

cd moltbot

pnpm install

pnpm ui:build # auto-installs UI deps on first run

## Security defaults (DM access)

Clawdbot connects to real messaging surfaces. Treat inbound DMs as **untrusted input**.

Moltbot connects to real messaging surfaces. Treat inbound DMs as **untrusted input**.

Full security guide: [Security](https://docs.molt.bot/gateway/security)

Default behavior on Telegram/WhatsApp/Signal/iMessage/Microsoft Teams/Discord/Google Chat/Slack:

- **DM pairing** (`dmPolicy="pairing"` / `channels.discord.dm.policy="pairing"` / `channels.slack.dm.policy="pairing"`): unknown senders receive a short pairing code and the bot does not process their message.

- Approve with: `clawdbot pairing approve <channel> <code>` (then the sender is added to a local allowlist store).

- Approve with: `moltbot pairing approve <channel> <code>` (then the sender is added to a local allowlist store).

- Public inbound DMs require an explicit opt-in: set `dmPolicy="open"` and include `"*"` in the channel allowlist (`allowFrom` / `channels.discord.dm.allowFrom` / `channels.slack.dm.allowFrom`).

Run `clawdbot doctor` to surface risky/misconfigured DM policies.

Run `moltbot doctor` to surface risky/misconfigured DM policies.

## Highlights

## Star History

[](https://www.star-history.com/#clawdbot/clawdbot&type=date&legend=top-left)

[](https://www.star-history.com/#moltbot/moltbot&type=date&legend=top-left)

## Everything we built so far

- [macOS node mode](https://docs.molt.bot/nodes): system.run/notify + canvas/camera exposure.

### Tools + automation

- [Browser control](https://docs.molt.bot/tools/browser): dedicated clawd Chrome/Chromium, snapshots, actions, uploads, profiles.

- [Browser control](https://docs.molt.bot/tools/browser): dedicated moltbot Chrome/Chromium, snapshots, actions, uploads, profiles.

- [Canvas](https://docs.molt.bot/platforms/mac/canvas): [A2UI](https://docs.molt.bot/platforms/mac/canvas#canvas-a2ui) push/reset, eval, snapshot.

- [Nodes](https://docs.molt.bot/nodes): camera snap/clip, screen record, [location.get](https://docs.molt.bot/nodes/location-command), notifications.

- [Cron + wakeups](https://docs.molt.bot/automation/cron-jobs); [webhooks](https://docs.molt.bot/automation/webhook); [Gmail Pub/Sub](https://docs.molt.bot/automation/gmail-pubsub).

└──────────────┬────────────────┘

│

├─ Pi agent (RPC)

├─ CLI (clawdbot …)

├─ CLI (moltbot …)

├─ WebChat UI

├─ macOS app

└─ iOS / Android nodes

- **[Gateway WebSocket network](https://docs.molt.bot/concepts/architecture)** — single WS control plane for clients, tools, and events (plus ops: [Gateway runbook](https://docs.molt.bot/gateway)).

- **[Tailscale exposure](https://docs.molt.bot/gateway/tailscale)** — Serve/Funnel for the Gateway dashboard + WS (remote access: [Remote](https://docs.molt.bot/gateway/remote)).

- **[Browser control](https://docs.molt.bot/tools/browser)** — clawd‑managed Chrome/Chromium with CDP control.

- **[Browser control](https://docs.molt.bot/tools/browser)** — moltbot‑managed Chrome/Chromium with CDP control.

- **[Canvas + A2UI](https://docs.molt.bot/platforms/mac/canvas)** — agent‑driven visual workspace (A2UI host: [Canvas/A2UI](https://docs.molt.bot/platforms/mac/canvas#canvas-a2ui)).

- **[Voice Wake](https://docs.molt.bot/nodes/voicewake) + [Talk Mode](https://docs.molt.bot/nodes/talk)** — always‑on speech and continuous conversation.

- **[Nodes](https://docs.molt.bot/nodes)** — Canvas, camera snap/clip, screen record, `location.get`, notifications, plus macOS‑only `system.run`/`system.notify`.

## Tailscale access (Gateway dashboard)

Clawdbot can auto-configure Tailscale **Serve** (tailnet-only) or **Funnel** (public) while the Gateway stays bound to loopback. Configure `gateway.tailscale.mode`:

Moltbot can auto-configure Tailscale **Serve** (tailnet-only) or **Funnel** (public) while the Gateway stays bound to loopback. Configure `gateway.tailscale.mode`:

- `off`: no Tailscale automation (default).

- `serve`: tailnet-only HTTPS via `tailscale serve` (uses Tailscale identity headers by default).

- `funnel`: public HTTPS via `tailscale funnel` (requires shared password auth).

Notes:

- `gateway.bind` must stay `loopback` when Serve/Funnel is enabled (Clawdbot enforces this).

- `gateway.bind` must stay `loopback` when Serve/Funnel is enabled (Moltbot enforces this).

- Serve can be forced to require a password by setting `gateway.auth.mode: "password"` or `gateway.auth.allowTailscale: false`.

- Funnel refuses to start unless `gateway.auth.mode: "password"` is set.

- Optional: `gateway.tailscale.resetOnExit` to undo Serve/Funnel on shutdown.

If you plan to build/run companion apps, follow the platform runbooks below.

### macOS (Clawdbot.app) (optional)

### macOS (Moltbot.app) (optional)

- Menu bar control for the Gateway and health.

- Voice Wake + push-to-talk overlay.

- Pairs as a node via the Bridge.

- Voice trigger forwarding + Canvas surface.

- Controlled via `clawdbot nodes …`.

- Controlled via `moltbot nodes …`.

Runbook: [iOS connect](https://docs.molt.bot/platforms/ios).

## Configuration

Minimal `~/.clawdbot/clawdbot.json` (model + defaults):

Minimal `~/.clawdbot/moltbot.json` (model + defaults):

```json5

{

### [WhatsApp](https://docs.molt.bot/channels/whatsapp)

- Link the device: `pnpm clawdbot channels login` (stores creds in `~/.clawdbot/credentials`).

- Link the device: `pnpm moltbot channels login` (stores creds in `~/.clawdbot/credentials`).

- Allowlist who can talk to the assistant via `channels.whatsapp.allowFrom`.

- If `channels.whatsapp.groups` is set, it becomes a group allowlist; include `"*"` to allow all.

- [docs.molt.bot/gmail-pubsub](https://docs.molt.bot/automation/gmail-pubsub)

## Clawd

## Molty

Clawdbot was built for **Clawd**, a space lobster AI assistant. 🦞

Moltbot was built for **Molty**, a space lobster AI assistant. 🦞

by Peter Steinberger and the community.

- [clawd.me](https://clawd.me)

- [soul.md](https://soul.md)

- [steipete.me](https://steipete.me)

- [@moltbot](https://x.com/moltbot)

## Community