openclaw中文乱码需分平台排查：一查配置文件编码字段；二在linux/macos设lang=en_us.utf-8；三在windows用chcp 65001并保存带bom的utf-8文件；四可修改源码强制指定utf-8解码；五可用iconv统一转码配置文件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
一、确认OpenClaw当前使用的文本编码
OpenClaw默认可能采用系统本地编码读取配置文件或日志内容，若源文件实际为UTF-8而系统环境使用GBK（如Windows中文版），则会触发中文显示为或方块等乱码现象。需先验证其内部解析所依赖的编码参数。
1、打开OpenClaw安装目录下的config.yaml或settings.json文件。
2、查找是否存在encoding、text_encoding或charset字段。
3、若字段值为空或为system、default，则表示未显式指定编码，将交由操作系统决定。
二、Linux/macOS下强制指定UTF-8环境变量
在类Unix系统中，OpenClaw进程继承shell的locale设置；若LANG未设为UTF-8兼容值，会导致文件读取与终端输出双重乱码。通过预设环境变量可覆盖默认行为。
1、在启动OpenClaw前，于终端执行：export LANG=en_US.UTF-8。
2、确认生效：locale | grep -i encoding，输出中CHARMAP应为UTF-8。
3、以该环境运行OpenClaw：LANG=zh_CN.UTF-8 ./openclaw --no-gui（或对应可执行文件名）。
三、Windows平台修改控制台代码页并配置BOM
Windows命令提示符默认使用GBK（CP936），而OpenClaw若直接读取无BOM的UTF-8配置文件，会误判为ANSI，造成配置项中的中文路径或标签解析失败。
1、以管理员身份运行CMD，输入：chcp 65001，切换当前会话为UTF-8代码页。
发布后文档同步技能，自动将 README/ARCHITECTURE/CONTRIBUTING/CLAUDE.md 与实际变更对齐，清理待办事项，完善变更记录。
2、用记事本以外的编辑器（如VS Code）打开config.yaml，另存为UTF-8 with BOM格式。
3、在OpenClaw启动脚本（如start.bat）首行添加：@chcp 65001 >nul。
四、修改OpenClaw源码级编码声明（适用于自编译用户）
若使用源码构建OpenClaw，可在关键I/O模块（如file_io.cpp或yaml_loader.py）中硬编码指定解码方式，绕过系统自动探测逻辑。
1、定位到读取配置文件的函数，例如Python中yaml.safe_load(open(path))调用处。
2、将其替换为显式编码声明：yaml.safe_load(open(path, encoding='utf-8'))。
3、C++项目中，在std::ifstream构造后立即调用.imbue(std::locale(std::locale(), new std::codecvt_utf8<wchar_t>))</wchar_t>。
五、使用中间配置转换工具预处理文件
当无法修改OpenClaw自身行为且跨平台分发配置时，可借助外部工具统一转码，确保所有系统均接收一致的字节序列输入。
1、下载轻量工具iconv（macOS/Linux内置，Windows可通过MSYS2或Git Bash获取）。
2、执行转换命令：iconv -f GBK -t UTF-8 config_old.yaml -o config.yaml（根据原始编码调整-f参数）。
3、验证转换结果：file -i config.yaml（Linux/macOS）或用VS Code查看右下角编码标识，确认显示UTF-8且无乱码字符。
