docs: preserve channel brand terms in Chinese i18n by hxy91819 · Pull Request #91419 · openclaw/openclaw

hxy91819 · 2026-06-08T12:53:26Z

Summary

Add Simplified Chinese and Traditional Chinese docs i18n glossary entries for channel brand/product terms that should remain stable in generated translations.
Cover LINE plus similar short channel names such as SMS, IRC, ClickClack, Nextcloud Talk, Nostr, Synology Chat, Tlon, Twitch, Twilio, Zalo, and Zalo Personal.
Keep the fix glossary-only so the existing automatic docs translation pipeline remains the source of generated localized pages.

Verification

jq -e . docs/.i18n/glossary.zh-CN.json
jq -e . docs/.i18n/glossary.zh-TW.json
duplicate-source check for both Chinese glossary files
channel brand coverage check for both Chinese glossary files
pnpm docs:check-i18n-glossary
git diff --check
.agents/skills/autoreview/scripts/autoreview --mode branch --base upstream/main

clawsweeper · 2026-06-08T12:55:20Z

Codex review: passed. Reviewed June 8, 2026, 9:24 AM ET / 13:24 UTC.

Summary
Adds Simplified and Traditional Chinese docs i18n glossary mappings to preserve channel and product brand terms in generated Chinese translations.

PR surface: Docs +144. Total +144 across 2 files.

Reproducibility: not applicable. this is a docs i18n glossary maintenance PR, not a bug report. The relevant check is source inspection plus PR-head JSON and coverage validation.

Review metrics: none identified.

Merge readiness
Overall: 🦞 diamond lobster
Proof: 🌊 off-meta tidepool
Patch quality: 🦞 diamond lobster
Result: ready for maintainer review.

Overall follows the weaker of proof and patch quality, so missing proof can cap an otherwise strong patch.

Next step before merge

[P2] No repair lane is needed because the protected maintainer/docs-only PR has no actionable findings.

Security
Cleared: The diff only changes docs i18n JSON glossary files and introduces no code execution, dependency, workflow, secret, or supply-chain surface.

Review details

Best possible solution:

Land the glossary-only update through the existing maintainer/automerge path so generated Chinese docs preserve these channel brand names without editing generated locale pages in this repository.

Do we have a high-confidence way to reproduce the issue?

Not applicable; this is a docs i18n glossary maintenance PR, not a bug report. The relevant check is source inspection plus PR-head JSON and coverage validation.

Is this the best way to solve the issue?

Yes; the scoped docs policy makes glossary files the source-of-truth hook for generated localized docs, and the PR keeps the fix there instead of editing generated locale output.

AGENTS.md: found and applied where relevant.

Codex review notes: model gpt-5.5, reasoning high; reviewed against a04de1a0ceac.

Label changes

Label justifications:

P3: This is a low-risk docs i18n glossary maintenance PR with no runtime, config, security, or channel-delivery behavior change.
rating: 🦞 diamond lobster: Overall readiness is 🦞 diamond lobster; proof is 🌊 off-meta tidepool and patch quality is 🦞 diamond lobster.
status: 🚀 automerge armed: This PR is in ClawSweeper's automerge lane. Not applicable: Real behavior proof is not required because this PR only changes files under docs/.

Evidence reviewed

PR surface:

Docs +144. Total +144 across 2 files.

View PR surface stats

Area	Files	Added	Net
Source	0	0	0
Tests	0	0	0
Docs	2	144	+144
Config	0	0	0
Generated	0	0	0
Other	0	0	0
Total	2	144	+144

What I checked:

Docs i18n owner boundary: The docs-scoped policy treats English docs plus glossary files as the source of truth and says glossary entries should be updated before generated translation runs. Public docs: docs/AGENTS.md. (docs/AGENTS.md:31, a04de1a0ceac)
Glossary contract: The i18n README defines glossary files as preferred source/target term mappings owned by the docs translation pipeline. Public docs: docs/.i18n/README.md. (docs/.i18n/README.md:42, a04de1a0ceac)
Translation prompt uses glossary entries: The docs translator prompt makes matching glossary terms mandatory and preserves identical source/target entries in English, which is the behavior this PR relies on. (scripts/docs-i18n/prompt.go:102, a04de1a0ceac)
Current main still lacks the requested coverage: Current main has only QQ Bot from the reviewed channel-term set in zh-CN and none of the reviewed channel terms in zh-TW, so the central glossary addition is not already implemented on main. Public docs: docs/.i18n/glossary.zh-CN.json. (docs/.i18n/glossary.zh-CN.json:263, a04de1a0ceac)
PR-head zh-CN glossary validation: At PR head 45d54b3, the zh-CN JSON parses, has no duplicate source terms, and includes the named channel brand terms with stable targets. Public docs: docs/.i18n/glossary.zh-CN.json. (docs/.i18n/glossary.zh-CN.json:267, 45d54b370f3b)
PR-head zh-TW glossary validation: At PR head 45d54b3, the zh-TW JSON parses, has no duplicate source terms, and includes the reviewed channel/product brand terms. Public docs: docs/.i18n/glossary.zh-TW.json. (docs/.i18n/glossary.zh-TW.json:15, 45d54b370f3b)

