@chrysb/alphaclaw 0.9.28 → 0.9.30

package/lib/public/js/components/gateway.js

@@ -36,6 +36,8 @@ export const Gateway = ({
     watchdogStatus?.lifecycle === "crash_loop"
       ? "crash_loop"
       : watchdogStatus?.health;
+  const hasConfigurationError =
+    watchdogStatus?.lifecycle === "configuration_error";
   const watchdogDotClass =
     watchdogHealth === "healthy"
       ? "ac-status-dot ac-status-dot--healthy ac-status-dot--healthy-offset"
@@ -44,8 +46,11 @@ export const Gateway = ({
         : watchdogHealth === "unhealthy" || watchdogHealth === "crash_loop"
           ? "bg-red-500"
           : "bg-gray-500";
-  const watchdogLabel =
-    watchdogHealth === "unknown" ? "initializing" : watchdogHealth || "unknown";
+  const watchdogLabel = hasConfigurationError
+    ? "configuration error"
+    : watchdogHealth === "unknown"
+      ? "initializing"
+      : watchdogHealth || "unknown";
   const isRepairInProgress = repairing || !!watchdogStatus?.operationInProgress;
   const showInspectButton = watchdogHealth === "degraded" && !!onOpenWatchdog;
   const showRepairButton =

package/lib/public/js/components/models-tab/model-picker.js

@@ -4,6 +4,7 @@ import htm from "htm";
 import {
   getModelProvider,
   getAuthProviderFromModelProvider,
+  getFriendlyModelLabel,
   kProviderLabels,
   kProviderOrder,
 } from "../../lib/model-config.js";
@@ -79,11 +80,13 @@ export const buildSyntheticModelEntry = (modelKey) => {
   return {
     key,
     provider,
-    label: anthropicLabel || key,
+    label: anthropicLabel || getFriendlyModelLabel(key),
   };
 };
 
-export const getModelDisplayLabel = (model) => model?.featuredLabel || model?.label || model?.key;
+export const getModelDisplayLabel = (model) =>
+  model?.featuredLabel ||
+  getFriendlyModelLabel(model?.key, model?.label || model?.key);
 
 const buildModelSearchText = (model) =>
   [

package/lib/public/js/components/models-tab/use-models.js

@@ -16,6 +16,7 @@ import {
   kModelCatalogCacheKey,
   kModelCatalogPollIntervalMs,
 } from "../../lib/model-catalog.js";
+import { withAlwaysAvailableModels } from "../../lib/model-config.js";
 
 let kModelsTabCache = null;
 const getCredentialValue = (value) =>
@@ -199,7 +200,9 @@ export const useModels = (agentId) => {
   const addModel = useCallback(
     (modelKey) => {
       if (!modelKey) return;
-      const catalogEntry = catalog.find((model) => model?.key === modelKey);
+      const catalogEntry = withAlwaysAvailableModels(catalog).find(
+        (model) => model?.key === modelKey,
+      );
       const modelConfig = catalogEntry?.agentRuntime
         ? { agentRuntime: catalogEntry.agentRuntime }
         : {};

package/lib/public/js/components/nodes-tab/setup-wizard/index.js

@@ -100,7 +100,9 @@ export const NodesSetupWizard = ({
                 onCopy: () =>
                   copyAndToast("npm install -g openclaw", "command"),
               })}
-              <div class="text-xs text-fg-muted">Requires Node.js 22+.</div>
+              <div class="text-xs text-fg-muted">
+                Requires Node.js ${">=22.22.3 <23, >=24.15.0 <25, or >=25.9.0."}
+              </div>
             `
           : null
       }

package/lib/public/js/components/onboarding/welcome-config.js

@@ -53,12 +53,16 @@ const getAiGroupError = (vals, ctx = {}) => {
   if (!hasValue(vals.MODEL_KEY) || !String(vals.MODEL_KEY).includes("/")) {
     return "Choose a model to continue.";
   }
-  if (ctx.selectedProvider === "openai-codex" && ctx.codexLoading) {
+  if (
+    ctx.selectedProvider === "openai-codex" &&
+    ctx.codexLoading &&
+    !ctx.hasAi
+  ) {
     return "Checking Codex OAuth status. Try Next again in a moment.";
   }
   if (!ctx.hasAi) {
     return ctx.selectedProvider === "openai-codex"
-      ? "Connect Codex OAuth to continue."
+      ? "Connect Codex OAuth or enter an OpenAI API key to continue."
       : "Add credentials for the selected model provider to continue.";
   }
   return "";

package/lib/public/js/components/onboarding/welcome-setup-step.js

@@ -2,6 +2,7 @@ import { h } from "preact";
 import { useEffect, useState } from "preact/hooks";
 import htm from "htm";
 import { LoadingSpinner } from "../loading-spinner.js";
+import { fetchOnboardProgress } from "../../lib/api.js";
 
 const html = htm.bind(h);
 const kSetupTips = [
@@ -30,9 +31,24 @@ const kSetupTips = [
     text: "Be incredibly careful installing skills from the internet - they may contain malicious code.",
   },
 ];
+const kDefaultProgress = {
+  stage: "creating_repo",
+  message: "Creating repo...",
+};
+const kProgressStepNumbers = {
+  creating_repo: 1,
+  running_openclaw_onboard: 2,
+  initial_git_push: 3,
+  starting_gateway: 4,
+};
+const kProgressPollIntervalMs = 500;
+const kProgressDotsIntervalMs = 450;
+const kProgressDotSlots = [1, 2, 3];
 
 export const WelcomeSetupStep = ({ error, loading, onRetry, onBack }) => {
   const [tipIndex, setTipIndex] = useState(0);
+  const [progress, setProgress] = useState(kDefaultProgress);
+  const [progressDotCount, setProgressDotCount] = useState(1);
 
   useEffect(() => {
     if (error || !loading) return;
@@ -42,6 +58,35 @@ export const WelcomeSetupStep = ({ error, loading, onRetry, onBack }) => {
     return () => clearInterval(timer);
   }, [error, loading]);
 
+  useEffect(() => {
+    if (error || !loading) return;
+    let cancelled = false;
+    const refreshProgress = async () => {
+      try {
+        const progress = await fetchOnboardProgress();
+        if (!cancelled && progress?.message) {
+          setProgress(progress);
+        }
+      } catch {}
+    };
+    setProgress(kDefaultProgress);
+    refreshProgress();
+    const timer = setInterval(refreshProgress, kProgressPollIntervalMs);
+    return () => {
+      cancelled = true;
+      clearInterval(timer);
+    };
+  }, [error, loading]);
+
+  useEffect(() => {
+    if (error || !loading) return;
+    setProgressDotCount(1);
+    const timer = setInterval(() => {
+      setProgressDotCount((count) => (count % 3) + 1);
+    }, kProgressDotsIntervalMs);
+    return () => clearInterval(timer);
+  }, [error, loading]);
+
   if (error) {
     return html`
       <div class="py-4 flex flex-col items-center text-center gap-3">
@@ -77,6 +122,8 @@ export const WelcomeSetupStep = ({ error, loading, onRetry, onBack }) => {
   }
 
   const currentTip = kSetupTips[tipIndex];
+  const progressStep = kProgressStepNumbers[progress.stage] || 1;
+  const progressLabel = (progress.message || kDefaultProgress.message).replace(/\.{1,3}$/, "");
 
   return html`
     <div class="relative min-h-[320px] pt-4 pb-20 flex">
@@ -84,10 +131,17 @@ export const WelcomeSetupStep = ({ error, loading, onRetry, onBack }) => {
         class="flex-1 flex flex-col items-center justify-center text-center gap-4"
       >
         <${LoadingSpinner} className="h-8 w-8 text-body" />
-        <h3 class="text-lg font-semibold text-body">
-          Initializing OpenClaw...
-        </h3>
-        <p class="text-sm text-fg-muted">This could take 10-15 seconds</p>
+        <h3 class="text-lg font-semibold text-body">Initializing AlphaClaw...</h3>
+        <p class="text-sm text-fg-muted">
+          ${progressStep} / 4: ${progressLabel}<span class="inline-flex" aria-hidden="true"
+            >${kProgressDotSlots.map(
+              (slot) => html`<span style=${{ visibility: slot <= progressDotCount ? "visible" : "hidden" }}
+                >.</span
+              >`,
+            )}</span
+          >
+        </p>
+        <p class="text-xs text-fg-muted">This could take up to 30 seconds</p>
       </div>
       <div
         class="absolute bottom-3 left-3 right-3 bg-field border border-border rounded-lg px-3 py-2 text-xs text-fg-muted"

package/lib/public/js/components/welcome/use-welcome.js

@@ -9,11 +9,14 @@ import {
 import { useCachedFetch } from "../../hooks/use-cached-fetch.js";
 import { usePolling } from "../../hooks/usePolling.js";
 import {
-  getModelProvider,
   getAuthProviderFromModelProvider,
   getFeaturedModels,
+  getOnboardingModelProvider,
+  getOnboardingModels,
+  isDeprecatedOnboardingModelKey,
   getVisibleAiFieldKeys,
   kProviderAuthFields,
+  withAlwaysAvailableModels,
 } from "../../lib/model-config.js";
 import {
   getInitialOnboardingModelKey,
@@ -167,7 +170,9 @@ export const useWelcome = ({ onComplete }) => {
   };
 
   const applyModelCatalog = useCallback((payload) => {
-    const list = getModelCatalogModels(payload);
+    const list = getOnboardingModels(
+      withAlwaysAvailableModels(getModelCatalogModels(payload)),
+    );
     if (!payload) return;
     const isRefreshing = isModelCatalogRefreshing(payload);
     const isFallbackRefresh =
@@ -181,11 +186,14 @@ export const useWelcome = ({ onComplete }) => {
           : null
         : "No models found",
     );
+    const currentModelIsDeprecated = isDeprecatedOnboardingModelKey(
+      vals.MODEL_KEY,
+    );
     const defaultModelKey = getInitialOnboardingModelKey({
       catalog: list,
-      currentModelKey: vals.MODEL_KEY,
+      currentModelKey: currentModelIsDeprecated ? "" : vals.MODEL_KEY,
     });
-    if (!vals.MODEL_KEY && defaultModelKey) {
+    if ((!vals.MODEL_KEY || currentModelIsDeprecated) && defaultModelKey) {
       setVals((prev) => ({ ...prev, MODEL_KEY: defaultModelKey }));
     }
   }, [setVals, vals.MODEL_KEY]);
@@ -212,16 +220,18 @@ export const useWelcome = ({ onComplete }) => {
   }, [modelsFetchState.error]);
 
   const getValidationContext = (currentVals = {}) => {
-    const currentSelectedProvider = getModelProvider(
-      String(currentVals.MODEL_KEY || "").trim(),
-    );
+    const currentSelectedProvider = getOnboardingModelProvider({
+      modelKey: currentVals.MODEL_KEY,
+      models,
+    });
     const currentSelectedAuthProvider =
       getAuthProviderFromModelProvider(currentSelectedProvider);
     const currentProviderAuthFields =
       kProviderAuthFields[currentSelectedAuthProvider] || [];
     const currentHasAi =
       currentSelectedProvider === "openai-codex"
-        ? !!codexStatus.connected
+        ? !!codexStatus.connected ||
+          !!String(currentVals.OPENAI_API_KEY || "").trim()
         : currentProviderAuthFields.some((field) =>
             !!String(currentVals[field.key] || "").trim(),
           );

package/lib/public/js/lib/api.js

@@ -818,6 +818,11 @@ export async function fetchOnboardStatus() {
   return res.json();
 }
 
+export async function fetchOnboardProgress() {
+  const res = await authFetch("/api/onboard/progress");
+  return res.json();
+}
+
 export async function runOnboard(vars, modelKey, { importMode = false } = {}) {
   const res = await authFetch("/api/onboard", {
     method: "POST",

package/lib/public/js/lib/model-config.js

@@ -26,11 +26,8 @@ export const kFeaturedModelDefs = [
     preferredKeys: ["anthropic/claude-sonnet-4-6"],
   },
   {
-    label: "Codex 5.3",
-    preferredKeys: [
-      "openai/gpt-5.3-codex",
-      "openai-codex/gpt-5.3-codex",
-    ],
+    label: "GPT-5.6 Sol",
+    preferredKeys: ["openai/gpt-5.6-sol", "openai-codex/gpt-5.6-sol"],
   },
   {
     label: "GPT-5.5",
@@ -42,7 +39,70 @@ export const kFeaturedModelDefs = [
   },
 ];
 
+const kDeprecatedOnboardingModelKeys = new Set([
+  "openai/gpt-5.3-codex",
+  "openai-codex/gpt-5.3-codex",
+]);
+const kCanonicalCodexOauthModelKeys = new Set([
+  "openai/gpt-5.4-mini",
+  "openai/gpt-5.5",
+  "openai/gpt-5.6-sol",
+  "openai/gpt-5.6-terra",
+  "openai/gpt-5.6-luna",
+]);
+const kFriendlyModelLabels = {
+  "openai/gpt-5.4-mini": "GPT-5.4 Mini",
+  "openai/gpt-5.5": "GPT-5.5",
+  "openai/gpt-5.6-sol": "GPT-5.6 Sol",
+  "openai/gpt-5.6-terra": "GPT-5.6 Terra",
+  "openai/gpt-5.6-luna": "GPT-5.6 Luna",
+};
+
+export const getFriendlyModelLabel = (modelKey, fallback = "") => {
+  const normalizedKey = String(modelKey || "").trim();
+  return kFriendlyModelLabels[normalizedKey] || fallback || normalizedKey;
+};
+
+export const isDeprecatedOnboardingModelKey = (modelKey) =>
+  kDeprecatedOnboardingModelKeys.has(String(modelKey || "").trim());
+
+export const getOnboardingModels = (models = []) =>
+  models.filter(
+    (model) => !isDeprecatedOnboardingModelKey(model?.key),
+  );
+
+export const getOnboardingModelProvider = ({ modelKey, models = [] } = {}) => {
+  const normalizedKey = String(modelKey || "").trim();
+  const model = models.find((candidate) => candidate?.key === normalizedKey);
+  if (
+    getModelProvider(normalizedKey) === "openai-codex" ||
+    kCanonicalCodexOauthModelKeys.has(normalizedKey) ||
+    model?.agentRuntime?.id === "codex"
+  ) {
+    return "openai-codex";
+  }
+  return getModelProvider(normalizedKey);
+};
+
 export const kAlwaysAvailableModelDefs = [
+  {
+    key: "openai/gpt-5.6-sol",
+    provider: "openai",
+    label: "GPT-5.6 Sol",
+    agentRuntime: { id: "codex" },
+  },
+  {
+    key: "openai/gpt-5.6-terra",
+    provider: "openai",
+    label: "GPT-5.6 Terra",
+    agentRuntime: { id: "codex" },
+  },
+  {
+    key: "openai/gpt-5.6-luna",
+    provider: "openai",
+    label: "GPT-5.6 Luna",
+    agentRuntime: { id: "codex" },
+  },
   {
     key: "openai/gpt-5.4-mini",
     provider: "openai",
@@ -59,9 +119,19 @@ export const kAlwaysAvailableModelDefs = [
 
 export const withAlwaysAvailableModels = (models = []) => {
   const merged = [...models];
-  const keys = new Set(merged.map((model) => model?.key));
   for (const model of kAlwaysAvailableModelDefs) {
-    if (!keys.has(model.key)) merged.push(model);
+    const existingIndex = merged.findIndex((candidate) => candidate?.key === model.key);
+    if (existingIndex < 0) {
+      merged.push(model);
+      continue;
+    }
+    const existing = merged[existingIndex];
+    merged[existingIndex] = {
+      ...model,
+      ...existing,
+      label: getFriendlyModelLabel(model.key, existing?.label || model.label),
+      agentRuntime: existing?.agentRuntime || model.agentRuntime,
+    };
   }
   return merged;
 };
@@ -345,7 +415,6 @@ export const kFeatureDefs = [
 ];
 
 export const getVisibleAiFieldKeys = (provider) => {
-  if (provider === "openai-codex") return new Set();
   const authProvider = getAuthProviderFromModelProvider(provider);
   const fields = kProviderAuthFields[authProvider] || [];
   return new Set(fields.map((field) => field.key));

package/lib/public/js/lib/thinking-levels.js

@@ -8,6 +8,7 @@ const kThinkingLevelLabelOverrides = {
   adaptive: "Adaptive",
   xhigh: "Extra high",
   max: "Maximum",
+  ultra: "Ultra",
 };
 
 export const formatThinkingLevelLabel = (levelId = "") => {

package/lib/server/agents/shared.js

@@ -3,6 +3,7 @@ const {
   readOpenclawConfig,
   writeOpenclawConfig,
 } = require("../openclaw-config");
+const { ensureCodexRuntimePlugin } = require("../codex-runtime-config");
 
 const kDefaultAgentId = "main";
 const kAgentIdPattern = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
@@ -105,6 +106,7 @@ const loadConfig = ({ fsImpl, OPENCLAW_DIR }) =>
   });
 
 const saveConfig = ({ fsImpl, OPENCLAW_DIR, config }) => {
+  ensureCodexRuntimePlugin(config);
   writeOpenclawConfig({
     fsModule: fsImpl,
     openclawDir: OPENCLAW_DIR,

package/lib/server/auth-profiles.js

@@ -2,6 +2,7 @@ const fs = require("fs");
 const path = require("path");
 const { DatabaseSync } = require("node:sqlite");
 const { AUTH_PROFILES_PATH, CODEX_PROFILE_ID, OPENCLAW_DIR } = require("./constants");
+const { ensureCodexRuntimePlugin } = require("./codex-runtime-config");
 
 const kDefaultAgentId = "main";
 const kApiKeyEnvVarByProvider = {
@@ -368,8 +369,13 @@ const createAuthProfiles = () => {
     const cfg = loadOpenclawConfig();
     const defaults = cfg.agents?.defaults || {};
     const configuredModels = preserveCodexRuntimeModels(defaults.models || {});
-    if (JSON.stringify(configuredModels) !== JSON.stringify(defaults.models || {})) {
+    const modelsChanged =
+      JSON.stringify(configuredModels) !== JSON.stringify(defaults.models || {});
+    if (modelsChanged) {
       cfg.agents.defaults.models = configuredModels;
+    }
+    const pluginsChanged = ensureCodexRuntimePlugin(cfg);
+    if (modelsChanged || pluginsChanged) {
       saveOpenclawConfig(cfg);
     }
     return {
@@ -389,6 +395,7 @@ const createAuthProfiles = () => {
     if (configuredModels !== undefined) {
       cfg.agents.defaults.models = preserveCodexRuntimeModels(configuredModels);
     }
+    ensureCodexRuntimePlugin(cfg);
     saveOpenclawConfig(cfg);
   };
 

package/lib/server/codex-runtime-config.js

@@ -0,0 +1,51 @@
+const {
+  ensurePluginsShell,
+  ensurePluginAllowed,
+} = require("./plugin-config");
+
+const modelUsesCodexRuntime = (modelKey, modelConfig) => {
+  const runtimeId = String(modelConfig?.agentRuntime?.id || "").trim();
+  if (runtimeId === "codex") return true;
+  if (runtimeId === "openclaw") return false;
+  return String(modelKey || "").startsWith("openai/gpt-");
+};
+
+const configUsesCodexRuntime = (cfg = {}) => {
+  const scopes = [
+    cfg.agents?.defaults || {},
+    ...(Array.isArray(cfg.agents?.list) ? cfg.agents.list : []),
+  ];
+  return scopes.some((scope) => {
+    const configuredModels = scope.models || {};
+    if (
+      Object.entries(configuredModels).some(([modelKey, modelConfig]) =>
+        modelUsesCodexRuntime(modelKey, modelConfig),
+      )
+    ) {
+      return true;
+    }
+    const primary = String(scope.model?.primary || "").trim();
+    return (
+      !!primary && modelUsesCodexRuntime(primary, configuredModels[primary])
+    );
+  });
+};
+
+const ensureCodexRuntimePlugin = (cfg = {}) => {
+  if (!configUsesCodexRuntime(cfg)) return false;
+  const before = JSON.stringify(cfg.plugins || {});
+  ensurePluginsShell(cfg);
+  ensurePluginAllowed({ cfg, pluginKey: "codex" });
+  const existingEntry = cfg.plugins.entries.codex;
+  cfg.plugins.entries.codex = {
+    ...(existingEntry && typeof existingEntry === "object" ? existingEntry : {}),
+    enabled: true,
+  };
+  return JSON.stringify(cfg.plugins) !== before;
+};
+
+module.exports = {
+  configUsesCodexRuntime,
+  ensureCodexRuntimePlugin,
+  modelUsesCodexRuntime,
+};

package/lib/server/constants.js

@@ -172,6 +172,24 @@ const kMinimalFallbackOnboardingModels = [
     provider: "anthropic",
     label: "Claude Haiku 4.6",
   },
+  {
+    key: "openai/gpt-5.6-sol",
+    provider: "openai",
+    label: "GPT-5.6 Sol",
+    agentRuntime: { id: "codex" },
+  },
+  {
+    key: "openai/gpt-5.6-terra",
+    provider: "openai",
+    label: "GPT-5.6 Terra",
+    agentRuntime: { id: "codex" },
+  },
+  {
+    key: "openai/gpt-5.6-luna",
+    provider: "openai",
+    label: "GPT-5.6 Luna",
+    agentRuntime: { id: "codex" },
+  },
   {
     key: "openai/gpt-5.5",
     provider: "openai",

package/lib/server/cost-utils.js

@@ -48,6 +48,24 @@ const kGlobalModelPricing = {
   "claude-haiku-4-6": { input: 0.8, output: 4.0 },
   "gpt-5": { input: 1.25, output: 10.0 },
   "gpt-5.4": { input: 2.5, output: 10.0 },
+  "gpt-5.6-sol": {
+    input: 5.0,
+    output: 30.0,
+    cacheRead: 0.5,
+    cacheWrite: 6.25,
+  },
+  "gpt-5.6-terra": {
+    input: 2.5,
+    output: 15.0,
+    cacheRead: 0.25,
+    cacheWrite: 3.125,
+  },
+  "gpt-5.6-luna": {
+    input: 1.0,
+    output: 6.0,
+    cacheRead: 0.1,
+    cacheWrite: 1.25,
+  },
   "gpt-5.1-codex": { input: 2.5, output: 10.0 },
   "gpt-5.3-codex": { input: 2.5, output: 10.0 },
   "gpt-4.1": { input: 2.0, output: 8.0 },

package/lib/server/helpers.js

@@ -123,13 +123,29 @@ const normalizeOnboardingModels = (models) => {
     const provider = resolveModelProvider(key);
     if (!kOnboardingModelProviders.has(provider)) continue;
     if (!deduped.has(key)) {
+      const agentRuntime = isCodexRuntimeModel
+        ? { id: "codex" }
+        : model.agentRuntime;
       deduped.set(key, {
         key,
         provider,
         label: model.name || model.key,
-        ...(isCodexRuntimeModel
-          ? { agentRuntime: { id: "codex" } }
+        ...(typeof model.available === "boolean"
+          ? { available: model.available }
           : {}),
+        ...(typeof model.reasoning === "boolean"
+          ? { reasoning: model.reasoning }
+          : {}),
+        ...(Number.isFinite(model.contextWindow)
+          ? { contextWindow: model.contextWindow }
+          : {}),
+        ...(Number.isFinite(model.maxTokens)
+          ? { maxTokens: model.maxTokens }
+          : {}),
+        ...(model.compat && typeof model.compat === "object"
+          ? { compat: model.compat }
+          : {}),
+        ...(agentRuntime ? { agentRuntime } : {}),
       });
     }
   }

package/lib/server/model-catalog-cache.js

@@ -3,7 +3,7 @@ const path = require("path");
 const { ALPHACLAW_DIR, kFallbackOnboardingModels } = require("./constants");
 const { getCommandOutputCandidates } = require("./utils/command-output");
 
-const kModelCatalogCacheVersion = 1;
+const kModelCatalogCacheVersion = 2;
 const kModelCatalogRefreshBackoffMs = 30 * 1000;
 const kModelCatalogLoadTimeoutMs = 120 * 1000;
 const kModelCatalogBootstrapSource = "bootstrap";
@@ -36,9 +36,9 @@ const normalizeCachedModels = ({
 } = {}) =>
   normalizeOnboardingModels(
     (Array.isArray(models) ? models : []).map((model) => ({
+      ...model,
       key: model?.key,
       name: model?.label || model?.name || model?.key,
-      ...(model?.agentRuntime ? { agentRuntime: model.agentRuntime } : {}),
     })),
   );
 

package/lib/server/onboarding/index.js

@@ -369,7 +369,14 @@ const createOnboardingService = ({
     vars,
     modelKey,
     importMode = false,
+    onProgress,
   }) => {
+    const reportProgress = (stage) => {
+      if (typeof onProgress !== "function") return;
+      try {
+        onProgress(stage);
+      } catch {}
+    };
     const validation = validateOnboardingInput({
       vars,
       modelKey,
@@ -425,6 +432,7 @@ const createOnboardingService = ({
     syncApiKeyAuthProfilesFromEnvVars(authProfiles, varsToSave);
 
     const [, repoName] = repoUrl.split("/");
+    reportProgress("creating_repo");
     const repoCheck = await ensureGithubRepoAccessible({
       repoUrl,
       repoName,
@@ -481,6 +489,7 @@ const createOnboardingService = ({
       );
     }
 
+    reportProgress("running_openclaw_onboard");
     if (!existingConfigPresent) {
       const onboardArgs = buildOnboardArgs({
         varMap,
@@ -551,6 +560,7 @@ const createOnboardingService = ({
 
     ensureGatewayProxyConfig(getBaseUrl(req));
 
+    reportProgress("initial_git_push");
     try {
       const commitMsg = importMode
         ? "imported existing setup via AlphaClaw"
@@ -567,6 +577,7 @@ const createOnboardingService = ({
       console.error("[onboard] Git push error:", e.message);
     }
 
+    reportProgress("starting_gateway");
     runOnboardedBootSequence();
     return { status: 200, body: { ok: true } };
   };

package/lib/server/onboarding/openclaw.js

@@ -5,6 +5,7 @@ const {
   ensureUsageTrackerPluginEntry,
 } = require("../usage-tracker-config");
 const { isOpenAiCompatApiEnabled } = require("../alphaclaw-config");
+const { ensureCodexRuntimePlugin } = require("../codex-runtime-config");
 
 const kDefaultToolsProfile = "full";
 const kBootstrapExtraFiles = [
@@ -248,6 +249,7 @@ const writeSanitizedOpenclawConfig = ({
     cfg,
     varMap,
   });
+  ensureCodexRuntimePlugin(cfg);
 
   let content = JSON.stringify(cfg, null, 2);
   const replacements = buildSecretReplacements(varMap, process.env);
@@ -357,6 +359,8 @@ const writeManagedImportOpenclawConfig = ({
     ensurePluginAllowed({ cfg, pluginKey: "whatsapp" });
   }
 
+  ensureCodexRuntimePlugin(cfg);
+
   fs.writeFileSync(configPath, JSON.stringify(cfg, null, 2));
 };