@takibeiy/moltbot_cn 2026.2.1 → 2026.2.2

package/docs/tools/slash-commands.md

@@ -3,7 +3,9 @@ summary: "Slash commands: text vs native, config, and supported commands"
 read_when:
   - Using or configuring chat commands
   - Debugging command routing or permissions
+title: "Slash Commands"
 ---
+
 # Slash commands
 
 Commands are handled by the Gateway. Most commands must be sent as a **standalone** message that starts with `/`.
@@ -35,8 +37,8 @@ They run immediately, are stripped before the model sees the message, and the re
     config: false,
     debug: false,
     restart: false,
-    useAccessGroups: true
-  }
+    useAccessGroups: true,
+  },
 }
 ```
 
@@ -51,13 +53,14 @@ They run immediately, are stripped before the model sees the message, and the re
   - Set `channels.discord.commands.nativeSkills`, `channels.telegram.commands.nativeSkills`, or `channels.slack.commands.nativeSkills` to override per provider (bool or `"auto"`).
 - `commands.bash` (default `false`) enables `! <cmd>` to run host shell commands (`/bash <cmd>` is an alias; requires `tools.elevated` allowlists).
 - `commands.bashForegroundMs` (default `2000`) controls how long bash waits before switching to background mode (`0` backgrounds immediately).
-- `commands.config` (default `false`) enables `/config` (reads/writes `moltbot.json`).
+- `commands.config` (default `false`) enables `/config` (reads/writes `openclaw.json`).
 - `commands.debug` (default `false`) enables `/debug` (runtime-only overrides).
 - `commands.useAccessGroups` (default `true`) enforces allowlists/policies for commands.
 
 ## Command list
 
 Text + native (when enabled):
+
 - `/help`
 - `/commands`
 - `/skill <name> [input]` (run a skill by name)
@@ -90,17 +93,19 @@ Text + native (when enabled):
 - `/bash <command>` (host-only; alias for `! <command>`; requires `commands.bash: true` + `tools.elevated` allowlists)
 
 Text-only:
+
 - `/compact [instructions]` (see [/concepts/compaction](/concepts/compaction))
 - `! <command>` (host-only; one at a time; use `!poll` + `!stop` for long-running jobs)
 - `!poll` (check output / status; accepts optional `sessionId`; `/bash poll` also works)
 - `!stop` (stop the running bash job; accepts optional `sessionId`; `/bash stop` also works)
 
 Notes:
+
 - Commands accept an optional `:` between the command and args (e.g. `/think: high`, `/send: on`, `/help:`).
 - `/new <model>` accepts a model alias, `provider/model`, or a provider name (fuzzy match); if no match, the text is treated as the message body.
-- For full provider usage breakdown, use `moltbot status --usage`.
+- For full provider usage breakdown, use `openclaw status --usage`.
 - `/allowlist add|remove` requires `commands.config=true` and honors channel `configWrites`.
-- `/usage` controls the per-response usage footer; `/usage cost` prints a local cost summary from Moltbot session logs.
+- `/usage` controls the per-response usage footer; `/usage cost` prints a local cost summary from OpenClaw session logs.
 - `/restart` is disabled by default; set `commands.restart: true` to enable it.
 - `/verbose` is meant for debugging and extra visibility; keep it **off** in normal use.
 - `/reasoning` (and `/verbose`) are risky in group settings: they may reveal internal reasoning or tool output you did not intend to expose. Prefer leaving them off, especially in group chats.
@@ -139,6 +144,7 @@ Examples:
 ```
 
 Notes:
+
 - `/model` and `/model list` show a compact, numbered picker (model family + available providers).
 - `/model <#>` selects from that picker (and prefers the current provider when possible).
 - `/model status` shows the detailed view, including configured provider endpoint (`baseUrl`) and API mode (`api`) when available.
@@ -151,19 +157,20 @@ Examples:
 
 ```
 /debug show
-/debug set messages.responsePrefix="[moltbot]"
+/debug set messages.responsePrefix="[openclaw]"
 /debug set channels.whatsapp.allowFrom=["+1555","+4477"]
 /debug unset messages.responsePrefix
 /debug reset
 ```
 
 Notes:
-- Overrides apply immediately to new config reads, but do **not** write to `moltbot.json`.
+
+- Overrides apply immediately to new config reads, but do **not** write to `openclaw.json`.
 - Use `/debug reset` to clear all overrides and return to the on-disk config.
 
 ## Config updates
 