Likely related people:

vincentkoc: The current docs i18n assets, glossary README, prompt contract, and glossary checker all blame to f5935bb by Vincent Koc in this checkout. (role: recent area contributor; confidence: medium; commits: f5935bbca15d; files: docs/.i18n/README.md, docs/.i18n/glossary.zh-CN.json, docs/.i18n/glossary.zh-TW.json)

What the crustacean ranks mean

🦀 challenger crab: rare, exceptional readiness with strong proof, clean implementation, and convincing validation.
🦞 diamond lobster: very strong readiness with only minor maintainer review expected.
🐚 platinum hermit: good normal PR, likely mergeable with ordinary maintainer review.
🦐 gold shrimp: useful signal, but proof or patch confidence is still limited.
🦪 silver shellfish: thin signal; proof, validation, or implementation needs work.
🧂 unranked krab: not merge-ready because proof is missing/unusable or there are serious correctness or safety concerns.
🌊 off-meta tidepool: rating does not apply to this item.

Shiny media proof means a screenshot, video, or linked artifact directly shows the changed behavior. Runtime, network, CSP, and security claims still need visible diagnostics.

How this review workflow works

ClawSweeper keeps one durable marker-backed review comment per issue or PR.
Re-runs edit this comment so the latest verdict, findings, and automation markers stay together instead of adding duplicate bot comments.
A fresh review can be triggered by eligible @clawsweeper re-review comments, exact-item GitHub events, scheduled/background review runs, or manual workflow dispatch.
PR/issue authors and users with repository write access can comment @clawsweeper re-review or @clawsweeper re-run on an open PR or issue to request a fresh review only.
Maintainers can also comment @clawsweeper review to request a fresh review only.
Fresh-review commands do not start repair, autofix, rebase, CI repair, or automerge.
Maintainer-only repair and merge flows require explicit commands such as @clawsweeper autofix, @clawsweeper automerge, @clawsweeper fix ci, or @clawsweeper address review.
Maintainers can comment @clawsweeper explain to ask for more context, or @clawsweeper stop to stop active automation.

hxy91819 · 2026-06-08T13:01:58Z

@clawsweeper automerge

clawsweeper · 2026-06-08T13:02:02Z

🦞✅
ClawSweeper merged this PR after the passing review.

Source: clawsweeper[bot]
Feedback: structured ClawSweeper verdict: pass (sha=45d54b370f3b8f9eeb4d8b991ac36ccc1f46be5e)
Merge status: merged by ClawSweeper automerge
Merged at: 2026-06-08T13:25:31Z
Merge commit: 9a82b60024b5

What merged:

Adds Simplified and Traditional Chinese docs i18n glossary mappings to preserve channel and product brand terms in generated Chinese translations.
PR surface: Docs +144. Total +144 across 2 files.
Reproducibility: not applicable. this is a docs i18n glossary maintenance PR, not a bug report. The relevant check is source inspection plus PR-head JSON and coverage validation.

Automerge notes:

PR branch already contained follow-up commit before automerge: docs: preserve channel brand terms in Chinese i18n

The automerge loop is complete.

Automerge progress:

2026-06-08 13:02:53 UTC review queued d0c0bc207591 (queued)

