docs: rebrand user-facing naming to MathClaw

Author: qz-qian

README.md

@@ -181,7 +181,7 @@ MATHCLAW_CONSOLE_WORKSPACE=../workspace python serve.py
 
 这里的 `../workspace` 指向仓库根目录下的 `workspace/`，因为命令是在 `console/` 目录里执行的。
 
-控制台默认会读取 `~/.mathclaw/config.json`；如果你还在沿用旧配置，也会自动回退到 `~/.nanobot/config.json`。旧环境变量前缀 `NANOBOT_CONSOLE_*` 也仍然兼容。
+控制台默认会读取 `~/.mathclaw/config.json`；如果你还在沿用旧版目录结构或旧环境变量命名，控制台也会自动兼容。
 
 默认控制台地址：
 

README_EN.md

@@ -174,7 +174,7 @@ MATHCLAW_CONSOLE_WORKSPACE=../workspace python serve.py
 
 Here `../workspace` points to the repository-level `workspace/` directory, because the command runs inside `console/`.
 
-The console reads `~/.mathclaw/config.json` by default; if you still keep the legacy layout, it automatically falls back to `~/.nanobot/config.json`. The old `NANOBOT_CONSOLE_*` environment variables remain supported as well.
+The console reads `~/.mathclaw/config.json` by default; if you still keep the legacy directory layout or legacy environment variable naming, the console remains backward compatible.
 
 Default console address:
 

bridge/package.json

