refactor: rename clawdbot to moltbot with legacy compat

This commit is contained in:
Peter Steinberger
2026-01-27 12:19:58 +00:00
parent 83460df96f
commit 6d16a658e5
1839 changed files with 11250 additions and 11199 deletions

View File

@@ -7,7 +7,7 @@ read_when:
# Onboarding Wizard (CLI)
The onboarding wizard is the **recommended** way to set up Clawdbot on macOS,
The onboarding wizard is the **recommended** way to set up Moltbot on macOS,
Linux, or Windows (via WSL2; strongly recommended).
It configures a local Gateway or a remote Gateway connection, plus channels, skills,
and workspace defaults in one guided flow.
@@ -15,20 +15,20 @@ and workspace defaults in one guided flow.
Primary entrypoint:
```bash
clawdbot onboard
moltbot onboard
```
Fastest first chat: open the Control UI (no channel setup needed). Run
`clawdbot dashboard` and chat in the browser. Docs: [Dashboard](/web/dashboard).
`moltbot dashboard` and chat in the browser. Docs: [Dashboard](/web/dashboard).
Followup reconfiguration:
```bash
clawdbot configure
moltbot configure
```
Recommended: set up a Brave Search API key so the agent can use `web_search`
(`web_fetch` works without a key). Easiest path: `clawdbot configure --section web`
(`web_fetch` works without a key). Easiest path: `moltbot configure --section web`
which stores `tools.web.search.apiKey`. Docs: [Web tools](/tools/web).
## QuickStart vs Advanced
@@ -62,7 +62,7 @@ It does **not** install or change anything on the remote host.
To add more isolated agents (separate workspace + sessions + auth), use:
```bash
clawdbot agents add <name>
moltbot agents add <name>
```
Tip: `--json` does **not** imply non-interactive mode. Use `--non-interactive` (and `--workspace`) for scripts.
@@ -70,11 +70,11 @@ Tip: `--json` does **not** imply non-interactive mode. Use `--non-interactive` (
## Flow details (local)
1) **Existing config detection**
- If `~/.clawdbot/clawdbot.json` exists, choose **Keep / Modify / Reset**.
- If `~/.clawdbot/moltbot.json` exists, choose **Keep / Modify / Reset**.
- Re-running the wizard does **not** wipe anything unless you explicitly choose **Reset**
(or pass `--reset`).
- If the config is invalid or contains legacy keys, the wizard stops and asks
you to run `clawdbot doctor` before continuing.
you to run `moltbot doctor` before continuing.
- Reset uses `trash` (never `rm`) and offers scopes:
- Config only
- Config + credentials + sessions
@@ -124,7 +124,7 @@ Tip: `--json` does **not** imply non-interactive mode. Use `--non-interactive` (
- Mattermost (plugin): bot token + base URL.
- Signal: optional `signal-cli` install + account config.
- iMessage: local `imsg` CLI path + DB access.
- DM security: default is pairing. First DM sends a code; approve via `clawdbot pairing approve <channel> <code>` or use allowlists.
- DM security: default is pairing. First DM sends a code; approve via `moltbot pairing approve <channel> <code>` or use allowlists.
6) **Daemon install**
- macOS: LaunchAgent
@@ -135,8 +135,8 @@ Tip: `--json` does **not** imply non-interactive mode. Use `--non-interactive` (
- **Runtime selection:** Node (recommended; required for WhatsApp/Telegram). Bun is **not recommended**.
7) **Health check**
- Starts the Gateway (if needed) and runs `clawdbot health`.
- Tip: `clawdbot status --deep` adds gateway health probes to status output (requires a reachable gateway).
- Starts the Gateway (if needed) and runs `moltbot health`.
- Tip: `moltbot status --deep` adds gateway health probes to status output (requires a reachable gateway).
8) **Skills (recommended)**
- Reads the available skills and checks requirements.
@@ -165,7 +165,7 @@ Notes:
## Add another agent
Use `clawdbot agents add <name>` to create a separate agent with its own workspace,
Use `moltbot agents add <name>` to create a separate agent with its own workspace,
sessions, and auth profiles. Running without `--workspace` launches the wizard.
What it sets:
@@ -183,7 +183,7 @@ Notes:
Use `--non-interactive` to automate or script onboarding:
```bash
clawdbot onboard --non-interactive \
moltbot onboard --non-interactive \
--mode local \
--auth-choice apiKey \
--anthropic-api-key "$ANTHROPIC_API_KEY" \
@@ -199,7 +199,7 @@ Add `--json` for a machinereadable summary.
Gemini example:
```bash
clawdbot onboard --non-interactive \
moltbot onboard --non-interactive \
--mode local \
--auth-choice gemini-api-key \
--gemini-api-key "$GEMINI_API_KEY" \
@@ -210,7 +210,7 @@ clawdbot onboard --non-interactive \
Z.AI example:
```bash
clawdbot onboard --non-interactive \
moltbot onboard --non-interactive \
--mode local \
--auth-choice zai-api-key \
--zai-api-key "$ZAI_API_KEY" \
@@ -221,7 +221,7 @@ clawdbot onboard --non-interactive \
Vercel AI Gateway example:
```bash
clawdbot onboard --non-interactive \
moltbot onboard --non-interactive \
--mode local \
--auth-choice ai-gateway-api-key \
--ai-gateway-api-key "$AI_GATEWAY_API_KEY" \
@@ -232,7 +232,7 @@ clawdbot onboard --non-interactive \
Moonshot example:
```bash
clawdbot onboard --non-interactive \
moltbot onboard --non-interactive \
--mode local \
--auth-choice moonshot-api-key \
--moonshot-api-key "$MOONSHOT_API_KEY" \
@@ -243,7 +243,7 @@ clawdbot onboard --non-interactive \
Synthetic example:
```bash
clawdbot onboard --non-interactive \
moltbot onboard --non-interactive \
--mode local \
--auth-choice synthetic-api-key \
--synthetic-api-key "$SYNTHETIC_API_KEY" \
@@ -254,7 +254,7 @@ clawdbot onboard --non-interactive \
OpenCode Zen example:
```bash
clawdbot onboard --non-interactive \
moltbot onboard --non-interactive \
--mode local \
--auth-choice opencode-zen \
--opencode-zen-api-key "$OPENCODE_API_KEY" \
@@ -265,7 +265,7 @@ clawdbot onboard --non-interactive \
Add agent (noninteractive) example:
```bash
clawdbot agents add work \
moltbot agents add work \
--workspace ~/clawd-work \
--model openai/gpt-5.2 \
--bind whatsapp:biz \
@@ -292,7 +292,7 @@ Notes:
## What the wizard writes
Typical fields in `~/.clawdbot/clawdbot.json`:
Typical fields in `~/.clawdbot/moltbot.json`:
- `agents.defaults.workspace`
- `agents.defaults.model` / `models.providers` (if Minimax chosen)
- `gateway.*` (mode, bind, auth, tailscale)
@@ -305,7 +305,7 @@ Typical fields in `~/.clawdbot/clawdbot.json`:
- `wizard.lastRunCommand`
- `wizard.lastRunMode`
`clawdbot agents add` writes `agents.list[]` and optional `bindings`.
`moltbot agents add` writes `agents.list[]` and optional `bindings`.
WhatsApp credentials go under `~/.clawdbot/credentials/whatsapp/<accountId>/`.
Sessions are stored under `~/.clawdbot/agents/<agentId>/sessions/`.