refactor: rename to openclaw

2026-03-12 07:20:45 +00:00 · 2026-01-30 03:15:10 +01:00
parent 4583f88626
commit 9a7160786a
2357 changed files with 16688 additions and 16788 deletions
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,14 +1,14 @@
 ---
-summary: "Top-level overview of Moltbot, features, and purpose"
+summary: "Top-level overview of OpenClaw, features, and purpose"
 read_when:
-  - Introducing Moltbot to newcomers
+  - Introducing OpenClaw to newcomers
 ---
-# Moltbot 🦞
+# OpenClaw 🦞

 > *"EXFOLIATE! EXFOLIATE!"* — A space lobster, probably

 <p align="center">
-  <img src="whatsapp-clawd.jpg" alt="Moltbot" width="420" />
+  <img src="whatsapp-openclaw.jpg" alt="OpenClaw" width="420" />
 </p>

 <p align="center">
@@ -18,23 +18,23 @@ read_when:
 </p>

 <p align="center">
-  <a href="https://github.com/moltbot/moltbot">GitHub</a> ·
-  <a href="https://github.com/moltbot/moltbot/releases">Releases</a> ·
+  <a href="https://github.com/openclaw/openclaw">GitHub</a> ·
+  <a href="https://github.com/openclaw/openclaw/releases">Releases</a> ·
  <a href="/">Docs</a> ·
-  <a href="/start/clawd">Moltbot assistant setup</a>
+  <a href="/start/openclaw">OpenClaw assistant setup</a>
 </p>

-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.
+OpenClaw 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.
+OpenClaw also powers the OpenClaw assistant.

 ## Start here

 - **New install from zero:** [Getting Started](/start/getting-started)
- **Guided setup (recommended):** [Wizard](/start/wizard) (`moltbot onboard`)
+- **Guided setup (recommended):** [Wizard](/start/wizard) (`openclaw 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: `moltbot gateway`.
+immediately. If it fails, start the Gateway first: `openclaw 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
-  │                           │    /__moltbot__/canvas/ (Canvas host)
+  │                           │    /__openclaw__/canvas/ (Canvas host)
  └───────────┬───────────────┘
              │
              ├─ Pi agent (RPC)
-              ├─ CLI (moltbot …)
+              ├─ CLI (openclaw …)
              ├─ Chat UI (SwiftUI)
-              ├─ macOS app (Moltbot.app)
+              ├─ macOS app (OpenClaw.app)
              ├─ iOS node via Gateway WS + pairing
              └─ Android node via Gateway WS + pairing
 ```

-Most operations flow through the **Gateway** (`moltbot gateway`), a single long-running process that owns channel connections and the WebSocket control plane.
+Most operations flow through the **Gateway** (`openclaw 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 `moltbot gateway --bind tailnet --token ...` (token is required for non-loopback binds).
+  - For Tailnet access, run `openclaw 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 `/__moltbot__/canvas/` for node WebViews; see [Gateway configuration](/gateway/configuration) (`canvasHost`).
+- **Canvas host**: HTTP file server on `canvasHost.port` (default `18793`), serving `/__openclaw__/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 moltbot@latest
-# or: pnpm add -g moltbot@latest
+npm install -g openclaw@latest
+# or: pnpm add -g openclaw@latest

 # Onboard + install the service (launchd/systemd user service)
-moltbot onboard --install-daemon
+openclaw onboard --install-daemon

 # Pair WhatsApp Web (shows QR)
-moltbot channels login
+openclaw channels login

 # Gateway runs via the service after onboarding; manual run is still possible:
-moltbot gateway --port 18789
+openclaw gateway --port 18789
 ```

-Switching between npm and git installs later is easy: install the other flavor and run `moltbot doctor` to update the gateway service entrypoint.
+Switching between npm and git installs later is easy: install the other flavor and run `openclaw doctor` to update the gateway service entrypoint.

 From source (development):

 ```bash
-git clone https://github.com/moltbot/moltbot.git
-cd moltbot
+git clone https://github.com/openclaw/openclaw.git
+cd openclaw
 pnpm install
 pnpm ui:build # auto-installs UI deps on first run
 pnpm build
-moltbot onboard --install-daemon
+openclaw onboard --install-daemon
 ```

-If you don’t have a global install yet, run the onboarding step via `pnpm moltbot ...` from the repo.
+If you don’t have a global install yet, run the onboarding step via `pnpm openclaw ...` from the repo.

 Multi-instance quickstart (optional):

 ```bash
-CLAWDBOT_CONFIG_PATH=~/.clawdbot/a.json \
-CLAWDBOT_STATE_DIR=~/.clawdbot-a \
-moltbot gateway --port 19001
+OPENCLAW_CONFIG_PATH=~/.openclaw/a.json \
+OPENCLAW_STATE_DIR=~/.openclaw-a \
+openclaw gateway --port 19001
 ```

 Send a test message (requires a running Gateway):

 ```bash
-moltbot message send --target +15555550123 --message "Hello from Moltbot"
+openclaw message send --target +15555550123 --message "Hello from OpenClaw"
 ```

 ## Configuration (optional)

-Config lives at `~/.clawdbot/moltbot.json`.
+Config lives at `~/.openclaw/openclaw.json`.

- If you **do nothing**, Moltbot uses the bundled Pi binary in RPC mode with per-sender sessions.
+- If you **do nothing**, OpenClaw 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:
@@ -161,7 +161,7 @@ Example:
      groups: { "*": { requireMention: true } }
    }
  },
-  messages: { groupChat: { mentionPatterns: ["@clawd"] } }
+  messages: { groupChat: { mentionPatterns: ["@openclaw"] } }
 }
 ```

@@ -177,7 +177,7 @@ Example:
  - [Updating / rollback](/install/updating)
  - [Pairing (DM + nodes)](/start/pairing)
  - [Nix mode](/install/nix)
-  - [Moltbot assistant setup (Clawd)](/start/clawd)
+  - [OpenClaw assistant setup](/start/openclaw)
  - [Skills](/tools/skills)
  - [Skills config](/tools/skills-config)
  - [Workspace templates](/reference/templates/AGENTS)
@@ -214,7 +214,7 @@ Example:

 ## The name

-**Moltbot = CLAW + TARDIS** — because every space lobster needs a time-and-space machine.
+**OpenClaw = CLAW + TARDIS** — because every space lobster needs a time-and-space machine.

 ---