OpenClaw 设置

配置 OpenClaw 使用 AIDESK API。

OpenClaw 是一个开源的 AI 代理平台,可以将 AI 助手直接带到你的终端和消息应用中。它支持多种 LLM 提供商,并可以通过插件进行扩展。通过安装 openclaw-aidesk 插件,即可使用一个 API Key 访问 AIDESK 上的所有模型。

前置条件

  • 一个 AIDESK 账户和 API Key
  • 已安装 Node.js 18 或更高版本
  • 终端 / 命令提示符访问权限
前往创建 API Key

安装

安装脚本(推荐):

curl -fsSL https://openclaw.ai/install | bash

或使用 npm(需要 Node.js 18+):

npm i -g openclaw

验证安装:

openclaw --version

插件配置

分三步完成:安装插件 → 启用插件 → 认证。

安装 AIDESK 提供商插件:

openclaw plugins install openclaw-aidesk

启用已安装的插件:

openclaw plugins enable openclaw-aidesk
重要:启用后需要重启 gateway 才能生效:
openclaw gateway restart

使用 AIDESK API Key 进行认证:

openclaw models auth login --provider aidesk --set-default

系统会提示你输入 API Key。输入你的 AIDESK API 密钥即可。

如果需要更换模型,可以重新运行 openclaw onboard,在 Model/auth provider 中选择 Skip for now,在 Filter models by provider 中选择 aidesk,然后在模型列表中选择你想切换的模型。

Docker 环境配置

如果你在 Docker 容器中不方便安装插件,可以直接创建配置文件。将配置文件挂载到容器中的 ~/.openclaw/openclaw.json 路径即可,OpenClaw 启动时会自动读取。

{
  "providers": {
    "aidesk": {
      "apiKey": "sk-aidesk-YOUR_KEY",
      "baseURL": "https://api.aideskapp.com/v1"
    }
  }
}

可用模型

插件会从 AIDESK API 动态加载模型。以下是一些示例:

OpenAI GPT

  • aidesk/openai/gpt-5.4
  • aidesk/openai/gpt-4.1
  • aidesk/openai/gpt-4.1-mini
  • aidesk/openai/gpt-4o

Anthropic Claude

  • aidesk/anthropic/claude-opus-4-7
  • aidesk/anthropic/claude-sonnet-4-6
  • aidesk/anthropic/claude-haiku-4-5-20251001

使用与进阶配置

认证成功后,查看可用模型:

openclaw models list | grep aidesk

也可以通过环境变量设置 API Key(无需运行 auth login):

export AIDESK_API_KEY="sk-aidesk-YOUR_KEY"

动态模型加载:

  • 插件启动时自动从 AIDESK API 获取最新模型列表
  • 新模型上线后无需更新插件即可使用
  • API 不可用时自动回退到内置模型列表

常见问题

  • 检查插件是否已安装并启用:openclaw plugins list
  • 安装:openclaw plugins install openclaw-aidesk
  • 启用:openclaw plugins enable openclaw-aidesk
  • 重启 gateway:openclaw gateway restart
  • 401:API Key 未设置或无效
  • 403:权限不足或密钥已过期
  • 前往控制台验证 API Key 是否正确