@chrysb/alphaclaw 0.9.29 → 0.9.31

package/lib/server/openclaw-version.js

@@ -10,6 +10,7 @@ const {
 } = require("./constants");
 const { normalizeOpenclawVersion } = require("./helpers");
 const { parseJsonObjectFromNoisyOutput } = require("./utils/json");
+const { assertSupportedNodeVersion } = require("../node-runtime");
 
 const createOpenclawVersionService = ({
   gatewayEnv,
@@ -124,6 +125,12 @@ const createOpenclawVersionService = ({
   // Copying individual files (cp -af) avoids the rename syscall entirely.
   const installLatestOpenclaw = () =>
     new Promise((resolve, reject) => {
+      try {
+        assertSupportedNodeVersion();
+      } catch (error) {
+        reject(error);
+        return;
+      }
       const installDir = findInstallDir();
       const tmpDir = fs.mkdtempSync(
         path.join(os.tmpdir(), "openclaw-update-"),

package/lib/server/plugin-config.js

@@ -0,0 +1,22 @@
+const ensurePluginsShell = (cfg = {}) => {
+  if (!cfg.plugins || typeof cfg.plugins !== "object") cfg.plugins = {};
+  if (!Array.isArray(cfg.plugins.allow)) cfg.plugins.allow = [];
+  if (!cfg.plugins.load || typeof cfg.plugins.load !== "object") {
+    cfg.plugins.load = {};
+  }
+  if (!Array.isArray(cfg.plugins.load.paths)) cfg.plugins.load.paths = [];
+  if (!cfg.plugins.entries || typeof cfg.plugins.entries !== "object") {
+    cfg.plugins.entries = {};
+  }
+};
+
+const ensurePluginAllowed = ({ cfg = {}, pluginKey = "" }) => {
+  const normalizedPluginKey = String(pluginKey || "").trim();
+  if (!normalizedPluginKey) return;
+  ensurePluginsShell(cfg);
+  if (!cfg.plugins.allow.includes(normalizedPluginKey)) {
+    cfg.plugins.allow.push(normalizedPluginKey);
+  }
+};
+
+module.exports = { ensurePluginsShell, ensurePluginAllowed };

package/lib/server/routes/models.js

@@ -197,8 +197,12 @@ const registerModelRoutes = ({
         typeof cfg.agents?.defaults?.thinkingDefault === "string"
           ? cfg.agents.defaults.thinkingDefault.trim()
           : null;
+      const agentRuntime = String(
+        cfg.agents?.defaults?.models?.[modelKey]?.agentRuntime?.id || "",
+      ).trim();
       const { levels, modelDefault } = await resolveThinkingOptionsForModel({
         modelKey,
+        agentRuntime,
       });
       const inheritedDefault = globalThinkingDefault || modelDefault || "off";
       return res.json({

package/lib/server/startup.js

@@ -1,6 +1,7 @@
 const runOnboardedBootSequence = ({
   ensureManagedExecDefaults,
   ensureUsageTrackerPluginConfig,
+  ensureWebhookMappingIds,
   doSyncPromptFiles,
   reloadEnv,
   syncChannelConfig,
@@ -25,6 +26,18 @@ const runOnboardedBootSequence = ({
       `[alphaclaw] Failed to ensure usage-tracker plugin config on boot: ${error.message}`,
     );
   }
+  try {
+    const result = ensureWebhookMappingIds();
+    if (result?.changed) {
+      console.log(
+        `[alphaclaw] Added IDs to webhook mappings: ${result.updatedIds.join(", ")}`,
+      );
+    }
+  } catch (error) {
+    console.error(
+      `[alphaclaw] Failed to ensure webhook mapping IDs on boot: ${error.message}`,
+    );
+  }
   doSyncPromptFiles();
   reloadEnv();
   syncChannelConfig(readEnvFile());

package/lib/server/usage-tracker-config.js

@@ -3,6 +3,8 @@ const { readOpenclawConfig, writeOpenclawConfig } = require("./openclaw-config")
 const {
   migrateLegacyTelegramStreamingConfig,
 } = require("./openclaw-config-migrations");
+const { ensureCodexRuntimePlugin } = require("./codex-runtime-config");
+const { ensurePluginsShell, ensurePluginAllowed } = require("./plugin-config");
 
 const kUsageTrackerPluginPath = path.resolve(
   __dirname,
@@ -14,27 +16,6 @@ const kConversationAccessHookPolicyKey = "allowConversationAccess";
 const kChannelPluginIds = ["telegram", "discord", "slack", "whatsapp"];
 const kDefaultDiscordGroupPolicy = "disabled";
 
-const ensurePluginsShell = (cfg = {}) => {
-  if (!cfg.plugins || typeof cfg.plugins !== "object") cfg.plugins = {};
-  if (!Array.isArray(cfg.plugins.allow)) cfg.plugins.allow = [];
-  if (!cfg.plugins.load || typeof cfg.plugins.load !== "object") {
-    cfg.plugins.load = {};
-  }
-  if (!Array.isArray(cfg.plugins.load.paths)) cfg.plugins.load.paths = [];
-  if (!cfg.plugins.entries || typeof cfg.plugins.entries !== "object") {
-    cfg.plugins.entries = {};
-  }
-};
-
-const ensurePluginAllowed = ({ cfg = {}, pluginKey = "" }) => {
-  const normalizedPluginKey = String(pluginKey || "").trim();
-  if (!normalizedPluginKey) return;
-  ensurePluginsShell(cfg);
-  if (!cfg.plugins.allow.includes(normalizedPluginKey)) {
-    cfg.plugins.allow.push(normalizedPluginKey);
-  }
-};
-
 const buildUsageTrackerHookPolicy = ({ existingHooks = {} } = {}) => {
   const hooks = {};
   if (typeof existingHooks.allowPromptInjection === "boolean") {
@@ -115,6 +96,7 @@ const reconcileEnabledChannelPlugins = (cfg = {}) => {
 
 const reconcileManagedPluginConfig = (cfg = {}) => {
   let changed = ensureUsageTrackerPluginEntry(cfg);
+  if (ensureCodexRuntimePlugin(cfg)) changed = true;
   if (reconcileEnabledChannelPlugins(cfg)) changed = true;
   if (reconcileDiscordGroupPolicy(cfg)) changed = true;
   return changed;

package/lib/server/watchdog.js

@@ -63,6 +63,7 @@ const createWatchdog = ({
     pendingRecoveryNoticeSource: "",
     awaitingAutoRepairRecovery: false,
     startupConsecutiveHealthFailures: 0,
+    configurationErrorActive: false,
   };
   let healthTimer = null;
   let bootstrapHealthTimer = null;
@@ -90,6 +91,7 @@ const createWatchdog = ({
 
   const scheduleDegradedHealthCheck = () => {
     if (degradedHealthTimer) return;
+    if (state.configurationErrorActive) return;
     if (state.health !== "degraded" || state.lifecycle !== "running") return;
     degradedHealthTimer = setTimeout(async () => {
       degradedHealthTimer = null;
@@ -380,6 +382,9 @@ const createWatchdog = ({
   };
 
   const runRepair = async ({ source, correlationId, force = false }) => {
+    if (state.configurationErrorActive && !force) {
+      return { ok: false, skipped: true, reason: "configuration_error" };
+    }
     if (!force && !state.autoRepair) {
       return { ok: false, skipped: true, reason: "auto_repair_disabled" };
     }
@@ -389,10 +394,16 @@ const createWatchdog = ({
     if (state.operationInProgress) {
       return { ok: false, skipped: true, reason: "operation_in_progress" };
     }
+    if (force) {
+      state.configurationErrorActive = false;
+    }
 
     state.operationInProgress = true;
     try {
       const result = await clawCmd("doctor --fix --yes", { quiet: true });
+      if (state.configurationErrorActive && !force) {
+        return { ok: false, skipped: true, reason: "configuration_error" };
+      }
       const ok = !!result?.ok;
       logEvent("repair", source, ok ? "ok" : "failed", result, correlationId);
       if (ok) {
@@ -484,6 +495,7 @@ const createWatchdog = ({
     source = "health_timer",
     allowAutoRepair = true,
   } = {}) => {
+    if (state.configurationErrorActive) return false;
     if (
       state.expectedRestartInProgress &&
       Date.now() >= state.expectedRestartUntilMs
@@ -495,6 +507,9 @@ const createWatchdog = ({
     const correlationId = createCorrelationId();
     state.lastHealthCheckAt = new Date().toISOString();
     const parsed = await probeGatewayHealth();
+    // The gateway may exit with EX_CONFIG while a probe is in flight. Keep the
+    // latched configuration-error state from being overwritten by that result.
+    if (state.configurationErrorActive) return false;
     const staleAfterRestart =
       gatewayStartedAtAtStart != null &&
       state.gatewayStartedAt != null &&
@@ -727,6 +742,33 @@ const createWatchdog = ({
       return;
     }
 
+    if (code === 78) {
+      state.configurationErrorActive = true;
+      state.lifecycle = "configuration_error";
+      state.health = "unhealthy";
+      state.uptimeStartedAt = null;
+      state.crashRecoveryActive = false;
+      state.startupConsecutiveHealthFailures = 0;
+      logEvent(
+        "config_error",
+        "exit_event",
+        "failed",
+        { code, signal: signal ?? null, stderrTail },
+        correlationId,
+      );
+      void notifyOncePerIncident(
+        "gateway_config_error",
+        [
+          "🐺 *AlphaClaw Watchdog*",
+          withViewLogsSuffix("🔴 Gateway configuration invalid"),
+          "OpenClaw stopped with `EX_CONFIG`; automatic restart is paused.",
+        ].join("\n"),
+        correlationId,
+        "config_error",
+      );
+      return;
+    }
+
     state.lifecycle = "crashed";
     state.health = "unhealthy";
     state.uptimeStartedAt = null;
@@ -787,6 +829,7 @@ const createWatchdog = ({
 
   const onGatewayLaunch = ({ startedAt = Date.now(), pid = null } = {}) => {
     clearDegradedHealthCheckTimer();
+    state.configurationErrorActive = false;
     state.lifecycle = "running";
     state.health = "unknown";
     state.startupConsecutiveHealthFailures = 0;

package/lib/server/webhooks.js

@@ -1,4 +1,8 @@
 const path = require("path");
+const {
+  readOpenclawConfig,
+  resolveOpenclawConfigPath,
+} = require("./openclaw-config");
 
 const kNamePattern = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 const kTransformsDir = "hooks/transforms";
@@ -12,11 +16,16 @@ const kManagedWebhookConfigs = [
 ];
 
 const getConfigPath = ({ OPENCLAW_DIR }) =>
-  path.join(OPENCLAW_DIR, "openclaw.json");
+  resolveOpenclawConfigPath({ openclawDir: OPENCLAW_DIR });
 
 const readConfig = ({ fs, constants }) => {
   const configPath = getConfigPath(constants);
-  const cfg = JSON.parse(fs.readFileSync(configPath, "utf8"));
+  const cfg = readOpenclawConfig({
+    fsModule: fs,
+    openclawDir: constants.OPENCLAW_DIR,
+    fallback: null,
+  });
+  if (!cfg) throw new Error("Could not read openclaw.json");
   return { cfg, configPath };
 };
 
@@ -78,6 +87,32 @@ const ensureHooksRoot = (cfg) => {
 
 const getMappingHookName = (mapping) =>
   String(mapping?.match?.path || "").trim();
+const normalizeMappingIdPart = (value) =>
+  String(value || "")
+    .trim()
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/-+/g, "-")
+    .replace(/^-|-$/g, "");
+const getMappingIdBase = (mapping, index) => {
+  const hookPath = normalizeMappingIdPart(getMappingHookName(mapping));
+  if (hookPath) return hookPath;
+  const name = normalizeMappingIdPart(mapping?.name);
+  if (name) return name;
+  const source = normalizeMappingIdPart(mapping?.match?.source);
+  if (source) return `source-${source}`;
+  return `mapping-${index + 1}`;
+};
+const reserveUniqueMappingId = (baseId, usedIds) => {
+  let candidate = baseId;
+  let suffix = 2;
+  while (usedIds.has(candidate)) {
+    candidate = `${baseId}-${suffix}`;
+    suffix += 1;
+  }
+  usedIds.add(candidate);
+  return candidate;
+};
 const isWebhookMapping = (mapping) => !!getMappingHookName(mapping);
 const findMappingIndexByName = (mappings, name) =>
   mappings.findIndex((mapping) => getMappingHookName(mapping) === name);
@@ -142,6 +177,35 @@ const normalizeMappingTransformModules = (mappings) => {
   return changed;
 };
 
+const ensureWebhookMappingIds = ({ fs, constants }) => {
+  const { cfg, configPath } = readConfig({ fs, constants });
+  const mappings = Array.isArray(cfg?.hooks?.mappings)
+    ? cfg.hooks.mappings
+    : [];
+  const usedIds = new Set(
+    mappings
+      .map((mapping) => String(mapping?.id || "").trim())
+      .filter(Boolean),
+  );
+  const updatedIds = [];
+  for (const [index, mapping] of mappings.entries()) {
+    if (!mapping || typeof mapping !== "object" || Array.isArray(mapping)) {
+      continue;
+    }
+    if (String(mapping?.id || "").trim()) continue;
+    const id = reserveUniqueMappingId(
+      getMappingIdBase(mapping, index),
+      usedIds,
+    );
+    mapping.id = id;
+    updatedIds.push(id);
+  }
+  if (updatedIds.length > 0) {
+    writeConfig({ fs, configPath, cfg });
+  }
+  return { changed: updatedIds.length > 0, updatedIds };
+};
+
 const buildDefaultTransformSource = (name) => {
   return [
     "export default async function transform(payload, context) {",
@@ -188,6 +252,7 @@ const ensureWebhookMapping = ({ cfg, name, mapping = {} }) => {
   const normalizedModulesChanged = normalizeMappingTransformModules(mappings);
   const index = findMappingIndexByName(mappings, webhookName);
   const defaults = {
+    id: webhookName,
     match: { path: webhookName },
     action: "agent",
     name: webhookName,
@@ -198,6 +263,7 @@ const ensureWebhookMapping = ({ cfg, name, mapping = {} }) => {
     mappings.push({
       ...defaults,
       ...mapping,
+      id: webhookName,
       match: { ...defaults.match, ...(mapping.match || {}) },
       transform: { ...defaults.transform, ...(mapping.transform || {}) },
     });
@@ -207,6 +273,7 @@ const ensureWebhookMapping = ({ cfg, name, mapping = {} }) => {
   const next = {
     ...current,
     ...mapping,
+    id: webhookName,
     match: {
       ...(current.match || {}),
       ...(mapping.match || {}),
@@ -436,6 +503,7 @@ const updateWebhookDestination = ({ fs, constants, name, destination = null }) =
   });
   const next = {
     ...current,
+    id: webhookName,
     deliver: true,
     channel:
       String(normalizedDestination?.channel || "").trim() ||
@@ -499,6 +567,7 @@ const deleteWebhook = ({ fs, constants, name, deleteTransformDir = false }) => {
 };
 
 module.exports = {
+  ensureWebhookMappingIds,
   listWebhooks,
   getWebhookDetail,
   createWebhook,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chrysb/alphaclaw",
-  "version": "0.9.29",
+  "version": "0.9.31",
   "publishConfig": {
     "access": "public"
   },
@@ -33,7 +33,7 @@
   "dependencies": {
     "express": "^4.21.0",
     "http-proxy": "^1.18.1",
-    "openclaw": "2026.6.11",
+    "openclaw": "2026.7.1",
     "ws": "^8.19.0"
   },
   "devDependencies": {
@@ -51,6 +51,6 @@
     "wouter-preact": "^3.7.1"
   },
   "engines": {
-    "node": ">=22.19.0"
+    "node": ">=22.22.3 <23 || >=24.15.0 <25 || >=25.9.0"
   }
 }