@takibeiy/moltbot_cn 2026.1.28 → 2026.2.1-beta.1

package/docs/cli/gateway.md

@@ -1,18 +1,20 @@
 ---
-summary: "Moltbot Gateway CLI (`moltbot gateway`) — run, query, and discover gateways"
+summary: "OpenClaw Gateway CLI (`openclaw gateway`) — run, query, and discover gateways"
 read_when:
   - Running the Gateway from the CLI (dev or servers)
   - Debugging Gateway auth, bind modes, and connectivity
   - Discovering gateways via Bonjour (LAN + tailnet)
+title: "gateway"
 ---
 
 # Gateway CLI
 
-The Gateway is Moltbot’s WebSocket server (channels, nodes, sessions, hooks).
+The Gateway is OpenClaw’s WebSocket server (channels, nodes, sessions, hooks).
 
-Subcommands in this page live under `moltbot gateway …`.
+Subcommands in this page live under `openclaw gateway …`.
 
 Related docs:
+
 - [/gateway/bonjour](/gateway/bonjour)
 - [/gateway/discovery](/gateway/discovery)
 - [/gateway/configuration](/gateway/configuration)
@@ -22,17 +24,18 @@ Related docs:
 Run a local Gateway process:
 
 ```bash
-moltbot gateway
+openclaw gateway
 ```
 
 Foreground alias:
 
 ```bash
-moltbot gateway run
+openclaw gateway run
 ```
 
 Notes:
-- By default, the Gateway refuses to start unless `gateway.mode=local` is set in `~/.clawdbot/moltbot.json`. Use `--allow-unconfigured` for ad-hoc/dev runs.
+
+- By default, the Gateway refuses to start unless `gateway.mode=local` is set in `~/.openclaw/openclaw.json`. Use `--allow-unconfigured` for ad-hoc/dev runs.
 - Binding beyond loopback without auth is blocked (safety guardrail).
 - `SIGUSR1` triggers an in-process restart when authorized (enable `commands.restart` or use the gateway tool/config apply/update).
 - `SIGINT`/`SIGTERM` handlers stop the gateway process, but they don’t restore any custom terminal state. If you wrap the CLI with a TUI or raw-mode input, restore the terminal before exit.
@@ -42,8 +45,8 @@ Notes:
 - `--port <port>`: WebSocket port (default comes from config/env; usually `18789`).
 - `--bind <loopback|lan|tailnet|auto|custom>`: listener bind mode.
 - `--auth <token|password>`: auth mode override.
-- `--token <token>`: token override (also sets `CLAWDBOT_GATEWAY_TOKEN` for the process).
-- `--password <password>`: password override (also sets `CLAWDBOT_GATEWAY_PASSWORD` for the process).
+- `--token <token>`: token override (also sets `OPENCLAW_GATEWAY_TOKEN` for the process).
+- `--password <password>`: password override (also sets `OPENCLAW_GATEWAY_PASSWORD` for the process).
 - `--tailscale <off|serve|funnel>`: expose the Gateway via Tailscale.
 - `--tailscale-reset-on-exit`: reset Tailscale serve/funnel config on shutdown.
 - `--allow-unconfigured`: allow gateway start without `gateway.mode=local` in config.
@@ -62,11 +65,13 @@ Notes:
 All query commands use WebSocket RPC.
 
 Output modes:
+
 - Default: human-readable (colored in TTY).
 - `--json`: machine-readable JSON (no styling/spinner).
 - `--no-color` (or `NO_COLOR=1`): disable ANSI while keeping human layout.
 
 Shared options (where supported):
+
 - `--url <url>`: Gateway WebSocket URL.
 - `--token <token>`: Gateway token.
 - `--password <password>`: Gateway password.
@@ -76,7 +81,7 @@ Shared options (where supported):
 ### `gateway health`
 
 ```bash
-moltbot gateway health --url ws://127.0.0.1:18789
+openclaw gateway health --url ws://127.0.0.1:18789
 ```
 
 ### `gateway status`
@@ -84,11 +89,12 @@ moltbot gateway health --url ws://127.0.0.1:18789
 `gateway status` shows the Gateway service (launchd/systemd/schtasks) plus an optional RPC probe.
 
 ```bash
-moltbot gateway status
-moltbot gateway status --json
+openclaw gateway status
+openclaw gateway status --json
 ```
 
 Options:
+
 - `--url <url>`: override the probe URL.
 - `--token <token>`: token auth for the probe.
 - `--password <password>`: password auth for the probe.
