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

# OpenClaw 本地AI网关配置老张API教程

> OpenClaw配置老张API完整教程。通过Custom Provider接入200+AI模型，支持OpenAI兼容端点，使用GPT-5.5、Claude Opus 4.7、Gemini 3.1等最新模型。

## 什么是 OpenClaw

OpenClaw 是一款开源的本地 AI 网关工具，在终端中运行，支持通过统一接口连接多种 AI 模型提供商。它内置了对 OpenAI、Anthropic、Google 等主流服务商的支持，同时也支持通过 **Custom Provider** 接入任何兼容 OpenAI 或 Anthropic 的第三方端点。

通过老张API的 Custom Provider 接入，您可以在 OpenClaw 中使用 200+ AI 模型，包括 GPT-5.5、Claude Opus 4.7、Gemini 3.1 Pro Preview 等最新模型。

## 前置准备

* 已安装 OpenClaw（参考 [OpenClaw 官方文档](https://github.com/openclaw-ai/openclaw)）
* 已注册老张API账号并获取 API 密钥（访问 [老张API令牌管理](https://api2.laozhang.ai/token)，创建新令牌，选择按量扣费，默认分组，其他保持默认即可）

## 配置步骤

### 第一步：选择 Custom Provider

启动 OpenClaw 配置向导后，在 **Model/auth provider** 列表中，滚动到底部，选择 **Custom Provider (Any OpenAI or Anthropic compatible endpoint)**。

<img src="https://mintcdn.com/laozhangai-edd05f2c/REhLpZiLbLVkByML/images/openclaw-step-1.png?fit=max&auto=format&n=REhLpZiLbLVkByML&q=85&s=72c75ee728ab629589557a591e307262" alt="OpenClaw选择Custom Provider作为模型提供商" width="1268" height="1058" data-path="images/openclaw-step-1.png" />

<Info>
  Custom Provider 支持任何兼容 OpenAI 或 Anthropic 接口的服务端点，老张API 完全兼容 OpenAI 接口格式。
</Info>

### 第二步：填写 API Base URL

在 **API Base URL** 字段中输入老张API的接口地址：

```
http://api2.laozhang.ai/v1
```

<img src="https://mintcdn.com/laozhangai-edd05f2c/REhLpZiLbLVkByML/images/openclaw-step-2.png?fit=max&auto=format&n=REhLpZiLbLVkByML&q=85&s=245edc806d2d8cde6f4b2085a12b4d97" alt="OpenClaw填写老张API的Base URL地址" width="750" height="658" data-path="images/openclaw-step-2.png" />

<Tip>
  也可以使用 `https://api2.laozhang.ai/v1`，推荐使用 HTTPS 以获得更好的安全性。
</Tip>

### 第三步：选择 API Key 提供方式

系统会询问如何提供 API Key，选择 **Paste API key now**，将密钥直接存储在 OpenClaw 配置中。

<img src="https://mintcdn.com/laozhangai-edd05f2c/REhLpZiLbLVkByML/images/openclaw-step-3.png?fit=max&auto=format&n=REhLpZiLbLVkByML&q=85&s=26261f47e01876426c5678ac66e3c71e" alt="OpenClaw选择粘贴API Key的方式" width="1086" height="780" data-path="images/openclaw-step-3.png" />

### 第四步：输入 API Key

在 **API Key** 字段中粘贴您从老张API控制台获取的密钥（格式为 `sk-` 开头的字符串）。

<img src="https://mintcdn.com/laozhangai-edd05f2c/REhLpZiLbLVkByML/images/openclaw-step-4.png?fit=max&auto=format&n=REhLpZiLbLVkByML&q=85&s=13c6db63495bbc18d6a6365fdf9eafe6" alt="OpenClaw输入老张API密钥" width="818" height="956" data-path="images/openclaw-step-4.png" />

<Info>
  API 密钥可在 [老张API令牌管理](https://api2.laozhang.ai/token) 页面创建。创建新令牌时，选择按量扣费，默认分组，其他保持默认即可。
</Info>

### 第五步：选择端点兼容模式

在 **Endpoint compatibility** 选项中，选择 **OpenAI-compatible (Uses /chat/completions)**。

<img src="https://mintcdn.com/laozhangai-edd05f2c/REhLpZiLbLVkByML/images/openclaw-step-5.png?fit=max&auto=format&n=REhLpZiLbLVkByML&q=85&s=42cc55719b9c17b81814eccab14872cf" alt="OpenClaw选择OpenAI兼容端点模式" width="1042" height="1134" data-path="images/openclaw-step-5.png" />

老张API 完全兼容 OpenAI 的 `/chat/completions` 接口，选择此选项即可。

### 第六步：设置 Model ID

在 **Model ID** 字段中输入您想使用的模型名称。

<img src="https://mintcdn.com/laozhangai-edd05f2c/REhLpZiLbLVkByML/images/openclaw-step-6.png?fit=max&auto=format&n=REhLpZiLbLVkByML&q=85&s=25b1ee756a501daed061da6110bb9ccc" alt="OpenClaw设置AI模型ID" width="1042" height="1128" data-path="images/openclaw-step-6.png" />

### 第七步：验证并完成

OpenClaw 会自动验证配置。验证成功后，系统会生成一个 **Endpoint ID**（如 `custom-api-laozhang-ai`），配置即完成。

<img src="https://mintcdn.com/laozhangai-edd05f2c/REhLpZiLbLVkByML/images/openclaw-step-7.png?fit=max&auto=format&n=REhLpZiLbLVkByML&q=85&s=16ec52c6daba5ac8b0209ef4a214cd0e" alt="OpenClaw验证成功并生成Endpoint ID" width="1172" height="1560" data-path="images/openclaw-step-7.png" />

<Info>
  验证时可能返回错误，重试即可成功。如验证持续失败，可选择 **Change model** 更换为其他模型 ID 再试。
</Info>

## 推荐模型

通过老张API，您可以在 OpenClaw 中使用以下主流模型：

| 模型系列                       | Model ID                 | 特点                 |
| -------------------------- | ------------------------ | ------------------ |
| **GPT-5.5**                | `gpt-5.5`                | OpenAI 最新旗舰模型      |
| **Claude Opus 4.7**        | `claude-opus-4-7`        | Anthropic 最强推理模型   |
| **Claude Sonnet 4.6**      | `claude-sonnet-4-6`      | 平衡性能与成本            |
| **Gemini 3.1 Pro Preview** | `gemini-3.1-pro-preview` | Google 最新 Pro 预览模型 |
| **Gemini 3 Flash Preview** | `gemini-3-flash-preview` | 快速响应，多模态能力强        |
| **GPT-4.1 Mini**           | `gpt-4.1-mini`           | 经典稳定，速度快           |

<Tip>
  **模型选择建议**

  * 复杂编程任务：推荐 `claude-opus-4-7` 或 `gpt-5.5`
  * 日常对话：推荐 `gpt-5.5` 或 `gpt-4.1-mini`
  * 多模态任务：推荐 `gemini-3.1-pro-preview`
  * 成本控制优先：推荐 `claude-sonnet-4-6`
</Tip>

## 配置总结

完成配置后，您的 OpenClaw 关键参数如下：

| 配置项                    | 值                            |
| ---------------------- | ---------------------------- |
| Provider               | Custom Provider              |
| API Base URL           | `http://api2.laozhang.ai/v1` |
| Endpoint Compatibility | OpenAI-compatible            |
| Endpoint ID            | `custom-api-laozhang-ai`     |

## 故障排除

### 验证返回错误

验证时可能返回错误，重试即可成功。

### 连接超时

* 检查网络连接是否正常
* 确认 API Base URL 是否正确填写
* 尝试使用 `https://api2.laozhang.ai/v1`

### 模型调用失败

* 确认账户余额充足
* 检查 Model ID 是否拼写正确
* 在 [老张API日志页面](https://api2.laozhang.ai/log) 查看调用日志排查问题

需要更多帮助？请访问 [老张API官网](https://api2.laozhang.ai)。