@gguf/claw 2026.2.1 → 2026.2.3

package/dist/web/auth-store.js

@@ -1,12 +1,12 @@
 import fsSync from "node:fs";
 import fs from "node:fs/promises";
 import path from "node:path";
+import { formatCliCommand } from "../cli/command-format.js";
 import { resolveOAuthDir } from "../config/paths.js";
 import { info, success } from "../globals.js";
 import { getChildLogger } from "../logging.js";
 import { DEFAULT_ACCOUNT_ID } from "../routing/session-key.js";
 import { defaultRuntime } from "../runtime.js";
-import { formatCliCommand } from "../cli/command-format.js";
 import { jidToE164, resolveUserPath } from "../utils.js";
 export function resolveDefaultWebAuthDir() {
     return path.join(resolveOAuthDir(), "whatsapp", DEFAULT_ACCOUNT_ID);

package/dist/web/auto-reply/deliver-reply.d.ts

@@ -1,7 +1,7 @@
-import { type ChunkMode } from "../../auto-reply/chunk.js";
-import type { MarkdownTableMode } from "../../config/types.base.js";
 import type { ReplyPayload } from "../../auto-reply/types.js";
+import type { MarkdownTableMode } from "../../config/types.base.js";
 import type { WebInboundMsg } from "./types.js";
+import { type ChunkMode } from "../../auto-reply/chunk.js";
 export declare function deliverWebReply(params: {
     replyResult: ReplyPayload;
     msg: WebInboundMsg;

package/dist/web/auto-reply/deliver-reply.js

@@ -1,6 +1,7 @@
 import { chunkMarkdownTextWithMode } from "../../auto-reply/chunk.js";
-import { convertMarkdownTables } from "../../markdown/tables.js";
 import { logVerbose, shouldLogVerbose } from "../../globals.js";
+import { convertMarkdownTables } from "../../markdown/tables.js";
+import { sleep } from "../../utils.js";
 import { loadWebMedia } from "../media.js";
 import { newConnectionId } from "../reconnect.js";
 import { formatError } from "../session.js";
@@ -18,7 +19,6 @@ export async function deliverWebReply(params) {
         : replyResult.mediaUrl
             ? [replyResult.mediaUrl]
             : [];
-    const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
     const sendWithRetry = async (fn, label, maxAttempts = 3) => {
         let lastErr;
         for (let attempt = 1; attempt <= maxAttempts; attempt++) {

package/dist/web/auto-reply/heartbeat-runner.js

@@ -1,6 +1,6 @@
 import { DEFAULT_HEARTBEAT_ACK_MAX_CHARS, resolveHeartbeatPrompt, stripHeartbeatToken, } from "../../auto-reply/heartbeat.js";
-import { HEARTBEAT_TOKEN } from "../../auto-reply/tokens.js";
 import { getReplyFromConfig } from "../../auto-reply/reply.js";
+import { HEARTBEAT_TOKEN } from "../../auto-reply/tokens.js";
 import { resolveWhatsAppHeartbeatRecipients } from "../../channels/plugins/whatsapp-heartbeat.js";
 import { loadConfig } from "../../config/config.js";
 import { loadSessionStore, resolveSessionKey, resolveStorePath, updateSessionStore, } from "../../config/sessions.js";

package/dist/web/auto-reply/monitor/ack-reaction.js

@@ -1,5 +1,5 @@
-import { logVerbose } from "../../../globals.js";
 import { shouldAckReactionForWhatsApp } from "../../../channels/ack-reactions.js";
+import { logVerbose } from "../../../globals.js";
 import { sendReactionWhatsApp } from "../../outbound.js";
 import { formatError } from "../../session.js";
 import { resolveGroupActivationFor } from "./group-activation.js";

package/dist/web/auto-reply/monitor/group-gating.js

@@ -1,9 +1,9 @@
 import { hasControlCommand } from "../../../auto-reply/command-detection.js";
 import { parseActivationCommand } from "../../../auto-reply/group-activation.js";
-import { normalizeE164 } from "../../../utils.js";
+import { recordPendingHistoryEntryIfEnabled } from "../../../auto-reply/reply/history.js";
 import { resolveMentionGating } from "../../../channels/mention-gating.js";
+import { normalizeE164 } from "../../../utils.js";
 import { buildMentionConfig, debugMention, resolveOwnerList } from "../mentions.js";
-import { recordPendingHistoryEntryIfEnabled } from "../../../auto-reply/reply/history.js";
 import { stripMentionsForCommand } from "./commands.js";
 import { resolveGroupActivationFor, resolveGroupPolicyFor } from "./group-activation.js";
 import { noteGroupMember } from "./group-members.js";

package/dist/web/auto-reply/monitor/message-line.d.ts

@@ -1,6 +1,6 @@
-import { type EnvelopeFormatOptions } from "../../../auto-reply/envelope.js";
 import type { loadConfig } from "../../../config/config.js";
 import type { WebInboundMsg } from "../types.js";
+import { type EnvelopeFormatOptions } from "../../../auto-reply/envelope.js";
 export declare function formatReplyContext(msg: WebInboundMsg): string | null;
 export declare function buildInboundLine(params: {
     cfg: ReturnType<typeof loadConfig>;

package/dist/web/auto-reply/monitor/process-message.js

@@ -1,14 +1,14 @@
 import { resolveIdentityNamePrefix } from "../../../agents/identity.js";
 import { resolveChunkMode, resolveTextChunkLimit } from "../../../auto-reply/chunk.js";
+import { shouldComputeCommandAuthorized } from "../../../auto-reply/command-detection.js";
 import { formatInboundEnvelope, resolveEnvelopeFormatOptions, } from "../../../auto-reply/envelope.js";
 import { buildHistoryContextFromEntries, } from "../../../auto-reply/reply/history.js";
-import { dispatchReplyWithBufferedBlockDispatcher } from "../../../auto-reply/reply/provider-dispatcher.js";
-import { shouldComputeCommandAuthorized } from "../../../auto-reply/command-detection.js";
 import { finalizeInboundContext } from "../../../auto-reply/reply/inbound-context.js";
+import { dispatchReplyWithBufferedBlockDispatcher } from "../../../auto-reply/reply/provider-dispatcher.js";
 import { toLocationContext } from "../../../channels/location.js";
 import { createReplyPrefixContext } from "../../../channels/reply-prefix.js";
-import { readSessionUpdatedAt, recordSessionMetaFromInbound, resolveStorePath, } from "../../../config/sessions.js";
 import { resolveMarkdownTableMode } from "../../../config/markdown-tables.js";
+import { readSessionUpdatedAt, recordSessionMetaFromInbound, resolveStorePath, } from "../../../config/sessions.js";
 import { logVerbose, shouldLogVerbose } from "../../../globals.js";
 import { readChannelAllowFromStore } from "../../../pairing/pairing-store.js";
 import { jidToE164, normalizeE164 } from "../../../utils.js";

package/dist/web/auto-reply/monitor.d.ts

@@ -1,5 +1,5 @@
+import type { WebMonitorTuning } from "./types.js";
 import { getReplyFromConfig } from "../../auto-reply/reply.js";
 import { type RuntimeEnv } from "../../runtime.js";
 import { monitorWebInbox } from "../inbound.js";
-import type { WebMonitorTuning } from "./types.js";
 export declare function monitorWebChannel(verbose: boolean, listenerFactory?: typeof monitorWebInbox | undefined, keepAlive?: boolean, replyResolver?: typeof getReplyFromConfig | undefined, runtime?: RuntimeEnv, abortSignal?: AbortSignal, tuning?: WebMonitorTuning): Promise<void>;

package/dist/web/auto-reply/monitor.js

@@ -1,7 +1,8 @@
-import { DEFAULT_GROUP_HISTORY_LIMIT } from "../../auto-reply/reply/history.js";
-import { getReplyFromConfig } from "../../auto-reply/reply.js";
 import { hasControlCommand } from "../../auto-reply/command-detection.js";
 import { resolveInboundDebounceMs } from "../../auto-reply/inbound-debounce.js";
+import { getReplyFromConfig } from "../../auto-reply/reply.js";
+import { DEFAULT_GROUP_HISTORY_LIMIT } from "../../auto-reply/reply/history.js";
+import { formatCliCommand } from "../../cli/command-format.js";
 import { waitForever } from "../../cli/wait.js";
 import { loadConfig } from "../../config/config.js";
 import { logVerbose } from "../../globals.js";
@@ -11,7 +12,6 @@ import { registerUnhandledRejectionHandler } from "../../infra/unhandled-rejecti
 import { getChildLogger } from "../../logging.js";
 import { resolveAgentRoute } from "../../routing/resolve-route.js";
 import { defaultRuntime } from "../../runtime.js";
-import { formatCliCommand } from "../../cli/command-format.js";
 import { resolveWhatsAppAccount } from "../accounts.js";
 import { setActiveWebListener } from "../active-listener.js";
 import { monitorWebInbox } from "../inbound.js";

package/dist/web/inbound/monitor.js

@@ -1,11 +1,11 @@
 import { DisconnectReason, isJidGroup } from "@whiskeysockets/baileys";
+import { createInboundDebouncer } from "../../auto-reply/inbound-debounce.js";
 import { formatLocationText } from "../../channels/location.js";
 import { logVerbose, shouldLogVerbose } from "../../globals.js";
 import { recordChannelActivity } from "../../infra/channel-activity.js";
 import { getChildLogger } from "../../logging/logger.js";
 import { createSubsystemLogger } from "../../logging/subsystem.js";
 import { saveMediaBuffer } from "../../media/store.js";
-import { createInboundDebouncer } from "../../auto-reply/inbound-debounce.js";
 import { jidToE164, resolveJidToE164 } from "../../utils.js";
 import { createWaSocket, getStatusCode, waitForWaConnection } from "../session.js";
 import { checkInboundAccessControl } from "./access-control.js";

package/dist/web/login-qr.js

@@ -1,5 +1,5 @@
-import { randomUUID } from "node:crypto";
 import { DisconnectReason } from "@whiskeysockets/baileys";
+import { randomUUID } from "node:crypto";
 import { loadConfig } from "../config/config.js";
 import { danger, info, success } from "../globals.js";
 import { logInfo } from "../logger.js";

package/dist/web/login.js

@@ -1,9 +1,9 @@
 import { DisconnectReason } from "@whiskeysockets/baileys";
+import { formatCliCommand } from "../cli/command-format.js";
 import { loadConfig } from "../config/config.js";
 import { danger, info, success } from "../globals.js";
 import { logInfo } from "../logger.js";
 import { defaultRuntime } from "../runtime.js";
-import { formatCliCommand } from "../cli/command-format.js";
 import { resolveWhatsAppAccount } from "./accounts.js";
 import { createWaSocket, formatError, logoutWeb, waitForWaConnection } from "./session.js";
 export async function loginWeb(verbose, waitForConnection, runtime = defaultRuntime, accountId) {

package/dist/web/media.d.ts

@@ -1,3 +1,4 @@
+import type { SsrFPolicy } from "../infra/net/ssrf.js";
 import { type MediaKind } from "../media/constants.js";
 import { optimizeImageToPng } from "../media/image-ops.js";
 export type WebMediaResult = {
@@ -6,8 +7,12 @@ export type WebMediaResult = {
     kind: MediaKind;
     fileName?: string;
 };
-export declare function loadWebMedia(mediaUrl: string, maxBytes?: number): Promise<WebMediaResult>;
-export declare function loadWebMediaRaw(mediaUrl: string, maxBytes?: number): Promise<WebMediaResult>;
+export declare function loadWebMedia(mediaUrl: string, maxBytes?: number, options?: {
+    ssrfPolicy?: SsrFPolicy;
+}): Promise<WebMediaResult>;
+export declare function loadWebMediaRaw(mediaUrl: string, maxBytes?: number, options?: {
+    ssrfPolicy?: SsrFPolicy;
+}): Promise<WebMediaResult>;
 export declare function optimizeImageToJpeg(buffer: Buffer, maxBytes: number, opts?: {
     contentType?: string;
     fileName?: string;

package/dist/web/media.js

@@ -3,10 +3,10 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { logVerbose, shouldLogVerbose } from "../globals.js";
 import { maxBytesForKind, mediaKindFromMime } from "../media/constants.js";
-import { resolveUserPath } from "../utils.js";
 import { fetchRemoteMedia } from "../media/fetch.js";
 import { convertHeicToJpeg, hasAlphaChannel, optimizeImageToPng, resizeToJpeg, } from "../media/image-ops.js";
 import { detectMime, extensionForMime } from "../media/mime.js";
+import { resolveUserPath } from "../utils.js";
 const HEIC_MIME_RE = /^image\/hei[cf]$/i;
 const HEIC_EXT_RE = /\.(heic|heif)$/i;
 const MB = 1024 * 1024;
@@ -72,7 +72,7 @@ async function optimizeImageWithFallback(params) {
     return { ...optimized, format: "jpeg" };
 }
 async function loadWebMediaInternal(mediaUrl, options = {}) {
-    const { maxBytes, optimizeImages = true } = options;
+    const { maxBytes, optimizeImages = true, ssrfPolicy } = options;
     // Use fileURLToPath for proper handling of file:// URLs (handles file://localhost/path, etc.)
     if (mediaUrl.startsWith("file://")) {
         try {
@@ -135,7 +135,15 @@ async function loadWebMediaInternal(mediaUrl, options = {}) {
         };
     };
     if (/^https?:\/\//i.test(mediaUrl)) {
-        const fetched = await fetchRemoteMedia({ url: mediaUrl });
+        // Enforce a download cap during fetch to avoid unbounded memory usage.
+        // For optimized images, allow fetching larger payloads before compression.
+        const defaultFetchCap = maxBytesForKind("unknown");
+        const fetchCap = maxBytes === undefined
+            ? defaultFetchCap
+            : optimizeImages
+                ? Math.max(maxBytes, defaultFetchCap)
+                : maxBytes;
+        const fetched = await fetchRemoteMedia({ url: mediaUrl, maxBytes: fetchCap, ssrfPolicy });
         const { buffer, contentType, fileName } = fetched;
         const kind = mediaKindFromMime(contentType);
         return await clampAndFinalize({ buffer, contentType, kind, fileName });
@@ -162,16 +170,18 @@ async function loadWebMediaInternal(mediaUrl, options = {}) {
         fileName,
     });
 }
-export async function loadWebMedia(mediaUrl, maxBytes) {
+export async function loadWebMedia(mediaUrl, maxBytes, options) {
     return await loadWebMediaInternal(mediaUrl, {
         maxBytes,
         optimizeImages: true,
+        ssrfPolicy: options?.ssrfPolicy,
     });
 }
-export async function loadWebMediaRaw(mediaUrl, maxBytes) {
+export async function loadWebMediaRaw(mediaUrl, maxBytes, options) {
     return await loadWebMediaInternal(mediaUrl, {
         maxBytes,
         optimizeImages: false,
+        ssrfPolicy: options?.ssrfPolicy,
     });
 }
 export async function optimizeImageToJpeg(buffer, maxBytes, opts = {}) {

package/dist/web/outbound.js

@@ -1,11 +1,11 @@
 import { randomUUID } from "node:crypto";
+import { loadConfig } from "../config/config.js";
+import { resolveMarkdownTableMode } from "../config/markdown-tables.js";
 import { getChildLogger } from "../logging/logger.js";
 import { createSubsystemLogger } from "../logging/subsystem.js";
+import { convertMarkdownTables } from "../markdown/tables.js";
 import { normalizePollInput } from "../polls.js";
 import { toWhatsappJid } from "../utils.js";
-import { loadConfig } from "../config/config.js";
-import { resolveMarkdownTableMode } from "../config/markdown-tables.js";
-import { convertMarkdownTables } from "../markdown/tables.js";
 import { requireActiveWebListener } from "./active-listener.js";
 import { loadWebMedia } from "./media.js";
 const outboundLog = createSubsystemLogger("gateway/channels/whatsapp").child("outbound");

package/dist/web/session.js

@@ -1,12 +1,12 @@
+import { DisconnectReason, fetchLatestBaileysVersion, makeCacheableSignalKeyStore, makeWASocket, useMultiFileAuthState, } from "@whiskeysockets/baileys";
 import { randomUUID } from "node:crypto";
 import fsSync from "node:fs";
-import { DisconnectReason, fetchLatestBaileysVersion, makeCacheableSignalKeyStore, makeWASocket, useMultiFileAuthState, } from "@whiskeysockets/baileys";
 import qrcode from "qrcode-terminal";
+import { formatCliCommand } from "../cli/command-format.js";
 import { danger, success } from "../globals.js";
 import { getChildLogger, toPinoLikeLogger } from "../logging.js";
 import { ensureDir, resolveUserPath } from "../utils.js";
 import { VERSION } from "../version.js";
-import { formatCliCommand } from "../cli/command-format.js";
 import { maybeRestoreCredsFromBackup, resolveDefaultWebAuthDir, resolveWebCredsBackupPath, resolveWebCredsPath, } from "./auth-store.js";
 export { getWebAuthAgeMs, logoutWeb, logWebSelfId, pickWebChannel, readWebSelfId, WA_WEB_AUTH_DIR, webAuthExists, } from "./auth-store.js";
 let credsSaveQueue = Promise.resolve();

package/dist/wizard/onboarding.finalize.d.ts

@@ -13,5 +13,7 @@ type FinalizeOnboardingOptions = {
     prompter: WizardPrompter;
     runtime: RuntimeEnv;
 };
-export declare function finalizeOnboardingWizard(options: FinalizeOnboardingOptions): Promise<void>;
+export declare function finalizeOnboardingWizard(options: FinalizeOnboardingOptions): Promise<{
+    launchedTui: boolean;
+}>;
 export {};

package/dist/wizard/onboarding.finalize.js

@@ -1,17 +1,18 @@
 import fs from "node:fs/promises";
 import path from "node:path";
 import { DEFAULT_BOOTSTRAP_FILENAME } from "../agents/workspace.js";
+import { formatCliCommand } from "../cli/command-format.js";
+import { buildGatewayInstallPlan, gatewayInstallErrorHint, } from "../commands/daemon-install-helpers.js";
 import { DEFAULT_GATEWAY_DAEMON_RUNTIME, GATEWAY_DAEMON_RUNTIME_OPTIONS, } from "../commands/daemon-runtime.js";
-import { healthCommand } from "../commands/health.js";
 import { formatHealthCheckFailure } from "../commands/health-format.js";
-import { detectBrowserOpenSupport, formatControlUiSshHint, openUrl, openUrlInBackground, probeGatewayReachable, waitForGatewayReachable, resolveControlUiLinks, } from "../commands/onboard-helpers.js";
-import { formatCliCommand } from "../cli/command-format.js";
+import { healthCommand } from "../commands/health.js";
+import { detectBrowserOpenSupport, formatControlUiSshHint, openUrl, probeGatewayReachable, waitForGatewayReachable, resolveControlUiLinks, } from "../commands/onboard-helpers.js";
 import { resolveGatewayService } from "../daemon/service.js";
 import { isSystemdUserServiceAvailable } from "../daemon/systemd.js";
 import { ensureControlUiAssetsBuilt } from "../infra/control-ui-assets.js";
+import { restoreTerminalState } from "../terminal/restore.js";
 import { runTui } from "../tui/tui.js";
 import { resolveUserPath } from "../utils.js";
-import { buildGatewayInstallPlan, gatewayInstallErrorHint, } from "../commands/daemon-install-helpers.js";
 export async function finalizeOnboardingWizard(options) {
     const { flow, opts, baseConfig, nextConfig, settings, prompter, runtime } = options;
     const withWizardProgress = async (label, options, work) => {
@@ -207,6 +208,7 @@ export async function finalizeOnboardingWizard(options) {
     let controlUiOpenHint;
     let seededInBackground = false;
     let hatchChoice = null;
+    let launchedTui = false;
     if (!opts.skipUi && gatewayProbe.ok) {
         if (hasBootstrap) {
             await prompter.note([
@@ -232,6 +234,7 @@ export async function finalizeOnboardingWizard(options) {
             initialValue: "tui",
         });
         if (hatchChoice === "tui") {
+            restoreTerminalState("pre-onboarding tui");
             await runTui({
                 url: links.wsUrl,
                 token: settings.authMode === "token" ? settings.gatewayToken : undefined,
@@ -240,12 +243,7 @@ export async function finalizeOnboardingWizard(options) {
                 deliver: false,
                 message: hasBootstrap ? "Wake up, my friend!" : undefined,
             });
-            if (settings.authMode === "token" && settings.gatewayToken) {
-                seededInBackground = await openUrlInBackground(authedUrl);
-            }
-            if (seededInBackground) {
-                await prompter.note(`Web UI seeded in the background. Open later with: ${formatCliCommand("openclaw dashboard --no-open")}`, "Web UI");
-            }
+            launchedTui = true;
         }
         else if (hatchChoice === "web") {
             const browserSupport = await detectBrowserOpenSupport();
@@ -351,4 +349,5 @@ export async function finalizeOnboardingWizard(options) {
         : seededInBackground
             ? "Onboarding complete. Web UI seeded in the background; open it anytime with the tokenized link above."
             : "Onboarding complete. Use the tokenized dashboard link above to control OpenClaw.");
+    return { launchedTui };
 }

package/dist/wizard/onboarding.js

@@ -1,14 +1,15 @@
 import { ensureAuthProfileStore } from "../agents/auth-profiles.js";
 import { listChannelPlugins } from "../channels/plugins/index.js";
-import { applyAuthChoice, resolvePreferredProviderForAuthChoice, warnIfModelConfigLooksOff, } from "../commands/auth-choice.js";
+import { formatCliCommand } from "../cli/command-format.js";
+import { installCompletion } from "../cli/completion-cli.js";
 import { promptAuthChoiceGrouped } from "../commands/auth-choice-prompt.js";
+import { applyAuthChoice, resolvePreferredProviderForAuthChoice, warnIfModelConfigLooksOff, } from "../commands/auth-choice.js";
 import { applyPrimaryModel, promptDefaultModel } from "../commands/model-picker.js";
 import { setupChannels } from "../commands/onboard-channels.js";
 import { applyWizardMetadata, DEFAULT_WORKSPACE, ensureWorkspaceAndSessions, handleReset, printWizardHeader, probeGatewayReachable, summarizeExistingConfig, } from "../commands/onboard-helpers.js";
+import { setupInternalHooks } from "../commands/onboard-hooks.js";
 import { promptRemoteGatewayConfig } from "../commands/onboard-remote.js";
 import { setupSkills } from "../commands/onboard-skills.js";
-import { setupInternalHooks } from "../commands/onboard-hooks.js";
-import { formatCliCommand } from "../cli/command-format.js";
 import { DEFAULT_GATEWAY_PORT, readConfigFileSnapshot, resolveGatewayPort, writeConfigFile, } from "../config/config.js";
 import { logConfigUpdated } from "../config/logging.js";
 import { defaultRuntime } from "../runtime.js";
@@ -16,7 +17,6 @@ import { resolveUserPath } from "../utils.js";
 import { finalizeOnboardingWizard } from "./onboarding.finalize.js";
 import { configureGatewayForOnboarding } from "./onboarding.gateway-config.js";
 import { WizardCancelledError } from "./prompts.js";
-import { installCompletion } from "../cli/completion-cli.js";
 async function requireRiskAcknowledgement(params) {
     if (params.opts.acceptRisk === true) {
         return;
@@ -368,7 +368,7 @@ export async function runOnboardingWizard(opts, runtime = defaultRuntime, prompt
     nextConfig = await setupInternalHooks(nextConfig, runtime, prompter);
     nextConfig = applyWizardMetadata(nextConfig, { command: "onboard", mode });
     await writeConfigFile(nextConfig);
-    await finalizeOnboardingWizard({
+    const { launchedTui } = await finalizeOnboardingWizard({
         flow,
         opts,
         baseConfig,
@@ -378,6 +378,9 @@ export async function runOnboardingWizard(opts, runtime = defaultRuntime, prompt
         prompter,
         runtime,
     });
+    if (launchedTui) {
+        return;
+    }
     const installShell = await prompter.confirm({
         message: "Install shell completion script?",
         initialValue: true,

package/docs/.i18n/README.md

@@ -0,0 +1,31 @@
+# OpenClaw docs i18n assets
+
+This folder stores **generated** and **config** files for documentation translations.
+
+## Files
+
+- `glossary.<lang>.json` — preferred term mappings (used in prompt guidance).
+- `<lang>.tm.jsonl` — translation memory (cache) keyed by workflow + model + text hash.
+
+## Glossary format
+
+`glossary.<lang>.json` is an array of entries:
+
+```json
+{
+  "source": "troubleshooting",
+  "target": "故障排除",
+  "ignore_case": true,
+  "whole_word": false
+}
+```
+
+Fields:
+
+- `source`: English (or source) phrase to prefer.
+- `target`: preferred translation output.
+
+## Notes
+
+- Glossary entries are passed to the model as **prompt guidance** (no deterministic rewrites).
+- The translation memory is updated by `scripts/docs-i18n`.

package/docs/.i18n/glossary.zh-CN.json

@@ -0,0 +1,134 @@
+[
+  {
+    "source": "OpenClaw",
+    "target": "OpenClaw"
+  },
+  {
+    "source": "Gateway",
+    "target": "Gateway网关"
+  },
+  {
+    "source": "Pi",
+    "target": "Pi"
+  },
+  {
+    "source": "Skills",
+    "target": "Skills"
+  },
+  {
+    "source": "Skills config",
+    "target": "Skills配置"
+  },
+  {
+    "source": "Skills Config",
+    "target": "Skills配置"
+  },
+  {
+    "source": "local loopback",
+    "target": "local loopback"
+  },
+  {
+    "source": "Tailscale",
+    "target": "Tailscale"
+  },
+  {
+    "source": "Getting Started",
+    "target": "入门指南"
+  },
+  {
+    "source": "Getting started",
+    "target": "入门指南"
+  },
+  {
+    "source": "DMs",
+    "target": "私信"
+  },
+  {
+    "source": "DM",
+    "target": "私信"
+  },
+  {
+    "source": "sandboxed",
+    "target": "沙箱隔离"
+  },
+  {
+    "source": "Sandboxed",
+    "target": "沙箱隔离"
+  },
+  {
+    "source": "Auth: where it lives (important)",
+    "target": "凭证：存储位置（重要）"
+  },
+  {
+    "source": "agent",
+    "target": "智能体"
+  },
+  {
+    "source": "channel",
+    "target": "渠道"
+  },
+  {
+    "source": "session",
+    "target": "会话"
+  },
+  {
+    "source": "provider",
+    "target": "提供商"
+  },
+  {
+    "source": "model",
+    "target": "模型"
+  },
+  {
+    "source": "tool",
+    "target": "工具"
+  },
+  {
+    "source": "CLI",
+    "target": "CLI"
+  },
+  {
+    "source": "install sanity",
+    "target": "安装完整性检查"
+  },
+  {
+    "source": "get unstuck",
+    "target": "解决问题"
+  },
+  {
+    "source": "troubleshooting",
+    "target": "故障排除"
+  },
+  {
+    "source": "FAQ",
+    "target": "常见问题"
+  },
+  {
+    "source": "onboarding",
+    "target": "新手引导"
+  },
+  {
+    "source": "Onboarding",
+    "target": "新手引导"
+  },
+  {
+    "source": "wizard",
+    "target": "向导"
+  },
+  {
+    "source": "environment variables",
+    "target": "环境变量"
+  },
+  {
+    "source": "environment variable",
+    "target": "环境变量"
+  },
+  {
+    "source": "env vars",
+    "target": "环境变量"
+  },
+  {
+    "source": "env var",
+    "target": "环境变量"
+  }
+]