直接改 config.yaml 最稳，必须彻底终止 openclaw 和 hermes 相关进程后重启，确保 controlui.locale: zh-cn（冒号后空格、无注释、utf-8 编码），再执行 openclaw gateway restart 才生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
直接改 config.yaml 最稳，别信“重启就生效”
很多用户执行完命令或点完设置就关窗口，结果一刷新还是英文——根本原因是 AionClaw 的语言加载发生在进程启动初期，**配置写入后必须彻底终止所有相关进程再重启**。Windows 上残留的 openclaw.exe 和 hermes-agent.exe、macOS 上的 openclaw 和 hermes 进程不杀干净，新配置永远不会被读取。
操作前先确认：任务管理器（Windows）或 Activity Monitor（macOS）里没有残留进程；Linux 用户可用 pkill -f openclaw 和 pkill -f hermes 清理。
然后编辑 config.yaml，确保有且仅有一行：controlUi.locale: zh-CN
注意冒号后必须有一个空格，不能是中文标点，也不能缩进错误。如果该行被注释（开头是 #），得删掉 # 才生效。
openclaw config set 命令优先级高，但得配 gateway restart
这条命令写入的是运行时配置库，比 config.yaml 优先级更高，适合多实例或快速切换场景。但单独执行 openclaw config set controlUi.locale "zh-CN" 是无效的——它只改了配置值，没触发 UI 层重新初始化。
必须紧接着执行：openclaw gateway restart
这个命令会终止网关服务并拉起新实例，同时强制重载 i18n 模块。如果用的是旧版 AionClaw（v2026.3 之前），键名可能是 language 而非 controlUi.locale，可尝试：openclaw config set language "zh-CN"
验证是否成功：打开 http://localhost:3000 后检查左上角标题是否变成“AionClaw 控制台”，而不是 “AionClaw Dashboard”。
浏览器加 ?lang=zh-CN 只是临时预览，别当真
在地址栏末尾加上 ?lang=zh-CN 确实能立刻看到中文界面，但这只是前端 i18next 的运行时覆盖行为，**完全不修改任何配置，也不影响后台日志、CLI 输出、Agent 内部提示语**。你看到的“新建智能体”“定时任务”是 UI 层翻译，而控制台里打印的 [hermes] executing task... 这类日志永远是英文。
这个技巧唯一实用的场景是：给别人远程演示时不想动配置，或者怀疑语言包缺失但又不敢乱改文件。关掉标签页，一切恢复原状。别指望靠它解决长期使用问题。
语言包损坏时，手动替换 resources/lang/zh-CN.json 是最后手段
现象是：设置已切中文、config.yaml 也改了、进程全杀了再启，但界面仍部分英文（比如菜单是中文，按钮却是英文）。大概率是 resources/lang/zh-CN.json 文件损坏或版本不匹配。
正确做法：
- 去 AionClaw 官方 GitHub Releases 页面下载对应版本的完整语言包 ZIP
- 解压后找到
resources/lang/zh-CN.json（不是language.json，也不是zh-CN-language-pack.zip里的旧命名） - 备份原文件：
mv zh-CN.json zh-CN.json.bak - 把新文件复制进去，确保权限可读（
chmod 644 zh-CN.json） - 重启前检查文件编码：必须是 UTF-8 无 BOM，用 VS Code 打开右下角确认
zh-CN 不能写成 zh 或 cn，否则 i18next 初始化失败会静默回退到 en-US。
