OpenClaw 接入 AI快站配置教程

OpenClaw 可以通过 models.providers 添加自定义 OpenAI Compatible 提供商。不要直接覆盖内置 openai 提供商；为 AI快站使用独立 provider ID，后续排错和切换会更清楚。

开始前检查

1. 使用 AI快站 Key 请求 /v1/models，复制真实模型 ID。
2. 确认目标模型使用 Chat Completions 还是 Responses API。
3. 为 OpenClaw 创建独立 API Key，并保存为环境变量。

export AIFAST_API_KEY="你的_API_Key"

配置步骤

在 OpenClaw 配置中合并一个独立提供商。以下示例适用于支持 /v1/chat/completions 的模型：

{
  models: {
    mode: "merge",
    providers: {
      aifast: {
        baseUrl: "https://www.aifast.club/v1",
        apiKey: "${AIFAST_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "YOUR_MODEL_ID",
            name: "AI快站模型"
          }
        ]
      }
    }
  },
  agents: {
    defaults: {
      model: {
        primary: "aifast/YOUR_MODEL_ID"
      }
    }
  }
}

将两处 YOUR_MODEL_ID 替换成 /v1/models 返回的同一个模型 ID。

选择正确的 API 适配器

只有在目标模型和兼容层实际支持 /v1/responses 时，才使用 openai-responses。不要仅根据模型名称判断。

验证模型是否注册

配置后使用 OpenClaw 的模型列表或状态命令确认：

• provider 显示为 aifast。
• 模型路由显示为 aifast/YOUR_MODEL_ID。
• 最终请求地址没有出现 /v1/v1。

然后运行一个不涉及敏感文件的短任务，确认普通文本、流式输出和工具调用分别可用。

常见问题

模型已显示，但请求返回 model not found

OpenClaw 本地模型目录注册成功，不代表上游接受这个模型名。再次调用 AI快站 /v1/models，核对大小写、前缀和账号开放状态。

普通聊天成功，工具调用失败

基础文本请求只能证明 Chat Completions 可用。工具调用还依赖模型能力、兼容层事件格式和 OpenClaw 适配器。先保存完整错误正文，不要盲目切换提示词。

配置后仍使用旧模型

确认 agents.defaults.model.primary 已指向 aifast/YOUR_MODEL_ID，并检查当前 Agent 是否有单独的模型覆盖配置。

下一步

接入成功后，为 OpenClaw 单独设置 Key 限额，并测试只读工具、写文件工具、长任务和 429 限流恢复。涉及浏览器、Shell 或文件权限时，还要单独审查工具授权范围。