OpenClaw 设置
配置 OpenClaw 使用 AIDESK API。
OpenClaw 是一个开源的 AI 代理平台,可以将 AI 助手直接带到你的终端和消息应用中。它支持多种 LLM 提供商,并可以通过插件进行扩展。通过安装 openclaw-aidesk 插件,即可使用一个 API Key 访问 AIDESK 上的所有模型。
前置条件
- 一个 AIDESK 账户和 API Key
- 已安装 Node.js 18 或更高版本
- 终端 / 命令提示符访问权限
安装
安装脚本(推荐):
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 是否正确