@gguf/pigbot 0.0.1 → 0.0.3

package/docs/gateway/troubleshooting.md

@@ -1,11 +1,11 @@
 ---
-summary: "Quick troubleshooting guide for common Pigbot failures"
+summary: "Quick troubleshooting guide for common Moltbot failures"
 read_when:
   - Investigating runtime issues or failures
 ---
 # Troubleshooting 🔧
 
-When Pigbot misbehaves, here's how to fix it.
+When Moltbot misbehaves, here's how to fix it.
 
 Start with the FAQ’s [First 60 seconds](/help/faq#first-60-seconds-if-somethings-broken) if you just want a quick triage recipe. This page goes deeper on runtime failures and diagnostics.
 
@@ -17,15 +17,15 @@ Quick triage commands (in order):
 
 | Command | What it tells you | When to use it |
 |---|---|---|
-| `pigbot status` | Local summary: OS + update, gateway reachability/mode, service, agents/sessions, provider config state | First check, quick overview |
-| `pigbot status --all` | Full local diagnosis (read-only, pasteable, safe-ish) incl. log tail | When you need to share a debug report |
-| `pigbot status --deep` | Runs gateway health checks (incl. provider probes; requires reachable gateway) | When “configured” doesn’t mean “working” |
-| `pigbot gateway probe` | Gateway discovery + reachability (local + remote targets) | When you suspect you’re probing the wrong gateway |
-| `pigbot channels status --probe` | Asks the running gateway for channel status (and optionally probes) | When gateway is reachable but channels misbehave |
-| `pigbot gateway status` | Supervisor state (launchd/systemd/schtasks), runtime PID/exit, last gateway error | When the service “looks loaded” but nothing runs |
-| `pigbot logs --follow` | Live logs (best signal for runtime issues) | When you need the actual failure reason |
+| `moltbot status` | Local summary: OS + update, gateway reachability/mode, service, agents/sessions, provider config state | First check, quick overview |
+| `moltbot status --all` | Full local diagnosis (read-only, pasteable, safe-ish) incl. log tail | When you need to share a debug report |
+| `moltbot status --deep` | Runs gateway health checks (incl. provider probes; requires reachable gateway) | When “configured” doesn’t mean “working” |
+| `moltbot gateway probe` | Gateway discovery + reachability (local + remote targets) | When you suspect you’re probing the wrong gateway |
+| `moltbot channels status --probe` | Asks the running gateway for channel status (and optionally probes) | When gateway is reachable but channels misbehave |
+| `moltbot gateway status` | Supervisor state (launchd/systemd/schtasks), runtime PID/exit, last gateway error | When the service “looks loaded” but nothing runs |
+| `moltbot logs --follow` | Live logs (best signal for runtime issues) | When you need the actual failure reason |
 
-**Sharing output:** prefer `pigbot status --all` (it redacts tokens). If you paste `pigbot status`, consider setting `PIGBOT_SHOW_SECRETS=0` first (token previews).
+**Sharing output:** prefer `moltbot status --all` (it redacts tokens). If you paste `moltbot status`, consider setting `CLAWDBOT_SHOW_SECRETS=0` first (token previews).
 
 See also: [Health checks](/gateway/health) and [Logging](/logging).
 
@@ -40,41 +40,36 @@ Fix options:
 - Re-run onboarding and choose **Anthropic** for that agent.
 - Or paste a setup-token on the **gateway host**:
   ```bash
-  pigbot models auth setup-token --provider anthropic
+  moltbot models auth setup-token --provider anthropic
   ```
 - Or copy `auth-profiles.json` from the main agent dir to the new agent dir.
 
 Verify:
 ```bash
-pigbot models status
+moltbot models status
 ```
 
 ### OAuth token refresh failed (Anthropic Claude subscription)
 
 This means the stored Anthropic OAuth token expired and the refresh failed.
 If you’re on a Claude subscription (no API key), the most reliable fix is to
-switch to a **Claude Code setup-token** or re-sync Claude Code CLI OAuth on the
-**gateway host**.
+switch to a **Claude Code setup-token** and paste it on the **gateway host**.
 
 **Recommended (setup-token):**
 
 ```bash
-# Run on the gateway host (runs Claude Code CLI)
-pigbot models auth setup-token --provider anthropic
-pigbot models status
+# Run on the gateway host (paste the setup-token)
+moltbot models auth setup-token --provider anthropic
+moltbot models status
 ```
 
 If you generated the token elsewhere:
 
 ```bash
-pigbot models auth paste-token --provider anthropic
-pigbot models status
+moltbot models auth paste-token --provider anthropic
+moltbot models status
 ```
 
-**If you want to keep OAuth reuse:**
-log in with Claude Code CLI on the gateway host, then run `pigbot models status`
-to sync the refreshed token into Pigbot’s auth store.
-
 More detail: [Anthropic](/providers/anthropic) and [OAuth](/concepts/oauth).
 
 ### Control UI fails on HTTP ("device identity required" / "connect failed")
@@ -102,18 +97,18 @@ can appear “loaded” while nothing is running.
 
 **Check:**
 ```bash
-pigbot gateway status
-pigbot doctor
+moltbot gateway status
+moltbot doctor
 ```
 
 Doctor/service will show runtime state (PID/last exit) and log hints.
 
 **Logs:**
-- Preferred: `pigbot logs --follow`
-- File logs (always): `/tmp/pigbot/pigbot-YYYY-MM-DD.log` (or your configured `logging.file`)
-- macOS LaunchAgent (if installed): `$PIGBOT_STATE_DIR/logs/gateway.log` and `gateway.err.log`
-- Linux systemd (if installed): `journalctl --user -u pigbot-gateway[-<profile>].service -n 200 --no-pager`
-- Windows: `schtasks /Query /TN "Pigbot Gateway (<profile>)" /V /FO LIST`
+- Preferred: `moltbot logs --follow`
+- File logs (always): `/tmp/moltbot/moltbot-YYYY-MM-DD.log` (or your configured `logging.file`)
+- macOS LaunchAgent (if installed): `$CLAWDBOT_STATE_DIR/logs/gateway.log` and `gateway.err.log`
+- Linux systemd (if installed): `journalctl --user -u moltbot-gateway[-<profile>].service -n 200 --no-pager`
+- Windows: `schtasks /Query /TN "Moltbot Gateway (<profile>)" /V /FO LIST`
 
 **Enable more logging:**
 - Bump file log detail (persisted JSONL):
@@ -136,24 +131,24 @@ Gateway refuses to start.
 **Fix (recommended):**
 - Run the wizard and set the Gateway run mode to **Local**:
   ```bash
-  pigbot configure
+  moltbot configure
   ```
 - Or set it directly:
   ```bash
-  pigbot config set gateway.mode local
+  moltbot config set gateway.mode local
   ```
 
 **If you meant to run a remote Gateway instead:**
 - Set a remote URL and keep `gateway.mode=remote`:
   ```bash
-  pigbot config set gateway.mode remote
-  pigbot config set gateway.remote.url "wss://gateway.example.com"
+  moltbot config set gateway.mode remote
+  moltbot config set gateway.remote.url "wss://gateway.example.com"
   ```
 
 **Ad-hoc/dev only:** pass `--allow-unconfigured` to start the gateway without
 `gateway.mode=local`.
 
-**No config file yet?** Run `pigbot setup` to create a starter config, then rerun
+**No config file yet?** Run `moltbot setup` to create a starter config, then rerun
 the gateway.
 
 ### Service Environment (PATH + runtime)
@@ -164,14 +159,14 @@ The gateway service runs with a **minimal PATH** to avoid shell/manager cruft:
 
 This intentionally excludes version managers (nvm/fnm/volta/asdf) and package
 managers (pnpm/npm) because the service does not load your shell init. Runtime
-variables like `DISPLAY` should live in `~/.pigbot/.env` (loaded early by the
+variables like `DISPLAY` should live in `~/.clawdbot/.env` (loaded early by the
 gateway).
 Exec runs on `host=gateway` merge your login-shell `PATH` into the exec environment,
 so missing tools usually mean your shell init isn’t exporting them (or set
 `tools.exec.pathPrepend`). See [/tools/exec](/tools/exec).
 
 WhatsApp + Telegram channels require **Node**; Bun is unsupported. If your
-service was installed with Bun or a version-managed Node path, run `pigbot doctor`
+service was installed with Bun or a version-managed Node path, run `moltbot doctor`
 to migrate to a system Node install.
 
 ### Skill missing API key in sandbox
@@ -183,7 +178,7 @@ to migrate to a system Node install.
 **Fix:**
 - set `agents.defaults.sandbox.docker.env` (or per-agent `agents.list[].sandbox.docker.env`)
 - or bake the key into your custom sandbox image
-- then run `pigbot sandbox recreate --agent <id>` (or `--all`)
+- then run `moltbot sandbox recreate --agent <id>` (or `--all`)
 
 ### Service Running but Port Not Listening
 
@@ -196,28 +191,28 @@ the Gateway likely refused to bind.
 - Always trust `Probe target:` + `Config (service):` as the “what did we actually try?” lines.
 
 **Check:**
-- `gateway.mode` must be `local` for `pigbot gateway` and the service.
-- If you set `gateway.mode=remote`, the **CLI defaults** to a remote URL. The service can still be running locally, but your CLI may be probing the wrong place. Use `pigbot gateway status` to see the service’s resolved port + probe target (or pass `--url`).
-- `pigbot gateway status` and `pigbot doctor` surface the **last gateway error** from logs when the service looks running but the port is closed.
+- `gateway.mode` must be `local` for `moltbot gateway` and the service.
+- If you set `gateway.mode=remote`, the **CLI defaults** to a remote URL. The service can still be running locally, but your CLI may be probing the wrong place. Use `moltbot gateway status` to see the service’s resolved port + probe target (or pass `--url`).
+- `moltbot gateway status` and `moltbot doctor` surface the **last gateway error** from logs when the service looks running but the port is closed.
 - Non-loopback binds (`lan`/`tailnet`/`custom`, or `auto` when loopback is unavailable) require auth:
-  `gateway.auth.token` (or `PIGBOT_GATEWAY_TOKEN`).
+  `gateway.auth.token` (or `CLAWDBOT_GATEWAY_TOKEN`).
 - `gateway.remote.token` is for remote CLI calls only; it does **not** enable local auth.
 - `gateway.token` is ignored; use `gateway.auth.token`.
 
-**If `pigbot gateway status` shows a config mismatch**
+**If `moltbot gateway status` shows a config mismatch**
 - `Config (cli): ...` and `Config (service): ...` should normally match.
 - If they don’t, you’re almost certainly editing one config while the service is running another.
-- Fix: rerun `pigbot gateway install --force` from the same `--profile` / `PIGBOT_STATE_DIR` you want the service to use.
+- Fix: rerun `moltbot gateway install --force` from the same `--profile` / `CLAWDBOT_STATE_DIR` you want the service to use.
 
-**If `pigbot gateway status` reports service config issues**
+**If `moltbot gateway status` reports service config issues**
 - The supervisor config (launchd/systemd/schtasks) is missing current defaults.
-- Fix: run `pigbot doctor` to update it (or `pigbot gateway install --force` for a full rewrite).
+- Fix: run `moltbot doctor` to update it (or `moltbot gateway install --force` for a full rewrite).
 
 **If `Last gateway error:` mentions “refusing to bind … without auth”**
-- You set `gateway.bind` to a non-loopback mode (`lan`/`tailnet`/`custom`, or `auto` when loopback is unavailable) but left auth off.
-- Fix: set `gateway.auth.mode` + `gateway.auth.token` (or export `PIGBOT_GATEWAY_TOKEN`) and restart the service.
+- You set `gateway.bind` to a non-loopback mode (`lan`/`tailnet`/`custom`, or `auto` when loopback is unavailable) but didn’t configure auth.
+- Fix: set `gateway.auth.mode` + `gateway.auth.token` (or export `CLAWDBOT_GATEWAY_TOKEN`) and restart the service.
 
-**If `pigbot gateway status` says `bind=tailnet` but no tailnet interface was found**
+**If `moltbot gateway status` says `bind=tailnet` but no tailnet interface was found**
 - The gateway tried to bind to a Tailscale IP (100.64.0.0/10) but none were detected on the host.
 - Fix: bring up Tailscale on that machine (or change `gateway.bind` to `loopback`/`lan`).
 
@@ -231,7 +226,7 @@ This means something is already listening on the gateway port.
 
 **Check:**
 ```bash
-pigbot gateway status
+moltbot gateway status
 ```
 
 It will show the listener(s) and likely causes (gateway already running, SSH tunnel).
@@ -239,7 +234,7 @@ If needed, stop the service or pick a different port.
 
 ### Extra Workspace Folders Detected
 
-If you upgraded from older installs, you might still have `~/pigbot` on disk.
+If you upgraded from older installs, you might still have `~/moltbot` on disk.
 Multiple workspace directories can cause confusing auth or state drift because
 only one workspace is active.
 
@@ -248,7 +243,7 @@ only one workspace is active.
 
 ### Main chat running in a sandbox workspace
 
-Symptoms: `pwd` or file tools show `~/.pigbot/sandboxes/...` even though you
+Symptoms: `pwd` or file tools show `~/.clawdbot/sandboxes/...` even though you
 expected the host workspace.
 
 **Why:** `agents.defaults.sandbox.mode: "non-main"` keys off `session.mainKey` (default `"main"`).
@@ -272,14 +267,14 @@ The agent was interrupted mid-response.
 
 ### "Agent failed before reply: Unknown model: anthropic/claude-haiku-3-5"
 
-Pigbot intentionally rejects **older/insecure models** (especially those more
+Moltbot intentionally rejects **older/insecure models** (especially those more
 vulnerable to prompt injection). If you see this error, the model name is no
 longer supported.
 
 **Fix:**
 - Pick a **latest** model for the provider and update your config or model alias.
-- If you’re unsure which models are available, run `pigbot models list` or
-  `pigbot models scan` and choose a supported one.
+- If you’re unsure which models are available, run `moltbot models list` or
+  `moltbot models scan` and choose a supported one.
 - Check gateway logs for the detailed failure reason.
 
 See also: [Models CLI](/cli/models) and [Model providers](/concepts/model-providers).
@@ -288,7 +283,7 @@ See also: [Models CLI](/cli/models) and [Model providers](/concepts/model-provid
 
 **Check 1:** Is the sender allowlisted?
 ```bash
-pigbot status
+moltbot status
 ```
 Look for `AllowFrom: ...` in the output.
 
@@ -297,14 +292,14 @@ Look for `AllowFrom: ...` in the output.
 # The message must match mentionPatterns or explicit mentions; defaults live in channel groups/guilds.
 # Multi-agent: `agents.list[].groupChat.mentionPatterns` overrides global patterns.
 grep -n "agents\\|groupChat\\|mentionPatterns\\|channels\\.whatsapp\\.groups\\|channels\\.telegram\\.groups\\|channels\\.imessage\\.groups\\|channels\\.discord\\.guilds" \
-  "${PIGBOT_CONFIG_PATH:-$HOME/.pigbot/pigbot.json}"
+  "${CLAWDBOT_CONFIG_PATH:-$HOME/.clawdbot/moltbot.json}"
 ```
 
 **Check 3:** Check the logs
 ```bash
-pigbot logs --follow
+moltbot logs --follow
 # or if you want quick filters:
-tail -f "$(ls -t /tmp/pigbot/pigbot-*.log | head -1)" | grep "blocked\\|skip\\|unauthorized"
+tail -f "$(ls -t /tmp/moltbot/moltbot-*.log | head -1)" | grep "blocked\\|skip\\|unauthorized"
 ```
 
 ### Pairing Code Not Arriving
@@ -313,14 +308,14 @@ If `dmPolicy` is `pairing`, unknown senders should receive a code and their mess
 
 **Check 1:** Is a pending request already waiting?
 ```bash
-pigbot pairing list <channel>
+moltbot pairing list <channel>
 ```
 
 Pending DM pairing requests are capped at **3 per channel** by default. If the list is full, new requests won’t generate a code until one is approved or expires.
 
 **Check 2:** Did the request get created but no reply was sent?
 ```bash
-pigbot logs --follow | grep "pairing request"
+moltbot logs --follow | grep "pairing request"
 ```
 
 **Check 3:** Confirm `dmPolicy` isn’t `open`/`allowlist` for that channel.
@@ -337,7 +332,7 @@ Known issue: When you send an image with ONLY a mention (no other text), WhatsAp
 
 **Check 1:** Is the session file there?
 ```bash
-ls -la ~/.pigbot/agents/<agentId>/sessions/
+ls -la ~/.clawdbot/agents/<agentId>/sessions/
 ```
 
 **Check 2:** Is the reset window too short?
@@ -373,26 +368,26 @@ Or use the `process` tool to background long commands.
 
 ```bash
 # Check local status (creds, sessions, queued events)
-pigbot status
+moltbot status
 # Probe the running gateway + channels (WA connect + Telegram + Discord APIs)
-pigbot status --deep
+moltbot status --deep
 
 # View recent connection events
-pigbot logs --limit 200 | grep "connection\\|disconnect\\|logout"
+moltbot logs --limit 200 | grep "connection\\|disconnect\\|logout"
 ```
 
 **Fix:** Usually reconnects automatically once the Gateway is running. If you’re stuck, restart the Gateway process (however you supervise it), or run it manually with verbose output:
 
 ```bash
-pigbot gateway --verbose
+moltbot gateway --verbose
 ```
 
 If you’re logged out / unlinked:
 
 ```bash
-pigbot channels logout
-trash "${PIGBOT_STATE_DIR:-$HOME/.pigbot}/credentials" # if logout can't cleanly remove everything
-pigbot channels login --verbose       # re-scan QR
+moltbot channels logout
+trash "${CLAWDBOT_STATE_DIR:-$HOME/.clawdbot}/credentials" # if logout can't cleanly remove everything
+moltbot channels login --verbose       # re-scan QR
 ```
 
 ### Media Send Failing
@@ -409,12 +404,12 @@ ls -la /path/to/your/image.jpg
 
 **Check 3:** Check media logs
 ```bash
-grep "media\\|fetch\\|download" "$(ls -t /tmp/pigbot/pigbot-*.log | head -1)" | tail -20
+grep "media\\|fetch\\|download" "$(ls -t /tmp/moltbot/moltbot-*.log | head -1)" | tail -20
 ```
 
 ### High Memory Usage
 
-Pigbot keeps conversation history in memory.
+Moltbot keeps conversation history in memory.
 
 **Fix:** Restart periodically or set session limits:
 ```json
@@ -429,26 +424,26 @@ Pigbot keeps conversation history in memory.
 
 ### “Gateway won’t start — configuration invalid”
 
-Pigbot now refuses to start when the config contains unknown keys, malformed values, or invalid types.
+Moltbot now refuses to start when the config contains unknown keys, malformed values, or invalid types.
 This is intentional for safety.
 
 Fix it with Doctor:
 ```bash
-pigbot doctor
-pigbot doctor --fix
+moltbot doctor
+moltbot doctor --fix
 ```
 
 Notes:
-- `pigbot doctor` reports every invalid entry.
-- `pigbot doctor --fix` applies migrations/repairs and rewrites the config.
-- Diagnostic commands like `pigbot logs`, `pigbot health`, `pigbot status`, `pigbot gateway status`, and `pigbot gateway probe` still run even if the config is invalid.
+- `moltbot doctor` reports every invalid entry.
+- `moltbot doctor --fix` applies migrations/repairs and rewrites the config.
+- Diagnostic commands like `moltbot logs`, `moltbot health`, `moltbot status`, `moltbot gateway status`, and `moltbot gateway probe` still run even if the config is invalid.
 
 ### “All models failed” — what should I check first?
 
 - **Credentials** present for the provider(s) being tried (auth profiles + env vars).
 - **Model routing**: confirm `agents.defaults.model.primary` and fallbacks are models you can access.
-- **Gateway logs** in `/tmp/pigbot/…` for the exact provider error.
-- **Model status**: use `/model status` (chat) or `pigbot models status` (CLI).
+- **Gateway logs** in `/tmp/moltbot/…` for the exact provider error.
+- **Model status**: use `/model status` (chat) or `moltbot models status` (CLI).
 
 ### I’m running on my personal WhatsApp number — why is self-chat weird?
 
@@ -473,13 +468,13 @@ See [WhatsApp setup](/channels/whatsapp).
 Run the login command again and scan the QR code:
 
 ```bash
-pigbot channels login
+moltbot channels login
 ```
 
 ### Build errors on `main` — what’s the standard fix path?
 
 1) `git pull origin main && pnpm install`
-2) `pigbot doctor`
+2) `moltbot doctor`
 3) Check GitHub issues or Discord
 4) Temporary workaround: check out an older commit
 
