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

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

Made-with: Cursor

openclaw/extensions/together/video-generation-provider.ts

@@ -0,0 +1,274 @@
+import { isProviderApiKeyConfigured } from "openclaw/plugin-sdk/provider-auth";
+import { resolveApiKeyForProvider } from "openclaw/plugin-sdk/provider-auth-runtime";
+import {
+  assertOkOrThrowHttpError,
+  createProviderOperationDeadline,
+  fetchWithTimeout,
+  postJsonRequest,
+  resolveProviderOperationTimeoutMs,
+  resolveProviderHttpRequestConfig,
+  waitProviderOperationPollInterval,
+} from "openclaw/plugin-sdk/provider-http";
+import { normalizeOptionalString } from "openclaw/plugin-sdk/text-runtime";
+import type {
+  GeneratedVideoAsset,
+  VideoGenerationProvider,
+  VideoGenerationRequest,
+} from "openclaw/plugin-sdk/video-generation";
+import { TOGETHER_BASE_URL } from "./models.js";
+
+const DEFAULT_TOGETHER_VIDEO_MODEL = "Wan-AI/Wan2.2-T2V-A14B";
+const DEFAULT_TIMEOUT_MS = 120_000;
+const POLL_INTERVAL_MS = 5_000;
+const MAX_POLL_ATTEMPTS = 120;
+
+type TogetherVideoResponse = {
+  id?: string;
+  model?: string;
+  status?: "in_progress" | "completed" | "failed";
+  error?: {
+    code?: string;
+    message?: string;
+  } | null;
+  outputs?:
+    | {
+        video_url?: string;
+        url?: string;
+      }
+    | Array<{
+        video_url?: string;
+        url?: string;
+      }>;
+};
+
+function resolveTogetherVideoBaseUrl(req: VideoGenerationRequest): string {
+  return (
+    normalizeOptionalString(req.cfg?.models?.providers?.together?.baseUrl) ?? TOGETHER_BASE_URL
+  );
+}
+
+function toDataUrl(buffer: Buffer, mimeType: string): string {
+  return `data:${mimeType};base64,${buffer.toString("base64")}`;
+}
+
+function extractTogetherVideoUrl(payload: TogetherVideoResponse): string | undefined {
+  if (Array.isArray(payload.outputs)) {
+    for (const entry of payload.outputs) {
+      const url = normalizeOptionalString(entry.video_url) ?? normalizeOptionalString(entry.url);
+      if (url) {
+        return url;
+      }
+    }
+    return undefined;
+  }
+  return (
+    normalizeOptionalString(payload.outputs?.video_url) ??
+    normalizeOptionalString(payload.outputs?.url)
+  );
+}
+
+async function pollTogetherVideo(params: {
+  videoId: string;
+  headers: Headers;
+  timeoutMs?: number;
+  baseUrl: string;
+  fetchFn: typeof fetch;
+}): Promise<TogetherVideoResponse> {
+  const deadline = createProviderOperationDeadline({
+    timeoutMs: params.timeoutMs,
+    label: `Together video generation task ${params.videoId}`,
+  });
+  for (let attempt = 0; attempt < MAX_POLL_ATTEMPTS; attempt += 1) {
+    const response = await fetchWithTimeout(
+      `${params.baseUrl}/videos/${params.videoId}`,
+      {
+        method: "GET",
+        headers: params.headers,
+      },
+      resolveProviderOperationTimeoutMs({ deadline, defaultTimeoutMs: DEFAULT_TIMEOUT_MS }),
+      params.fetchFn,
+    );
+    await assertOkOrThrowHttpError(response, "Together video status request failed");
+    const payload = (await response.json()) as TogetherVideoResponse;
+    if (payload.status === "completed") {
+      return payload;
+    }
+    if (payload.status === "failed") {
+      throw new Error(
+        normalizeOptionalString(payload.error?.message) ?? "Together video generation failed",
+      );
+    }
+    await waitProviderOperationPollInterval({ deadline, pollIntervalMs: POLL_INTERVAL_MS });
+  }
+  throw new Error(`Together video generation task ${params.videoId} did not finish in time`);
+}
+
+async function downloadTogetherVideo(params: {
+  url: string;
+  timeoutMs?: number;
+  fetchFn: typeof fetch;
+}): Promise<GeneratedVideoAsset> {
+  const response = await fetchWithTimeout(
+    params.url,
+    { method: "GET" },
+    params.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+    params.fetchFn,
+  );
+  await assertOkOrThrowHttpError(response, "Together generated video download failed");
+  const mimeType = normalizeOptionalString(response.headers.get("content-type")) ?? "video/mp4";
+  const arrayBuffer = await response.arrayBuffer();
+  return {
+    buffer: Buffer.from(arrayBuffer),
+    mimeType,
+    fileName: `video-1.${mimeType.includes("webm") ? "webm" : "mp4"}`,
+  };
+}
+
+export function buildTogetherVideoGenerationProvider(): VideoGenerationProvider {
+  return {
+    id: "together",
+    label: "Together",
+    defaultModel: DEFAULT_TOGETHER_VIDEO_MODEL,
+    models: [
+      DEFAULT_TOGETHER_VIDEO_MODEL,
+      "Wan-AI/Wan2.2-I2V-A14B",
+      "minimax/Hailuo-02",
+      "Kwai/Kling-2.1-Master",
+    ],
+    isConfigured: ({ agentDir }) =>
+      isProviderApiKeyConfigured({
+        provider: "together",
+        agentDir,
+      }),
+    capabilities: {
+      generate: {
+        maxVideos: 1,
+        maxDurationSeconds: 12,
+        supportsSize: true,
+      },
+      imageToVideo: {
+        enabled: true,
+        maxVideos: 1,
+        maxInputImages: 1,
+        maxDurationSeconds: 12,
+        supportsSize: true,
+      },
+      videoToVideo: {
+        enabled: false,
+      },
+    },
+    async generateVideo(req) {
+      if ((req.inputVideos?.length ?? 0) > 0) {
+        throw new Error("Together video generation does not support video reference inputs.");
+      }
+      const auth = await resolveApiKeyForProvider({
+        provider: "together",
+        cfg: req.cfg,
+        agentDir: req.agentDir,
+        store: req.authStore,
+      });
+      if (!auth.apiKey) {
+        throw new Error("Together API key missing");
+      }
+
+      const fetchFn = fetch;
+      const deadline = createProviderOperationDeadline({
+        timeoutMs: req.timeoutMs,
+        label: "Together video generation",
+      });
+      const { baseUrl, allowPrivateNetwork, headers, dispatcherPolicy } =
+        resolveProviderHttpRequestConfig({
+          baseUrl: resolveTogetherVideoBaseUrl(req),
+          defaultBaseUrl: TOGETHER_BASE_URL,
+          allowPrivateNetwork: false,
+          defaultHeaders: {
+            Authorization: `Bearer ${auth.apiKey}`,
+            "Content-Type": "application/json",
+          },
+          provider: "together",
+          capability: "video",
+          transport: "http",
+        });
+      const body: Record<string, unknown> = {
+        model: normalizeOptionalString(req.model) ?? DEFAULT_TOGETHER_VIDEO_MODEL,
+        prompt: req.prompt,
+      };
+      if (typeof req.durationSeconds === "number" && Number.isFinite(req.durationSeconds)) {
+        body.seconds = String(Math.max(1, Math.round(req.durationSeconds)));
+      }
+      const size = normalizeOptionalString(req.size);
+      if (size) {
+        const match = /^(\d+)x(\d+)$/u.exec(size);
+        if (match) {
+          body.width = Number.parseInt(match[1] ?? "", 10);
+          body.height = Number.parseInt(match[2] ?? "", 10);
+        }
+      }
+      if (req.inputImages?.[0]) {
+        const input = req.inputImages[0];
+        const value = normalizeOptionalString(input.url)
+          ? normalizeOptionalString(input.url)
+          : input.buffer
+            ? toDataUrl(input.buffer, normalizeOptionalString(input.mimeType) ?? "image/png")
+            : undefined;
+        if (!value) {
+          throw new Error("Together reference image is missing image data.");
+        }
+        body.reference_images = [value];
+      }
+      const { response, release } = await postJsonRequest({
+        url: `${baseUrl}/videos`,
+        headers,
+        body,
+        timeoutMs: resolveProviderOperationTimeoutMs({
+          deadline,
+          defaultTimeoutMs: DEFAULT_TIMEOUT_MS,
+        }),
+        fetchFn,
+        allowPrivateNetwork,
+        dispatcherPolicy,
+      });
+      try {
+        await assertOkOrThrowHttpError(response, "Together video generation failed");
+        const submitted = (await response.json()) as TogetherVideoResponse;
+        const videoId = normalizeOptionalString(submitted.id);
+        if (!videoId) {
+          throw new Error("Together video generation response missing id");
+        }
+        const completed = await pollTogetherVideo({
+          videoId,
+          headers,
+          timeoutMs: resolveProviderOperationTimeoutMs({
+            deadline,
+            defaultTimeoutMs: DEFAULT_TIMEOUT_MS,
+          }),
+          baseUrl,
+          fetchFn,
+        });
+        const videoUrl = extractTogetherVideoUrl(completed);
+        if (!videoUrl) {
+          throw new Error("Together video generation completed without an output URL");
+        }
+        const video = await downloadTogetherVideo({
+          url: videoUrl,
+          timeoutMs: resolveProviderOperationTimeoutMs({
+            deadline,
+            defaultTimeoutMs: DEFAULT_TIMEOUT_MS,
+          }),
+          fetchFn,
+        });
+        return {
+          videos: [video],
+          model: completed.model ?? req.model ?? DEFAULT_TOGETHER_VIDEO_MODEL,
+          metadata: {
+            videoId,
+            status: completed.status,
+            videoUrl,
+          },
+        };
+      } finally {
+        await release();
+      }
+    },
+  };
+}