概述
OpenClaw v2026.4.5 将控制 UI 本地化到 12 种语言，中文用户现在可以使用完整的中文界面管理 OpenClaw。
支持的语言列表：
| 语言 | 代码 |
|---|---|
| 简体中文 | zh-CN |
| 繁体中文 | zh-TW |
| 日语 | ja |
| 韩语 | ko |
| 法语 | fr |
| 德语 | de |
| 西班牙语 | es |
| 巴西葡萄牙语 | pt-BR |
| 土耳其语 | tr |
| 印尼语 | id |
| 波兰语 | pl |
| 乌克兰语 | uk |
前置要求
- OpenClaw v2026.4.5 或更高版本
确认当前版本：
openclaw --version
如需升级：
npm install -g openclaw@latest
配置中文界面
方法一：配置文件
在 config.yaml 中设置语言：
gateway:
locale: "zh-CN" # 简体中文
重启网关后生效：
openclaw gateway restart
方法二：环境变量
export OPENCLAW_LOCALE=zh-CN
openclaw gateway start
方法三：CLI 参数
openclaw gateway start --locale zh-CN
中文界面覆盖范围
启用中文后，以下界面元素会本地化：
- Dashboard 控制面板：所有菜单、按钮、状态标签
- CLI 输出：命令提示、错误信息、帮助文本
- WebChat 界面：聊天界面文本、设置面板
- 审批提示：exec 审批、工具调用确认
- 系统通知：任务状态、错误报告
多语言 Agent 回复
语言设置影响的是控制 UI，不影响 Agent 的回复语言。要让 Agent 使用中文回复，应在 AGENTS.md 中设定：
# AGENTS.md
## 语言偏好
- 始终使用简体中文回复用户
- 代码注释保持英文
- 技术术语可保留英文原文
或在 Agent 配置中设置：
agents:
defaults:
systemPrompt: "请始终使用简体中文回复。"
繁体中文支持
台湾和香港用户可以选择繁体中文：
gateway:
locale: "zh-TW"
繁体中文界面使用标准繁体字符和台湾地区常用术语。
多用户多语言环境
如果不同用户需要不同语言，可以通过频道级别配置：
channels:
telegram:
locale: "zh-CN" # 微信/飞书用户用中文
slack:
locale: "en" # Slack 用户用英文
自定义翻译
如果对默认翻译不满意，可以覆盖特定文本：
gateway:
locale: "zh-CN"
localeOverrides:
"Approve": "批准执行"
"Deny": "拒绝"
"Task completed": "任务已完成"
验证语言配置
配置完成后，验证语言设置：
# 检查当前语言配置
openclaw doctor
# 查看 UI 语言
openclaw gateway status
注意事项
- 多语言 UI 需要 v2026.4.5 或更高版本
- 语言设置变更需要重启网关
- Agent 的回复语言由系统提示控制，不受 UI 语言设置影响
- 部分第三方插件可能尚未完成翻译，会回退到英文
- 日志文件始终使用英文，方便国际化排查问题