@@ -493,8 +488,8 @@ Typical recovery:
 git status   # ensure you’re in the repo root
 pnpm install
 pnpm build
-pigbot doctor
-pigbot gateway restart
+moltbot doctor
+moltbot gateway restart
 ```
 
 Why: pnpm is the configured package manager for this repo.
@@ -506,20 +501,20 @@ upgrades in place and rewrites the gateway service to point at the new install.
 
 Switch **to git install**:
 ```bash
-curl -fsSL https://clawd.bot/install.sh | bash -s -- --install-method git --no-onboard
+curl -fsSL https://molt.bot/install.sh | bash -s -- --install-method git --no-onboard
 ```
 
 Switch **to npm global**:
 ```bash
-curl -fsSL https://clawd.bot/install.sh | bash
+curl -fsSL https://molt.bot/install.sh | bash
 ```
 
 Notes:
 - The git flow only rebases if the repo is clean. Commit or stash changes first.
 - After switching, run:
   ```bash
-  pigbot doctor
-  pigbot gateway restart
+  moltbot doctor
+  moltbot gateway restart
   ```
 
 ### Telegram block streaming isn’t splitting text between tool calls. Why?
@@ -551,19 +546,19 @@ Fix checklist:
 3) Put `requireMention: false` **under** `channels.discord.guilds` (global or per‑channel).
    Top‑level `channels.discord.requireMention` is not a supported key.
 4) Ensure the bot has **Message Content Intent** and channel permissions.
-5) Run `pigbot channels status --probe` for audit hints.
+5) Run `moltbot channels status --probe` for audit hints.
 
 Docs: [Discord](/channels/discord), [Channels troubleshooting](/channels/troubleshooting).
 
 ### Cloud Code Assist API error: invalid tool schema (400). What now?
 
 This is almost always a **tool schema compatibility** issue. The Cloud Code Assist
-endpoint accepts a strict subset of JSON Schema. Pigbot scrubs/normalizes tool
+endpoint accepts a strict subset of JSON Schema. Moltbot scrubs/normalizes tool
 schemas in current `main`, but the fix is not in the last release yet (as of
 January 13, 2026).
 
 Fix checklist:
-1) **Update Pigbot**:
+1) **Update Moltbot**:
    - If you can run from source, pull `main` and restart the gateway.
    - Otherwise, wait for the next release that includes the schema scrubber.
 2) Avoid unsupported keywords like `anyOf/oneOf/allOf`, `patternProperties`,
@@ -581,11 +576,11 @@ If the app disappears or shows "Abort trap 6" when you click "Allow" on a privac
 
 **Fix 1: Reset TCC Cache**
 ```bash