2026-06-08 13:09:10 UTC review passed d0c0bc207591 (structured ClawSweeper verdict: pass (sha=d0c0bc2075910a2e28f4ea159f7a6b7967c68...)

2026-06-08 13:09:31 UTC repair queued d0c0bc207591 (autonomous) Run: https://github.com/openclaw/clawsweeper/actions/runs/27139862227

2026-06-08 13:11:09 UTC repair started (running) in 1s Run: https://github.com/openclaw/clawsweeper/actions/runs/27139862227 automerge-openclaw-openclaw-91419

2026-06-08 13:11:33 UTC validation plan (passed) in 24s Run: https://github.com/openclaw/clawsweeper/actions/runs/27139862227 pnpm check:changed; pnpm lint; pnpm check:test-types

2026-06-08 13:11:43 UTC Codex write preflight (passed) in 34s Run: https://github.com/openclaw/clawsweeper/actions/runs/27139862227 danger-full-access

2026-06-08 13:15:47 UTC Codex edit 1 c0835f83c991 (complete) in 4m 38s Run: https://github.com/openclaw/clawsweeper/actions/runs/27139862227 exit 0

2026-06-08 13:19:00 UTC validation and review 1 45d54b370f3b (complete) in 7m 51s Run: https://github.com/openclaw/clawsweeper/actions/runs/27139862227 already-current

2026-06-08 13:19:05 UTC repair completed 45d54b370f3b (branch updated) in 7m 56s Run: https://github.com/openclaw/clawsweeper/actions/runs/27139862227 initial automerge rebase is delegated to Codex repair

2026-06-08 13:19:05 UTC review queued 45d54b370f3b (after repair)

2026-06-08 13:25:33 UTC automerge wait 45d54b370f3b (ready) in 14m 24s Run: https://github.com/openclaw/clawsweeper/actions/runs/27139862227 checks and exact-head review are ready

2026-06-08 13:25:18 UTC review passed 45d54b370f3b (structured ClawSweeper verdict: pass (sha=45d54b370f3b8f9eeb4d8b991ac36ccc1f46b...)

2026-06-08 13:25:33 UTC merged 45d54b370f3b (merged by ClawSweeper automerge)

2026-06-08 13:25:34 UTC repair finished 45d54b370f3b (pushed) in 14m 25s Run: https://github.com/openclaw/clawsweeper/actions/runs/27139862227 repair_contributor_branch

Summary: - Adds Simplified and Traditional Chinese docs i18n glossary mappings to preserve channel and product brand terms in generated Chinese translations. - PR surface: Docs +144. Total +144 across 2 files. - Reproducibility: not applicable. this is a docs i18n glossary maintenance PR, not a bug report. The relevant check is source inspection plus PR-head JSON and coverage validation. Automerge notes: - PR branch already contained follow-up commit before automerge: docs: preserve channel brand terms in Chinese i18n Validation: - ClawSweeper review passed for head 45d54b3. - Required merge gates passed before the squash merge. Prepared head SHA: 45d54b3 Review: openclaw#91419 (comment) Co-authored-by: Mason Huang <masonxhuang@tencent.com> Co-authored-by: clawsweeper <274271284+clawsweeper[bot]@users.noreply.github.com> Co-authored-by: clawsweeper[bot] <274271284+clawsweeper[bot]@users.noreply.github.com> Approved-by: hxy91819 Co-authored-by: hxy91819 <8814856+hxy91819@users.noreply.github.com>

openclaw-barnacle Bot added docs Improvements or additions to documentation size: XS maintainer Maintainer-authored PR labels Jun 8, 2026

clawsweeper Bot added rating: 🐚 platinum hermit Good normal PR readiness with ordinary maintainer review expected. status: 👀 ready for maintainer look ClawSweeper has no concrete contributor-facing blocker left for this PR. labels Jun 8, 2026

hxy91819 and others added 2 commits June 8, 2026 13:15

docs: preserve channel brand terms in Chinese i18n

c0835f8

docs: preserve channel brand terms in Chinese i18n

45d54b3

clawsweeper Bot force-pushed the codex/docs-i18n-channel-glossary branch from d0c0bc2 to 45d54b3 Compare June 8, 2026 13:19

clawsweeper Bot merged commit 9a82b60 into main Jun 8, 2026
32 checks passed

clawsweeper Bot deleted the codex/docs-i18n-channel-glossary branch June 8, 2026 13:25

github-actions Bot mentioned this pull request Jun 8, 2026

📡 Upstream Digest — 2026-06-08 14:00 UTC curtismercier/openclaw-mods#1038

Open

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

docs: preserve channel brand terms in Chinese i18n#91419

docs: preserve channel brand terms in Chinese i18n#91419
clawsweeper[bot] merged 2 commits into
mainfrom
codex/docs-i18n-channel-glossary

hxy91819 commented Jun 8, 2026

Uh oh!

clawsweeper Bot commented Jun 8, 2026 •

edited

Loading

Uh oh!

hxy91819 commented Jun 8, 2026

Uh oh!

clawsweeper Bot commented Jun 8, 2026 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

hxy91819 commented Jun 8, 2026

Summary

Verification

Uh oh!

clawsweeper Bot commented Jun 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

hxy91819 commented Jun 8, 2026

Uh oh!

clawsweeper Bot commented Jun 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

clawsweeper Bot commented Jun 8, 2026 •

edited

Loading

clawsweeper Bot commented Jun 8, 2026 •

edited

Loading