@poolzin/pool-bot 1.28.0 → 2026.1.26

package/docs/cli/acp.md

@@ -7,7 +7,7 @@ read_when:
 
 # acp
 
-Run the ACP (Agent Client Protocol) bridge that talks to a Pool Bot Gateway.
+Run the ACP (Agent Client Protocol) bridge that talks to a Clawdbot Gateway.
 
 This command speaks ACP over stdio for IDEs and forwards prompts to the Gateway
 over WebSocket. It keeps ACP sessions mapped to Gateway session keys.
@@ -15,19 +15,19 @@ over WebSocket. It keeps ACP sessions mapped to Gateway session keys.
 ## Usage
 
 ```bash
-moltbot acp
+clawdbot acp
 
 # Remote Gateway
-moltbot acp --url wss://gateway-host:18789 --token <token>
+clawdbot acp --url wss://gateway-host:18789 --token <token>
 
 # Attach to an existing session key
-moltbot acp --session agent:main:main
+clawdbot acp --session agent:main:main
 
 # Attach by label (must already exist)
-moltbot acp --session-label "support inbox"
+clawdbot acp --session-label "support inbox"
 
 # Reset the session key before the first prompt
-moltbot acp --session agent:main:main --reset-session
+clawdbot acp --session agent:main:main --reset-session
 ```
 
 ## ACP client (debug)
@@ -36,35 +36,35 @@ Use the built-in ACP client to sanity-check the bridge without an IDE.
 It spawns the ACP bridge and lets you type prompts interactively.
 
 ```bash
-moltbot acp client
+clawdbot acp client
 
 # Point the spawned bridge at a remote Gateway
-moltbot acp client --server-args --url wss://gateway-host:18789 --token <token>
+clawdbot acp client --server-args --url wss://gateway-host:18789 --token <token>
 
-# Override the server command (default: moltbot)
-moltbot acp client --server "node" --server-args dist/entry.js acp --url ws://127.0.0.1:19001
+# Override the server command (default: clawdbot)
+clawdbot acp client --server "node" --server-args dist/entry.js acp --url ws://127.0.0.1:19001
 ```
 
 ## How to use this
 
 Use ACP when an IDE (or other client) speaks Agent Client Protocol and you want
-it to drive a Pool Bot Gateway session.
+it to drive a Clawdbot Gateway session.
 
 1. Ensure the Gateway is running (local or remote).
 2. Configure the Gateway target (config or flags).
-3. Point your IDE to run `moltbot acp` over stdio.
+3. Point your IDE to run `clawdbot acp` over stdio.
 
 Example config (persisted):
 
 ```bash
-moltbot config set gateway.remote.url wss://gateway-host:18789
-moltbot config set gateway.remote.token <token>
+clawdbot config set gateway.remote.url wss://gateway-host:18789
+clawdbot config set gateway.remote.token <token>
 ```
 
 Example direct run (no config write):
 
 ```bash
-moltbot acp --url wss://gateway-host:18789 --token <token>
+clawdbot acp --url wss://gateway-host:18789 --token <token>
 ```
 
 ## Selecting agents
@@ -74,9 +74,9 @@ ACP does not pick agents directly. It routes by the Gateway session key.
 Use agent-scoped session keys to target a specific agent:
 
 ```bash
-moltbot acp --session agent:main:main
-moltbot acp --session agent:design:main
-moltbot acp --session agent:qa:bug-123
+clawdbot acp --session agent:main:main
+clawdbot acp --session agent:design:main
+clawdbot acp --session agent:qa:bug-123
 ```
 
 Each ACP session maps to a single Gateway session key. One agent can have many
