Linux/macOS

AI小龙虾OpenClaw的中文配置方法如下：

基础配置

环境变量设置

export OPENCLAW_CHARSET=UTF-8
# Windows（命令提示符）
set OPENCLAW_LANG=zh_CN
set OPENCLAW_CHARSET=UTF-8

配置文件修改

找到安装目录下的 config.ini 或 settings.json：

# config.ini示例
[Language]
locale = zh_CN
encoding = utf-8
[Display]
language = chinese
timezone = Asia/Shanghai

// settings.json示例
{
  "language": "zh_CN",
  "region": "CN",
  "time_format": "24h",
  "date_format": "YYYY-MM-DD"
}

界面汉化

下载语言包

# 从官方仓库下载中文语言包
git clone https://github.com/openclaw/l10n-zh_CN.git
# 或使用包管理器
pip install openclaw-l10n-zh

安装语言包

# 方法一：复制语言文件
cp -r l10n-zh_CN/* /usr/share/openclaw/locale/zh_CN/
# 方法二：使用安装脚本
python install_l10n.py --language zh_CN

中文输入支持

输入法配置

# 在openclaw的启动脚本中添加
import sys
sys.path.append('/path/to/openclaw')
# 设置中文输入法
os.environ['GTK_IM_MODULE'] = 'fcitx'  # Linux
os.environ['QT_IM_MODULE'] = 'fcitx'

字体设置

/* 修改CSS配置文件 */
:root {
  --font-family: "Noto Sans CJK SC", "Microsoft YaHei", sans-serif;
  --font-size: 14px;
}

高级配置

Docker容器配置

# Dockerfile中添加
ENV LANG=zh_CN.UTF-8
ENV LANGUAGE=zh_CN:zh
ENV LC_ALL=zh_CN.UTF-8
RUN apt-get update && apt-get install -y \
    fonts-noto-cjk \
    locales
RUN locale-gen zh_CN.UTF-8

Web界面配置

// 前端配置文件
const config = {
  i18n: {
    locale: 'zh-CN',
    fallbackLocale: 'zh-CN',
    messages: {
      zh: require('./locales/zh-CN.json')
    }
  }
}

常见问题解决

乱码问题

# 检查系统编码
echo $LANG
# 临时解决
export PYTHONIOENCODING=utf-8
# 永久修改
sudo localedef -c -f UTF-8 -i zh_CN zh_CN.UTF-8

字体缺失

# 安装中文字体
# Ubuntu/Debian
sudo apt install fonts-noto-cjk
# CentOS/RHEL
sudo yum install google-noto-sans-cjk-fonts
# macOS
brew tap homebrew/cask-fonts
brew install font-noto-sans-cjk

中文路径支持

# 在Python脚本开头添加
import sys
import os
if sys.platform == 'win32':
    import win32api
    sys.argv = [win32api.GetLongPathName(arg) for arg in sys.argv]

验证配置

# 查看当前语言设置
openclaw --version --language
# 测试中文显示
echo "测试中文显示" | openclaw --test
# 检查依赖
openclaw --check-dependencies

注意事项

1. 确保系统已安装中文语言包
2. 配置文件路径可能因安装方式不同而变化
3. 部分功能可能需要重启服务生效
4. 建议备份原始配置文件

如果遇到问题,可以查看日志文件：

tail -f /var/log/openclaw/error.log

具体配置可能因版本而异,建议参考官方文档中的本地化部分。

标签： macOS