重构主控编排与运行时预热链路，统一工作区提示词/专家调度协议并补齐 wiki 记忆注入与写回闭环。

同时收敛启动与运维脚本默认行为（含 wiki worker）、更新 Admin 可观测性与相关测试，降低首轮时延并提高运行稳定性。

Made-with: Cursor

openclaw/extensions/opencode/api.ts

@@ -0,0 +1,9 @@
+export {
+  applyOpencodeZenModelDefault,
+  OPENCODE_ZEN_DEFAULT_MODEL,
+} from "openclaw/plugin-sdk/provider-onboard";
+export {
+  applyOpencodeZenConfig,
+  applyOpencodeZenProviderConfig,
+  OPENCODE_ZEN_DEFAULT_MODEL_REF,
+} from "./onboard.js";

openclaw/extensions/opencode/index.test.ts

@@ -0,0 +1,22 @@
+import { describe, it } from "vitest";
+import { expectPassthroughReplayPolicy } from "../../test/helpers/provider-replay-policy.ts";
+import plugin from "./index.js";
+
+describe("opencode provider plugin", () => {
+  it("owns passthrough-gemini replay policy for Gemini-backed models", async () => {
+    await expectPassthroughReplayPolicy({
+      plugin,
+      providerId: "opencode",
+      modelId: "gemini-2.5-pro",
+      sanitizeThoughtSignatures: true,
+    });
+  });
+
+  it("keeps non-Gemini replay policy minimal on passthrough routes", async () => {
+    await expectPassthroughReplayPolicy({
+      plugin,
+      providerId: "opencode",
+      modelId: "claude-opus-4.6",
+    });
+  });
+});

openclaw/extensions/opencode/index.ts

@@ -0,0 +1,53 @@
+import { createOpencodeCatalogApiKeyAuthMethod } from "openclaw/plugin-sdk/opencode";
+import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
+import {
+  matchesExactOrPrefix,
+  PASSTHROUGH_GEMINI_REPLAY_HOOKS,
+} from "openclaw/plugin-sdk/provider-model-shared";
+import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/text-runtime";
+import { applyOpencodeZenConfig, OPENCODE_ZEN_DEFAULT_MODEL } from "./api.js";
+
+const PROVIDER_ID = "opencode";
+const MINIMAX_MODERN_MODEL_MATCHERS = ["minimax-m2.7"] as const;
+
+function isModernOpencodeModel(modelId: string): boolean {
+  const lower = normalizeLowercaseStringOrEmpty(modelId);
+  if (lower.endsWith("-free") || lower === "alpha-glm-4.7") {
+    return false;
+  }
+  return !matchesExactOrPrefix(lower, MINIMAX_MODERN_MODEL_MATCHERS);
+}
+
+export default definePluginEntry({
+  id: PROVIDER_ID,
+  name: "OpenCode Zen Provider",
+  description: "Bundled OpenCode Zen provider plugin",
+  register(api) {
+    api.registerProvider({
+      id: PROVIDER_ID,
+      label: "OpenCode Zen",
+      docsPath: "/providers/models",
+      envVars: ["OPENCODE_API_KEY", "OPENCODE_ZEN_API_KEY"],
+      auth: [
+        createOpencodeCatalogApiKeyAuthMethod({
+          providerId: PROVIDER_ID,
+          label: "OpenCode Zen catalog",
+          optionKey: "opencodeZenApiKey",
+          flagName: "--opencode-zen-api-key",
+          defaultModel: OPENCODE_ZEN_DEFAULT_MODEL,
+          applyConfig: (cfg) => applyOpencodeZenConfig(cfg),
+          noteMessage: [
+            "OpenCode uses one API key across the Zen and Go catalogs.",
+            "Zen provides access to Claude, GPT, Gemini, and more models.",
+            "Get your API key at: https://opencode.ai/auth",
+            "Choose the Zen catalog when you want the curated multi-model proxy.",
+          ].join("\n"),
+          choiceId: "opencode-zen",
+          choiceLabel: "OpenCode Zen catalog",
+        }),
+      ],
+      ...PASSTHROUGH_GEMINI_REPLAY_HOOKS,
+      isModernModelRef: ({ modelId }) => isModernOpencodeModel(modelId),
+    });
+  },
+});

