Xikapi 接入文档

配置 Xikapi 模型 ​

OpenClaw 支持通过 models.providers 添加自定义 OpenAI 兼容模型供应商。可以把 Xikapi 配置成一个独立 provider，让 OpenClaw 统一调用 Xikapi 中启用的模型。

基础配置 ​

示例配置：

js
{
  env: {
    XIKAPI_API_KEY: "YOUR_XIKAPI_API_KEY"
  },
  agents: {
    defaults: {
      model: {
        primary: "xikapi/YOUR_MODEL_ID"
      }
    }
  },
  models: {
    mode: "merge",
    providers: {
      xikapi: {
        baseUrl: "https://xikapi.com/v1",
        apiKey: "${XIKAPI_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "YOUR_MODEL_ID",
            name: "My Xikapi model"
          }
        ]
      }
    }
  }
}

把 YOUR_MODEL_ID 替换为你在 Xikapi 后台已启用的模型名称。

生产环境不建议把真实 Xikapi API Key 明文写进公开配置文件。可以先用环境变量完成验证，随后按 密钥与安全配置 迁移到 SecretRef 或受保护的密钥文件。

模型引用格式 ​

OpenClaw 中的模型引用格式为：

text
provider/model-name

例如：

text
xikapi/YOUR_MODEL_ID

验证模型 ​

配置完成后执行：

bash
openclaw models list
openclaw models status

如果可以看到 xikapi/... 模型，说明模型配置已被 OpenClaw 识别。

也可以切换默认模型：

bash
openclaw models set xikapi/YOUR_MODEL_ID

模型不可用时检查 ​

  • Xikapi API Key 是否正确
  • baseUrl 是否为 https://xikapi.com/v1
  • 模型名是否已在 Xikapi 后台启用
  • 模型引用是否包含 provider 前缀，例如 xikapi/YOUR_MODEL_ID
  • 当前令牌是否有对应模型权限

工具调用注意 ​

OpenClaw 对 OpenAI 兼容服务通常使用 openai-completions 模式。不同上游模型对工具调用、视觉输入和结构化输出的支持并不完全一致，建议先用文本模型完成基础验证，再逐项测试工具调用和图片输入。

参考链接 ​