← 返回首页

API Key 配置失败

无法获取 API Key 或 Key 额度不足

❌ 常见错误
# 错误1: Invalid API key
Error: Invalid API key provided

# 错误2: 额度不足
Error: Insufficient credits

# 错误3: 模型不支持
Error: Model not supported

推荐的 API 提供商

平台特点网址
硅基流动 国内直连,免费额度多 cloud.siliconflow.cn
DeepSeek 性价比高 platform.deepseek.com
智谱 AI GLM 模型,新用户送 Tokens bigmodel.cn
阿里云百炼 新用户免费额度 aliyun.com

配置步骤

1. 获取 API Key

以硅基流动为例:

  1. 访问 cloud.siliconflow.cn
  2. 注册/登录账号
  3. 进入「API 密钥」页面
  4. 点击「新建密钥」
  5. 复制生成的 Key

2. 配置 OpenClaw

# 方式1: 交互式配置
openclaw config
# 方式2: 直接编辑配置
nano ~/.openclaw/openclaw.json
# 配置示例
{
  "models": {
    "default": {
      "provider": "siliconflow",
      "model": "Qwen/Qwen2.5-7B-Instruct",
      "apiKey": "sk-xxxxxxxxxxxx"
    }
  }
}

验证配置

# 测试 API 连接
openclaw test

# 或查看日志
openclaw logs

常见问题

Q: API Key 无效?

检查 Key 是否复制完整,不要有空格或换行

Q: 额度用完了?

登录对应平台充值或换用其他免费平台

Q: 模型不支持?

使用平台支持的模型名称,可参考平台文档