April 23, 2026 โ€ข Version: 2026.5.10-beta.2

zh-TW Config Schema Form Labels Not Translated in Settings Page

JSON Schema title/description fields in the Settings page are not being picked up by the i18n translation system, resulting in English labels persisting despite complete zh-TW translation files.

๐Ÿ” Symptoms

Visual Manifestation

Settings page under zh-TW locale displays English-only labels for all Config Schema-driven form fields:

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚  AI ่ˆ‡ไปฃ็†่จญๅฎš                                               โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚  Primary Model            [________________________]         โ”‚
โ”‚  Fallback Models          [________________________]         โ”‚
โ”‚  Max Tokens               [____]                            โ”‚
โ”‚  Context Window           [____]                            โ”‚
โ”‚  Compaction Mode          [โ–ผ Select ]                        โ”‚
โ”‚  Image Model              [________________________]         โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
Expected: ไธป่ฆๆจกๅž‹, ๅ‚™็”จๆจกๅž‹, ๆœ€ๅคง Token, ไธŠไธ‹ๆ–‡็ช—ๅฃ, ๅฃ“็ธฎๆจกๅผ, ๅœ–ๅƒๆจกๅž‹
Actual:   English labels persist despite zh-TW.js having 100+ translation entries

Affected Configuration Blocks

The following Settings sections exhibit untranslated labels:

  • AI ่ˆ‡ไปฃ็† (AI & Agents): Primary Model, Fallback Models, Max Tokens, Context Window
  • ้€š่จŠ (Communications): Connection Timeout, Retry Attempts, Protocol Version
  • ๅŸบ็คŽ่จญๆ–ฝ (Infrastructure): Instance Type, Region, Scaling Policy
  • ๅฃ“็ธฎ่จญๅฎš (Compression): Compaction Mode, Threshold Percentage, Algorithm
  • ๅœ–ๅƒ็”Ÿๆˆ (Image Generation): Image Model, Resolution, Quality Preset

Diagnostic CLI Output

$ openclaw locale --list
Installed locales: en-US, zh-TW, zh-CN, ja-JP
Active locale: zh-TW

$ openclaw debug --i18n 2>&1 | head -50
[DEBUG] i18n: Loading zh-TW.json... OK (847 keys)
[DEBUG] i18n: Translation coverage: 847/847 (100%)
[DEBUG] schema: ConfigSchema.fields = 127 entries
[DEBUG] schema: Fields with i18n keys = 0
[DEBUG] schema: Fields using raw title/description = 127
[WARNING] schema: 127 Config Schema titles NOT integrated with i18n system

Browser Console Evidence

$F12 Console in browser:
[openclaw:i18n] Missing key: "config.schema.primaryModel.title"
[openclaw:i18n] Missing key: "config.schema.fallbackModels.title"
[openclaw:i18n] Missing key: "config.schema.maxTokens.title"
... (repeated for all Config Schema fields)

๐Ÿง  Root Cause

Architectural Analysis

The issue stems from a two-tier translation architecture disconnect:

Evidence & Sources

This troubleshooting guide was automatically synthesized by the FixClaw Intelligence Pipeline from community discussions.