@@ -99,14 +105,15 @@ Options:
 ### `gateway probe`
 
 `gateway probe` is the “debug everything” command. It always probes:
+
 - your configured remote gateway (if set), and
 - localhost (loopback) **even if remote is configured**.
 
 If multiple gateways are reachable, it prints all of them. Multiple gateways are supported when you use isolated profiles/ports (e.g., a rescue bot), but most installs still run a single gateway.
 
 ```bash
-moltbot gateway probe
-moltbot gateway probe --json
+openclaw gateway probe
+openclaw gateway probe --json
 ```
 
 #### Remote over SSH (Mac app parity)
@@ -116,15 +123,17 @@ The macOS app “Remote over SSH” mode uses a local port-forward so the remote
 CLI equivalent:
 
 ```bash
-moltbot gateway probe --ssh user@gateway-host
+openclaw gateway probe --ssh user@gateway-host
 ```
 
 Options:
+
 - `--ssh <target>`: `user@host` or `user@host:port` (port defaults to `22`).
 - `--ssh-identity <path>`: identity file.
 - `--ssh-auto`: pick the first discovered gateway host as SSH target (LAN/WAB only).
 
 Config (optional, used as defaults):
+
 - `gateway.remote.sshTarget`
 - `gateway.remote.sshIdentity`
 
@@ -133,34 +142,36 @@ Config (optional, used as defaults):
 Low-level RPC helper.
 
 ```bash
-moltbot gateway call status
-moltbot gateway call logs.tail --params '{"sinceMs": 60000}'
+openclaw gateway call status
+openclaw gateway call logs.tail --params '{"sinceMs": 60000}'
 ```
 
 ## Manage the Gateway service
 
 ```bash
-moltbot gateway install
-moltbot gateway start
-moltbot gateway stop
-moltbot gateway restart
-moltbot gateway uninstall
+openclaw gateway install
+openclaw gateway start
+openclaw gateway stop
+openclaw gateway restart
+openclaw gateway uninstall
 ```
 
 Notes:
+
 - `gateway install` supports `--port`, `--runtime`, `--token`, `--force`, `--json`.
 - Lifecycle commands accept `--json` for scripting.
 
 ## Discover gateways (Bonjour)
 
-`gateway discover` scans for Gateway beacons (`_moltbot-gw._tcp`).
+`gateway discover` scans for Gateway beacons (`_openclaw-gw._tcp`).
 
 - Multicast DNS-SD: `local.`
-- Unicast DNS-SD (Wide-Area Bonjour): `moltbot.internal.` (requires split DNS + DNS server; see [/gateway/bonjour](/gateway/bonjour))
+- Unicast DNS-SD (Wide-Area Bonjour): choose a domain (example: `openclaw.internal.`) and set up split DNS + a DNS server; see [/gateway/bonjour](/gateway/bonjour)
 
 Only gateways with Bonjour discovery enabled (default) advertise the beacon.
 
 Wide-Area discovery records include (TXT):
+
 - `role` (gateway role hint)
 - `transport` (transport hint, e.g. `gateway`)
 - `gatewayPort` (WebSocket port, usually `18789`)
@@ -172,16 +183,17 @@ Wide-Area discovery records include (TXT):
 ### `gateway discover`
 
 ```bash
-moltbot gateway discover
+openclaw gateway discover
 ```
 
 Options:
+
 - `--timeout <ms>`: per-command timeout (browse/resolve); default `2000`.
 - `--json`: machine-readable output (also disables styling/spinner).
 
 Examples:
 
 ```bash
-moltbot gateway discover --timeout 4000
-moltbot gateway discover --json | jq '.beacons[].wsUrl'
+openclaw gateway discover --timeout 4000
+openclaw gateway discover --json | jq '.beacons[].wsUrl'
 ```

package/docs/cli/health.md

@@ -1,19 +1,21 @@
 ---
-summary: "CLI reference for `moltbot health` (gateway health endpoint via RPC)"
+summary: "CLI reference for `openclaw health` (gateway health endpoint via RPC)"
 read_when:
   - You want to quickly check the running Gateway’s health
+title: "health"
 ---
 
-# `moltbot health`
+# `openclaw health`
 
 Fetch health from the running Gateway.
 
 ```bash
-moltbot health
-moltbot health --json
-moltbot health --verbose
+openclaw health
+openclaw health --json
+openclaw health --verbose
 ```
 
 Notes:
