### Changes

- Models/OpenAI CLI auth: make `openclaw models auth login --provider openai` start the ChatGPT/Codex account login by default, while `--method api-key` remains the explicit OpenAI API-key setup path.

- Google/Gemini: normalize retired Gemini 3 Pro Preview ids in provider catalog rows when API-key onboarding only reapplies the agent default, so emitted config keeps testing `google/gemini-3.1-pro-preview`.

- Docs/subagents: document `agents.defaults.subagents.announceTimeoutMs` in the sub-agent and configuration references. (#75509) Thanks @akrimm702.

- Cron: add direct `cron.get`, `openclaw cron get <id>`, and agent-tool `get` support for inspecting one stored cron job by id. (#75117) Thanks @samzong.

- Agents/tools: add per-sender tool policies with canonical channel-scoped sender keys, so operators can restrict dangerous tools by requester identity across global, agent, group, core, bundled, and plugin tool surfaces. (#66933) Thanks @JerranC.

});

});

it("normalizes retired Gemini provider catalog rows when the primary is already current", () => {

const applied = applyGoogleGeminiModelDefault({

agents: {

defaults: {

model: {

primary: GOOGLE_GEMINI_DEFAULT_MODEL,

},

},

},

models: {

providers: {

google: {

api: "google-generative-ai",

baseUrl: "https://generativelanguage.googleapis.com/v1beta",

models: [

{

id: "google/gemini-3-pro-preview",

name: "Gemini 3 Pro",

contextWindow: 1_000_000,

maxTokens: 8192,

input: ["text"],

cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },

reasoning: true,

},

],

},

},

},

} as OpenClawConfig);

expect(applied.changed).toBe(true);

expect(applied.next.models?.providers?.google?.models?.map((model) => model.id)).toEqual([

GOOGLE_GEMINI_DEFAULT_MODEL,

]);

});

it("no-ops when already on the target default", () => {

const cfg = {

agents: { defaults: { model: { primary: GOOGLE_GEMINI_DEFAULT_MODEL } } },

export const GOOGLE_GEMINI_DEFAULT_MODEL = "google/gemini-3.1-pro-preview";

const RETIRED_GOOGLE_GEMINI_MODEL_REFS = new Set([

"gemini-3-pro",

"gemini-3-pro-preview",

"google/gemini-3-pro",

"google/gemini-3-pro-preview",

]);

function isRetiredGeminiModelRef(value: unknown): boolean {

if (typeof value !== "string") {

return false;

}

const modelRef = value.trim();

if (RETIRED_GOOGLE_GEMINI_MODEL_REFS.has(modelRef)) {

return true;

}

return modelRef.endsWith("/gemini-3-pro") || modelRef.endsWith("/gemini-3-pro-preview");

}

function hasRetiredGeminiDefaultModelRefs(cfg: OpenClawConfig): boolean {

const defaults = cfg.agents?.defaults;

const model = defaults?.model as unknown;

if (model && typeof model === "object") {

const fallbacks = (model as { fallbacks?: unknown }).fallbacks;

if (

Array.isArray(fallbacks) &&

fallbacks.some(

(fallback) =>

typeof fallback === "string" && RETIRED_GOOGLE_GEMINI_MODEL_REFS.has(fallback),

)

fallbacks.some((fallback) => isRetiredGeminiModelRef(fallback))

) {

return true;

}

}

const models = defaults?.models;

return Boolean(

if (

models &&

typeof models === "object" &&

Object.keys(models).some((modelRef) => RETIRED_GOOGLE_GEMINI_MODEL_REFS.has(modelRef)),

Object.keys(models).some((modelRef) => isRetiredGeminiModelRef(modelRef))

) {

return true;

}

const providerConfigs = cfg.models?.providers;

if (!providerConfigs) {

return false;

}

return Object.values(providerConfigs).some((providerConfig) =>

Array.isArray(providerConfig.models)

? providerConfig.models.some((providerModel) => isRetiredGeminiModelRef(providerModel.id))

: false,

);

}

import type { AgentModelEntryConfig } from "../config/types.agent-defaults.js";

import type { ModelDefinitionConfig } from "../config/types.models.js";

import {

applyAgentDefaultModelPrimary,

applyProviderConfigWithDefaultModelPreset,

applyProviderConfigWithModelCatalogPreset,

applyProviderConfigWithDefaultModel,

]);

});

it("normalizes retired Google provider catalog ids when applying only an agent default", () => {

const next = applyAgentDefaultModelPrimary(

{

models: {

providers: {

google: {

api: "google-generative-ai",

baseUrl: "https://generativelanguage.googleapis.com/v1beta",

models: [makeModel("google/gemini-3-pro-preview")],

},

kilocode: {

api: "openai-completions",

baseUrl: "https://kilocode.example.com/v1",

models: [makeModel("google/gemini-3-pro-preview")],

},

},

},

},

"google/gemini-3.1-pro-preview",

);

expect(next.models?.providers?.google?.models?.map((m) => m.id)).toEqual([

"google/gemini-3.1-pro-preview",

]);

expect(next.models?.providers?.kilocode?.models?.map((m) => m.id)).toEqual([

"google/gemini-3.1-pro-preview",

]);

expect(next.agents?.defaults?.model).toEqual({ primary: "google/gemini-3.1-pro-preview" });

});

it("supports single default model convenience wrapper", () => {

const next = applyProviderConfigWithDefaultModel(

{},

return mutated ? next : models;

}

function normalizeModelProvidersForConfig(

providers: Record<string, ModelProviderConfig> | undefined,

): Record<string, ModelProviderConfig> | undefined {

if (!providers) {

return providers;

}

let mutated = false;

const nextProviders: Record<string, ModelProviderConfig> = {};

for (const [providerId, providerConfig] of Object.entries(providers)) {

const models = Array.isArray(providerConfig.models)

? normalizeProviderModelsForConfig(providerId, providerConfig.models)

: providerConfig.models;

if (models !== providerConfig.models) {

mutated = true;

nextProviders[providerId] = { ...providerConfig, models };

continue;

}

nextProviders[providerId] = providerConfig;

}

return mutated ? nextProviders : providers;

}

function resolveProviderModelMergeState(

cfg: OpenClawConfig,

providerId: string,

);

const normalizedModels =

defaults?.models === undefined ? undefined : normalizeAgentModelMapForConfig(defaults.models);

const normalizedProviders = normalizeModelProvidersForConfig(cfg.models?.providers);

return {

...cfg,

agents: {

...(normalizedModels !== undefined ? { models: normalizedModels } : undefined),

},

},

...(normalizedProviders !== undefined

? {

models: {

...cfg.models,

providers: normalizedProviders,

},

}

: undefined),

};

}