@poolzin/pool-bot 1.28.0 → 2026.1.26

package/docs/start/setup.md

@@ -1,5 +1,5 @@
 ---
-summary: "Setup guide: keep your Pool Bot setup tailored while staying up-to-date"
+summary: "Setup guide: keep your Clawdbot setup tailored while staying up-to-date"
 read_when:
   - Setting up a new machine
   - You want “latest + greatest” without breaking your personal setup
@@ -10,7 +10,7 @@ read_when:
 Last updated: 2026-01-01
 
 ## TL;DR
-- **Tailoring lives outside the repo:** `~/clawd` (workspace) + `~/.clawdbot/moltbot.json` (config).
+- **Tailoring lives outside the repo:** `~/clawd` (workspace) + `~/.clawdbot/clawdbot.json` (config).
 - **Stable workflow:** install the macOS app; let it run the bundled Gateway.
 - **Bleeding edge workflow:** run the Gateway yourself via `pnpm gateway:watch`, then let the macOS app attach in Local mode.
 
@@ -23,42 +23,42 @@ Last updated: 2026-01-01
 
 If you want “100% tailored to me” *and* easy updates, keep your customization in:
 
-- **Config:** `~/.clawdbot/moltbot.json` (JSON/JSON5-ish)
+- **Config:** `~/.clawdbot/clawdbot.json` (JSON/JSON5-ish)
 - **Workspace:** `~/clawd` (skills, prompts, memories; make it a private git repo)
 
 Bootstrap once:
 
 ```bash
-moltbot setup
+clawdbot setup
 ```
 
 From inside this repo, use the local CLI entry:
 
 ```bash
-moltbot setup
+clawdbot setup
 ```
 
-If you don’t have a global install yet, run it via `pnpm moltbot setup`.
+If you don’t have a global install yet, run it via `pnpm clawdbot setup`.
 
 ## Stable workflow (macOS app first)
 
-1) Install + launch **Pool Bot.app** (menu bar).
+1) Install + launch **Clawdbot.app** (menu bar).
 2) Complete the onboarding/permissions checklist (TCC prompts).
 3) Ensure Gateway is **Local** and running (the app manages it).
 4) Link surfaces (example: WhatsApp):
 
 ```bash
-moltbot channels login
+clawdbot channels login
 ```
 
 5) Sanity check:
 
 ```bash
-moltbot health
+clawdbot health
 ```
 
 If onboarding is not available in your build:
-- Run `moltbot setup`, then `moltbot channels login`, then start the Gateway manually (`moltbot gateway`).
+- Run `clawdbot setup`, then `clawdbot channels login`, then start the Gateway manually (`clawdbot gateway`).
 
 ## Bleeding edge workflow (Gateway in a terminal)
 
@@ -83,7 +83,7 @@ pnpm gateway:watch
 
 ### 2) Point the macOS app at your running Gateway
 
-In **Pool Bot.app**:
+In **Clawdbot.app**:
 
 - Connection Mode: **Local**
 The app will attach to the running gateway on the configured port.
@@ -94,7 +94,7 @@ The app will attach to the running gateway on the configured port.
 - Or via CLI:
 
 ```bash
-moltbot health
+clawdbot health
 ```
 
 ### Common footguns
@@ -102,24 +102,11 @@ moltbot health
 - **Where state lives:**
   - Credentials: `~/.clawdbot/credentials/`
   - Sessions: `~/.clawdbot/agents/<agentId>/sessions/`
