接入 OpenClaw

通过 AIGCDesk API 为 OpenClaw 配置自定义模型服务商，用最短路径完成安装、接入和启动验证。

API 文档 API 参考

让 OpenClaw 通过 AIGCDesk 调用模型

这页只解决一件事：把 OpenClaw 的模型服务指向 AIGCDesk，并确认它已经能正常回复。WhatsApp、Telegram、Discord 这类频道配置不在本页展开。

准备事项

AIGCDesk API Key请先在 AIGCDesk API 控制台的 Token 页面创建一枚新的 API Key。建议为 OpenClaw 单独创建，不要和其他应用共用。
可用的模型名称你需要知道 AIGCDesk 实际开放给调用方的模型名，例如 gpt-5.4。可在 AIGCDesk 控制台的模型列表里确认。如果站点启用了模型别名，请使用对外展示的调用名，而不是后台的原始 ID。
OpenClaw 运行环境OpenClaw 官方当前推荐使用 Node 24；兼容模式下也支持 Node 22.16+。Windows 环境建议通过 WSL2 中的 Linux 来安装和运行。
配置文件位置OpenClaw 的主配置文件默认在 ~/.openclaw/openclaw.json。如果你使用接入向导，最终也是写到这个位置。

AIGCDesk 当前文档明确提供的是 OpenAI 兼容接口，因此在 OpenClaw 里应选择 OpenAI-compatible 这条路径，而不是 Anthropic 兼容路径。

推荐路径

首次接入建议

如果你只是想先打通 OpenClaw 和 AIGCDesk，请优先使用 OpenClaw 自带的接入向导。先让浏览器控制台能正常回复，再继续配置频道、后台常驻或多 Agent 路由。

安装 OpenClaw

macOS、Linux 和 WSL2 中的 Ubuntu 可以直接使用 OpenClaw 官方安装脚本。--no-onboard 表示只安装命令行工具，不自动进入向导。

# 安装 openclaw 命令行工具，--no-onboard 跳过安装后的自动向导
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

启动接入向导

安装完成后，执行以下命令进入向导。第一次接入不需要先配频道，先把模型服务商配置好即可。

# 进入交互式接入向导，逐步完成服务商和鉴权配置
openclaw onboard

在模型和鉴权步骤中选择 Custom provider

当向导进入模型和 API Key 配置时，选择 Custom provider。这是 OpenClaw 官方支持的自定义服务商方式，适合接入 AIGCDesk 这类 OpenAI 兼容接口。

按下面的值填写

字段	填写值
兼容类型	`OpenAI-compatible`
基础地址	`https://api.aigcdesk.com/v1`
模型名	你在 AIGCDesk 控制台看到的实际模型名
Provider ID	`aigcdesk`
API Key	你的 AIGCDesk API Key

完成向导并保存配置

网关端口和绑定方式首次接入可以先用默认值。是否安装后台常驻服务（即让 OpenClaw 以后台进程形式随系统自启）按你的实际需要决定；只做接入验证时，跳过这一步即可。

验证配置并打开浏览器控制台

向导完成后，依次执行以下命令确认一切正常，然后在浏览器控制台里发一条消息，收到回复就说明接入成功。

# 检查配置文件格式和字段是否有问题
openclaw doctor

# 查看 OpenClaw 当前运行状态和使用的模型
openclaw status

# 在浏览器中打开本地控制台，发一条消息验证 AIGCDesk 已能正常回复
openclaw dashboard

脚本化接入

适合自动化或批量部署

如果你要把接入动作写进脚本、初始化流程或企业镜像，直接使用非交互模式会更稳定。下面这条命令会把 API Key 作为环境变量引用保存，而不是直接写死在配置文件里。

# 先把 AIGCDesk API Key 导出为环境变量
# --secret-input-mode ref 会引用这个变量名，而不是把明文写进配置文件
export AIGCDESK_API_KEY="YOUR_AIGCDESK_API_KEY"

# 非交互式接入：将 AIGCDesk 配置为自定义服务商，网关仅监听本机
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice custom-api-key \
  --custom-base-url "https://api.aigcdesk.com/v1" \
  --custom-model-id "YOUR_MODEL" \
  --custom-provider-id "aigcdesk" \
  --custom-compatibility openai \
  --secret-input-mode ref \
  --gateway-port 18789 \
  --gateway-bind loopback

手动检查或手动写入配置

如果你不想跑向导，也可以直接检查或编辑 ~/.openclaw/openclaw.json。把 YOUR_MODEL 和 AIGCDESK_API_KEY 替换成实际值后，下面这份配置即可直接使用：

{
  agents: {
    defaults: {
      // 默认模型必须写成 "服务商ID/模型名" 格式，不能只写模型名
      model: { primary: "aigcdesk/YOUR_MODEL" },
    },
  },
  models: {
    providers: {
      aigcdesk: {
        baseUrl: "https://api.aigcdesk.com/v1",
        // 引用环境变量 AIGCDESK_API_KEY，避免明文存储密钥
        apiKey: "${AIGCDESK_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "YOUR_MODEL",   // 替换为 AIGCDesk 控制台里的实际模型名
            name: "YOUR_MODEL",
          },
        ],
      },
    },
  },
}

这里最容易写错的不是 API Key，而是模型引用格式。OpenClaw 默认模型要写成 服务商 ID / 模型名，也就是 aigcdesk/YOUR_MODEL，不是只写 YOUR_MODEL。

成功标准

基础地址使用 https://api.aigcdesk.com/v1
API Key 对应的 Token 仍然有效，未过期、未停用、未耗尽额度
OpenClaw 的默认模型写成了 aigcdesk/YOUR_MODEL
浏览器控制台里能发出一条消息并收到回复

如果以上任何一项还不确定，可以回查这些页面：

常见错误

明明填了地址，还是连不上

先检查基础地址是不是 https://api.aigcdesk.com/v1。对 OpenClaw 的自定义服务商来说，这里需要带上 /v1。

OpenClaw 能启动，但发消息时报模型不存在

优先检查两项：

YOUR_MODEL 是否替换成了 AIGCDesk 实际开放的模型名
默认模型是否写成了 aigcdesk/YOUR_MODEL，而不是只写模型名

使用脚本化命令时提示 API Key 缺失

如果你用了 --secret-input-mode ref，请确认当前 shell 里已经导出了 AIGCDESK_API_KEY。这条模式会保存环境变量引用，不会替你补 API Key。

我已经配好 OpenClaw，为什么还不能在 WhatsApp 或 Telegram 里用

这通常不是模型接入问题，而是频道还没配好。本页只负责把 OpenClaw 和 AIGCDesk 之间的模型调用打通；频道接入请继续看 OpenClaw 官方的 Channels 文档。

下一步

想先确认 AIGCDesk 这边是否可用，回到快速开始
需要管理 Token 的额度、过期时间和轮换，查看 API Key 管理
遇到状态码、模型名或请求体问题，查看接入排查
需要继续配置 WhatsApp、Telegram、Discord 等频道，查看 OpenClaw 官方频道文档