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

@@ -1,5 +1,5 @@
---
summary: "Run Clawdbot Gateway on exe.dev (VM + HTTPS proxy) for remote access"
summary: "Run Moltbot Gateway on exe.dev (VM + HTTPS proxy) for remote access"
read_when:
- You want a cheap always-on Linux host for the Gateway
- You want remote Control UI access without running your own VPS
@@ -7,7 +7,7 @@ read_when:
# exe.dev
Goal: Clawdbot Gateway running on an exe.dev VM, reachable from your laptop via:
Goal: Moltbot Gateway running on an exe.dev VM, reachable from your laptop via:
- **exe.dev HTTPS proxy** (easy, no tunnel) or
- **SSH tunnel** (most secure; loopback-only Gateway)
@@ -17,8 +17,8 @@ If youre on any other Linux VPS, the same steps apply — you just wont us
## Beginner quick path
1) Create VM → install Node 22 → install Clawdbot
2) Run `clawdbot onboard --install-daemon`
1) Create VM → install Node 22 → install Moltbot
2) Run `moltbot onboard --install-daemon`
3) Tunnel from laptop (`ssh -N -L 18789:127.0.0.1:18789 …`)
4) Open `http://127.0.0.1:18789/` and paste your token
@@ -34,16 +34,16 @@ If youre on any other Linux VPS, the same steps apply — you just wont us
From your laptop:
```bash
ssh exe.dev new --name=clawdbot
ssh exe.dev new --name=moltbot
```
Then connect:
```bash
ssh clawdbot.exe.xyz
ssh moltbot.exe.xyz
```
Tip: keep this VM **stateful**. Clawdbot stores state under `~/.clawdbot/` and `~/clawd/`.
Tip: keep this VM **stateful**. Moltbot stores state under `~/.clawdbot/` and `~/clawd/`.
## 2) Install prerequisites (on the VM)
@@ -69,13 +69,13 @@ curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
```
## 3) Install Clawdbot
## 3) Install Moltbot
Recommended on servers: npm global install.
```bash
npm i -g clawdbot@latest
clawdbot --version
npm i -g moltbot@latest
moltbot --version
```
If native deps fail to install (rare; usually `sharp`), add build tools:
@@ -89,12 +89,12 @@ sudo apt-get install -y build-essential python3
Run the onboarding wizard on the VM:
```bash
clawdbot onboard --install-daemon
moltbot onboard --install-daemon
```
It can set up:
- `~/clawd` workspace bootstrap
- `~/.clawdbot/clawdbot.json` config
- `~/.clawdbot/moltbot.json` config
- model auth profiles
- model provider config/login
- Linux systemd **user** service (service)
@@ -108,7 +108,7 @@ If youre doing OAuth on a headless VM: do OAuth on a normal machine first, th
Keep Gateway on loopback (default) and tunnel it from your laptop:
```bash
ssh -N -L 18789:127.0.0.1:18789 clawdbot.exe.xyz
ssh -N -L 18789:127.0.0.1:18789 moltbot.exe.xyz
```
Open locally:
@@ -122,10 +122,10 @@ To let exe.dev proxy traffic to the VM, bind the Gateway to the LAN interface an
```bash
export CLAWDBOT_GATEWAY_TOKEN="$(openssl rand -hex 32)"
clawdbot gateway --bind lan --port 8080 --token "$CLAWDBOT_GATEWAY_TOKEN"
moltbot gateway --bind lan --port 8080 --token "$CLAWDBOT_GATEWAY_TOKEN"
```
For service runs, persist it in `~/.clawdbot/clawdbot.json`:
For service runs, persist it in `~/.clawdbot/moltbot.json`:
```json5
{
@@ -145,11 +145,11 @@ Notes:
Then point exe.devs proxy at `8080` (or whatever port you chose) and open your VMs HTTPS URL:
```bash
ssh exe.dev share port clawdbot 8080
ssh exe.dev share port moltbot 8080
```
Open:
- `https://clawdbot.exe.xyz/`
- `https://moltbot.exe.xyz/`
In the Control UI, paste the token (UI → Settings → token). The UI sends it as `connect.params.auth.token`.
@@ -161,10 +161,10 @@ Control UI details: [Control UI](/web/control-ui)
## 6) Keep it running (service)
On Linux, Clawdbot uses a systemd **user** service. After `--install-daemon`, verify:
On Linux, Moltbot uses a systemd **user** service. After `--install-daemon`, verify:
```bash
systemctl --user status clawdbot-gateway[-<profile>].service
systemctl --user status moltbot-gateway[-<profile>].service
```
If the service dies after logout, enable lingering:
@@ -178,10 +178,10 @@ More: [Linux](/platforms/linux)
## 7) Updates
```bash
npm i -g clawdbot@latest
clawdbot doctor
clawdbot gateway restart
clawdbot health
npm i -g moltbot@latest
moltbot doctor
moltbot gateway restart
moltbot health
```
Guide: [Updating](/install/updating)