clawconnect-agent 0.2.3 → 0.2.5

package/README.md

@@ -422,7 +422,7 @@ Tests are colocated with the source as `*.test.ts`. They run with `npm test`, an
 ## Requirements
 
 - macOS, Linux, or Windows 10 / Server 2016+
-- Node.js 18+
+- Node.js 22.19+
 
 ## License
 

package/README.zh-CN.md

@@ -477,7 +477,7 @@ clawconnect-agent/
 ## 前置要求
 
 - macOS、Linux 或 Windows 10 / Server 2016+
-- Node.js `18+`
+- Node.js `22.19+`
 - 本机已安装并可运行 `openclaw`
 - 本机 OpenClaw Gateway 能正常启动
 

package/dist/hermes/runtime/hermes-api-bootstrap.d.ts

@@ -5,6 +5,8 @@ export interface HermesApiBootstrapOptions {
     fileEnv?: Record<string, string>;
     runHermesCommand?: (args: string[]) => string;
     generateApiKey?: () => string;
+    writeEnvValues?: (values: Record<string, string>) => void;
+    readBackEnv?: () => Record<string, string>;
 }
 export type HermesApiBootstrapResult = "already-ready" | "configured" | "explicit-local" | "external-api";
 /**
@@ -16,4 +18,5 @@ export type HermesApiBootstrapResult = "already-ready" | "configured" | "explici
  * idempotent and never exposes the generated API key to ClawConnect logs.
  */
 export declare function ensureHermesApiServer(options?: HermesApiBootstrapOptions): HermesApiBootstrapResult;
+export declare function writeHermesEnvValues(values: Record<string, string>, options?: Pick<HermesApiBootstrapOptions, "env" | "hermesHome">): void;
 export {};

package/dist/hermes/runtime/hermes-api-bootstrap.js

@@ -1,5 +1,10 @@
 import { randomBytes } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { parseEnvFile } from "../../config/env.js";
+import { setRestrictiveDirPermissions, setRestrictiveFilePermissions } from "../../platform/service-manager-common.js";
 import { resolveHermesApiSettings, readHermesHomeEnv } from "./hermes-runtime-api-settings.js";