-`/config` writes to your on-disk config (`moltbot.json`). Owner-only. Disabled by default; enable with `commands.config: true`.
+`/config` writes to your on-disk config (`openclaw.json`). Owner-only. Disabled by default; enable with `commands.config: true`.
 
 Examples:
 
@@ -171,11 +178,12 @@ Examples:
 /config show
 /config show messages.responsePrefix
 /config get messages.responsePrefix
-/config set messages.responsePrefix="[moltbot]"
+/config set messages.responsePrefix="[openclaw]"
 /config unset messages.responsePrefix
 ```
 
 Notes:
+
 - Config is validated before write; invalid changes are rejected.
 - `/config` updates persist across restarts.
 
@@ -187,4 +195,4 @@ Notes:
   - Slack: `agent:<agentId>:slack:slash:<userId>` (prefix configurable via `channels.slack.slashCommand.sessionPrefix`)
   - Telegram: `telegram:slash:<userId>` (targets the chat session via `CommandTargetSessionKey`)
 - **`/stop`** targets the active chat session so it can abort the current run.
-- **Slack:** `channels.slack.slashCommand` is still supported for a single `/clawd`-style command. If you enable `commands.native`, you must create one Slack slash command per built-in command (same names as `/help`). Command argument menus for Slack are delivered as ephemeral Block Kit buttons.
+- **Slack:** `channels.slack.slashCommand` is still supported for a single `/openclaw`-style command. If you enable `commands.native`, you must create one Slack slash command per built-in command (same names as `/help`). Command argument menus for Slack are delivered as ephemeral Block Kit buttons.

package/docs/tools/subagents.md

@@ -3,6 +3,7 @@ summary: "Sub-agents: spawning isolated agent runs that announce results back to
 read_when:
   - You want background/parallel work via the agent
   - You are changing sessions_spawn or sub-agent tool policy
+title: "Sub-Agents"
 ---
 
 # Sub-agents
@@ -12,6 +13,7 @@ Sub-agents are background agent runs spawned from an existing agent run. They ru
 ## Slash command
 
 Use `/subagents` to inspect or control sub-agent runs for the **current session**:
+
 - `/subagents list`
 - `/subagents stop <id|#|all>`
 - `/subagents log <id|#> [limit] [tools]`
@@ -21,6 +23,7 @@ Use `/subagents` to inspect or control sub-agent runs for the **current session*
 `/subagents info` shows run metadata (status, timestamps, session id, transcript path, cleanup).
 
 Primary goals:
+
 - Parallelize “research / long task / slow tool” work without blocking the main run.
 - Keep sub-agents isolated by default (session separation + optional sandboxing).
 - Keep the tool surface hard to misuse: sub-agents do **not** get session tools by default.
@@ -33,11 +36,13 @@ You can configure this via `agents.defaults.subagents.model` or per-agent overri
 ## Tool
 
 Use `sessions_spawn`:
+
 - Starts a sub-agent run (`deliver: false`, global lane: `subagent`)
 - Then runs an announce step and posts the announce reply to the requester chat channel
 - Default model: inherits the caller unless you set `agents.defaults.subagents.model` (or per-agent `agents.list[].subagents.model`); an explicit `sessions_spawn.model` still wins.
 
 Tool params:
+
 - `task` (required)
 - `label?` (optional)
 - `agentId?` (optional; spawn under another agent id if allowed)
@@ -47,12 +52,15 @@ Tool params:
 - `cleanup?` (`delete|keep`, default `keep`)
 
 Allowlist:
+
 - `agents.list[].subagents.allowAgents`: list of agent ids that can be targeted via `agentId` (`["*"]` to allow any). Default: only the requester agent.
 
 Discovery:
+
 - Use `agents_list` to see which agent ids are currently allowed for `sessions_spawn`.
 
 Auto-archive:
+
 - Sub-agent sessions are automatically archived after `agents.defaults.subagents.archiveAfterMinutes` (default: 60).
 - Archive uses `sessions.delete` and renames the transcript to `*.deleted.<timestamp>` (same folder).
 - `cleanup: "delete"` archives immediately after announce (still keeps the transcript via rename).
@@ -62,6 +70,7 @@ Auto-archive:
 ## Authentication
 
 Sub-agent auth is resolved by **agent id**, not by session type:
+
 - The sub-agent session key is `agent:<agentId>:subagent:<uuid>`.
 - The auth store is loaded from that agent’s `agentDir`.
 - The main agent’s auth profiles are merged in as a **fallback**; agent profiles override main profiles on conflicts.