-tccutil reset All com.pigbot.mac.debug
+tccutil reset All bot.molt.mac.debug
 ```
 
 **Fix 2: Force New Bundle ID**
-If resetting doesn't work, change the `BUNDLE_ID` in [`scripts/package-mac-app.sh`](https://github.com/pigbot/pigbot/blob/main/scripts/package-mac-app.sh) (e.g., add a `.test` suffix) and rebuild. This forces macOS to treat it as a new app.
+If resetting doesn't work, change the `BUNDLE_ID` in [`scripts/package-mac-app.sh`](https://github.com/moltbot/moltbot/blob/main/scripts/package-mac-app.sh) (e.g., add a `.test` suffix) and rebuild. This forces macOS to treat it as a new app.
 
 ### Gateway stuck on "Starting..."
 
@@ -594,9 +589,9 @@ The app connects to a local gateway on port `18789`. If it stays stuck:
 **Fix 1: Stop the supervisor (preferred)**
 If the gateway is supervised by launchd, killing the PID will just respawn it. Stop the supervisor first:
 ```bash
-pigbot gateway status
-pigbot gateway stop
-# Or: launchctl bootout gui/$UID/com.pigbot.gateway (replace with com.pigbot.<profile> if needed)
+moltbot gateway status
+moltbot gateway stop
+# Or: launchctl bootout gui/$UID/bot.molt.gateway (replace with bot.molt.<profile>; legacy com.clawdbot.* still works)
 ```
 
 **Fix 2: Port is busy (find the listener)**
@@ -612,10 +607,10 @@ kill -9 <PID> # last resort
 ```
 
 **Fix 3: Check the CLI install**