@@ -1,7 +1,7 @@
 {
   "name": "nanobot-whatsapp-bridge",
   "version": "0.1.0",
-  "description": "WhatsApp bridge for nanobot using Baileys",
+  "description": "WhatsApp bridge for MathClaw using Baileys",
   "type": "module",
   "main": "dist/index.js",
   "scripts": {

bridge/src/index.ts

@@ -1,16 +1,16 @@
 #!/usr/bin/env node
 /**
- * nanobot WhatsApp Bridge
+ * MathClaw WhatsApp Bridge
  * 
- * This bridge connects WhatsApp Web to nanobot's Python backend
+ * This bridge connects WhatsApp Web to MathClaw's Python backend
  * via WebSocket. It handles authentication, message forwarding,
  * and reconnection logic.
  * 
  * Usage:
  *   npm run build && npm start
  *   
  * Or with custom settings:
- *   BRIDGE_PORT=3001 AUTH_DIR=~/.nanobot/whatsapp npm start
+ *   BRIDGE_PORT=3001 AUTH_DIR=~/.mathclaw/whatsapp-auth npm start
  */
 
 // Polyfill crypto for Baileys in ESM
@@ -20,14 +20,20 @@ if (!globalThis.crypto) {
 }
 
 import { BridgeServer } from './server.js';
+import { existsSync } from 'fs';
 import { homedir } from 'os';
 import { join } from 'path';
 
 const PORT = parseInt(process.env.BRIDGE_PORT || '3001', 10);
-const AUTH_DIR = process.env.AUTH_DIR || join(homedir(), '.nanobot', 'whatsapp-auth');
+const DEFAULT_AUTH_DIR = (() => {
+  const preferred = join(homedir(), '.mathclaw', 'whatsapp-auth');
+  const legacy = join(homedir(), '.nanobot', 'whatsapp-auth');
+  return existsSync(preferred) || !existsSync(legacy) ? preferred : legacy;
+})();
+const AUTH_DIR = process.env.AUTH_DIR || DEFAULT_AUTH_DIR;
 const TOKEN = process.env.BRIDGE_TOKEN || undefined;
 
-console.log('🐈 nanobot WhatsApp Bridge');
+console.log('?? MathClaw WhatsApp Bridge');
 console.log('========================\n');
 
 const server = new BridgeServer(PORT, AUTH_DIR, TOKEN);

bridge/src/whatsapp.ts

@@ -90,7 +90,7 @@ export class WhatsAppClient {
       version,
       logger,
       printQRInTerminal: false,
-      browser: ['nanobot', 'cli', VERSION],
+      browser: ['MathClaw', 'cli', VERSION],
       syncFullHistory: false,
       markOnlineOnConnect: false,
     });

console/README.md

@@ -1,4 +1,4 @@
-# nanobot console shell
+# MathClaw console shell
 
 Minimal static frontend shell copied in spirit from the MathClaw console layout.
 

core_agent_lines.sh

@@ -2,20 +2,20 @@
 # Count core agent lines (excluding channels/, cli/, providers/ adapters)
 cd "$(dirname "$0")" || exit 1
 
-echo "nanobot core agent line count"
+echo "mathclaw core agent line count"
 echo "================================"
 echo ""
 
 for dir in agent agent/tools bus config cron heartbeat session utils; do
-  count=$(find "nanobot/$dir" -maxdepth 1 -name "*.py" -exec cat {} + | wc -l)
+  count=$(find "mathclaw/$dir" -maxdepth 1 -name "*.py" -exec cat {} + | wc -l)
   printf "  %-16s %5s lines\n" "$dir/" "$count"
 done
 
-root=$(cat nanobot/__init__.py nanobot/__main__.py | wc -l)
+root=$(cat mathclaw/__init__.py nanobot/__init__.py nanobot/__main__.py | wc -l)
 printf "  %-16s %5s lines\n" "(root)" "$root"
 
 echo ""
-total=$(find nanobot -name "*.py" ! -path "*/channels/*" ! -path "*/cli/*" ! -path "*/command/*" ! -path "*/providers/*" ! -path "*/skills/*" | xargs cat | wc -l)
+total=$(find mathclaw -name "*.py" ! -path "*/channels/*" ! -path "*/cli/*" ! -path "*/command/*" ! -path "*/providers/*" ! -path "*/skills/*" | xargs cat | wc -l)
 echo "  Core total:     $total lines"
 echo ""
 echo "  (excludes: channels/, cli/, command/, providers/, skills/)"

docs/CHANNEL_PLUGIN_GUIDE.md

@@ -1,15 +1,15 @@
 # Channel Plugin Guide
 
-Build a custom nanobot channel in three steps: subclass, package, install.
+Build a custom MathClaw channel in three steps: subclass, package, install.
 
-> **Note:** We recommend developing channel plugins against a source checkout of nanobot (`pip install -e .`) rather than a PyPI release, so you always have access to the latest base-channel features and APIs.
+> **Note:** We recommend developing channel plugins against a source checkout of MathClaw (`pip install -e .`) rather than a PyPI release, so you always have access to the latest base-channel features and APIs.
 
 ## How It Works
 
-nanobot discovers channel plugins via Python [entry points](https://packaging.python.org/en/latest/specifications/entry-points/). When `nanobot gateway` starts, it scans:
+MathClaw discovers channel plugins via Python [entry points](https://packaging.python.org/en/latest/specifications/entry-points/). When `mathclaw gateway` starts, it scans:
 
-1. Built-in channels in `nanobot/channels/`
-2. External packages registered under the `nanobot.channels` entry point group
+1. Built-in channels in `mathclaw/channels/`
+2. External packages registered under the `mathclaw.channels` entry point group
 
 If a matching config section has `"enabled": true`, the channel is instantiated and started.
 
@@ -20,8 +20,8 @@ We'll build a minimal webhook channel that receives messages via HTTP POST and s
 ### Project Structure
 
 ```
-nanobot-channel-webhook/
-├── nanobot_channel_webhook/
+mathclaw-channel-webhook/
+├── mathclaw_channel_webhook/
 │   ├── __init__.py          # re-export WebhookChannel
 │   └── channel.py           # channel implementation
 └── pyproject.toml
@@ -30,22 +30,22 @@ nanobot-channel-webhook/
 ### 1. Create Your Channel
 
 ```python
-# nanobot_channel_webhook/__init__.py
-from nanobot_channel_webhook.channel import WebhookChannel
+# mathclaw_channel_webhook/__init__.py
+from mathclaw_channel_webhook.channel import WebhookChannel
 
 __all__ = ["WebhookChannel"]
 ```
 
 ```python
-# nanobot_channel_webhook/channel.py
+# mathclaw_channel_webhook/channel.py
 import asyncio
 from typing import Any
 
 from aiohttp import web
 from loguru import logger
 
-from nanobot.channels.base import BaseChannel
-from nanobot.bus.events import OutboundMessage
+from mathclaw.channels.base import BaseChannel
+from mathclaw.bus.events import OutboundMessage
 
 
 class WebhookChannel(BaseChannel):
@@ -118,12 +118,12 @@ class WebhookChannel(BaseChannel):
 ```toml
 # pyproject.toml
 [project]
-name = "nanobot-channel-webhook"
+name = "mathclaw-channel-webhook"
 version = "0.1.0"
-dependencies = ["nanobot", "aiohttp"]
+dependencies = ["mathclaw", "aiohttp"]
 
-[project.entry-points."nanobot.channels"]
-webhook = "nanobot_channel_webhook:WebhookChannel"
+[project.entry-points."mathclaw.channels"]
+webhook = "mathclaw_channel_webhook:WebhookChannel"
 
 [build-system]
 requires = ["setuptools"]
@@ -136,11 +136,11 @@ The key (`webhook`) becomes the config section name. The value points to your `B
 
 ```bash
 pip install -e .
-nanobot plugins list      # verify "Webhook" shows as "plugin"
-nanobot onboard           # auto-adds default config for detected plugins
+mathclaw plugins list      # verify "Webhook" shows as "plugin"
+mathclaw onboard           # auto-adds default config for detected plugins
 ```
 
-Edit `~/.nanobot/config.json`:
+Edit `~/.mathclaw/config.json`:
 
 ```json
 {
@@ -157,7 +157,7 @@ Edit `~/.nanobot/config.json`:
 ### 4. Run & Test
 
 ```bash
-nanobot gateway
+mathclaw gateway
 ```
 
 In another terminal:
@@ -205,8 +205,8 @@ Channels that don't need interactive login (e.g. Telegram with bot token, Discor
 
 Users trigger interactive login via:
 ```bash
-nanobot channels login <channel_name>
-nanobot channels login <channel_name> --force  # re-authenticate
+mathclaw channels login <channel_name>
+mathclaw channels login <channel_name> --force  # re-authenticate
 ```
 
 ### Provided by Base
@@ -215,7 +215,7 @@ nanobot channels login <channel_name> --force  # re-authenticate
 |-------------------|-------------|
 | `_handle_message(sender_id, chat_id, content, media?, metadata?, session_key?)` | **Call this when you receive a message.** Checks `is_allowed()`, then publishes to the bus. Automatically sets `_wants_stream` if `supports_streaming` is true. |
 | `is_allowed(sender_id)` | Checks against `config["allowFrom"]`; `"*"` allows all, `[]` denies all. |
-| `default_config()` (classmethod) | Returns default config dict for `nanobot onboard`. Override to declare your fields. |
+| `default_config()` (classmethod) | Returns default config dict for `mathclaw onboard`. Override to declare your fields. |
 | `transcribe_audio(file_path)` | Transcribes audio via Groq Whisper (if configured). |
 | `supports_streaming` (property) | `True` when config has `"streaming": true` **and** subclass overrides `send_delta()`. |
 | `is_running` | Returns `self._running`. |
@@ -343,7 +343,7 @@ async def start(self) -> None:
 
 `allowFrom` is handled automatically by `_handle_message()` — you don't need to check it yourself.
 
-Override `default_config()` so `nanobot onboard` auto-populates `config.json`:
+Override `default_config()` so `mathclaw onboard` auto-populates `config.json`:
 
 ```python
 @classmethod
@@ -357,25 +357,25 @@ If not overridden, the base class returns `{"enabled": false}`.
 
 | What | Format | Example |
 |------|--------|---------|
-| PyPI package | `nanobot-channel-{name}` | `nanobot-channel-webhook` |
+| PyPI package | `mathclaw-channel-{name}` | `mathclaw-channel-webhook` |
 | Entry point key | `{name}` | `webhook` |
 | Config section | `channels.{name}` | `channels.webhook` |
-| Python package | `nanobot_channel_{name}` | `nanobot_channel_webhook` |
+| Python package | `mathclaw_channel_{name}` | `mathclaw_channel_webhook` |
 
 ## Local Development
 
 ```bash
-git clone https://github.com/you/nanobot-channel-webhook
-cd nanobot-channel-webhook
+git clone https://github.com/you/mathclaw-channel-webhook
+cd mathclaw-channel-webhook
 pip install -e .
-nanobot plugins list    # should show "Webhook" as "plugin"
-nanobot gateway         # test end-to-end
+mathclaw plugins list    # should show "Webhook" as "plugin"
+mathclaw gateway         # test end-to-end
 ```
 
 ## Verify
 
 ```bash
-$ nanobot plugins list
+$ mathclaw plugins list
 
   Name       Source    Enabled
   telegram   builtin  yes

mathclaw/channels/dingtalk.py

@@ -41,7 +41,7 @@
 class NanobotDingTalkHandler(CallbackHandler):
     """
     Standard DingTalk Stream SDK Callback Handler.
-    Parses incoming messages and forwards them to the Nanobot channel.
+    Parses incoming messages and forwards them to the MathClaw channel.
     """
 
     def __init__(self, channel: "DingTalkChannel"):
@@ -124,7 +124,7 @@ async def process(self, message: CallbackMessage):
 
             logger.info("Received DingTalk message from {} ({}): {}", sender_name, sender_id, content)
 
-            # Forward to Nanobot via _on_message (non-blocking).
+            # Forward to MathClaw via _on_message (non-blocking).
             # Store reference to prevent GC before task completes.
             task = asyncio.create_task(
                 self.channel._on_message(
@@ -418,7 +418,7 @@ async def _send_markdown_text(self, token: str, chat_id: str, content: str) -> b
             token,
             chat_id,
             "sampleMarkdown",
-            {"text": content, "title": "Nanobot Reply"},
+            {"text": content, "title": "MathClaw Reply"},
         )
 
     async def _send_media_ref(self, token: str, chat_id: str, media_ref: str) -> bool:
@@ -510,7 +510,7 @@ async def _on_message(
         conversation_type: str | None = None,
         conversation_id: str | None = None,
     ) -> None:
-        """Handle incoming message (called by NanobotDingTalkHandler).
+        """Handle incoming message (called by the DingTalk handler).
 
         Delegates to BaseChannel._handle_message() which enforces allow_from
         permission checks before publishing to the bus.

mathclaw/providers/openai_compat_provider.py

@@ -95,7 +95,7 @@ def _extract_tc_extras(tc: Any) -> tuple[
 
 
 def _uses_openrouter_attribution(spec: "ProviderSpec | None", api_base: str | None) -> bool:
-    """Apply Nanobot attribution headers to OpenRouter requests by default."""
+    """Apply MathClaw attribution headers to OpenRouter requests by default."""
     if spec and spec.name == "openrouter":
         return True
     return bool(api_base and "openrouter" in api_base.lower())