nextclaw 0.6.24 → 0.6.25

package/dist/cli/index.js

@@ -2128,10 +2128,21 @@ var GatewayControllerImpl = class {
     };
   }
   async updateRun(params) {
+    const versionBefore = getPackageVersion();
     const result = runSelfUpdate({ timeoutMs: params.timeoutMs });
     if (!result.ok) {
-      return { ok: false, error: result.error ?? "update failed", steps: result.steps };
+      return {
+        ok: false,
+        error: result.error ?? "update failed",
+        steps: result.steps,
+        version: {
+          before: versionBefore,
+          after: getPackageVersion(),
+          changed: false
+        }
+      };
     }
+    const versionAfter = getPackageVersion();
     const delayMs = params.restartDelayMs ?? 0;
     const sentinelPath = await this.writeRestartSentinelPayload({
       kind: "update.run",
@@ -2148,6 +2159,11 @@ var GatewayControllerImpl = class {
       restart: { scheduled: true, delayMs },
       strategy: result.strategy,
       steps: result.steps,
+      version: {
+        before: versionBefore,
+        after: versionAfter,
+        changed: versionBefore !== versionAfter
+      },
       sentinel: sentinelPath ? { path: sentinelPath } : null
     };
   }
@@ -3605,6 +3621,8 @@ ${this.logo} ${APP_NAME4} is ready! (${source})`);
       }
       timeoutMs = parsed;
     }
+    const versionBefore = getPackageVersion();
+    console.log(`Current version: ${versionBefore}`);
     const result = runSelfUpdate({ timeoutMs, cwd: process.cwd() });
     const printSteps = () => {
       for (const step of result.steps) {
@@ -3624,7 +3642,13 @@ ${this.logo} ${APP_NAME4} is ready! (${source})`);
       }
       process.exit(1);
     }
+    const versionAfter = getPackageVersion();
     console.log(`\u2713 Update complete (${result.strategy})`);
