> ## Documentation Index
> Fetch the complete documentation index at: https://doc.geekapis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 在 OpenClaw 中配置 即刻API，5 步完成初始化

> OpenClaw 配置即刻API 指南：运行 openclaw onboard，选择 Custom Provider，设置 API Base URL，填写 API Key，5 步完成向导配置。

OpenClaw 是一款 AI 编程助手工具，支持自定义 API 提供商。通过 `openclaw onboard` 交互式向导，您可以快速将 即刻API 配置为后端，使用 Claude、Qwen、Kimi 等多种模型。

## 准备工作

在开始之前，请确保：

1. **已安装 OpenClaw** — 下载并安装 OpenClaw，安装完成后可在终端中运行 `openclaw` 命令
2. **已获取 即刻API API 密钥** — 登录 [即刻API 控制台](https://geekapis.com/dashboard/overview) 获取您的 API 密钥（以 `sk-` 开头）

<Tip>
  如果还没有 即刻API 账户，请先在 [即刻API](https://geekapis.com) 注册并获取 API 密钥。
</Tip>

## 配置步骤

在终端中运行以下命令启动初始化向导：

```bash theme={null}
openclaw onboard
```

按照提示依次完成以下 5 个步骤：

<Steps>
  <Step title="选择模型/认证提供商">
    向导将显示以下提示：

    ```text theme={null}
    Model/auth provider:
    ```

    使用**方向键**选择 **Custom Provider**，然后按回车确认。
  </Step>

  <Step title="填写 API Base URL">
    向导将显示以下提示：

    ```text theme={null}
    API Base URL:
    ```

    输入以下地址：

    ```text theme={null}
    https://geekapis.com/v1
    ```

    <Note>
      URL 末尾需包含 `/v1` 后缀。
    </Note>
  </Step>

  <Step title="填写 API Key">
    向导将显示以下提示：

    ```text theme={null}
    API Key:
    ```

    粘贴您从 [即刻API 控制台](https://geekapis.com/dashboard/overview) 获取的 API 密钥（`sk-xxxxxxxxxxxx`）。
  </Step>

  <Step title="选择端点兼容性">
    向导将显示以下提示：

    ```text theme={null}
    Endpoint compatibility:
    ```

    使用**方向键**选择 **OpenAI-compatible**，然后按回车确认。
  </Step>

  <Step title="填写模型 ID">
    向导将显示以下提示：

    ```text theme={null}
    Model ID:
    ```

    输入您要使用的模型 ID，例如：

    ```text theme={null}
    claude-sonnet-4-6
    ```

    完成以上步骤后，OpenClaw 将使用 即刻API 作为后端服务。您可以直接开始使用 AI 对话功能，所有请求将通过 即刻API 路由到对应的模型。
  </Step>
</Steps>

## 推荐模型

| 模型名称              | 模型 ID               | 特点                    |
| ----------------- | ------------------- | --------------------- |
| Claude Sonnet 4.6 | `claude-sonnet-4-6` | 性能与成本最佳平衡，适合大多数场景     |
| Claude Opus 4.6   | `claude-opus-4-6`   | 最强大的 Claude 模型，适合复杂任务 |
| Claude Haiku 4.5  | `claude-haiku-4-5`  | 快速且经济，适合轻量任务          |
| Qwen3 Max         | `qwen3-max`         | 阿里云旗舰推理模型             |
| Kimi K2.5         | `kimi-k2.5`         | 月之暗面长上下文模型            |

## 常见问题

<AccordionGroup>
  <Accordion title="认证失败？">
    * 确认 API Key 正确且以 `sk-` 开头
    * 在 [即刻API 控制台](https://geekapis.com/dashboard/overview) 检查密钥是否有效
    * 确保账户余额充足
  </Accordion>

  <Accordion title="模型不可用？">
    * 确认 API Base URL 填写为 `https://geekapis.com/v1`（包含 `/v1` 后缀）
    * 确认 Endpoint compatibility 选择了 **OpenAI-compatible**
    * 检查模型 ID 是否拼写正确，可在 [即刻API 模型列表](https://geekapis.com/pricing) 查询所有可用模型 ID
  </Accordion>
</AccordionGroup>