@@ -71,6 +80,7 @@ Note: the merge is additive, so main profiles are always available as fallbacks.
 ## Announce
 
 Sub-agents report back via an announce step:
+
 - The announce step runs inside the sub-agent session (not the requester session).
 - If the sub-agent replies exactly `ANNOUNCE_SKIP`, nothing is posted.
 - Otherwise the announce reply is posted to the requester chat channel via a follow-up `agent` call (`deliver=true`).
@@ -82,6 +92,7 @@ Sub-agents report back via an announce step:
 - `Status` is not inferred from model output; it comes from runtime outcome signals.
 
 Announce payloads include a stats line at the end (even when wrapped):
+
 - Runtime (e.g., `runtime 5m12s`)
 - Token usage (input/output/total)
 - Estimated cost when model pricing is configured (`models.providers.*.models[].cost`)
@@ -90,6 +101,7 @@ Announce payloads include a stats line at the end (even when wrapped):
 ## Tool Policy (sub-agent tools)
 
 By default, sub-agents get **all tools except session tools**:
+
 - `sessions_list`
 - `sessions_history`
 - `sessions_send`
@@ -102,9 +114,9 @@ Override via config:
   agents: {
     defaults: {
       subagents: {
-        maxConcurrent: 1
-      }
-    }
+        maxConcurrent: 1,
+      },
+    },
   },
   tools: {
     subagents: {
@@ -113,15 +125,16 @@ Override via config:
         deny: ["gateway", "cron"],
         // if allow is set, it becomes allow-only (deny still wins)
         // allow: ["read", "exec", "process"]
-      }
-    }
-  }
+      },
+    },
+  },
 }
 ```
 
 ## Concurrency
 
 Sub-agents use a dedicated in-process queue lane:
+
 - Lane name: `subagent`
 - Concurrency: `agents.defaults.subagents.maxConcurrent` (default `8`)
 

package/docs/tools/thinking.md

@@ -2,10 +2,13 @@
 summary: "Directive syntax for /think + /verbose and how they affect model reasoning"
 read_when:
   - Adjusting thinking or verbose directive parsing or defaults
+title: "Thinking Levels"
 ---
+
 # Thinking Levels (/think directives)
 
 ## What it does
+
 - Inline directive in any inbound body: `/t <level>`, `/think:<level>`, or `/thinking <level>`.
 - Levels (aliases): `off | minimal | low | medium | high | xhigh` (GPT-5.2 + Codex models only)
   - minimal → “think”
@@ -18,21 +21,25 @@ read_when:
   - Z.AI (`zai/*`) only supports binary thinking (`on`/`off`). Any non-`off` level is treated as `on` (mapped to `low`).
 
 ## Resolution order
+
 1. Inline directive on the message (applies only to that message).
 2. Session override (set by sending a directive-only message).
 3. Global default (`agents.defaults.thinkingDefault` in config).
 4. Fallback: low for reasoning-capable models; off otherwise.
 
 ## Setting a session default
+
 - Send a message that is **only** the directive (whitespace allowed), e.g. `/think:medium` or `/t high`.
 - That sticks for the current session (per-sender by default); cleared by `/think:off` or session idle reset.
 - Confirmation reply is sent (`Thinking level set to high.` / `Thinking disabled.`). If the level is invalid (e.g. `/thinking big`), the command is rejected with a hint and the session state is left unchanged.
 - Send `/think` (or `/think:`) with no argument to see the current thinking level.
 
 ## Application by agent
+
 - **Embedded Pi**: the resolved level is passed to the in-process Pi agent runtime.
 
 ## Verbose directives (/verbose or /v)
+
 - Levels: `on` (minimal) | `full` | `off` (default).
 - Directive-only message toggles session verbose and replies `Verbose logging enabled.` / `Verbose logging disabled.`; invalid levels return a hint without changing state.
 - `/verbose off` stores an explicit session override; clear it via the Sessions UI by choosing `inherit`.
@@ -42,6 +49,7 @@ read_when:
 - When verbose is `full`, tool outputs are also forwarded after completion (separate bubble, truncated to a safe length). If you toggle `/verbose on|full|off` while a run is in-flight, subsequent tool bubbles honor the new setting.
 
 ## Reasoning visibility (/reasoning)
+
 - Levels: `on|off|stream`.
 - Directive-only message toggles whether thinking blocks are shown in replies.
 - When enabled, reasoning is sent as a **separate message** prefixed with `Reasoning:`.
@@ -50,13 +58,16 @@ read_when:
 - Send `/reasoning` (or `/reasoning:`) with no argument to see the current reasoning level.
 
 ## Related
+
 - Elevated mode docs live in [Elevated mode](/tools/elevated).
 
 ## Heartbeats
+
 - Heartbeat probe body is the configured heartbeat prompt (default: `Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.`). Inline directives in a heartbeat message apply as usual (but avoid changing session defaults from heartbeats).
 - Heartbeat delivery defaults to the final payload only. To also send the separate `Reasoning:` message (when available), set `agents.defaults.heartbeat.includeReasoning: true` or per-agent `agents.list[].heartbeat.includeReasoning: true`.
 
 ## Web chat UI
+
 - The web chat thinking selector mirrors the session's stored level from the inbound session store/config when the page loads.
 - Picking another level applies only to the next message (`thinkingOnce`); after sending, the selector snaps back to the stored session level.
 - To change the session default, send a `/think:<level>` directive (as before); the selector will reflect it after the next reload.

package/docs/tools/web.md

@@ -4,11 +4,12 @@ read_when:
   - You want to enable web_search or web_fetch
   - You need Brave Search API key setup
   - You want to use Perplexity Sonar for web search
+title: "Web Tools"
 ---
 
 # Web tools
 
-Moltbot ships two lightweight web tools:
+OpenClaw ships two lightweight web tools:
 
 - `web_search` — Search the web via Brave Search API (default) or Perplexity Sonar (direct or via OpenRouter).
 - `web_fetch` — HTTP fetch + readable extraction (HTML → markdown/text).
@@ -28,10 +29,10 @@ These are **not** browser automation. For JS-heavy sites or logins, use the
 
 ## Choosing a search provider
 
-| Provider | Pros | Cons | API Key |
-|----------|------|------|---------|
-| **Brave** (default) | Fast, structured results, free tier | Traditional search results | `BRAVE_API_KEY` |
-| **Perplexity** | AI-synthesized answers, citations, real-time | Requires Perplexity or OpenRouter access | `OPENROUTER_API_KEY` or `PERPLEXITY_API_KEY` |
+| Provider            | Pros                                         | Cons                                     | API Key                                      |
+| ------------------- | -------------------------------------------- | ---------------------------------------- | -------------------------------------------- |
+| **Brave** (default) | Fast, structured results, free tier          | Traditional search results               | `BRAVE_API_KEY`                              |
+| **Perplexity**      | AI-synthesized answers, citations, real-time | Requires Perplexity or OpenRouter access | `OPENROUTER_API_KEY` or `PERPLEXITY_API_KEY` |
 
 See [Brave Search setup](/brave-search) and [Perplexity Sonar](/perplexity) for provider-specific details.
 
@@ -42,10 +43,10 @@ Set the provider in config:
   tools: {
     web: {
       search: {
-        provider: "brave"  // or "perplexity"
-      }
-    }
-  }
+        provider: "brave", // or "perplexity"
+      },
+    },
+  },
 }
 ```
 
@@ -60,31 +61,31 @@ Example: switch to Perplexity Sonar (direct API):
         perplexity: {
           apiKey: "pplx-...",
           baseUrl: "https://api.perplexity.ai",
-          model: "perplexity/sonar-pro"
-        }
-      }
-    }
-  }
+          model: "perplexity/sonar-pro",
+        },
+      },
+    },
+  },
 }
 ```
 
 ## Getting a Brave API key
 
-1) Create a Brave Search API account at https://brave.com/search/api/
-2) In the dashboard, choose the **Data for Search** plan (not “Data for AI”) and generate an API key.
-3) Run `moltbot configure --section web` to store the key in config (recommended), or set `BRAVE_API_KEY` in your environment.
+1. Create a Brave Search API account at https://brave.com/search/api/
+2. In the dashboard, choose the **Data for Search** plan (not “Data for AI”) and generate an API key.
+3. Run `openclaw configure --section web` to store the key in config (recommended), or set `BRAVE_API_KEY` in your environment.
 
 Brave provides a free tier plus paid plans; check the Brave API portal for the
 current limits and pricing.
 
 ### Where to set the key (recommended)
 
-**Recommended:** run `moltbot configure --section web`. It stores the key in
-`~/.clawdbot/moltbot.json` under `tools.web.search.apiKey`.
+**Recommended:** run `openclaw configure --section web`. It stores the key in
+`~/.openclaw/openclaw.json` under `tools.web.search.apiKey`.
 
 **Environment alternative:** set `BRAVE_API_KEY` in the Gateway process
-environment. For a gateway install, put it in `~/.clawdbot/.env` (or your
-service environment). See [Env vars](/help/faq#how-does-moltbot-load-environment-variables).
+environment. For a gateway install, put it in `~/.openclaw/.env` (or your
+service environment). See [Env vars](/help/faq#how-does-openclaw-load-environment-variables).
 
 ## Using Perplexity (direct or via OpenRouter)
 
@@ -94,9 +95,9 @@ crypto/prepaid).
 
 ### Getting an OpenRouter API key
 
-1) Create an account at https://openrouter.ai/
-2) Add credits (supports crypto, prepaid, or credit card)
-3) Generate an API key in your account settings
+1. Create an account at https://openrouter.ai/
+2. Add credits (supports crypto, prepaid, or credit card)
+3. Generate an API key in your account settings
 
 ### Setting up Perplexity search
 
@@ -113,18 +114,18 @@ crypto/prepaid).
           // Base URL (key-aware default if omitted)
           baseUrl: "https://openrouter.ai/api/v1",
           // Model (defaults to perplexity/sonar-pro)
-          model: "perplexity/sonar-pro"
-        }
-      }
-    }
-  }
+          model: "perplexity/sonar-pro",
+        },
+      },
+    },
+  },
 }
 ```
 
 **Environment alternative:** set `OPENROUTER_API_KEY` or `PERPLEXITY_API_KEY` in the Gateway
-environment. For a gateway install, put it in `~/.clawdbot/.env`.
+environment. For a gateway install, put it in `~/.openclaw/.env`.
 
-If no base URL is set, Moltbot chooses a default based on the API key source:
+If no base URL is set, OpenClaw chooses a default based on the API key source:
 
 - `PERPLEXITY_API_KEY` or `pplx-...` → `https://api.perplexity.ai`
 - `OPENROUTER_API_KEY` or `sk-or-...` → `https://openrouter.ai/api/v1`
@@ -132,11 +133,11 @@ If no base URL is set, Moltbot chooses a default based on the API key source:
 
 ### Available Perplexity models
 
-| Model | Description | Best for |
-|-------|-------------|----------|
-| `perplexity/sonar` | Fast Q&A with web search | Quick lookups |
+| Model                            | Description                          | Best for          |
+| -------------------------------- | ------------------------------------ | ----------------- |
+| `perplexity/sonar`               | Fast Q&A with web search             | Quick lookups     |
 | `perplexity/sonar-pro` (default) | Multi-step reasoning with web search | Complex questions |
-| `perplexity/sonar-reasoning-pro` | Chain-of-thought analysis | Deep research |
+| `perplexity/sonar-reasoning-pro` | Chain-of-thought analysis            | Deep research     |
 
 ## web_search
 
@@ -160,10 +161,10 @@ Search the web using your configured provider.
         apiKey: "BRAVE_API_KEY_HERE", // optional if BRAVE_API_KEY is set
         maxResults: 5,
         timeoutSeconds: 30,
-        cacheTtlMinutes: 15
-      }
-    }
-  }
+        cacheTtlMinutes: 15,
+      },
+    },
+  },
 }
 ```
 
@@ -184,7 +185,7 @@ await web_search({
   query: "TV online schauen",
   count: 10,
   country: "DE",
-  search_lang: "de"
+  search_lang: "de",
 });
 
 // French search with French UI
@@ -192,13 +193,13 @@ await web_search({
   query: "actualités",
   country: "FR",
   search_lang: "fr",
-  ui_lang: "fr"
+  ui_lang: "fr",
 });
 
 // Recent results (past week)
 await web_search({
   query: "TMBG interview",
-  freshness: "pw"
+  freshness: "pw",
 });
 ```
 
@@ -231,11 +232,11 @@ Fetch a URL and extract readable content.
           baseUrl: "https://api.firecrawl.dev",
           onlyMainContent: true,
           maxAgeMs: 86400000, // ms (1 day)
-          timeoutSeconds: 60
-        }
-      }
-    }
-  }
+          timeoutSeconds: 60,
+        },
+      },
+    },
+  },
 }
 ```
 
@@ -246,6 +247,7 @@ Fetch a URL and extract readable content.
 - `maxChars` (truncate long pages)
 
 Notes:
+
 - `web_fetch` uses Readability (main-content extraction) first, then Firecrawl (if configured). If both fail, the tool returns an error.
 - Firecrawl requests use bot-circumvention mode and cache results by default.
 - `web_fetch` sends a Chrome-like User-Agent and `Accept-Language` by default; override `userAgent` if needed.