模型配置指南

🤖 大模型配置指南

OpenClaw 支持多种大模型，本教程将指导你如何配置国内常用的大模型 API。

🔑 DeepSeek API 配置

第一步：获取 API Key

1. 访问 DeepSeek 平台
2. 注册账号并登录
3. 进入"API Keys"页面
4. 点击"Create new API Key"
5. 复制生成的 API Key

第二步：配置 OpenClaw

# 编辑 OpenClaw 配置文件
# 路径：~/.openclaw/config.yaml

# 设置默认模型为 DeepSeek
model: "deepseek/deepseek-chat"

# 配置 DeepSeek API
providers:
  deepseek:
    api_key: "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    base_url: "https://api.deepseek.com"
    model: "deepseek-chat"
    
# 可选：设置备用模型
fallback_models:
  - "deepseek/deepseek-chat"
  - "gpt-3.5-turbo"

第三步：测试连接

# 测试 DeepSeek API 连接
openclaw test-model deepseek

# 发送测试消息
openclaw chat "你好，测试一下连接"

🎤 讯飞星辰 API 配置

第一步：注册讯飞开放平台

1. 访问 讯飞开放平台
2. 注册企业账号
3. 完成实名认证

第二步：创建应用

应用名称：OpenClaw AI助手
应用描述：智能AI助手平台
应用平台：Web应用

第三步：获取 API 凭证

AppID: xxxxxxxx
API Key: xxxxxxxxxxxxxxxxxxxxxxxx
API Secret: xxxxxxxxxxxxxxxxxxxxxxxx

第四步：配置 OpenClaw

# 配置讯飞星辰 API
providers:
  xunfei:
    app_id: "xxxxxxxx"
    api_key: "xxxxxxxxxxxxxxxxxxxxxxxx"
    api_secret: "xxxxxxxxxxxxxxxxxxxxxxxx"
    base_url: "https://spark-api.xf-yun.com"
    model: "generalv3"

🔄 多模型切换

配置多个模型

# 配置多个模型提供商
providers:
  deepseek:
    api_key: "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    base_url: "https://api.deepseek.com"
    model: "deepseek-chat"
    
  xunfei:
    app_id: "xxxxxxxx"
    api_key: "xxxxxxxxxxxxxxxxxxxxxxxx"
    api_secret: "xxxxxxxxxxxxxxxxxxxxxxxx"
    base_url: "https://spark-api.xf-yun.com"
    model: "generalv3"
    
  zhipu:
    api_key: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    base_url: "https://open.bigmodel.cn"
    model: "glm-4"

设置默认模型

# 设置默认模型
model: "deepseek/deepseek-chat"

# 或者使用环境变量
export OPENCLAW_MODEL="xunfei/generalv3"

动态切换模型

# 在对话中切换模型
openclaw chat --model "xunfei/generalv3" "你好，使用讯飞模型"

# 或者在代码中切换
const model = "deepseek/deepseek-chat";

⚙️ 高级配置

模型参数调优

# 调整模型参数
providers:
  deepseek:
    api_key: "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    base_url: "https://api.deepseek.com"
    model: "deepseek-chat"
    parameters:
      temperature: 0.7
      max_tokens: 2000
      top_p: 0.9

代理配置

# 配置代理（如果需要）
providers:
  deepseek:
    api_key: "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    base_url: "https://api.deepseek.com"
    model: "deepseek-chat"
    proxy:
      host: "127.0.0.1"
      port: 7890

负载均衡

# 配置多个 API Key 实现负载均衡
providers:
  deepseek:
    api_keys:
      - "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      - "sk-yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy"
      - "sk-zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz"
    base_url: "https://api.deepseek.com"
    model: "deepseek-chat"
    strategy: "round-robin"

🔧 故障排除

常见问题

• API Key 无效：检查 API Key 是否正确，是否过期
• 连接超时：检查网络连接，确认 API 地址正确
• 额度不足：检查 API 调用额度是否用完
• 模型不可用：检查模型名称是否正确

调试方法

# 启用调试模式
openclaw --debug chat "测试消息"

# 查看详细日志
tail -f ~/.openclaw/logs/openclaw.log

# 测试 API 连接
curl -X POST https://api.deepseek.com/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-chat","messages":[{"role":"user","content":"Hello"}]}'