openclaw/extensions/opencode/onboard.test.ts

@@ -0,0 +1,25 @@
+import { describe, it } from "vitest";
+import {
+  expectProviderOnboardAllowlistAlias,
+  expectProviderOnboardPrimaryAndFallbacks,
+} from "../../test/helpers/plugins/provider-onboard.js";
+import { applyOpencodeZenConfig, applyOpencodeZenProviderConfig } from "./onboard.js";
+
+const MODEL_REF = "opencode/claude-opus-4-6";
+
+describe("opencode onboard", () => {
+  it("adds allowlist entry and preserves alias", () => {
+    expectProviderOnboardAllowlistAlias({
+      applyProviderConfig: applyOpencodeZenProviderConfig,
+      modelRef: MODEL_REF,
+      alias: "My Opus",
+    });
+  });
+
+  it("sets primary model and preserves existing model fallbacks", () => {
+    expectProviderOnboardPrimaryAndFallbacks({
+      applyConfig: applyOpencodeZenConfig,
+      modelRef: MODEL_REF,
+    });
+  });
+});

openclaw/extensions/opencode/onboard.ts

@@ -0,0 +1,29 @@
+import {
+  applyAgentDefaultModelPrimary,
+  withAgentModelAliases,
+  type OpenClawConfig,
+} from "openclaw/plugin-sdk/provider-onboard";
+
+export const OPENCODE_ZEN_DEFAULT_MODEL_REF = "opencode/claude-opus-4-6";
+
+export function applyOpencodeZenProviderConfig(cfg: OpenClawConfig): OpenClawConfig {
+  return {
+    ...cfg,
+    agents: {
+      ...cfg.agents,
+      defaults: {
+        ...cfg.agents?.defaults,
+        models: withAgentModelAliases(cfg.agents?.defaults?.models, [
+          { modelRef: OPENCODE_ZEN_DEFAULT_MODEL_REF, alias: "Opus" },
+        ]),
+      },
+    },
+  };
+}
+
+export function applyOpencodeZenConfig(cfg: OpenClawConfig): OpenClawConfig {
+  return applyAgentDefaultModelPrimary(
+    applyOpencodeZenProviderConfig(cfg),
+    OPENCODE_ZEN_DEFAULT_MODEL_REF,
+  );
+}

openclaw/extensions/opencode/openclaw.plugin.json

@@ -0,0 +1,28 @@
+{
+  "id": "opencode",
+  "enabledByDefault": true,
+  "providers": ["opencode"],
+  "providerAuthEnvVars": {
+    "opencode": ["OPENCODE_API_KEY", "OPENCODE_ZEN_API_KEY"]
+  },
+  "providerAuthChoices": [
+    {
+      "provider": "opencode",
+      "method": "api-key",
+      "choiceId": "opencode-zen",
+      "choiceLabel": "OpenCode Zen catalog",
+      "groupId": "opencode",
+      "groupLabel": "OpenCode",
+      "groupHint": "Shared API key for Zen + Go catalogs",
+      "optionKey": "opencodeZenApiKey",
+      "cliFlag": "--opencode-zen-api-key",
+      "cliOption": "--opencode-zen-api-key <key>",
+      "cliDescription": "OpenCode API key (Zen catalog)"
+    }
+  ],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

openclaw/extensions/opencode/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@openclaw/opencode-provider",
+  "version": "2026.4.20",
+  "private": true,
+  "description": "OpenClaw OpenCode Zen provider plugin",
+  "type": "module",
+  "devDependencies": {
+    "@openclaw/plugin-sdk": "workspace:*"
+  },
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ]
+  }
+}

openclaw/extensions/opencode/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "extends": "../tsconfig.package-boundary.base.json",
+  "compilerOptions": {
+    "rootDir": "."
+  },
+  "include": ["./*.ts", "./src/**/*.ts"],
+  "exclude": [
+    "./**/*.test.ts",
+    "./dist/**",
+    "./node_modules/**",
+    "./src/test-support/**",
+    "./src/**/*test-helpers.ts",
+    "./src/**/*test-harness.ts",
+    "./src/**/*test-support.ts"
+  ]
+}