-Ensure the global `pigbot` CLI is installed and matches the app version:
+Ensure the global `moltbot` CLI is installed and matches the app version:
 ```bash
-pigbot --version
-npm install -g pigbot@<version>
+moltbot --version
+npm install -g moltbot@<version>
 ```
 
 ## Debug Mode
@@ -624,43 +619,43 @@ Get verbose logging:
 
 ```bash
 # Turn on trace logging in config:
-#   ${PIGBOT_CONFIG_PATH:-$HOME/.pigbot/pigbot.json} -> { logging: { level: "trace" } }
+#   ${CLAWDBOT_CONFIG_PATH:-$HOME/.clawdbot/moltbot.json} -> { logging: { level: "trace" } }
 #
 # Then run verbose commands to mirror debug output to stdout:
-pigbot gateway --verbose
-pigbot channels login --verbose
+moltbot gateway --verbose
+moltbot channels login --verbose
 ```
 
 ## Log Locations
 
 | Log | Location |
 |-----|----------|
-| Gateway file logs (structured) | `/tmp/pigbot/pigbot-YYYY-MM-DD.log` (or `logging.file`) |
-| Gateway service logs (supervisor) | macOS: `$PIGBOT_STATE_DIR/logs/gateway.log` + `gateway.err.log` (default: `~/.pigbot/logs/...`; profiles use `~/.pigbot-<profile>/logs/...`)<br />Linux: `journalctl --user -u pigbot-gateway[-<profile>].service -n 200 --no-pager`<br />Windows: `schtasks /Query /TN "Pigbot Gateway (<profile>)" /V /FO LIST` |
-| Session files | `$PIGBOT_STATE_DIR/agents/<agentId>/sessions/` |
-| Media cache | `$PIGBOT_STATE_DIR/media/` |
-| Credentials | `$PIGBOT_STATE_DIR/credentials/` |
+| Gateway file logs (structured) | `/tmp/moltbot/moltbot-YYYY-MM-DD.log` (or `logging.file`) |
+| Gateway service logs (supervisor) | macOS: `$CLAWDBOT_STATE_DIR/logs/gateway.log` + `gateway.err.log` (default: `~/.clawdbot/logs/...`; profiles use `~/.clawdbot-<profile>/logs/...`)<br />Linux: `journalctl --user -u moltbot-gateway[-<profile>].service -n 200 --no-pager`<br />Windows: `schtasks /Query /TN "Moltbot Gateway (<profile>)" /V /FO LIST` |
+| Session files | `$CLAWDBOT_STATE_DIR/agents/<agentId>/sessions/` |
+| Media cache | `$CLAWDBOT_STATE_DIR/media/` |
+| Credentials | `$CLAWDBOT_STATE_DIR/credentials/` |
 
 ## Health Check
 
 ```bash
 # Supervisor + probe target + config paths
-pigbot gateway status
+moltbot gateway status
 # Include system-level scans (legacy/extra services, port listeners)
-pigbot gateway status --deep
+moltbot gateway status --deep
 
 # Is the gateway reachable?
-pigbot health --json
+moltbot health --json
 # If it fails, rerun with connection details:
-pigbot health --verbose
+moltbot health --verbose
 
 # Is something listening on the default port?
 lsof -nP -iTCP:18789 -sTCP:LISTEN
 
 # Recent activity (RPC log tail)
-pigbot logs --follow
+moltbot logs --follow
 # Fallback if RPC is down
-tail -20 /tmp/pigbot/pigbot-*.log
+tail -20 /tmp/moltbot/moltbot-*.log
 ```
 
 ## Reset Everything