+
 - `--verbose` runs live probes and prints per-account timings when multiple accounts are configured.
 - Output includes per-agent session stores when multiple agents are configured.

package/docs/cli/hooks.md

@@ -1,27 +1,30 @@
 ---
-summary: "CLI reference for `moltbot hooks` (agent hooks)"
+summary: "CLI reference for `openclaw hooks` (agent hooks)"
 read_when:
   - You want to manage agent hooks
   - You want to install or update hooks
+title: "hooks"
 ---
 
-# `moltbot hooks`
+# `openclaw hooks`
 
 Manage agent hooks (event-driven automations for commands like `/new`, `/reset`, and gateway startup).
 
 Related:
+
 - Hooks: [Hooks](/hooks)
 - Plugin hooks: [Plugins](/plugin#plugin-hooks)
 
 ## List All Hooks
 
 ```bash
-moltbot hooks list
+openclaw hooks list
 ```
 
 List all discovered hooks from workspace, managed, and bundled directories.
 
 **Options:**
+
 - `--eligible`: Show only eligible hooks (requirements met)
 - `--json`: Output as JSON
 - `-v, --verbose`: Show detailed information including missing requirements
@@ -41,7 +44,7 @@ Ready:
 **Example (verbose):**
 
 ```bash
-moltbot hooks list --verbose
+openclaw hooks list --verbose
 ```
 
 Shows missing requirements for ineligible hooks.
@@ -49,7 +52,7 @@ Shows missing requirements for ineligible hooks.
 **Example (JSON):**
 
 ```bash
-moltbot hooks list --json
+openclaw hooks list --json
 ```
 
 Returns structured JSON for programmatic use.
@@ -57,21 +60,23 @@ Returns structured JSON for programmatic use.
 ## Get Hook Information
 
 ```bash
-moltbot hooks info <name>
+openclaw hooks info <name>
 ```
 
 Show detailed information about a specific hook.
 
 **Arguments:**
+
 - `<name>`: Hook name (e.g., `session-memory`)
 
 **Options:**
+
 - `--json`: Output as JSON
 
 **Example:**
 
 ```bash
-moltbot hooks info session-memory
+openclaw hooks info session-memory
 ```
 
 **Output:**
@@ -82,10 +87,10 @@ moltbot hooks info session-memory
 Save session context to memory when /new command is issued
 
 Details:
-  Source: moltbot-bundled
-  Path: /path/to/moltbot/hooks/bundled/session-memory/HOOK.md
-  Handler: /path/to/moltbot/hooks/bundled/session-memory/handler.ts
-  Homepage: https://docs.molt.bot/hooks#session-memory
+  Source: openclaw-bundled
+  Path: /path/to/openclaw/hooks/bundled/session-memory/HOOK.md
+  Handler: /path/to/openclaw/hooks/bundled/session-memory/handler.ts
+  Homepage: https://docs.openclaw.ai/hooks#session-memory
   Events: command:new
 
 Requirements:
@@ -95,12 +100,13 @@ Requirements:
 ## Check Hooks Eligibility
 
 ```bash
-moltbot hooks check
+openclaw hooks check
 ```
 
 Show summary of hook eligibility status (how many are ready vs. not ready).
 
 **Options:**
+
 - `--json`: Output as JSON
 
 **Example output:**
@@ -116,21 +122,22 @@ Not ready: 0
 ## Enable a Hook
 
 ```bash
-moltbot hooks enable <name>
+openclaw hooks enable <name>
 ```
 
-Enable a specific hook by adding it to your config (`~/.clawdbot/config.json`).
+Enable a specific hook by adding it to your config (`~/.openclaw/config.json`).
 
-**Note:** Hooks managed by plugins show `plugin:<id>` in `moltbot hooks list` and
+**Note:** Hooks managed by plugins show `plugin:<id>` in `openclaw hooks list` and
 can’t be enabled/disabled here. Enable/disable the plugin instead.
 
 **Arguments:**
+
 - `<name>`: Hook name (e.g., `session-memory`)
 
 **Example:**
 
 ```bash
-moltbot hooks enable session-memory
+openclaw hooks enable session-memory
 ```
 
 **Output:**
@@ -140,28 +147,31 @@ moltbot hooks enable session-memory
 ```
 
 **What it does:**
+
 - Checks if hook exists and is eligible
 - Updates `hooks.internal.entries.<name>.enabled = true` in your config
 - Saves config to disk
 
 **After enabling:**
+
 - Restart the gateway so hooks reload (menu bar app restart on macOS, or restart your gateway process in dev).
 
 ## Disable a Hook
 
 ```bash
-moltbot hooks disable <name>
+openclaw hooks disable <name>
 ```
 
 Disable a specific hook by updating your config.
 
 **Arguments:**
+
 - `<name>`: Hook name (e.g., `command-logger`)
 
 **Example:**
 
 ```bash
-moltbot hooks disable command-logger
+openclaw hooks disable command-logger
 ```
 
 **Output:**
@@ -171,22 +181,25 @@ moltbot hooks disable command-logger
 ```
 
 **After disabling:**
+
 - Restart the gateway so hooks reload
 
 ## Install Hooks
 
 ```bash
-moltbot hooks install <path-or-spec>
+openclaw hooks install <path-or-spec>
 ```
 
 Install a hook pack from a local folder/archive or npm.
 
 **What it does:**
-- Copies the hook pack into `~/.clawdbot/hooks/<id>`
+
+- Copies the hook pack into `~/.openclaw/hooks/<id>`
 - Enables the installed hooks in `hooks.internal.entries.*`
 - Records the install under `hooks.internal.installs`
 
 **Options:**
+
 - `-l, --link`: Link a local directory instead of copying (adds it to `hooks.internal.load.extraDirs`)
 
 **Supported archives:** `.zip`, `.tgz`, `.tar.gz`, `.tar`
@@ -195,28 +208,29 @@ Install a hook pack from a local folder/archive or npm.
 
 ```bash
 # Local directory
-moltbot hooks install ./my-hook-pack
+openclaw hooks install ./my-hook-pack
 
 # Local archive
-moltbot hooks install ./my-hook-pack.zip
+openclaw hooks install ./my-hook-pack.zip
 
 # NPM package
-moltbot hooks install @moltbot/my-hook-pack
+openclaw hooks install @openclaw/my-hook-pack
 
 # Link a local directory without copying
-moltbot hooks install -l ./my-hook-pack
+openclaw hooks install -l ./my-hook-pack
 ```
 
 ## Update Hooks
 
 ```bash
-moltbot hooks update <id>
-moltbot hooks update --all
+openclaw hooks update <id>
+openclaw hooks update --all
 ```
 
 Update installed hook packs (npm installs only).
 
 **Options:**
+
 - `--all`: Update all tracked hook packs
 - `--dry-run`: Show what would change without writing
 
@@ -229,10 +243,10 @@ Saves session context to memory when you issue `/new`.
 **Enable:**
 
 ```bash
-moltbot hooks enable session-memory
+openclaw hooks enable session-memory
 ```
 
-**Output:** `~/clawd/memory/YYYY-MM-DD-slug.md`
+**Output:** `~/.openclaw/workspace/memory/YYYY-MM-DD-slug.md`
 
 **See:** [session-memory documentation](/hooks#session-memory)
 
@@ -243,22 +257,22 @@ Logs all command events to a centralized audit file.
 **Enable:**
 
 ```bash
-moltbot hooks enable command-logger
+openclaw hooks enable command-logger
 ```
 
-**Output:** `~/.clawdbot/logs/commands.log`
+**Output:** `~/.openclaw/logs/commands.log`
 
 **View logs:**
 
 ```bash
 # Recent commands
-tail -n 20 ~/.clawdbot/logs/commands.log
+tail -n 20 ~/.openclaw/logs/commands.log
 
 # Pretty-print
-cat ~/.clawdbot/logs/commands.log | jq .
+cat ~/.openclaw/logs/commands.log | jq .
 
 # Filter by action
-grep '"action":"new"' ~/.clawdbot/logs/commands.log | jq .
+grep '"action":"new"' ~/.openclaw/logs/commands.log | jq .
 ```
 
 **See:** [command-logger documentation](/hooks#command-logger)
@@ -270,7 +284,7 @@ Swaps injected `SOUL.md` content with `SOUL_EVIL.md` during a purge window or by
 **Enable:**
 
 ```bash
-moltbot hooks enable soul-evil
+openclaw hooks enable soul-evil
 ```
 
 **See:** [SOUL Evil Hook](/hooks/soul-evil)
@@ -284,7 +298,7 @@ Runs `BOOT.md` when the gateway starts (after channels start).
 **Enable**:
 
 ```bash
-moltbot hooks enable boot-md
+openclaw hooks enable boot-md
 ```
 
 **See:** [boot-md documentation](/hooks#boot-md)