多语言功能需通过五种方式配置：一、修改.env中APP_LANG变量；二、编辑config.json的localeIdentifier字段；三、用moltbot命令覆盖浏览器区域设置；四、移动端需设系统语言并授予权限；五、手动添加语言包并编译。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正在使用一款免费AI助手，却发现其界面或响应仅限单一语言，则可能是由于语言配置未启用或多语言模块未加载。以下是实现多语言功能的具体操作路径：
一、检查并修改环境变量语言配置
多数免费AI助手通过环境变量控制默认语言，该设置直接影响界面显示与文本生成语种。修改后无需重新安装，重启服务即可生效。
1、在项目根目录下查找或新建.env文件。
2、确认是否存在APP_LANG变量，若无则手动添加一行：APP_LANG=zh_CN。
3、将zh_CN替换为所需语言代码，例如en_US（美式英语）、ja_JP（日语）、es_ES（西班牙语）。
4、保存文件，执行npm run dev或对应启动命令重启服务。
5、刷新页面或重连客户端，观察界面文字是否切换为指定语言。
二、编辑配置文件中的语言标识参数
部分助手依赖本地JSON配置文件设定语音识别与文本处理的语言区域，错误的localeIdentifier值会导致语音无法识别或翻译失效。
1、打开配置路径~/.config/swabble/config.json（Linux/macOS）或%APPDATA%\swabble\config.json（Windows）。
2、定位到"speech"对象内，找到"localeIdentifier"字段。
3、将其值更改为对应语言代码：zh_CN用于简体中文识别，ja_JP用于日语识别，fr_FR用于法语识别。
4、确保该字段值为字符串格式，前后包含英文双引号。
5、关闭所有相关进程，运行systemctl --user restart clawdbot（Linux）或重启Windows服务。
三、调用浏览器工具强制设置区域环境
某些跨平台助手在Web端运行时会继承浏览器语言偏好，但可通过命令行工具覆盖系统级区域设置，绕过浏览器限制。
1、打开终端或命令提示符，确保已安装moltbot工具。
2、输入命令：moltbot browsersetlocale zh-CN，回车执行。
3、如需切换为其他语言，将zh-CN替换为en-US、ko-KR或ar-SA等标准BCP 47标签。
4、该命令会直接写入助手运行时的LANG和LC_ALL环境变量。
5、重新加载Web界面或重启桌面客户端，验证语言变更是否即时反映。
四、启用移动客户端自动语言检测
移动端AI助手通常具备系统语言自适应能力，但需确认设备语言设置与客户端权限均已就绪，否则将回退至默认英文界面。
1、进入手机系统设置，点击【语言与输入法】→【语言】。
2、将首选语言调整为所需语种，例如将【简体中文】拖至列表顶部。
3、返回应用列表，长按AI助手图标，选择【应用信息】→【权限】。
4、确认已授予“读取系统设置”权限，否则无法获取系统语言状态。
5、完全退出助手App，再次启动，界面元素与语音反馈应同步匹配系统语言。
五、加载并注册新增语言包文件
当内置语言不满足需求时，可通过手动添加语言包扩展支持范围，此方法适用于开源可定制的免费助手项目。
1、进入项目locales/目录，新建文件pt-BR.js（以巴西葡萄牙语为例）。
2、在文件中定义键值对对象，格式为const ptBR = { __WELCOME_MESSAGE: 'Olá!', ... };。
3、打开locales/index.js，在const locales = { ... }对象末尾添加pt_BR: ptBR。
4、保存全部更改，在终端运行npm run build:i18n触发语言资源编译。
5、重启助手，通过URL参数?lang=pt-BR或环境变量APP_LANG=pt_BR激活新语言。
