clawdbot中文界面需通过启用内置zh.json语言包、设置clawdbot_lang=zh环境变量或在config.yaml中配置lang: zh实现；指令中文识别需确认zh.yaml存在且doctor检查通过。

如果您已安装 Clawdbot 但界面仍显示英文，说明中文语言包尚未启用或未正确配置。Clawdbot 支持开箱即用的中文界面，其语言切换依赖于前端 i18n 配置文件与运行时环境变量的协同生效。以下是完成 Clawdbot 中文版设置的完整操作路径：

一、确认并启用内置中文语言包

Clawdbot 前端基于 Gradio 构建，其语言资源存放于 /app/i18n/zh.json 文件中，该文件在官方发布版本中已预置。启用中文无需额外下载，只需确保 Clawdbot 运行时识别到该语言文件并加载。

1、打开终端，进入 Clawdbot 安装目录（通常为全局 npm 全局模块路径，可通过 npm root -g 查看）。

2、执行命令定位 i18n 目录：find $(npm root -g) -path "*/clawdbot/app/i18n/zh.json" -type f。

3、若返回有效路径（如 /usr/local/lib/node_modules/clawdbot/app/i18n/zh.json），说明中文包存在；若无输出，请重新执行 npm install -g clawdbot@latest 完整安装。

二、通过环境变量强制指定中文界面

Clawdbot 启动时会读取 CLAWDBOT_LANG 环境变量以决定默认语言。设置该变量可绕过浏览器语言自动检测，确保稳定显示中文。

1、在 macOS/Linux 终端中，运行：export CLAWDBOT_LANG=zh。

2、在 Windows PowerShell 中，运行：$env:CLAWDBOT_LANG="zh"。

3、随后启动 Clawdbot：clawdbot web 或 clawdbot gui。

4、刷新浏览器页面，界面元素（如 Settings、Model Provider、Save Config）应全部显示为中文。

三、修改配置文件永久生效

为避免每次启动前手动设置环境变量，可将语言偏好写入 Clawdbot 的主配置文件 config.yaml，实现开机即中文。

1、执行命令生成或定位配置文件：clawdbot config path，获取输出路径（如 ~/.clawdbot/config.yaml）。

2、用文本编辑器打开该文件，在顶层添加新行：lang: zh（注意缩进与已有字段对齐，使用空格而非 Tab）。

3、保存文件后重启 Clawdbot 服务：clawdbot stop && clawdbot start。

4、访问 http://localhost:7860，验证所有 UI 文本是否已切换为简体中文。

四、验证指令关键词中文识别（可选增强）

Clawdbot 的命令系统支持多语言触发词，例如输入 /帮助 可等效于 /help。此功能需确保指令映射表已加载中文键值对。

1、检查指令映射文件是否存在：ls $(npm root -g)/clawdbot/app/commands/i18n/zh.yaml。

2、若文件存在，运行 clawdbot doctor --check-commands，确认输出中包含 zh command mappings: OK。

3、在 Web UI 聊天框中直接输入 /帮助 或 /设置，观察是否触发对应功能响应。