+    if (versionAfter === versionBefore) {
+      console.log(`Version unchanged: ${versionBefore}`);
+    } else {
+      console.log(`Version updated: ${versionBefore} -> ${versionAfter}`);
+    }
     const state = readServiceState();
     if (state && isProcessRunning(state.pid)) {
       console.log(`Tip: restart ${APP_NAME4} to apply the update.`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nextclaw",
-  "version": "0.6.24",
+  "version": "0.6.25",
   "description": "Lightweight personal AI assistant with CLI, multi-provider routing, and channel integrations.",
   "private": false,
   "type": "module",

package/templates/USAGE.md

@@ -23,6 +23,7 @@ When NextClaw AI needs to operate the product itself (status/doctor/channels/con
 - [AI Self-Management Contract](#ai-self-management-contract)
 - [Quick Start](#quick-start)
 - [Configuration](#configuration)
+- [Multi-agent routing & session isolation](#multi-agent-routing--session-isolation-openclaw-aligned)
 - [Workspace](#workspace)
 - [Commands](#commands)
 - [Channels](#channels)
@@ -140,6 +141,64 @@ Restart is still required for:
 
 To confirm hot reload succeeded, check gateway console logs or `${NEXTCLAW_HOME:-~/.nextclaw}/logs/service.log` for messages like `Config reload: ... applied.`
 
+### Multi-agent routing & session isolation (OpenClaw-aligned)
+
+You can now configure OpenClaw-style multi-agent runtime behavior directly in the UI (**Routing & Runtime**) or in `config.json`:
+
+- `agents.list`: run multiple resident agent roles in one gateway process
+- `bindings`: route inbound messages by `channel + accountId (+peer)` to a target `agentId`
+- `session.dmScope`: DM isolation strategy (`main` / `per-peer` / `per-channel-peer` / `per-account-channel-peer`)
+- `session.agentToAgent.maxPingPongTurns`: cap cross-agent ping-pong loops (`0` means block auto ping-pong)
+
+Example:
+
+```json
+{
+  "agents": {
+    "defaults": { "model": "openai/gpt-5.2-codex" },
+    "list": [
+      { "id": "main", "default": true },
+      {
+        "id": "engineer",
+        "workspace": "~/workspace-engineer",
+        "model": "openai/gpt-5.2-codex",
+        "maxTokens": 12000,
+        "maxToolIterations": 24
+      }
+    ]
+  },
+  "bindings": [
+    {
+      "agentId": "engineer",
+      "match": {
+        "channel": "discord",
+        "accountId": "zongzhihui",
+        "peer": { "kind": "channel", "id": "dev-room" }
+      }
+    }
+  ],
+  "session": {
+    "dmScope": "per-account-channel-peer",
+    "agentToAgent": { "maxPingPongTurns": 0 }
+  }
+}
+```
+
+CLI equivalents:
+
+```bash
+nextclaw config set agents.list '[{"id":"main","default":true},{"id":"engineer"}]' --json
+nextclaw config set bindings '[{"agentId":"engineer","match":{"channel":"discord","accountId":"zongzhihui"}}]' --json
+nextclaw config set session.dmScope '"per-account-channel-peer"' --json
+nextclaw config set session.agentToAgent.maxPingPongTurns 0 --json
+```
+
+For internal AI operations (same as other built-in capabilities):
+
+- Yes, the runtime registers the `gateway` tool (`config.get` / `config.schema` / `config.apply` / `config.patch`).
+- The AI can use it to manage the same config surface when you explicitly ask.
+- As with all config mutations, it follows the explicit-request rule (no silent self-mutation).
+
 ---
 
 ## Workspace
@@ -262,6 +321,7 @@ Behavior:
 
 - If `NEXTCLAW_UPDATE_COMMAND` is set, the CLI executes it (useful for custom update flows).
 - Otherwise it falls back to `npm i -g nextclaw`.
+- `nextclaw update` now prints version progress explicitly: `Current version: x.y.z`, then either `Version updated: x.y.z -> a.b.c` or `Version unchanged: x.y.z`.
 - If the background service is running, restart it after the update to apply changes.
 - When update is triggered from the running gateway (agent `update.run`), NextClaw arms a self-relaunch helper before exiting, so the service comes back automatically (like an OS reboot flow).
 - After restart, NextClaw automatically pings the last active session with restart/update status (including note when provided).
@@ -292,7 +352,19 @@ Configure channels in the UI at http://127.0.0.1:18791 or in `~/.nextclaw/config
       "enabled": true,
       "token": "YOUR_BOT_TOKEN",
       "allowBots": false,
-      "allowFrom": []
+      "allowFrom": [],
+      "accountId": "zongzhihui",
+      "dmPolicy": "open",
+      "groupPolicy": "allowlist",
+      "groupAllowFrom": ["dev-room"],
+      "requireMention": true,
+      "mentionPatterns": ["@工程师", "@engineer"],
+      "groups": {
+        "dev-room": {
+          "requireMention": true,
+          "mentionPatterns": ["@engineer"]
+        }
+      }
     }
   }
 }
@@ -312,7 +384,19 @@ Configure channels in the UI at http://127.0.0.1:18791 or in `~/.nextclaw/config
     "telegram": {
       "enabled": true,
       "token": "YOUR_BOT_TOKEN",
-      "allowFrom": ["YOUR_USER_ID"]
+      "allowFrom": ["YOUR_USER_ID"],
+      "accountId": "zongzhihui",
+      "dmPolicy": "open",
+      "groupPolicy": "allowlist",
+      "groupAllowFrom": ["GROUP_ID"],
+      "requireMention": true,
+      "mentionPatterns": ["@工程师", "@engineer"],
+      "groups": {
+        "GROUP_ID": {
+          "requireMention": true,
+          "mentionPatterns": ["@engineer"]
+        }
+      }
     }
   }
 }