---
title: OpenClaw
description: 在 OpenClaw 中添加 VC 自定义服务商，选择模型并开启个人 Agent 会话。
---

使用支持 Chat Completions 和工具调用的文本模型分组。VC API Key 与 OpenClaw 网关自身的访问令牌是两项不同的凭据。

## 安装与配置向导

按 [OpenClaw 官方安装说明](https://docs.openclaw.ai/start/getting-started)安装客户端，然后在终端执行：

```bash
openclaw onboard
```

在模型认证步骤选择自定义服务商（Custom Provider），填写：

| 项目 | 内容 |
| --- | --- |
| Provider ID | `vc` |
| 兼容协议 | OpenAI compatible / Chat Completions |
| Base URL | `https://sub.vcnovb.cn/v1` |
| API Key | 你的 VC API Key |
| Model ID | 当前 Key 的可用文本模型 ID |

根据所选模型填写上下文长度与输入类型，保存后选择 `vc/模型ID`。消息平台和其他可选功能可以在完成普通对话后再配置。

## 已安装用户的配置文件

也可以将下面内容合并到用户目录的 `.openclaw/openclaw.json`。将两处 `YOUR_MODEL_ID` 替换为相同的可用模型 ID，保留已有的网关、频道和其他配置。

```json
{
  "models": {
    "mode": "merge",
    "providers": {
      "vc": {
        "baseUrl": "https://sub.vcnovb.cn/v1",
        "apiKey": "${VC_API_KEY}",
        "api": "openai-completions",
        "models": [
          {"id": "YOUR_MODEL_ID", "name": "VC 编程模型"}
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {"primary": "vc/YOUR_MODEL_ID"}
    }
  }
}
```

使用此文件配置时，在 OpenClaw 用户目录的 `.env` 中添加 `VC_API_KEY=YOUR_VC_API_KEY`，替换为真实密钥。如果 OpenClaw 作为服务运行，确保该服务使用同一用户目录；已使用配置向导保存密钥的用户无需重复设置。

## 启动和检查

保存配置并重新启动 OpenClaw 网关，执行 `openclaw dashboard` 打开控制台。在新会话中选择 VC 模型，发送一个简单问题。

`openclaw models list` 可查看模型配置，`openclaw doctor` 可检查配置问题。

## 常见问题

- **缺少 VC_API_KEY**：确认变量或 `.env` 属于实际运行网关的用户。
- **选不到配置的模型**：已有 `agents.defaults.models` 或模型允许列表时，将 `vc/模型ID` 加入其中。
- **切换后仍使用原模型**：重新选择 VC 模型并新建会话。

更多选项见 [OpenClaw 自定义服务商说明](https://docs.openclaw.ai/gateway/config-tools/custom-providers)。