@drakon-systems/multi-clawd 1.8.2 → 1.8.3

package/README.md

@@ -367,7 +367,7 @@ openclaw plugins install (Get-Location).Path
 **Or let your agent install it.** Running an OpenClaw assistant or Claude
 Code on the target machine already? Paste it this and go make coffee:
 
-> Read https://raw.githubusercontent.com/Drakon-Systems-Ltd/multi-clawd/v1.8.2/SETUP-AGENT.md
+> Read https://raw.githubusercontent.com/Drakon-Systems-Ltd/multi-clawd/v1.8.3/SETUP-AGENT.md
 > and follow it to set up multi-clawd on this machine. I own a second
 > Claude account — ask me when you need me to log in.
 
@@ -381,7 +381,7 @@ prefer a tag over a branch.
 
 **Requirements:** OpenClaw ≥ 2026.6, the `claude` CLI on `PATH`, and a
 second Claude subscription you own. The current plugin SDK contract and runtime
-registration path are tested against OpenClaw **2026.7.1**. The standalone
+registration path are tested against OpenClaw **2026.8.1**. The standalone
 `multi-clawd` CLI and Hermes commands do not require the optional OpenClaw peer
 to be resolvable; plugin loading and OpenClaw-backed commands still require the
 host-provided peer.
@@ -603,7 +603,7 @@ Three moves, all through the official plugin SDK (details in
    (`CLAUDE_CONFIG_DIR` + `CLAUDE_CODE_OAUTH_TOKEN`) into the child process
    env, after the host's ambient Claude credentials are stripped.
 
-## Known issue: idle backends can be evicted by OpenClaw core
+## Legacy issue: idle backend eviction on OpenClaw ≤ 2026.7.1
 
 On OpenClaw ≤ 2026.7.1, core's *scoped* harness activation can silently drop
 a plugin-registered CLI backend from the live registry: when an agent turn
@@ -615,9 +615,10 @@ list` (a separate cache) still lists its models. A common real-world trigger
 is an hourly heartbeat running on a model served by another harness.
 
 - Upstream bug: [openclaw#107408](https://github.com/openclaw/openclaw/issues/107408)
-- Upstream fix: [openclaw#107596](https://github.com/openclaw/openclaw/pull/107596)
+- Upstream fix: [openclaw#108110](https://github.com/openclaw/openclaw/pull/108110)
 
-**Until that lands:** a gateway restart always restores the backend (startup
+OpenClaw 2026.8.1 includes the fix. On affected older runtimes, a gateway
+restart always restores the backend (startup
 loads are full-scope), and backends that are in regular use effectively
 re-assert themselves. This repo ships a ready-made mitigation —
 `scripts/eviction-watchdog.mjs` — which tails the gateway log for the

package/SECURITY.md

@@ -30,7 +30,7 @@ credit you (unless you'd rather we didn't), and note it in the CHANGELOG.
   `oauthTokenFile`, multi-clawd warns (once per process) when the file is
   readable beyond your own user account. It warns rather than refuses: the
   credential still works, and the fix is yours to make — `chmod 600`.
-- **Host credentials are stripped from child processes.** 38 Claude/Anthropic
+- **Host credentials are stripped from child processes.** 42 Claude/Anthropic
   environment variables covering authentication, runtime, and telemetry are
   cleared before each launch, so one account's credential cannot bleed into
   another account's session.

package/dist/index.js

@@ -1,6 +1,4 @@
-import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
-import { resolvePluginConfigObject, resolveLivePluginConfigObject, } from "openclaw/plugin-sdk/plugin-config-runtime";
-import { CLI_FRESH_WATCHDOG_DEFAULTS, CLI_RESUME_WATCHDOG_DEFAULTS, } from "openclaw/plugin-sdk/cli-backend";
+import { definePluginEntry, } from "openclaw/plugin-sdk/plugin-entry";
 import { homedir } from "node:os";
 import { mkdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
@@ -21,6 +19,16 @@ import { buildAccountChildEnv, tokenFileModeWarning, validateAccountTokenSources
 import { diffCatalogModels, formatNewModelNotice, } from "./model-currency.js";
 import { checkAccountCredential, createRefProbeTracker, } from "./login-health.js";
 import { execFileSync } from "node:child_process";
+const CLI_FRESH_WATCHDOG_DEFAULTS = {
+    noOutputTimeoutRatio: 0.8,
+    minMs: 180_000,
+    maxMs: 600_000,
+};
+const CLI_RESUME_WATCHDOG_DEFAULTS = {
+    noOutputTimeoutRatio: 0.3,
+    minMs: 60_000,
+    maxMs: 180_000,
+};
 const BASE_ARGS = [
     "-p",
     "--output-format",
@@ -44,6 +52,10 @@ export const CLEAR_ENV = [
     "ANTHROPIC_OAUTH_TOKEN",
     "ANTHROPIC_UNIX_SOCKET",
     "CLAUDE_CONFIG_DIR",
+    "CLAUDE_CODE_AUTO_COMPACT_WINDOW",
+    "CLAUDE_CODE_DISABLE_1M_CONTEXT",
+    "CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING",
+    "MAX_THINKING_TOKENS",
     "CLAUDE_CODE_API_KEY_FILE_DESCRIPTOR",
     "CLAUDE_CODE_ENTRYPOINT",
     "CLAUDE_CODE_OAUTH_REFRESH_TOKEN",
@@ -81,6 +93,18 @@ function expandHome(p) {
         return resolve(homedir(), p.slice(2));
     return resolve(p);
 }
+function pluginConfigFromRoot(root, pluginId) {
+    if (typeof root !== "object" || root === null)
+        return undefined;
+    const entries = root.plugins?.entries;
+    const entry = entries?.[pluginId];
+    if (typeof entry !== "object" || entry === null)
+        return undefined;
+    const config = entry.config;
+    return typeof config === "object" && config !== null && !Array.isArray(config)
+        ? config
+        : undefined;
+}
 let activeTokenResolver;
 let alertState = { alerts: [] };
 let loginProbeTimer;
@@ -352,7 +376,7 @@ function checkModelCurrency(catalogIds, chainRefs, poolId) {
     }
 }
 export function buildBackend(account, execMode) {
-    return {
+    const backend = {
         id: account.id,
         liveTest: {
             defaultModelRef: `${account.id}/${account.defaultModel ?? "claude-fable-5"}`,
@@ -372,6 +396,8 @@ export function buildBackend(account, execMode) {
             command: process.execPath,
             args: [SHIM_PATH, ...BASE_ARGS, ...permissionModeArgs(execMode)],
             resumeArgs: [SHIM_PATH, ...BASE_ARGS, ...permissionModeArgs(execMode), "--resume", "{sessionId}"],
+            forkArg: "--fork-session",
+            resumeAtArg: "--resume-session-at",
             output: "jsonl",
             liveSession: "claude-stdio",
             input: "stdin",
@@ -380,8 +406,9 @@ export function buildBackend(account, execMode) {
             modelAliases: { ...MODEL_ALIASES },
             imageArg: "@",
             imagePathScope: "workspace",
-            sessionArg: "--session-id",
+            sessionArgs: ["--session-id", "{sessionId}"],
             sessionMode: "always",
+            freshSessionRecovery: "invalidated-only",
             reseedFromRawTranscriptWhenUncompacted: true,
             sessionIdFields: ["session_id", "sessionId", "conversation_id", "conversationId"],
             systemPromptFileArg: "--append-system-prompt-file",
@@ -400,6 +427,8 @@ export function buildBackend(account, execMode) {
             return { env: await buildAccountEnv(account) };
         },
     };
+    Object.assign(backend.config, { sessionArg: "--session-id" });
+    return backend;
 }
 async function buildAccountEnv(account, resolver) {
     const token = await resolveTokenAsync(account, resolver);
@@ -434,12 +463,12 @@ export default definePluginEntry({
     name: "multi-clawd",
     description: "Register additional Claude Code logins as first-class OpenClaw CLI backends for cross-account failover.",
     register(api) {
-        const runtimeConfigLoader = (api.runtime?.config?.current
+        const runtimeConfigLoader = api.runtime?.config?.current
             ? () => api.runtime.config.current()
-            : undefined);
+            : undefined;
         const candidates = [
-            resolveLivePluginConfigObject(runtimeConfigLoader, "multi-clawd", api.pluginConfig),
-            resolvePluginConfigObject(api.config, "multi-clawd"),
+            pluginConfigFromRoot(runtimeConfigLoader?.(), "multi-clawd"),
+            pluginConfigFromRoot(api.config, "multi-clawd"),
             api.pluginConfig,
         ];
         const hasAccounts = (c) => Array.isArray(c?.accounts) &&

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "multi-clawd",
   "name": "multi-clawd",
-  "version": "1.8.2",
+  "version": "1.8.3",
   "description": "Register additional Claude Code logins (Max/Pro accounts) as first-class OpenClaw CLI backends for cross-account failover, keeping the full skills/MCP harness on every account.",
   "cliBackends": [
     "claw1",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drakon-systems/multi-clawd",
-  "version": "1.8.2",
+  "version": "1.8.3",
   "description": "Multi-account Claude Code failover for OpenClaw — register additional Claude (Max/Pro) logins as first-class CLI backends and keep the full skills/MCP harness across every account. Also imports those accounts' setup tokens into Hermes Agent's Anthropic credential pool.",
   "type": "module",
   "license": "MIT",
@@ -21,7 +21,7 @@
   ],
   "openclaw": {
     "build": {
-      "openclawVersion": "2026.7.1"
+      "openclawVersion": "2026.8.1"
     },
     "extensions": [
       "./src/index.ts"
@@ -72,7 +72,7 @@
     }
   },
   "devDependencies": {
-    "openclaw": "2026.7.1",
+    "openclaw": "2026.8.1",
     "typescript": "^5.9.0",
     "vitest": "^4.1.10"
   },