OpenClaw全栈中文支持实测指南：装完就能用的本地AI助手

你试过本地AI助手，点开界面全是英文？报错信息看不懂？文档要翻墙查？CLI提示词像天书？中文开发者卡在第一步。

OpenClaw（v0.12.0+）已实现全链路中文支持：GUI界面、错误弹窗、CLI命令提示、官方文档、日志输出全部原生汉化。不依赖翻译插件，不改源码，一键切换中英文。

安装（Mac/Linux一键）

curl -fsSL https://raw.githubusercontent.com/petersteinberger/OpenClaw/main/install.sh | bash

脚本自动检测系统、下载预编译二进制、配置PATH，并默认启用中文语言包——基于系统区域设置，开箱即用。

启动并确认语言

openclaw --version  # 输出含"v0.12.3 (中文版)"
openclaw --gui      # 界面右上角显示「简体中文」标识

手动切换中英文（随时生效）

# 切换为英文
openclaw --lang en --gui

# 切换回中文（推荐存为别名）
echo "alias oc-cn='openclaw --lang zh'" >> ~/.zshrc && source ~/.zshrc
oc-cn --gui

--lang 参数在启动时覆盖系统语言设置，不用重启系统或改系统区域。

验证中文可用性

• 在GUI中输入：“帮我写一个Python函数，计算列表平均值” → 返回带中文注释的代码
• 故意输错命令：openclaw --mode=xxx → 弹窗提示：“错误：不支持的运行模式 'xxx'。可选值：'agent', 'chat', 'cli'”
• 查看文档：浏览器打开 http://localhost:8080/docs → 全页中文，含中文API示例和错误码表

👉 Binance · OKX · Gate.io · HTX · Bitget

实测效果

用中文提问：“把当前目录下所有.py文件打包成zip”，OpenClaw调用Shell执行成功，日志输出：

✅ 已生成 archive_20240520.zip（3个文件）

无乱码、无漏译、无英文残留。

常见问题

• Q：Windows怎么装？
  A：下载 OpenClaw-v0.12.3-win-x64.zip，解压后双击 openclaw.exe，首次运行自动弹出中文向导。
• Q：切换语言后GUI没变？
  A：关闭所有OpenClaw进程（任务管理器 / pkill openclaw），再用 --lang 重启。GUI不支持热更新语言。
• Q：CLI里中文路径报错？
  A：确保终端编码为UTF-8（Mac/Linux默认支持；Windows需在CMD属性→字体→勾选“UTF-8”）。

OpenClaw的中文不是“勉强能看”。错误提示直指问题，比如：

“未找到配置文件 config.yaml，请先运行 openclaw init”

而不是抛出 FileNotFoundError。

下一步：试试用OpenClaw + 本地Ollama（Qwen2-Chinese）搭建离线中文Agent：《Ollama+OpenClaw：零GPU跑通中文自主工作流》