@@ -668,23 +663,23 @@ tail -20 /tmp/pigbot/pigbot-*.log
 Nuclear option:
 
 ```bash
-pigbot gateway stop
+moltbot gateway stop
 # If you installed a service and want a clean install:
-# pigbot gateway uninstall
+# moltbot gateway uninstall
 
-trash "${PIGBOT_STATE_DIR:-$HOME/.pigbot}"
-pigbot channels login         # re-pair WhatsApp
-pigbot gateway restart           # or: pigbot gateway
+trash "${CLAWDBOT_STATE_DIR:-$HOME/.clawdbot}"
+moltbot channels login         # re-pair WhatsApp
+moltbot gateway restart           # or: moltbot gateway
 ```
 
 ⚠️ This loses all sessions and requires re-pairing WhatsApp.
 
 ## Getting Help
 
-1. Check logs first: `/tmp/pigbot/` (default: `pigbot-YYYY-MM-DD.log`, or your configured `logging.file`)
+1. Check logs first: `/tmp/moltbot/` (default: `moltbot-YYYY-MM-DD.log`, or your configured `logging.file`)
 2. Search existing issues on GitHub
 3. Open a new issue with:
-   - Pigbot version
+   - Moltbot version
    - Relevant log snippets
    - Steps to reproduce
    - Your config (redact secrets!)