+import { resolveHermesHomeDir } from "./hermes-runtime-paths.js";
 import { runHermes } from "./hermes-runtime-process.js";
 /**
  * Make Hermes' local API Server the default ClawConnect transport.
@@ -28,19 +33,75 @@ export function ensureHermesApiServer(options = {}) {
     const run = options.runHermesCommand ?? ((args) => runHermes(args));
     const existingKey = firstNonEmpty(env.CLAWCONNECT_HERMES_API_KEY, fileEnv.CLAWCONNECT_HERMES_API_KEY, env.API_SERVER_KEY, fileEnv.API_SERVER_KEY, settings.apiKey);
     const apiKey = existingKey ?? (options.generateApiKey ?? (() => randomBytes(32).toString("hex")))();
+    const values = {
+        API_SERVER_ENABLED: "true",
+        ...(!existingKey ? { API_SERVER_KEY: apiKey } : {}),
+    };
     try {
-        run(["config", "set", "API_SERVER_ENABLED", "true"]);
-        if (!existingKey) {
-            run(["config", "set", "API_SERVER_KEY", apiKey]);
+        const writeEnvValues = options.writeEnvValues ?? ((nextValues) => {
+            writeHermesEnvValues(nextValues, { env, hermesHome: options.hermesHome });
+        });
+        writeEnvValues(values);
+        const verifiedEnv = options.readBackEnv
+            ? options.readBackEnv()
+            : options.writeEnvValues
+                ? { ...fileEnv, ...values }
+                : readHermesHomeEnv({ env, hermesHome: options.hermesHome });
+        const verified = resolveHermesApiSettings({ env, fileEnv: verifiedEnv, hermesHome: options.hermesHome });
+        if (!isTruthy(verifiedEnv.API_SERVER_ENABLED) || !verified.executionReady) {
+            throw new Error("Hermes API environment verification failed");
         }
         run(["gateway", "restart"]);
     }
     catch {
-        throw new Error("Failed to enable the Hermes API Server. Run 'hermes config set API_SERVER_ENABLED true' "
-            + "and 'hermes gateway restart', or explicitly set CLAWCONNECT_HERMES_RUNTIME_MODE=local.");
+        throw new Error("Failed to enable and verify the Hermes API Server in its .env file. "
+            + "Check the Hermes home permissions, or explicitly set CLAWCONNECT_HERMES_RUNTIME_MODE=local.");
     }
     return "configured";
 }
+export function writeHermesEnvValues(values, options = {}) {
+    const env = options.env ?? process.env;
+    const hermesHome = options.hermesHome ?? resolveHermesHomeDir({ env });
+    const envPath = join(hermesHome, ".env");
+    const current = existsSync(envPath) ? readFileSync(envPath, "utf8") : "";
+    const requested = new Map(Object.entries(values));
+    const pending = new Map(requested);
+    const written = new Set();
+    const lines = current.split(/\r?\n/).map((line) => {
+        const match = line.match(/^\s*(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=/);
+        const key = match?.[1];
+        if (!key || !requested.has(key))
+            return line;
+        if (written.has(key))
+            return "";
+        const value = requested.get(key) ?? "";
+        written.add(key);
+        pending.delete(key);
+        return `${key}=${formatEnvValue(value)}`;
+    });
+    while (lines.length > 0 && lines[lines.length - 1] === "")
+        lines.pop();
+    for (const [key, value] of pending) {
+        lines.push(`${key}=${formatEnvValue(value)}`);
+    }
+    const output = `${lines.join("\n")}\n`;
+    const tempPath = join(dirname(envPath), `.env.clawconnect-${process.pid}-${randomBytes(6).toString("hex")}.tmp`);
+    mkdirSync(hermesHome, { recursive: true });
+    setRestrictiveDirPermissions(hermesHome);
+    writeFileSync(tempPath, output, "utf8");
+    setRestrictiveFilePermissions(tempPath);
+    renameSync(tempPath, envPath);
+    setRestrictiveFilePermissions(envPath);
+    const verified = parseEnvFile(readFileSync(envPath, "utf8"));
+    for (const [key, value] of Object.entries(values)) {
+        if (verified[key] !== value) {
+            throw new Error(`Failed to verify Hermes environment key ${key}`);
+        }
+    }
+}
+function formatEnvValue(value) {
+    return /^[A-Za-z0-9_./:@+-]*$/.test(value) ? value : JSON.stringify(value);
+}
 function firstNonEmpty(...values) {
     for (const value of values) {
         const trimmed = value?.trim();

package/dist/hermes/runtime/hermes-api-bootstrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"hermes-api-bootstrap.js","sourceRoot":"","sources":["../../../src/hermes/runtime/hermes-api-bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC/F,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAcxD;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAqC,EAAE;IAC3E,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,cAAc,GAAG,GAAG,CAAC,+BAA+B,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACjF,IAAI,cAAc,KAAK,OAAO,IAAI,cAAc,KAAK,KAAK,IAAI,cAAc,KAAK,QAAQ,EAAE,CAAC;QAC1F,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,iBAAiB,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC9F,MAAM,QAAQ,GAAG,wBAAwB,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC5F,MAAM,WAAW,GAAG,aAAa,CAC/B,GAAG,CAAC,0BAA0B,EAC9B,GAAG,CAAC,qBAAqB,EACzB,OAAO,CAAC,0BAA0B,EAClC,OAAO,CAAC,qBAAqB,CAC9B,CAAC;IACF,IAAI,WAAW,IAAI,QAAQ,CAAC,cAAc,EAAE,CAAC;QAC3C,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAC5F,IAAI,OAAO,IAAI,QAAQ,CAAC,cAAc,EAAE,CAAC;QACvC,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,gBAAgB,IAAI,CAAC,CAAC,IAAc,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9E,MAAM,WAAW,GAAG,aAAa,CAC/B,GAAG,CAAC,0BAA0B,EAC9B,OAAO,CAAC,0BAA0B,EAClC,GAAG,CAAC,cAAc,EAClB,OAAO,CAAC,cAAc,EACtB,QAAQ,CAAC,MAAM,CAChB,CAAC;IACF,MAAM,MAAM,GAAG,WAAW,IAAI,CAAC,OAAO,CAAC,cAAc,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAEpG,IAAI,CAAC;QACH,GAAG,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,oBAAoB,EAAE,MAAM,CAAC,CAAC,CAAC;QACrD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,GAAG,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC;QACnD,CAAC;QACD,GAAG,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,0FAA0F;cACxF,wFAAwF,CAC3F,CAAC;IACJ,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,SAAS,aAAa,CAAC,GAAG,MAAiC;IACzD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;QAC9B,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC;IAC9B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,QAAQ,CAAC,KAAyB;IACzC,OAAO,KAAK,KAAK,GAAG,IAAI,KAAK,EAAE,WAAW,EAAE,KAAK,MAAM,IAAI,KAAK,EAAE,WAAW,EAAE,KAAK,KAAK,IAAI,KAAK,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;AAC7H,CAAC"}
+{"version":3,"file":"hermes-api-bootstrap.js","sourceRoot":"","sources":["../../../src/hermes/runtime/hermes-api-bootstrap.ts"],"names":[],"mappings":"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"}

package/dist/openclaw/gateway-client.d.ts

@@ -1,3 +1,4 @@
+import { type GatewayClientMode, type GatewayClientName } from "@openclaw/gateway-protocol/client-info";
 export declare function gatewayWebSocketOrigin(url: string): string;
 export interface GatewayClientOptions {
     url: string | (() => string);
@@ -6,27 +7,30 @@ export interface GatewayClientOptions {
     role?: string;
     scopes?: string[];
     caps?: string[];
-    clientMode?: string;
-    clientId?: string;
+    clientMode?: GatewayClientMode;
+    clientId?: GatewayClientName;
     clientDisplayName?: string;
     clientVersion?: string;
     onConnected: () => void;
     onEvent: (eventName: string, payload: unknown) => void;
     onDisconnected: (reason: string) => void;
 }
+/**
+ * ClawConnect's compatibility wrapper around OpenClaw's reference v4 client.
+ *
+ * ClawConnect is a WebChat bridge, not the bundled Control UI. Advertising the
+ * WebChat identity preserves chat routing while avoiding Control UI build-ID
+ * checks that third-party clients cannot satisfy.
+ */
 export declare class OpenClawGatewayClient {
     private readonly opts;
-    private ws;
-    private pending;
-    private backoffMs;
+    private client;
+    private activeUrl;
     private stopped;
-    private connectNonce;
-    private connectSent;
-    private storedDeviceToken;
-    private connectTimer;
-    private tickTimer;
-    private lastTick;
-    private tickIntervalMs;
+    private reconnectTimer;
+    private storedDeviceAuth;
+    private responseHookRequests;
+    private bufferedEvents;
     private readonly identity;
     constructor(opts: GatewayClientOptions);
     start(): void;
@@ -36,10 +40,6 @@ export declare class OpenClawGatewayClient {
         onResponse?: (value: T) => void;
     }): Promise<T>;
     private resolveUrl;
-    private sendConnect;
-    private handleMessage;
-    private startTickWatch;
-    private scheduleReconnect;
-    private teardown;
-    private flushPending;
+    private recreateForChangedUrl;
+    private flushBufferedEvents;
 }