diff --git a/README.md b/README.md index 348040b17..23b0ba983 100644 --- a/README.md +++ b/README.md @@ -87,6 +87,17 @@ Upgrading? `clawdbot doctor`. If you run from source, prefer `bun run clawdbot …` or `pnpm clawdbot …` (not global `clawdbot`). +## Security defaults (DM access) + +Clawdbot connects to real messaging surfaces. Treat inbound DMs as **untrusted input**. + +Default behavior on Telegram/WhatsApp/Signal/iMessage/Discord/Slack: +- **DM pairing** (`dmPolicy="pairing"` / `discord.dm.policy="pairing"` / `slack.dm.policy="pairing"`): unknown senders receive a short pairing code and the bot does not process their message. +- Approve with: `clawdbot pairing approve --provider ` (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 provider allowlist (`allowFrom` / `discord.dm.allowFrom` / `slack.dm.allowFrom`). + +Run `clawdbot doctor` to surface risky/misconfigured DM policies. + ## Highlights - **[Local-first Gateway](https://github.com/clawdbot/clawdbot/blob/main/docs/gateway.md)** — single control plane for sessions, providers, tools, and events. diff --git a/docs/group-messages.md b/docs/group-messages.md index 85cfe4305..5975b5a71 100644 --- a/docs/group-messages.md +++ b/docs/group-messages.md @@ -52,7 +52,7 @@ Use the group chat command: - `/activation mention` - `/activation always` -Only the owner number (from `whatsapp.allowFrom`, defaulting to the bot’s own E.164 when unset) can change this. `/status` in the group shows the current activation mode. +Only the owner number (from `whatsapp.allowFrom`, or the bot’s own E.164 when unset) can change this. `/status` in the group shows the current activation mode. ## How to use 1) Add Clawd UK (`+447700900123`) to the group. diff --git a/docs/wizard.md b/docs/wizard.md index 883f4e003..a22032b60 100644 --- a/docs/wizard.md +++ b/docs/wizard.md @@ -71,6 +71,7 @@ It does **not** install or change anything on the remote host. - Discord: bot token. - Signal: optional `signal-cli` install + account config. - iMessage: local `imsg` CLI path + DB access. + - DM security: default is pairing (unknown DMs get a pairing code). Approve via `clawdbot pairing approve --provider `. 6) **Daemon install** - macOS: LaunchAgent