-  - Logs: `/tmp/moltbot/`
-
-## Credential storage map
-
-Use this when debugging auth or deciding what to back up:
-
-- **WhatsApp**: `~/.clawdbot/credentials/whatsapp/<accountId>/creds.json`
-- **Telegram bot token**: config/env or `channels.telegram.tokenFile`
-- **Discord bot token**: config/env (token file not yet supported)
-- **Slack tokens**: config/env (`channels.slack.*`)
-- **Pairing allowlists**: `~/.clawdbot/credentials/<channel>-allowFrom.json`
-- **Model auth profiles**: `~/.clawdbot/agents/<agentId>/agent/auth-profiles.json`
-- **Legacy OAuth import**: `~/.clawdbot/credentials/oauth.json`
-More detail: [Security](/gateway/security#credential-storage-map).
+  - Logs: `/tmp/clawdbot/`
 
 ## Updating (without wrecking your setup)
 
-- Keep `~/clawd` and `~/.clawdbot/` as “your stuff”; don’t put personal prompts/config into the `moltbot` repo.
+- Keep `~/clawd` and `~/.clawdbot/` as “your stuff”; don’t put personal prompts/config into the `clawdbot` repo.
 - Updating source: `git pull` + `pnpm install` (when lockfile changed) + keep using `pnpm gateway:watch`.
 
 ## Linux (systemd user service)
@@ -140,5 +127,5 @@ user service (no lingering needed). See [Gateway runbook](/gateway) for the syst
 - [Gateway runbook](/gateway) (flags, supervision, ports)
 - [Gateway configuration](/gateway/configuration) (config schema + examples)
 - [Discord](/channels/discord) and [Telegram](/channels/telegram) (reply tags + replyToMode settings)
-- [Pool Bot assistant setup](/start/clawd)
+- [Clawdbot assistant setup](/start/clawd)
 - [macOS app](/platforms/macos) (gateway lifecycle)

package/docs/start/showcase.md

@@ -1,18 +1,18 @@
 ---
 title: "Showcase"
-description: "Real-world Pool Bot projects from the community"
-summary: "Community-built projects and integrations powered by Pool Bot"
+description: "Real-world Clawdbot projects from the community"
+summary: "Community-built projects and integrations powered by Clawdbot"
 ---
 
 # Showcase
 
-Real projects from the community. See what people are building with Pool Bot.
+Real projects from the community. See what people are building with Clawdbot.
 
 <Info>
-**Want to be featured?** Share your project in [#showcase on Discord](https://discord.gg/clawd) or [tag @moltbot on X](https://x.com/moltbot).
+**Want to be featured?** Share your project in [#showcase on Discord](https://discord.gg/clawd) or [tag @clawdbot on X](https://x.com/clawdbot).
 </Info>
 
-## 🎥 Pool Bot in Action
+## 🎥 Clawdbot in Action
 
 Full setup walkthrough (28m) by VelvetShark.
 
@@ -27,7 +27,7 @@ Full setup walkthrough (28m) by VelvetShark.
 >
   <iframe
     src="https://www.youtube-nocookie.com/embed/SaWSPZoPX34"
-    title="Pool Bot: The self-hosted AI that Siri should have been (Full setup)"
+    title="Clawdbot: The self-hosted AI that Siri should have been (Full setup)"
     style={{ position: "absolute", top: 0, left: 0, width: "100%", height: "100%" }}
     frameBorder="0"
     loading="lazy"
@@ -49,7 +49,7 @@ Full setup walkthrough (28m) by VelvetShark.
 >
   <iframe
     src="https://www.youtube-nocookie.com/embed/mMSKQvlmFuQ"
-    title="Pool Bot showcase video"
+    title="Clawdbot showcase video"
     style={{ position: "absolute", top: 0, left: 0, width: "100%", height: "100%" }}
     frameBorder="0"
     loading="lazy"
@@ -71,7 +71,7 @@ Full setup walkthrough (28m) by VelvetShark.
 >
   <iframe
     src="https://www.youtube-nocookie.com/embed/5kkIJNUGFho"
-    title="Pool Bot community showcase"
+    title="Clawdbot community showcase"
     style={{ position: "absolute", top: 0, left: 0, width: "100%", height: "100%" }}
     frameBorder="0"
     loading="lazy"
@@ -89,17 +89,17 @@ Full setup walkthrough (28m) by VelvetShark.
 <Card title="PR Review → Telegram Feedback" icon="code-pull-request" href="https://x.com/i/status/2010878524543131691">
   **@bangnokia** • `review` `github` `telegram`
 
-  OpenCode finishes the change → opens a PR → Pool Bot reviews the diff and replies in Telegram with “minor suggestions” plus a clear merge verdict (including critical fixes to apply first).
+  OpenCode finishes the change → opens a PR → Clawdbot reviews the diff and replies in Telegram with “minor suggestions” plus a clear merge verdict (including critical fixes to apply first).
 
-  <img src="/assets/showcase/pr-review-telegram.jpg" alt="Pool Bot PR review feedback delivered in Telegram" />
+  <img src="/assets/showcase/pr-review-telegram.jpg" alt="Clawdbot PR review feedback delivered in Telegram" />
 </Card>
 
 <Card title="Wine Cellar Skill in Minutes" icon="wine-glass" href="https://x.com/i/status/2010916352454791216">
   **@prades_maxime** • `skills` `local` `csv`
 
-  Asked “Robby” (@moltbot) for a local wine cellar skill. It requests a sample CSV export + where to store it, then builds/tests the skill fast (962 bottles in the example).
+  Asked “Robby” (@clawdbot) for a local wine cellar skill. It requests a sample CSV export + where to store it, then builds/tests the skill fast (962 bottles in the example).
 
-  <img src="/assets/showcase/wine-cellar-skill.jpg" alt="Pool Bot building a local wine cellar skill from CSV" />
+  <img src="/assets/showcase/wine-cellar-skill.jpg" alt="Clawdbot building a local wine cellar skill from CSV" />
 </Card>
 
 <Card title="Tesco Shop Autopilot" icon="cart-shopping" href="https://x.com/i/status/2009724862470689131">
@@ -121,7 +121,7 @@ Full setup walkthrough (28m) by VelvetShark.
 <Card title="Agents UI" icon="window-maximize" href="https://releaseflow.net/kitze/agents-ui">
   **@kitze** • `ui` `skills` `sync`
 
-  Desktop app to manage skills/commands across Agents, Claude, Codex, and Pool Bot.
+  Desktop app to manage skills/commands across Agents, Claude, Codex, and Clawdbot.
 
   <img src="/assets/showcase/agents-ui.jpg" alt="Agents UI app" />
 </Card>
@@ -167,7 +167,7 @@ Full setup walkthrough (28m) by VelvetShark.
 <Card title="R2 Upload (Send Me My Files)" icon="cloud-arrow-up" href="https://clawdhub.com/skills/r2-upload">
   **@julianengel** • `files` `r2` `presigned-urls`
 
-  Upload to Cloudflare R2/S3 and generate secure presigned download links. Perfect for remote Pool Bot instances.
+  Upload to Cloudflare R2/S3 and generate secure presigned download links. Perfect for remote Clawdbot instances.
 </Card>
 
 <Card title="iOS App via Telegram" icon="mobile" href="#">
@@ -194,7 +194,7 @@ Full setup walkthrough (28m) by VelvetShark.
 <Card title="Linear CLI" icon="terminal" href="https://github.com/Finesssee/linear-cli">
   **@NessZerra** • `devtools` `linear` `cli` `issues`
 
-  CLI for Linear that integrates with agentic workflows (Claude Code, Pool Bot). Manage issues, projects, and workflows from the terminal. First external PR merged!
+  CLI for Linear that integrates with agentic workflows (Claude Code, Clawdbot). Manage issues, projects, and workflows from the terminal. First external PR merged!
 </Card>
 
 <Card title="Beeper CLI" icon="message" href="https://github.com/blqke/beepcli">
@@ -212,23 +212,23 @@ Full setup walkthrough (28m) by VelvetShark.
 <Card title="Winix Air Purifier Control" icon="wind" href="https://x.com/antonplex/status/2010518442471006253">
   **@antonplex** • `automation` `hardware` `air-quality`
 
-  Claude Code discovered and confirmed the purifier controls, then Pool Bot takes over to manage room air quality.
+  Claude Code discovered and confirmed the purifier controls, then Clawdbot takes over to manage room air quality.
 
-  <img src="/assets/showcase/winix-air-purifier.jpg" alt="Winix air purifier control via Pool Bot" />
+  <img src="/assets/showcase/winix-air-purifier.jpg" alt="Winix air purifier control via Clawdbot" />
 </Card>
 
 <Card title="Pretty Sky Camera Shots" icon="camera" href="https://x.com/signalgaining/status/2010523120604746151">
   **@signalgaining** • `automation` `camera` `skill` `images`
 
-  Triggered by a roof camera: ask Pool Bot to snap a sky photo whenever it looks pretty — it designed a skill and took the shot.
+  Triggered by a roof camera: ask Clawdbot to snap a sky photo whenever it looks pretty — it designed a skill and took the shot.
 
-  <img src="/assets/showcase/roof-camera-sky.jpg" alt="Roof camera sky snapshot captured by Pool Bot" />
+  <img src="/assets/showcase/roof-camera-sky.jpg" alt="Roof camera sky snapshot captured by Clawdbot" />
 </Card>
 
 <Card title="Visual Morning Briefing Scene" icon="robot" href="https://x.com/buddyhadry/status/2010005331925954739">
   **@buddyhadry** • `automation` `briefing` `images` `telegram`
 
-  A scheduled prompt generates a single "scene" image each morning (weather, tasks, date, favorite post/quote) via a Pool Bot persona.
+  A scheduled prompt generates a single "scene" image each morning (weather, tasks, date, favorite post/quote) via a Clawdbot persona.
 </Card>
 
 <Card title="Padel Court Booking" icon="calendar-check" href="https://github.com/joshp123/padel-cli">
@@ -260,13 +260,13 @@ Full setup walkthrough (28m) by VelvetShark.
 <Card title="Jira Skill Builder" icon="diagram-project" href="https://x.com/jdrhyne/status/2008336434827002232">
   **@jdrhyne** • `automation` `jira` `skill` `devtools`
 
-  Pool Bot connected to Jira, then generated a new skill on the fly (before it existed on ClawdHub).
+  Clawdbot connected to Jira, then generated a new skill on the fly (before it existed on ClawdHub).
 </Card>
 
 <Card title="Todoist Skill via Telegram" icon="list-check" href="https://x.com/iamsubhrajyoti/status/2009949389884920153">
   **@iamsubhrajyoti** • `automation` `todoist` `skill` `telegram`
 
-  Automated Todoist tasks and had Pool Bot generate the skill directly in Telegram chat.
+  Automated Todoist tasks and had Clawdbot generate the skill directly in Telegram chat.
 </Card>
 
 <Card title="TradingView Analysis" icon="chart-line">
@@ -290,7 +290,7 @@ Full setup walkthrough (28m) by VelvetShark.
 <Card title="xuezh Chinese Learning" icon="language" href="https://github.com/joshp123/xuezh">
   **@joshp123** • `learning` `voice` `skill`
   
-  Chinese learning engine with pronunciation feedback and study flows via Pool Bot.
+  Chinese learning engine with pronunciation feedback and study flows via Clawdbot.
   
   <img src="/assets/showcase/xuezh-pronunciation.jpeg" alt="xuezh pronunciation feedback" />
 </Card>
@@ -322,7 +322,7 @@ Full setup walkthrough (28m) by VelvetShark.
 <Card title="Clawdia Phone Bridge" icon="phone" href="https://github.com/alejandroOPI/clawdia-bridge">
   **@alejandroOPI** • `voice` `vapi` `bridge`
   
-  Vapi voice assistant ↔ Pool Bot HTTP bridge. Near real-time phone calls with your agent.
+  Vapi voice assistant ↔ Clawdbot HTTP bridge. Near real-time phone calls with your agent.
 </Card>
 
 <Card title="OpenRouter Transcription" icon="microphone" href="https://clawdhub.com/obviyus/openrouter-transcribe">
@@ -337,10 +337,10 @@ Full setup walkthrough (28m) by VelvetShark.
 
 <CardGroup cols={2}>
 
-<Card title="Home Assistant Add-on" icon="home" href="https://github.com/ngutman/moltbot-ha-addon">
+<Card title="Home Assistant Add-on" icon="home" href="https://github.com/ngutman/clawdbot-ha-addon">
   **@ngutman** • `homeassistant` `docker` `raspberry-pi`
   
-  Pool Bot gateway running on Home Assistant OS with SSH tunnel support and persistent state.
+  Clawdbot gateway running on Home Assistant OS with SSH tunnel support and persistent state.
 </Card>
 
 <Card title="Home Assistant Skill" icon="toggle-on" href="https://clawdhub.com/skills/homeassistant">
@@ -349,10 +349,10 @@ Full setup walkthrough (28m) by VelvetShark.
   Control and automate Home Assistant devices via natural language.
 </Card>
 
-<Card title="Nix Packaging" icon="snowflake" href="https://github.com/moltbot/nix-moltbot">
-  **@moltbot** • `nix` `packaging` `deployment`
+<Card title="Nix Packaging" icon="snowflake" href="https://github.com/clawdbot/nix-clawdbot">
+  **@clawdbot** • `nix` `packaging` `deployment`
   
-  Batteries-included nixified Pool Bot configuration for reproducible deployments.
+  Batteries-included nixified Clawdbot configuration for reproducible deployments.
 </Card>
 
 <Card title="CalDAV Calendar" icon="calendar" href="https://clawdhub.com/skills/caldav-calendar">
@@ -370,7 +370,7 @@ Full setup walkthrough (28m) by VelvetShark.
 <Card title="GoHome Automation" icon="house-signal" href="https://github.com/joshp123/gohome">
   **@joshp123** • `home` `nix` `grafana`
   
-  Nix-native home automation with Pool Bot as the interface, plus beautiful Grafana dashboards.
+  Nix-native home automation with Clawdbot as the interface, plus beautiful Grafana dashboards.
   
   <img src="/assets/showcase/gohome-grafana.png" alt="GoHome Grafana dashboard" />
 </Card>
@@ -392,7 +392,7 @@ Full setup walkthrough (28m) by VelvetShark.
 <Card title="StarSwap Marketplace" icon="star" href="https://star-swap.com/">
   **Community** • `marketplace` `astronomy` `webapp`
   
-  Full astronomy gear marketplace. Built with/around the Pool Bot ecosystem.
+  Full astronomy gear marketplace. Built with/around the Clawdbot ecosystem.
 </Card>
 
 </CardGroup>
@@ -405,7 +405,7 @@ Have something to share? We'd love to feature it!
 
 <Steps>
   <Step title="Share It">
-    Post in [#showcase on Discord](https://discord.gg/clawd) or [tweet @moltbot](https://x.com/moltbot)
+    Post in [#showcase on Discord](https://discord.gg/clawd) or [tweet @clawdbot](https://x.com/clawdbot)
   </Step>
   <Step title="Include Details">
     Tell us what it does, link to the repo/demo, share a screenshot if you have one

package/docs/start/wizard.md

@@ -7,7 +7,7 @@ read_when:
 
 # Onboarding Wizard (CLI)
 
-The onboarding wizard is the **recommended** way to set up Pool Bot on macOS,
+The onboarding wizard is the **recommended** way to set up Clawdbot on macOS,
 Linux, or Windows (via WSL2; strongly recommended).
 It configures a local Gateway or a remote Gateway connection, plus channels, skills,
 and workspace defaults in one guided flow.
@@ -15,20 +15,17 @@ and workspace defaults in one guided flow.
 Primary entrypoint:
 
 ```bash
-moltbot onboard
+clawdbot onboard
 ```
 
-Fastest first chat: open the Control UI (no channel setup needed). Run
-`moltbot dashboard` and chat in the browser. Docs: [Dashboard](/web/dashboard).
-
 Follow‑up reconfiguration:
 
 ```bash
-moltbot configure
+clawdbot configure
 ```
 
 Recommended: set up a Brave Search API key so the agent can use `web_search`
-(`web_fetch` works without a key). Easiest path: `moltbot configure --section web`
+(`web_fetch` works without a key). Easiest path: `clawdbot configure --section web`
 which stores `tools.web.search.apiKey`. Docs: [Web tools](/tools/web).
 
 ## QuickStart vs Advanced
@@ -62,7 +59,7 @@ It does **not** install or change anything on the remote host.
 To add more isolated agents (separate workspace + sessions + auth), use:
 
 ```bash
-moltbot agents add <name>
+clawdbot agents add <name>
 ```
 
 Tip: `--json` does **not** imply non-interactive mode. Use `--non-interactive` (and `--workspace`) for scripts.
@@ -70,11 +67,11 @@ Tip: `--json` does **not** imply non-interactive mode. Use `--non-interactive` (
 ## Flow details (local)
 
 1) **Existing config detection**
-   - If `~/.clawdbot/moltbot.json` exists, choose **Keep / Modify / Reset**.
+   - If `~/.clawdbot/clawdbot.json` exists, choose **Keep / Modify / Reset**.
    - Re-running the wizard does **not** wipe anything unless you explicitly choose **Reset**
      (or pass `--reset`).
    - If the config is invalid or contains legacy keys, the wizard stops and asks
-     you to run `moltbot doctor` before continuing.
+     you to run `clawdbot doctor` before continuing.
    - Reset uses `trash` (never `rm`) and offers scopes:
      - Config only
      - Config + credentials + sessions
@@ -124,7 +121,7 @@ Tip: `--json` does **not** imply non-interactive mode. Use `--non-interactive` (
   - Mattermost (plugin): bot token + base URL.
    - Signal: optional `signal-cli` install + account config.
    - iMessage: local `imsg` CLI path + DB access.
-  - DM security: default is pairing. First DM sends a code; approve via `moltbot pairing approve <channel> <code>` or use allowlists.
+  - DM security: default is pairing. First DM sends a code; approve via `clawdbot pairing approve <channel> <code>` or use allowlists.
 
 6) **Daemon install**
    - macOS: LaunchAgent
@@ -135,8 +132,8 @@ Tip: `--json` does **not** imply non-interactive mode. Use `--non-interactive` (
    - **Runtime selection:** Node (recommended; required for WhatsApp/Telegram). Bun is **not recommended**.
 
 7) **Health check**
-   - Starts the Gateway (if needed) and runs `moltbot health`.
-   - Tip: `moltbot status --deep` adds gateway health probes to status output (requires a reachable gateway).
+   - Starts the Gateway (if needed) and runs `clawdbot health`.
+   - Tip: `clawdbot status --deep` adds gateway health probes to status output (requires a reachable gateway).
 
 8) **Skills (recommended)**
    - Reads the available skills and checks requirements.
@@ -165,7 +162,7 @@ Notes:
 
 ## Add another agent
 
-Use `moltbot agents add <name>` to create a separate agent with its own workspace,
+Use `clawdbot agents add <name>` to create a separate agent with its own workspace,
 sessions, and auth profiles. Running without `--workspace` launches the wizard.
 
 What it sets:
@@ -183,7 +180,7 @@ Notes:
 Use `--non-interactive` to automate or script onboarding:
 
 ```bash
-moltbot onboard --non-interactive \
+clawdbot onboard --non-interactive \
   --mode local \
   --auth-choice apiKey \
   --anthropic-api-key "$ANTHROPIC_API_KEY" \
@@ -199,7 +196,7 @@ Add `--json` for a machine‑readable summary.
 Gemini example:
 
 ```bash
-moltbot onboard --non-interactive \
+clawdbot onboard --non-interactive \
   --mode local \
   --auth-choice gemini-api-key \
   --gemini-api-key "$GEMINI_API_KEY" \
@@ -210,7 +207,7 @@ moltbot onboard --non-interactive \
 Z.AI example:
 
 ```bash
-moltbot onboard --non-interactive \
+clawdbot onboard --non-interactive \
   --mode local \
   --auth-choice zai-api-key \
   --zai-api-key "$ZAI_API_KEY" \
@@ -221,7 +218,7 @@ moltbot onboard --non-interactive \
 Vercel AI Gateway example:
 
 ```bash
-moltbot onboard --non-interactive \
+clawdbot onboard --non-interactive \
   --mode local \
   --auth-choice ai-gateway-api-key \
   --ai-gateway-api-key "$AI_GATEWAY_API_KEY" \
@@ -232,7 +229,7 @@ moltbot onboard --non-interactive \
 Moonshot example:
 
 ```bash
-moltbot onboard --non-interactive \
+clawdbot onboard --non-interactive \
   --mode local \
   --auth-choice moonshot-api-key \
   --moonshot-api-key "$MOONSHOT_API_KEY" \
@@ -243,7 +240,7 @@ moltbot onboard --non-interactive \
 Synthetic example:
 
 ```bash
-moltbot onboard --non-interactive \
+clawdbot onboard --non-interactive \
   --mode local \
   --auth-choice synthetic-api-key \
   --synthetic-api-key "$SYNTHETIC_API_KEY" \
@@ -254,7 +251,7 @@ moltbot onboard --non-interactive \
 OpenCode Zen example:
 
 ```bash
-moltbot onboard --non-interactive \
+clawdbot onboard --non-interactive \
   --mode local \
   --auth-choice opencode-zen \
   --opencode-zen-api-key "$OPENCODE_API_KEY" \
@@ -265,7 +262,7 @@ moltbot onboard --non-interactive \
 Add agent (non‑interactive) example:
 
 ```bash
-moltbot agents add work \
+clawdbot agents add work \
   --workspace ~/clawd-work \
   --model openai/gpt-5.2 \
   --bind whatsapp:biz \
@@ -292,7 +289,7 @@ Notes:
 
 ## What the wizard writes
 
-Typical fields in `~/.clawdbot/moltbot.json`:
+Typical fields in `~/.clawdbot/clawdbot.json`:
 - `agents.defaults.workspace`
 - `agents.defaults.model` / `models.providers` (if Minimax chosen)
 - `gateway.*` (mode, bind, auth, tailscale)
@@ -305,7 +302,7 @@ Typical fields in `~/.clawdbot/moltbot.json`:
 - `wizard.lastRunCommand`
 - `wizard.lastRunMode`
 
-`moltbot agents add` writes `agents.list[]` and optional `bindings`.
+`clawdbot agents add` writes `agents.list[]` and optional `bindings`.
 
 WhatsApp credentials go under `~/.clawdbot/credentials/whatsapp/<accountId>/`.
 Sessions are stored under `~/.clawdbot/agents/<agentId>/sessions/`.

package/docs/testing.md

@@ -8,7 +8,7 @@ read_when:
 
 # Testing
 
-Pool Bot has three Vitest suites (unit/integration, e2e, live) and a small set of Docker runners.
+Clawdbot has three Vitest suites (unit/integration, e2e, live) and a small set of Docker runners.
 
 This doc is a “how we test” guide:
 - What each suite covers (and what it deliberately does *not* cover)
@@ -113,7 +113,7 @@ Live tests are split into two layers so we can isolate failures:
   - Separates “provider API is broken / key is invalid” from “gateway agent pipeline is broken”
   - Contains small, isolated regressions (example: OpenAI Responses/Codex Responses reasoning replay + tool-call flows)
 
-### Layer 2: Gateway + dev agent smoke (what “@moltbot” actually does)
+### Layer 2: Gateway + dev agent smoke (what “@clawdbot” actually does)
 
 - Test: `src/gateway/gateway-models.profiles.live.test.ts`
 - Goal:
@@ -150,8 +150,8 @@ Live tests are split into two layers so we can isolate failures:
 Tip: to see what you can test on your machine (and the exact `provider/model` ids), run:
 
 ```bash
-moltbot models list
-moltbot models list --json
+clawdbot models list
+clawdbot models list --json
 ```
 
 ## Live: Anthropic setup-token smoke
@@ -170,7 +170,7 @@ moltbot models list --json
 Setup example:
 
 ```bash
-moltbot models auth paste-token --provider anthropic --profile-id anthropic:setup-token-test
+clawdbot models auth paste-token --provider anthropic --profile-id anthropic:setup-token-test
 CLAWDBOT_LIVE_SETUP_TOKEN=1 CLAWDBOT_LIVE_SETUP_TOKEN_PROFILE=anthropic:setup-token-test pnpm test:live src/agents/anthropic.setup-token.live.test.ts
 ```
 
@@ -227,8 +227,8 @@ Notes:
 - `google-antigravity/...` uses the Antigravity OAuth bridge (Cloud Code Assist-style agent endpoint).
 - `google-gemini-cli/...` uses the local Gemini CLI on your machine (separate auth + tooling quirks).
 - Gemini API vs Gemini CLI:
-  - API: Pool Bot calls Google’s hosted Gemini API over HTTP (API key / profile auth); this is what most users mean by “Gemini”.
-  - CLI: Pool Bot shells out to a local `gemini` binary; it has its own auth and can behave differently (streaming/tool support/version skew).
+  - API: Clawdbot calls Google’s hosted Gemini API over HTTP (API key / profile auth); this is what most users mean by “Gemini”.
+  - CLI: Clawdbot shells out to a local `gemini` binary; it has its own auth and can behave differently (streaming/tool support/version skew).
 
 ## Live: model matrix (what we cover)
 
@@ -270,7 +270,7 @@ Include at least one image-capable model in `CLAWDBOT_LIVE_GATEWAY_MODELS` (Clau
 ### Aggregators / alternate gateways
 
 If you have keys enabled, we also support testing via:
-- OpenRouter: `openrouter/...` (hundreds of models; use `moltbot models scan` to find tool+image capable candidates)
+- OpenRouter: `openrouter/...` (hundreds of models; use `clawdbot models scan` to find tool+image capable candidates)
 - OpenCode Zen: `opencode/...` (auth via `OPENCODE_API_KEY` / `OPENCODE_ZEN_API_KEY`)
 
 More providers you can include in the live matrix (if you have creds/config):
@@ -283,10 +283,10 @@ Tip: don’t try to hardcode “all models” in docs. The authoritative list is
 
 Live tests discover credentials the same way the CLI does. Practical implications:
 - If the CLI works, live tests should find the same keys.
-- If a live test says “no creds”, debug the same way you’d debug `moltbot models list` / model selection.
+- If a live test says “no creds”, debug the same way you’d debug `clawdbot models list` / model selection.
 
 - Profile store: `~/.clawdbot/credentials/` (preferred; what “profile keys” means in the tests)
-- Config: `~/.clawdbot/moltbot.json` (or `CLAWDBOT_CONFIG_PATH`)
+- Config: `~/.clawdbot/clawdbot.json` (or `CLAWDBOT_CONFIG_PATH`)
 
 If you want to rely on env keys (e.g. exported in your `~/.profile`), run local tests after `source ~/.profile`, or use the Docker runners below (they can mount `~/.profile` into the container).
 

package/docs/token-use.md

@@ -1,17 +1,17 @@
 ---
-summary: "How Pool Bot builds prompt context and reports token usage + costs"
+summary: "How Clawdbot builds prompt context and reports token usage + costs"
 read_when:
   - Explaining token usage, costs, or context windows
   - Debugging context growth or compaction behavior
 ---
 # Token use & costs
 
-Pool Bot tracks **tokens**, not characters. Tokens are model-specific, but most
+Clawdbot tracks **tokens**, not characters. Tokens are model-specific, but most
 OpenAI-style models average ~4 characters per token for English text.
 
 ## How the system prompt is built
 
-Pool Bot assembles its own system prompt on every run. It includes:
+Clawdbot assembles its own system prompt on every run. It includes:
 
 - Tool list + short descriptions
 - Skills list (only metadata; instructions are loaded on demand with `read`)
@@ -45,12 +45,12 @@ Use these in chat:
 - `/usage off|tokens|full` → appends a **per-response usage footer** to every reply.
   - Persists per session (stored as `responseUsage`).
   - OAuth auth **hides cost** (tokens only).
-- `/usage cost` → shows a local cost summary from Pool Bot session logs.
+- `/usage cost` → shows a local cost summary from Clawdbot session logs.
 
 Other surfaces:
 
 - **TUI/Web TUI:** `/status` + `/usage` are supported.
-- **CLI:** `moltbot status --usage` and `moltbot channels list` show
+- **CLI:** `clawdbot status --usage` and `clawdbot channels list` show
   provider quota windows (not per-response costs).
 
 ## Cost estimation (when shown)
@@ -62,12 +62,12 @@ models.providers.<provider>.models[].cost
 ```
 
 These are **USD per 1M tokens** for `input`, `output`, `cacheRead`, and
-`cacheWrite`. If pricing is missing, Pool Bot shows tokens only. OAuth tokens
+`cacheWrite`. If pricing is missing, Clawdbot shows tokens only. OAuth tokens
 never show dollar cost.
 
 ## Cache TTL and pruning impact
 
-Provider prompt caching only applies within the cache TTL window. Pool Bot can
+Provider prompt caching only applies within the cache TTL window. Clawdbot can
 optionally run **cache-ttl pruning**: it prunes the session once the cache TTL
 has expired, then resets the cache window so subsequent requests can re-use the
 freshly cached context instead of re-caching the full history. This keeps cache