一人一器
  • 简体中文

    • OpenClaw

    OpenClaw 支持自定义 OpenAI 或 Anthropic 兼容 Provider。Geekit 可通过 Chat Completions、Responses 或 Messages 接入；为代码 Agent 模型配置时，优先选择模型原生支持的协议。

    核验日期：2026-07-27

    前置条件

    • 已按 OpenClaw 官方安装教程安装或更新客户端，或已有可使用的实例。
    • 已取得 Geekit 根地址、用户令牌和模型 ID。
    • 已确认模型支持所需的工具调用、上下文和输入类型。

    按照快速开始第一步永久设置 GEEKIT_API_KEY，变量值替换为生成的真实 Geekit 令牌。不要只在当前终端临时执行 export。

    配置 Responses

    编辑用户配置 ~/.openclaw/openclaw.json。下面是一个最小 JSON5 示例：

    {
  agents: {
    defaults: {
      model: {
        primary: "geekit/<Geekit 模型 ID>",
      },
    },
  },
  models: {
    mode: "merge",
    providers: {
      geekit: {
        baseUrl: "https://geekit.yryq.top/v1",
        apiKey: "${GEEKIT_API_KEY}",
        api: "openai-responses",
        models: [
          {
            id: "<Geekit 模型 ID>",
            name: "Geekit",
            input: ["text"],
            contextWindow: 128000,
            maxTokens: 32000,
          },
        ],
      },
    },
  },
}

    contextWindow、maxTokens 和 input 只是结构示例，必须按真实模型能力填写。不要为纯文本模型声明图片输入，也不要把网关限制误写成模型上限。

    切换协议

    模型协议apibaseUrl
    OpenAI Responsesopenai-responseshttps://geekit.yryq.top/v1
    OpenAI Chat Completionsopenai-completionshttps://geekit.yryq.top/v1
    Anthropic Messagesanthropic-messageshttps://geekit.yryq.top

    省略 api 时通常会走 Chat Completions。需要 Responses 时必须显式填写 openai-responses；Claude 模型使用 Messages 时，Base URL 不要附加 /v1。

    校验与试用

    修改后先运行配置校验：

    openclaw config validate

    校验通过后，在 OpenClaw 中执行一个最小只读任务，并同时检查 Geekit 调用日志：

    1. 请求端点与 api 一致。
    2. 模型 ID 与 models[] 中登记的 ID 一致。
    3. 流式输出能完整结束。
    4. 工具调用返回结构没有被当成普通文本。

    OpenClaw 会严格校验配置字段和类型。遇到启动失败时，先处理 config validate 的错误，不要通过删除模型能力字段绕过真实配置问题。

    常见问题

    返回 404

    检查协议和 Base URL 是否成对匹配。Chat 与 Responses 使用 /v1 Base URL，Messages 使用根地址。

    文本可用但工具调用失败

    确认所选模型原生支持当前协议下的工具调用。切换 api 只能改变请求协议，不能给模型增加能力。

    修改后仍使用旧模型

    确认 agents.defaults.model.primary 使用 Provider ID/模型 ID 形式，并重新启动现有会话。

    官方资料