refactor: rename clawdbot to moltbot with legacy compat
This commit is contained in:
@@ -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).
|
||||
|
||||
Follow‑up 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 machine‑readable 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 (non‑interactive) 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/`.
|
||||
|
||||
Reference in New Issue
Block a user