@@ -90,9 +90,9 @@ Add a custom ACP agent in `~/.config/zed/settings.json` (or use Zed’s Settings
 ```json
 {
   "agent_servers": {
-    "Pool Bot ACP": {
+    "Clawdbot ACP": {
       "type": "custom",
-      "command": "moltbot",
+      "command": "clawdbot",
       "args": ["acp"],
       "env": {}
     }
@@ -105,9 +105,9 @@ To target a specific Gateway or agent:
 ```json
 {
   "agent_servers": {
-    "Pool Bot ACP": {
+    "Clawdbot ACP": {
       "type": "custom",
-      "command": "moltbot",
+      "command": "clawdbot",
       "args": [
         "acp",
         "--url", "wss://gateway-host:18789",
@@ -120,7 +120,7 @@ To target a specific Gateway or agent:
 }
 ```
 
-In Zed, open the Agent panel and select “Pool Bot ACP” to start a thread.
+In Zed, open the Agent panel and select “Clawdbot ACP” to start a thread.
 
 ## Session mapping
 
@@ -160,7 +160,7 @@ Learn more about session keys at [/concepts/session](/concepts/session).
 ### `acp client` options
 
 - `--cwd <dir>`: working directory for the ACP session.
-- `--server <command>`: ACP server command (default: `moltbot`).
+- `--server <command>`: ACP server command (default: `clawdbot`).
 - `--server-args <args...>`: extra arguments passed to the ACP server.
 - `--server-verbose`: enable verbose logging on the ACP server.
 - `--verbose, -v`: verbose client logging.

package/docs/cli/agent.md

@@ -1,10 +1,10 @@
 ---
-summary: "CLI reference for `moltbot agent` (send one agent turn via the Gateway)"
+summary: "CLI reference for `clawdbot agent` (send one agent turn via the Gateway)"
 read_when:
   - You want to run one agent turn from scripts (optionally deliver reply)
 ---
 
-# `moltbot agent`
+# `clawdbot agent`
 
 Run an agent turn via the Gateway (use `--local` for embedded).
 Use `--agent <id>` to target a configured agent directly.
@@ -15,8 +15,8 @@ Related:
 ## Examples
 
 ```bash
-moltbot agent --to +15555550123 --message "status update" --deliver
-moltbot agent --agent ops --message "Summarize logs"
-moltbot agent --session-id 1234 --message "Summarize inbox" --thinking medium
-moltbot agent --agent ops --message "Generate report" --deliver --reply-channel slack --reply-to "#reports"
+clawdbot agent --to +15555550123 --message "status update" --deliver
+clawdbot agent --agent ops --message "Summarize logs"
+clawdbot agent --session-id 1234 --message "Summarize inbox" --thinking medium
+clawdbot agent --agent ops --message "Generate report" --deliver --reply-channel slack --reply-to "#reports"
 ```

package/docs/cli/agents.md

@@ -1,10 +1,10 @@
 ---
-summary: "CLI reference for `moltbot agents` (list/add/delete/set identity)"
+summary: "CLI reference for `clawdbot agents` (list/add/delete/set identity)"
 read_when:
   - You want multiple isolated agents (workspaces + routing + auth)
 ---
 
-# `moltbot agents`
+# `clawdbot agents`
 
 Manage isolated agents (workspaces + auth + routing).
 
@@ -15,11 +15,11 @@ Related:
 ## Examples
 
 ```bash
-moltbot agents list
-moltbot agents add work --workspace ~/clawd-work
-moltbot agents set-identity --workspace ~/clawd --from-identity
-moltbot agents set-identity --agent main --avatar avatars/clawd.png
-moltbot agents delete work
+clawdbot agents list
+clawdbot agents add work --workspace ~/clawd-work
+clawdbot agents set-identity --workspace ~/clawd --from-identity
+clawdbot agents set-identity --agent main --avatar avatars/clawd.png
+clawdbot agents delete work
 ```
 
 ## Identity files
@@ -41,13 +41,13 @@ Avatar paths resolve relative to the workspace root.
 Load from `IDENTITY.md`:
 
 ```bash
-moltbot agents set-identity --workspace ~/clawd --from-identity
+clawdbot agents set-identity --workspace ~/clawd --from-identity
 ```
 
 Override fields explicitly:
 
 ```bash
-moltbot agents set-identity --agent main --name "Clawd" --emoji "🦞" --avatar avatars/clawd.png
+clawdbot agents set-identity --agent main --name "Clawd" --emoji "🦞" --avatar avatars/clawd.png
 ```
 
 Config sample:

package/docs/cli/approvals.md

@@ -1,11 +1,11 @@
 ---
-summary: "CLI reference for `moltbot approvals` (exec approvals for gateway or node hosts)"
+summary: "CLI reference for `clawdbot approvals` (exec approvals for gateway or node hosts)"
 read_when:
   - You want to edit exec approvals from the CLI
   - You need to manage allowlists on gateway or node hosts
 ---
 
-# `moltbot approvals`
+# `clawdbot approvals`
 
 Manage exec approvals for the **local host**, **gateway host**, or a **node host**.
 By default, commands target the local approvals file on disk. Use `--gateway` to target the gateway, or `--node` to target a specific node.
@@ -17,32 +17,32 @@ Related:
 ## Common commands
 
 ```bash
-moltbot approvals get
-moltbot approvals get --node <id|name|ip>
-moltbot approvals get --gateway
+clawdbot approvals get
+clawdbot approvals get --node <id|name|ip>
+clawdbot approvals get --gateway
 ```
 
 ## Replace approvals from a file
 
 ```bash
-moltbot approvals set --file ./exec-approvals.json
-moltbot approvals set --node <id|name|ip> --file ./exec-approvals.json
-moltbot approvals set --gateway --file ./exec-approvals.json
+clawdbot approvals set --file ./exec-approvals.json
+clawdbot approvals set --node <id|name|ip> --file ./exec-approvals.json
+clawdbot approvals set --gateway --file ./exec-approvals.json
 ```
 
 ## Allowlist helpers
 
 ```bash
-moltbot approvals allowlist add "~/Projects/**/bin/rg"
-moltbot approvals allowlist add --agent main --node <id|name|ip> "/usr/bin/uptime"
-moltbot approvals allowlist add --agent "*" "/usr/bin/uname"
+clawdbot approvals allowlist add "~/Projects/**/bin/rg"
+clawdbot approvals allowlist add --agent main --node <id|name|ip> "/usr/bin/uptime"
+clawdbot approvals allowlist add --agent "*" "/usr/bin/uname"
 
-moltbot approvals allowlist remove "~/Projects/**/bin/rg"
+clawdbot approvals allowlist remove "~/Projects/**/bin/rg"
 ```
 
 ## Notes
 
-- `--node` uses the same resolver as `moltbot nodes` (id, name, ip, or id prefix).
+- `--node` uses the same resolver as `clawdbot nodes` (id, name, ip, or id prefix).
 - `--agent` defaults to `"*"`, which applies to all agents.
 - The node host must advertise `system.execApprovals.get/set` (macOS app or headless node host).
 - Approvals files are stored per host at `~/.clawdbot/exec-approvals.json`.

package/docs/cli/browser.md

@@ -1,14 +1,14 @@
 ---
-summary: "CLI reference for `moltbot browser` (profiles, tabs, actions, extension relay)"
+summary: "CLI reference for `clawdbot browser` (profiles, tabs, actions, extension relay, remote serve)"
 read_when:
-  - You use `moltbot browser` and want examples for common tasks
-  - You want to control a browser running on another machine via a node host
+  - You use `clawdbot browser` and want examples for common tasks
+  - You want to control a remote browser via `browser.controlUrl`
   - You want to use the Chrome extension relay (attach/detach via toolbar button)
 ---
 
-# `moltbot browser`
+# `clawdbot browser`
 
-Manage Pool Bot’s browser control server and run browser actions (tabs, snapshots, screenshots, navigation, clicks, typing).
+Manage Clawdbot’s browser control server and run browser actions (tabs, snapshots, screenshots, navigation, clicks, typing).
 
 Related:
 - Browser tool + API: [Browser tool](/tools/browser)
@@ -16,46 +16,44 @@ Related:
 
 ## Common flags
 
-- `--url <gatewayWsUrl>`: Gateway WebSocket URL (defaults to config).
-- `--token <token>`: Gateway token (if required).
-- `--timeout <ms>`: request timeout (ms).
-- `--browser-profile <name>`: choose a browser profile (default from config).
+- `--url <controlUrl>`: override `browser.controlUrl` for this command invocation.
+- `--browser-profile <name>`: choose a browser profile (default comes from config).
 - `--json`: machine-readable output (where supported).
 
 ## Quick start (local)
 
 ```bash
-moltbot browser --browser-profile chrome tabs
-moltbot browser --browser-profile clawd start
-moltbot browser --browser-profile clawd open https://example.com
-moltbot browser --browser-profile clawd snapshot
+clawdbot browser --browser-profile chrome tabs
+clawdbot browser --browser-profile clawd start
+clawdbot browser --browser-profile clawd open https://example.com
+clawdbot browser --browser-profile clawd snapshot
 ```
 
 ## Profiles
 
 Profiles are named browser routing configs. In practice:
-- `clawd`: launches/attaches to a dedicated Pool Bot-managed Chrome instance (isolated user data dir).
+- `clawd`: launches/attaches to a dedicated Clawdbot-managed Chrome instance (isolated user data dir).
 - `chrome`: controls your existing Chrome tab(s) via the Chrome extension relay.
 
 ```bash
-moltbot browser profiles
-moltbot browser create-profile --name work --color "#FF5A36"
-moltbot browser delete-profile --name work
+clawdbot browser profiles
+clawdbot browser create-profile --name work --color "#FF5A36"
+clawdbot browser delete-profile --name work
 ```
 
 Use a specific profile:
 
 ```bash
-moltbot browser --browser-profile work tabs
+clawdbot browser --browser-profile work tabs
 ```
 
 ## Tabs
 
 ```bash
-moltbot browser tabs
-moltbot browser open https://docs.molt.bot
-moltbot browser focus <targetId>
-moltbot browser close <targetId>
+clawdbot browser tabs
+clawdbot browser open https://docs.clawd.bot
+clawdbot browser focus <targetId>
+clawdbot browser close <targetId>
 ```
 
 ## Snapshot / screenshot / actions
@@ -63,21 +61,21 @@ moltbot browser close <targetId>
 Snapshot:
 
 ```bash
-moltbot browser snapshot
+clawdbot browser snapshot
 ```
 
 Screenshot:
 
 ```bash
-moltbot browser screenshot
+clawdbot browser screenshot
 ```
 
 Navigate/click/type (ref-based UI automation):
 
 ```bash
-moltbot browser navigate https://example.com
-moltbot browser click <ref>
-moltbot browser type <ref> "hello"
+clawdbot browser navigate https://example.com
+clawdbot browser click <ref>
+clawdbot browser type <ref> "hello"
 ```
 
 ## Chrome extension relay (attach via toolbar button)
@@ -87,18 +85,22 @@ This mode lets the agent control an existing Chrome tab that you attach manually
 Install the unpacked extension to a stable path:
 
 ```bash
-moltbot browser extension install
-moltbot browser extension path
+clawdbot browser extension install
+clawdbot browser extension path
 ```
 
 Then Chrome → `chrome://extensions` → enable “Developer mode” → “Load unpacked” → select the printed folder.
 
 Full guide: [Chrome extension](/tools/chrome-extension)
 
-## Remote browser control (node host proxy)
+## Remote browser control (`clawdbot browser serve`)
 
-If the Gateway runs on a different machine than the browser, run a **node host** on the machine that has Chrome/Brave/Edge/Chromium. The Gateway will proxy browser actions to that node (no separate browser control server required).
+If the Gateway runs on a different machine than the browser, run a standalone browser control server on the machine that runs Chrome:
 
-Use `gateway.nodes.browser.mode` to control auto-routing and `gateway.nodes.browser.node` to pin a specific node if multiple are connected.
+```bash
+clawdbot browser serve --bind 127.0.0.1 --port 18791 --token <token>
+```
+
+Then point the Gateway at it using `browser.controlUrl` + `browser.controlToken` (or `CLAWDBOT_BROWSER_CONTROL_TOKEN`).
 
-Security + remote setup: [Browser tool](/tools/browser), [Remote access](/gateway/remote), [Tailscale](/gateway/tailscale), [Security](/gateway/security)
+Security + TLS best-practices: [Browser tool](/tools/browser), [Tailscale](/gateway/tailscale), [Security](/gateway/security)

package/docs/cli/channels.md

@@ -1,11 +1,11 @@
 ---
-summary: "CLI reference for `moltbot channels` (accounts, status, login/logout, logs)"
+summary: "CLI reference for `clawdbot channels` (accounts, status, login/logout, logs)"
 read_when:
   - You want to add/remove channel accounts (WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost (plugin)/Signal/iMessage)
   - You want to check channel status or tail channel logs
 ---
 
-# `moltbot channels`
+# `clawdbot channels`
 
 Manage chat channel accounts and their runtime status on the Gateway.
 
@@ -16,43 +16,43 @@ Related docs:
 ## Common commands
 
 ```bash
-moltbot channels list
-moltbot channels status
-moltbot channels capabilities
-moltbot channels capabilities --channel discord --target channel:123
-moltbot channels resolve --channel slack "#general" "@jane"
-moltbot channels logs --channel all
+clawdbot channels list
+clawdbot channels status
+clawdbot channels capabilities
+clawdbot channels capabilities --channel discord --target channel:123
+clawdbot channels resolve --channel slack "#general" "@jane"
+clawdbot channels logs --channel all
 ```
 
 ## Add / remove accounts
 
 ```bash
-moltbot channels add --channel telegram --token <bot-token>
-moltbot channels remove --channel telegram --delete
+clawdbot channels add --channel telegram --token <bot-token>
+clawdbot channels remove --channel telegram --delete
 ```
 
-Tip: `moltbot channels add --help` shows per-channel flags (token, app token, signal-cli paths, etc).
+Tip: `clawdbot channels add --help` shows per-channel flags (token, app token, signal-cli paths, etc).
 
 ## Login / logout (interactive)
 
 ```bash
-moltbot channels login --channel whatsapp
-moltbot channels logout --channel whatsapp
+clawdbot channels login --channel whatsapp
+clawdbot channels logout --channel whatsapp
 ```
 
 ## Troubleshooting
 
-- Run `moltbot status --deep` for a broad probe.
-- Use `moltbot doctor` for guided fixes.
-- `moltbot channels list` prints `Claude: HTTP 403 ... user:profile` → usage snapshot needs the `user:profile` scope. Use `--no-usage`, or provide a claude.ai session key (`CLAUDE_WEB_SESSION_KEY` / `CLAUDE_WEB_COOKIE`), or re-auth via Claude Code CLI.
+- Run `clawdbot status --deep` for a broad probe.
+- Use `clawdbot doctor` for guided fixes.
+- `clawdbot channels list` prints `Claude: HTTP 403 ... user:profile` → usage snapshot needs the `user:profile` scope. Use `--no-usage`, or provide a claude.ai session key (`CLAUDE_WEB_SESSION_KEY` / `CLAUDE_WEB_COOKIE`), or re-auth via Claude Code CLI.
 
 ## Capabilities probe
 
 Fetch provider capability hints (intents/scopes where available) plus static feature support:
 
 ```bash
-moltbot channels capabilities
-moltbot channels capabilities --channel discord --target channel:123
+clawdbot channels capabilities
+clawdbot channels capabilities --channel discord --target channel:123
 ```
 
 Notes:
@@ -65,9 +65,9 @@ Notes:
 Resolve channel/user names to IDs using the provider directory:
 
 ```bash
-moltbot channels resolve --channel slack "#general" "@jane"
-moltbot channels resolve --channel discord "My Server/#support" "@someone"
-moltbot channels resolve --channel matrix "Project Room"
+clawdbot channels resolve --channel slack "#general" "@jane"
+clawdbot channels resolve --channel discord "My Server/#support" "@someone"
+clawdbot channels resolve --channel matrix "Project Room"
 ```
 
 Notes:

package/docs/cli/config.md

@@ -1,22 +1,22 @@
 ---
-summary: "CLI reference for `moltbot config` (get/set/unset config values)"
+summary: "CLI reference for `clawdbot config` (get/set/unset config values)"
 read_when:
   - You want to read or edit config non-interactively
 ---
 
-# `moltbot config`
+# `clawdbot config`
 
 Config helpers: get/set/unset values by path. Run without a subcommand to open
-the configure wizard (same as `moltbot configure`).
+the configure wizard (same as `clawdbot configure`).
 
 ## Examples
 
 ```bash
-moltbot config get browser.executablePath
-moltbot config set browser.executablePath "/usr/bin/google-chrome"
-moltbot config set agents.defaults.heartbeat.every "2h"
-moltbot config set agents.list[0].tools.exec.node "node-id-or-name"
-moltbot config unset tools.web.search.apiKey
+clawdbot config get browser.executablePath
+clawdbot config set browser.executablePath "/usr/bin/google-chrome"
+clawdbot config set agents.defaults.heartbeat.every "2h"
+clawdbot config set agents.list[0].tools.exec.node "node-id-or-name"
+clawdbot config unset tools.web.search.apiKey
 ```
 
 ## Paths
@@ -24,15 +24,15 @@ moltbot config unset tools.web.search.apiKey
 Paths use dot or bracket notation:
 
 ```bash
-moltbot config get agents.defaults.workspace
-moltbot config get agents.list[0].id
+clawdbot config get agents.defaults.workspace
+clawdbot config get agents.list[0].id
 ```
 
 Use the agent list index to target a specific agent:
 
 ```bash
-moltbot config get agents.list
-moltbot config set agents.list[1].tools.exec.node "node-id-or-name"
+clawdbot config get agents.list
+clawdbot config set agents.list[1].tools.exec.node "node-id-or-name"
 ```
 
 ## Values
@@ -41,9 +41,9 @@ Values are parsed as JSON5 when possible; otherwise they are treated as strings.
 Use `--json` to require JSON5 parsing.
 
 ```bash
-moltbot config set agents.defaults.heartbeat.every "0m"
-moltbot config set gateway.port 19001 --json
-moltbot config set channels.whatsapp.groups '["*"]' --json
+clawdbot config set agents.defaults.heartbeat.every "0m"
+clawdbot config set gateway.port 19001 --json
+clawdbot config set channels.whatsapp.groups '["*"]' --json
 ```
 
 Restart the gateway after edits.

package/docs/cli/configure.md

@@ -1,18 +1,18 @@
 ---
-summary: "CLI reference for `moltbot configure` (interactive configuration prompts)"
+summary: "CLI reference for `clawdbot configure` (interactive configuration prompts)"
 read_when:
   - You want to tweak credentials, devices, or agent defaults interactively
 ---
 
-# `moltbot configure`
+# `clawdbot configure`
 
 Interactive prompt to set up credentials, devices, and agent defaults.
 
 Note: The **Model** section now includes a multi-select for the
 `agents.defaults.models` allowlist (what shows up in `/model` and the model picker).
 
-Tip: `moltbot config` without a subcommand opens the same wizard. Use
-`moltbot config get|set|unset` for non-interactive edits.
+Tip: `clawdbot config` without a subcommand opens the same wizard. Use
+`clawdbot config get|set|unset` for non-interactive edits.
 
 Related:
 - Gateway configuration reference: [Configuration](/gateway/configuration)
@@ -25,6 +25,6 @@ Notes:
 ## Examples
 
 ```bash
-moltbot configure
-moltbot configure --section models --section channels
+clawdbot configure
+clawdbot configure --section models --section channels
 ```

package/docs/cli/cron.md

@@ -1,29 +1,29 @@
 ---
-summary: "CLI reference for `moltbot cron` (schedule and run background jobs)"
+summary: "CLI reference for `clawdbot cron` (schedule and run background jobs)"
 read_when:
   - You want scheduled jobs and wakeups
   - You’re debugging cron execution and logs
 ---
 
-# `moltbot cron`
+# `clawdbot cron`
 
 Manage cron jobs for the Gateway scheduler.
 
 Related:
 - Cron jobs: [Cron jobs](/automation/cron-jobs)
 
-Tip: run `moltbot cron --help` for the full command surface.
+Tip: run `clawdbot cron --help` for the full command surface.
 
 ## Common edits
 
 Update delivery settings without changing the message:
 
 ```bash
-moltbot cron edit <job-id> --deliver --channel telegram --to "123456789"
+clawdbot cron edit <job-id> --deliver --channel telegram --to "123456789"
 ```
 
 Disable delivery for an isolated job:
 
 ```bash
-moltbot cron edit <job-id> --no-deliver
+clawdbot cron edit <job-id> --no-deliver
 ```

package/docs/cli/dashboard.md

@@ -1,16 +1,16 @@
 ---
-summary: "CLI reference for `moltbot dashboard` (open the Control UI)"
+summary: "CLI reference for `clawdbot dashboard` (open the Control UI)"
 read_when:
   - You want to open the Control UI with your current token
   - You want to print the URL without launching a browser
 ---
 
-# `moltbot dashboard`
+# `clawdbot dashboard`
 
 Open the Control UI using your current auth.
 
 ```bash
-moltbot dashboard
-moltbot dashboard --no-open
+clawdbot dashboard
+clawdbot dashboard --no-open
 ```