OpenClaw 中文使用指南：国内用户必知的配置技巧与最佳实践

# 安装 Ollama
brew install ollama  # macOS
# Linux: curl -fsSL https://ollama.com/install.sh | sh

# 下载中文优化模型（推荐 qwen2.5）
ollama pull qwen2.5:7b   # 7B 参数，约 4.7GB，适合 16GB 内存
ollama pull qwen2.5:14b  # 14B 参数，约 8.9GB，适合 32GB 内存

# 配置 OpenClaw 使用 Ollama
openclaw config set agents.defaults.model "qwen2.5:7b"
openclaw config set providers.ollama.baseUrl "http://localhost:11434"

# Google AI Studio 注册免费账号，获取 API Key
# 地址：aistudio.google.com

openclaw configure
# 选择 Google Gemini
# 输入 API Key
# 推荐模型：gemini-2.0-flash（超高性价比，中文表现好）

# 配置 Anthropic
openclaw configure
# 选择 Anthropic
# 输入 API Key（在 console.anthropic.com 获取）

# SOUL.md

你是「小助」，一个专注帮助中文用户的 AI 助手。

## 语言规范
- **默认用简体中文回复**
- 技术术语保留英文（API、Token、Claude Code 等）
- 代码注释可以用中文，提高可读性
- 如果用户用英文提问，用英文回复

## 回复风格
- 简洁：不用「您好，我是您的 AI 助手，很高兴为您服务...」
- 直接给答案，背景知识按需补充
- 代码示例优先用 Python（国内用户最熟悉）

## 本地化注意
- 时区：北京时间（UTC+8）
- 日期格式：YYYY-MM-DD 或 MM月DD日
- 货币默认用人民币（¥），除非另有说明

# 在 QQ 开放平台注册应用获取 AppID 和 Token
# https://q.qq.com/

openclaw configure --section channels.qq
# 输入 AppID 和 AppSecret

{
  channels: {
    qq: {
      appId: "你的QQ AppID",
      token: "你的Token",
      allowFrom: ["QQ号1", "QQ号2"],
    }
  }
}

# 在飞书开放平台创建应用
# https://open.feishu.cn/

openclaw configure --section channels.lark

{
  channels: {
    lark: {
      appId: "cli_xxx",
      appSecret: "xxx",
      verificationToken: "xxx",
    }
  }
}

# 冗余写法（消耗更多 Token）
你是一个非常专业、经验丰富、知识渊博的 AI 助手，
具有超过 10 年的软件开发经验，能够帮助用户解决各种技术问题...

# 精简写法（效果相同，Token 少 60%）
你是资深工程师助手。Python/Go 专长。简洁直接。

{
  agents: {
    defaults: {
      session: {
        compression: {
          enabled: true,
          triggerTokens: 60000  // 中文对话建议设低一点
        }
      }
    }
  }
}

{
  agents: {
    defaults: {
      // 普通对话用 haiku（便宜 12 倍）
      model: "claude-haiku-3-5",
    }
  }
}

{
  agents: {
    defaults: {
      timezone: "Asia/Shanghai"  // 确保 Cron 任务按北京时间执行
    }
  }
}