2026-03-19 - OpenClaw API 配置问题修复复盘

📋 问题现象

QQ 机器人回复卡顿/无响应
StepFun API 调用失败 (HTTP 503 错误)
日志中持续出现 upstream error (status 503)

🔍 诊断过程

1. 系统检查

系统资源充足 (内存 3.8GB，磁盘 40GB)
OpenClaw Gateway 运行正常
所有插件已加载 (qqbot, stepfun, lark, wecom, dingtalk)

2. API 连通性测试

# 测试不同 endpoint
https://chatapi.stepfun.com/chatapi/v1 → 404
https://api.stepfun.com/v1 → 401 (invalid_api_key)

发现配置中的 baseUrl https://chatapi.stepfun.com/chatapi/v1 已废弃。

3. 环境变量冲突

发现环境变量覆盖了配置文件：

STEPFUN_BASE_URL='https://chatapi.stepfun.com/chatapi/v1'  # 错误的

环境变量优先级高于 openclaw.json，导致修改配置文件无效。

4. 正确配置

经过测试，正确的 endpoint 是：

https://api.stepfun.com/v1

✅ 解决方案

更新环境变量 (/etc/environment):

- STEPFUN_BASE_URL='https://chatapi.stepfun.com/chatapi/v1'
+ STEPFUN_BASE_URL='https://api.stepfun.com/v1'

同步更新配置文件 (openclaw.json):

"models": {
  "providers": {
    "stepfun_api": {
      "baseUrl": "https://api.stepfun.com/v1",

重启服务:
```
openclaw gateway restart
```

📊 结果

API 调用恢复正常
QQ 机器人响应速度恢复正常
不再出现 503 错误

🎓 学到的经验

配置优先级顺序

环境变量 (最高)
openclaw.json
默认值

诊断技巧

使用 openclaw config get 查看实际生效的配置
使用 printenv 检查环境变量
查看 /etc/environment 和 systemd service 文件

安全建议

敏感配置 (API keys) 应使用环境变量或密钥管理
定期检查端点 URL 是否变更
保持配置文件与环境变量同步

🔧 推荐配置规范

# /etc/environment (或 systemd service Environment 字段)
STEPFUN_BASE_URL="https://api.stepfun.com/v1"
STEPFUN_API_KEY="sk-xxxxx"
PRIMARY_MODEL="stepfun_api/step-3.5-flash"

# openclaw.json (应与环境变量一致)
{
  "models": {
    "providers": {
      "stepfun_api": {
        "baseUrl": "https://api.stepfun.com/v1",
        "apiKey": "sk-xxxxx"
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "stepfun_api/step-3.5-flash"
      }
    }
  }
}

复盘时间: 2026-03-19 19:20
状态: 已解决 ✓

OpenClaw 自检修复复盘：API 配置问题