AionClaw中文乱码主因是UTF-8文件被GBK等窄编码错误解析，需先确认文件编码为UTF-8 with BOM，再在config.yaml中显式声明server和gateway的UTF-8编解码参数，并完整重启服务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你在AionClaw中修改config.yaml、skills.json或自定义脚本后，保存再重启服务，发现中文显示为“æçæè½”或方框问号，说明文件编码被错误写入或读取——这不是字体问题，而是UTF-8字节序列被当作GBK等窄编码解析所致。
确认原始文件是否已损坏
先别急着重写。打开你刚修改的文件（如config.yaml），用VS Code、Notepad++或Sublime Text打开，右下角查看当前识别的编码。若显示“GBK”“GB2312”或“Windows 1252”，【说明文件已被错误另存，原始中文字节已丢失】。此时立即停止保存操作，从备份或Git历史中恢复上一版。
若右下角显示“UTF-8”且文字正常，但AionClaw仍乱码，则问题出在读取环节，继续下一步。
Windows下强制启用UTF-8代码页并加BOM
Windows命令行和部分编辑器默认用GBK读取无BOM的UTF-8文件，AionClaw继承该行为，导致配置项中的中文路径、提示语全数错解。
方法一：用VS Code修复文件编码
① 在VS Code中打开该文件→点击右下角编码名称（如UTF-8）→选择“Save with Encoding”→选“UTF-8 with BOM”。
② 保存后关闭再重新打开，确认右下角显示“UTF-8 with BOM”。
③ 重启AionClaw服务，乱码应消失。
方法二：用记事本另存（仅限简单文本，慎用于YAML/JSON）
用记事本打开→“文件→另存为”→在“编码”下拉菜单中【必须选“UTF-8”】（不是“ANSI”也不是“Unicode”），点击保存。注意：记事本的“UTF-8”实际是带BOM的，但会破坏YAML缩进，不推荐用于结构化配置文件。
Linux/macOS下检查环境与文件双重UTF-8
类Unix系统虽默认支持UTF-8，但AionClaw若由systemd或shell脚本启动，可能未继承正确的locale。
第一步：确认文件本身是UTF-8
执行：file -i config.yaml，输出中应含 charset=utf-8。若为 charset=us-ascii 或 charset=unknown-8bit，说明文件不含中文或编码异常。
通过 Claw Post API 发布到 X（Twitter）、LinkedIn、Facebook 和 TikTok。搜索 Facebook 群组，加入并向其发布内容。适用于用户想要发布内容时。
第二步：强制启动时指定locale
不要只改系统全局locale。在启动AionClaw前运行：export LANG=en_US.UTF-8 LC_ALL=en_US.UTF-8，再执行启动命令。这能确保进程内所有I/O模块统一按UTF-8解析字节流。
第三步：验证AionClaw日志输出
启动后查看logs目录下的latest.log，搜索中文关键词。若日志中中文正常，但Web界面仍乱码，问题转向前端响应头或浏览器缓存，跳过此节直接查浏览器设置。
检查AionClaw配置文件中的encoding字段
AionClaw基于OpenClaw框架，其config.yaml中server与gateway模块支持显式编码声明。若缺失，将回退至系统默认，极易引发中文解析失败。
打开config.yaml，在server:下方添加：
encoding: "UTF-8"
charset: "utf-8"
在gateway:区块下补充：
request_encoding: "UTF-8"
response_encoding: "UTF-8"
保存后必须【完整重启AionClaw主进程，不能仅刷新网页】。热重载不加载encoding新配置。
