vultr/openclaw
1
0
Fork 0
mirror of https://github.com/openclaw/openclaw.git synced 2026-03-12 07:20:45 +00:00
Code Issues Packages Projects Releases Wiki Activity

refactor: rename clawdbot to moltbot with legacy compat

Browse Source
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
Download Patch File Download Diff File Expand all files Collapse all files

66
docs/index.md
View File

@@ -1,14 +1,14 @@
---
summary: "Top-level overview of Clawdbot, features, and purpose"
summary: "Top-level overview of Moltbot, features, and purpose"
read_when:
- Introducing Clawdbot to newcomers
- Introducing Moltbot to newcomers
---
# Clawdbot 🦞
# Moltbot 🦞
> *"EXFOLIATE! EXFOLIATE!"* — A space lobster, probably
<p align="center">
<img src="whatsapp-clawd.jpg" alt="Clawdbot" width="420" />
<img src="whatsapp-clawd.jpg" alt="Moltbot" width="420" />
</p>
<p align="center">
@@ -18,23 +18,23 @@ read_when:
</p>
<p align="center">
<a href="https://github.com/clawdbot/clawdbot">GitHub</a> ·
<a href="https://github.com/clawdbot/clawdbot/releases">Releases</a> ·
<a href="https://github.com/moltbot/moltbot">GitHub</a> ·
<a href="https://github.com/moltbot/moltbot/releases">Releases</a> ·
<a href="/">Docs</a> ·
<a href="/start/clawd">Clawdbot assistant setup</a>
<a href="/start/clawd">Moltbot assistant setup</a>
</p>
Clawdbot bridges WhatsApp (via WhatsApp Web / Baileys), Telegram (Bot API / grammY), Discord (Bot API / channels.discord.js), and iMessage (imsg CLI) to coding agents like [Pi](https://github.com/badlogic/pi-mono). Plugins add Mattermost (Bot API + WebSocket) and more.
Clawdbot also powers [Clawd](https://clawd.me), the space‑lobster assistant.
Moltbot bridges WhatsApp (via WhatsApp Web / Baileys), Telegram (Bot API / grammY), Discord (Bot API / channels.discord.js), and iMessage (imsg CLI) to coding agents like [Pi](https://github.com/badlogic/pi-mono). Plugins add Mattermost (Bot API + WebSocket) and more.
Moltbot also powers [Clawd](https://clawd.me), the space‑lobster assistant.
## Start here
- **New install from zero:** [Getting Started](/start/getting-started)
- **Guided setup (recommended):** [Wizard](/start/wizard) (`clawdbot onboard`)
- **Guided setup (recommended):** [Wizard](/start/wizard) (`moltbot onboard`)
- **Open the dashboard (local Gateway):** http://127.0.0.1:18789/ (or http://localhost:18789/)
If the Gateway is running on the same computer, that link opens the browser Control UI
immediately. If it fails, start the Gateway first: `clawdbot gateway`.
immediately. If it fails, start the Gateway first: `moltbot gateway`.
## Dashboard (browser Control UI)
@@ -52,27 +52,27 @@ WhatsApp / Telegram / Discord / iMessage (+ plugins)
│ Gateway │ ws://127.0.0.1:18789 (loopback-only)
│ (single source) │
│ │ http://<gateway-host>:18793
│ │ /__clawdbot__/canvas/ (Canvas host)
│ │ /__moltbot__/canvas/ (Canvas host)
└───────────┬───────────────┘
│
├─ Pi agent (RPC)
├─ CLI (clawdbot …)
├─ CLI (moltbot …)
├─ Chat UI (SwiftUI)
├─ macOS app (Clawdbot.app)
├─ macOS app (Moltbot.app)
├─ iOS node via Gateway WS + pairing
└─ Android node via Gateway WS + pairing
```
Most operations flow through the **Gateway** (`clawdbot gateway`), a single long-running process that owns channel connections and the WebSocket control plane.
Most operations flow through the **Gateway** (`moltbot gateway`), a single long-running process that owns channel connections and the WebSocket control plane.
## Network model
- **One Gateway per host (recommended)**: it is the only process allowed to own the WhatsApp Web session. If you need a rescue bot or strict isolation, run multiple gateways with isolated profiles and ports; see [Multiple gateways](/gateway/multiple-gateways).
- **Loopback-first**: Gateway WS defaults to `ws://127.0.0.1:18789`.
- The wizard now generates a gateway token by default (even for loopback).
- For Tailnet access, run `clawdbot gateway --bind tailnet --token ...` (token is required for non-loopback binds).
- For Tailnet access, run `moltbot gateway --bind tailnet --token ...` (token is required for non-loopback binds).
- **Nodes**: connect to the Gateway WebSocket (LAN/tailnet/SSH as needed); legacy TCP bridge is deprecated/removed.
- **Canvas host**: HTTP file server on `canvasHost.port` (default `18793`), serving `/__clawdbot__/canvas/` for node WebViews; see [Gateway configuration](/gateway/configuration) (`canvasHost`).
- **Canvas host**: HTTP file server on `canvasHost.port` (default `18793`), serving `/__moltbot__/canvas/` for node WebViews; see [Gateway configuration](/gateway/configuration) (`canvasHost`).
- **Remote use**: SSH tunnel or tailnet/VPN; see [Remote access](/gateway/remote) and [Discovery](/gateway/discovery).
## Features (high level)
@@ -102,53 +102,53 @@ Runtime requirement: **Node ≥ 22**.
```bash
# Recommended: global install (npm/pnpm)
npm install -g clawdbot@latest
# or: pnpm add -g clawdbot@latest
npm install -g moltbot@latest
# or: pnpm add -g moltbot@latest
# Onboard + install the service (launchd/systemd user service)
clawdbot onboard --install-daemon
moltbot onboard --install-daemon
# Pair WhatsApp Web (shows QR)
clawdbot channels login
moltbot channels login
# Gateway runs via the service after onboarding; manual run is still possible:
clawdbot gateway --port 18789
moltbot gateway --port 18789
```
Switching between npm and git installs later is easy: install the other flavor and run `clawdbot doctor` to update the gateway service entrypoint.
Switching between npm and git installs later is easy: install the other flavor and run `moltbot doctor` to update the gateway service entrypoint.
From source (development):
```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 don’t have a global install yet, run the onboarding step via `pnpm clawdbot ...` from the repo.
If you don’t have a global install yet, run the onboarding step via `pnpm moltbot ...` from the repo.
Multi-instance quickstart (optional):
```bash
CLAWDBOT_CONFIG_PATH=~/.clawdbot/a.json \
CLAWDBOT_STATE_DIR=~/.clawdbot-a \
clawdbot gateway --port 19001
moltbot gateway --port 19001
```
Send a test message (requires a running Gateway):
```bash
clawdbot message send --target +15555550123 --message "Hello from Clawdbot"
moltbot message send --target +15555550123 --message "Hello from Moltbot"
```
## Configuration (optional)
Config lives at `~/.clawdbot/clawdbot.json`.
Config lives at `~/.clawdbot/moltbot.json`.
- If you **do nothing**, Clawdbot uses the bundled Pi binary in RPC mode with per-sender sessions.
- If you **do nothing**, Moltbot uses the bundled Pi binary in RPC mode with per-sender sessions.
- If you want to lock it down, start with `channels.whatsapp.allowFrom` and (for groups) mention rules.
Example:
@@ -177,7 +177,7 @@ Example:
- [Updating / rollback](/install/updating)
- [Pairing (DM + nodes)](/start/pairing)
- [Nix mode](/install/nix)
- [Clawdbot assistant setup (Clawd)](/start/clawd)
- [Moltbot assistant setup (Clawd)](/start/clawd)
- [Skills](/tools/skills)
- [Skills config](/tools/skills-config)
- [Workspace templates](/reference/templates/AGENTS)
@@ -214,7 +214,7 @@ Example:
## The name
**Clawdbot = CLAW + TARDIS** — because every space lobster needs a time-and-space machine.
**Moltbot = CLAW + TARDIS** — because every space lobster needs a time-and-space machine.
---