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

@@ -9,11 +9,11 @@ read_when:
Goal: go from **zero****first working chat** (with sane defaults) as quickly as possible.
Fastest chat: open the Control UI (no channel setup needed). Run `clawdbot dashboard`
Fastest chat: open the Control UI (no channel setup needed). Run `moltbot dashboard`
and chat in the browser, or open `http://127.0.0.1:18789/` on the gateway host.
Docs: [Dashboard](/web/dashboard) and [Control UI](/web/control-ui).
Recommended path: use the **CLI onboarding wizard** (`clawdbot onboard`). It sets up:
Recommended path: use the **CLI onboarding wizard** (`moltbot onboard`). It sets up:
- model/auth (OAuth recommended)
- gateway settings
- channels (WhatsApp/Telegram/Discord/Mattermost (plugin)/...)
@@ -45,7 +45,7 @@ run on host, set an explicit per-agent override:
- Node `>=22`
- `pnpm` (optional; recommended if you build from source)
- **Recommended:** Brave Search API key for web search. Easiest path:
`clawdbot configure --section web` (stores `tools.web.search.apiKey`).
`moltbot configure --section web` (stores `tools.web.search.apiKey`).
See [Web tools](/tools/web).
macOS: if you plan to build the apps, install Xcode / CLT. For the CLI + gateway only, Node is enough.
@@ -68,17 +68,17 @@ iwr -useb https://molt.bot/install.ps1 | iex
Alternative (global install):
```bash
npm install -g clawdbot@latest
npm install -g moltbot@latest
```
```bash
pnpm add -g clawdbot@latest
pnpm add -g moltbot@latest
```
## 2) Run the onboarding wizard (and install the service)
```bash
clawdbot onboard --install-daemon
moltbot onboard --install-daemon
```
What youll choose:
@@ -105,13 +105,13 @@ Headless/server tip: do OAuth on a normal machine first, then copy `oauth.json`
If you installed the service during onboarding, the Gateway should already be running:
```bash
clawdbot gateway status
moltbot gateway status
```
Manual run (foreground):
```bash
clawdbot gateway --port 18789 --verbose
moltbot gateway --port 18789 --verbose
```
Dashboard (local loopback): `http://127.0.0.1:18789/`
@@ -123,9 +123,9 @@ channels. If you use WhatsApp or Telegram, run the Gateway with **Node**.
## 3.5) Quick verify (2 min)
```bash
clawdbot status
clawdbot health
clawdbot security audit --deep
moltbot status
moltbot health
moltbot security audit --deep
```
## 4) Pair + connect your first chat surface
@@ -133,7 +133,7 @@ clawdbot security audit --deep
### WhatsApp (QR login)
```bash
clawdbot channels login
moltbot channels login
```
Scan via WhatsApp → Settings → Linked Devices.
@@ -155,26 +155,26 @@ Default posture: unknown DMs get a short code and messages are not processed unt
If your first DM gets no reply, approve the pairing:
```bash
clawdbot pairing list whatsapp
clawdbot pairing approve whatsapp <code>
moltbot pairing list whatsapp
moltbot pairing approve whatsapp <code>
```
Pairing doc: [Pairing](/start/pairing)
## From source (development)
If youre hacking on Clawdbot itself, run from source:
If youre hacking on Moltbot itself, run from source:
```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
pnpm build
clawdbot onboard --install-daemon
moltbot onboard --install-daemon
```
If you dont have a global install yet, run the onboarding step via `pnpm clawdbot ...` from the repo.
If you dont have a global install yet, run the onboarding step via `pnpm moltbot ...` from the repo.
`pnpm build` also bundles A2UI assets; if you need to run just that step, use `pnpm canvas:a2ui:bundle`.
Gateway (from this repo):
@@ -188,13 +188,13 @@ node dist/entry.js gateway --port 18789 --verbose
In a new terminal, send a test message:
```bash
clawdbot message send --target +15555550123 --message "Hello from Clawdbot"
moltbot message send --target +15555550123 --message "Hello from Moltbot"
```
If `clawdbot health` shows “no auth configured”, go back to the wizard and set OAuth/key auth — the agent wont be able to respond without it.
If `moltbot health` shows “no auth configured”, go back to the wizard and set OAuth/key auth — the agent wont be able to respond without it.
Tip: `clawdbot status --all` is the best pasteable, read-only debug report.
Health probes: `clawdbot health` (or `clawdbot status --deep`) asks the running gateway for a health snapshot.
Tip: `moltbot status --all` is the best pasteable, read-only debug report.
Health probes: `moltbot health` (or `moltbot status --deep`) asks the running gateway for a health snapshot.
## Next steps (optional, but great)