Aimyria API 接入文档
Aimyria 支持 OpenAI、Google Gemini、Anthropic 多种兼容格式接口。你可以把官方 SDK 的 base URL 指向 Aimyria,无需改动业务代码,即可调用 Claude / Gemini / GPT 等多家模型。
- Base URL:
https://aimyria.com - 鉴权:API Key(
sk-...) - 协议:同时支持 Anthropic 原生格式(
/v1/messages)、OpenAI 兼容格式(/v1/chat/completions)、OpenAI Responses API(/v1/responses,仅 GPT 系列)、Gemini 原生格式(/v1beta/models/{model}:generateContent)和图像生成(/v1/images)
新账号余额为 0,先充值再调用。 第一次请求前先充值。如果请求返回 402(OpenAI 格式为 400)、提示「钱包余额不足」,说明余额为 0,不是 Base URL 或 Key 配错了,充值后重试即可。
文中的 sk-xxxxxx 请替换为你自己的 Key,妥善保管、不要提交到代码仓库。
没有海外卡?也可以用 USDT 充值:在充值弹窗点「Crypto支付」,用 USDT、USDC 或 ETH,从币安、OKX 等交易所 App 转账即可——收银台会按金额显示可用网络,不用装钱包插件(教程)。
一、Base URL 与请求头
根据使用的模型选择对应的兼容格式:
安装 OpenClaw 并接入 Aimyria
OpenClaw 是一个开源的个人 AI 助手,可以接入飞书、微信等常用聊天工具,可以通过 Skill 扩展能力。
一、接入 Aimyria
使用Aimyria前请先将OpenClaw升级到最新版本,部分版本可能存在兼容性问题。如果你已经安装了 OpenClaw,运行以下命令重新进入配置阶段,切换到 Aimyria 提供商:
openclaw onboard --install-daemon
然后按照提示操作:
- 遇到提示:
I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?请选择 Yes。 - 遇到提示:
Setup mode推荐选择 QuickStart。 - 遇到提示:
Model/auth provider请选择 More…,在展开的完整列表里直接键入custom过滤(或上下键查找),选中Custom Provider(提示文案 "Any OpenAI or Anthropic compatible endpoint")。 - 遇到提示:
API Base URL时,根据你想使用的模型系列,填写对应的 Base URL:
- 遇到提示:
How do you want to provide this API key?请选择 Paste API key now。 - 遇到提示:
API Key (leave blank if not required)粘贴你在 Aimyria 控制台 创建的 API Key。 - 遇到提示:
Endpoint compatibility请根据你想是使用的模型系列,选择对应的选项:
| 供应商类型 | 模型系列 |
|---|---|
| OpenAI-compatible | GPT系列、Gemini系列、DeepSeek系列、GLM系列、Grok系列 |
| Anthropic-compatible | Claude系列 |
- 遇到提示:
Model ID请按需填写 Aimyria 已支持的模型,例如claude-fable-5-1,完整列表见下表。
| Model ID | 模型名称 |
|---|---|
| gpt-6-astra | GPT 6 Astra |
| gpt-6-sol | GPT 6 Sol |
| gpt-6-luna | GPT 6 Luna |
| gpt-5.6-sol | GPT 5.6 sol |
| gpt-5.6-terra | GPT 5.6 terra |
| gpt-5.6-luna | GPT 5.6 luna |
| claude-fable-5-1 | Claude fable 5.1 |
| claude-fable-5 | Claude fable 5 |
| claude-sonnet-5 | Claude sonnet 5 |
| claude-opus-4-8 | Claude opus 4.8 |
| claude-opus-4-7 | Claude opus 4.7 |
| claude-opus-4-6 | Claude opus 4.6 |
| claude-sonnet-4-6 | Claude sonnet 4.6 |
| claude-haiku-4-5 | Claude haiku 4.5 |
| gpt-5.5 | GPT 5.5 |
| gpt-5.4 | GPT 5.4 |
| gemini-3.1-pro-preview | Gemini 3.1 pro(preview) |
| deepseek-flash | DeepSeek V4.1 Flash |
| deepseek-v4-pro | DeepSeek v4 pro |
| deepseek-v4-flash | DeepSeek v4 flash |
| deepseek-v4-flash-free | DeepSeek V4 Flash 福利版 |
| glm-5.3-flash | GLM 5.3 Flash |
| glm-5.3 | GLM 5.3 |
| glm-5.2 | GLM 5.2 |
| grok-4.6 | Grok 4.6 |
- 看到
Verification successful.即说明 Aimyria 接入成功。 - 后续的其余配置(消息频道、Skill 等)请根据需求配置,新手可以先选择 Skip for now。
二、从零安装 OpenClaw
下载与安装
Linux / Mac 用户执行以下命令,从 OpenClaw 安装脚本 安装:
curl -fsSL https://openclaw.ai/install.sh | bash
Windows 用户执行以下命令,从 OpenClaw 安装脚本 安装:
iwr -useb https://openclaw.ai/install.ps1 | iex
配置模型
首次安装完成后会自动进入 setup 阶段;已经安装过 OpenClaw 的用户可以通过 openclaw onboard --install-daemon 重新进入配置阶段。
- 遇到提示:
I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?请选择 Yes。 - 遇到提示:
Setup mode推荐选择 QuickStart。 - 遇到提示:
Model/auth provider请选择 More…,在展开的完整列表里直接键入custom过滤(或上下键查找),选中Custom Provider(提示文案 "Any OpenAI or Anthropic compatible endpoint")。 - 遇到提示:
API Base URL填入https://aimyria.com/v1。 - 遇到提示:
How do you want to provide this API key?请选择 Paste API key now。 - 遇到提示:
API Key (leave blank if not required)粘贴你在 Aimyria 控制台 创建的 API Key。 - 遇到提示:
Endpoint compatibility请选择 OpenAI-compatible。 - 遇到提示:
Model ID请按需填写 Aimyria 已支持的模型,例如claude-fable-5-1,完整列表见下表。
| Model ID | 模型名称 |
|---|---|
| gpt-6-astra | GPT 6 Astra |
| gpt-6-sol | GPT 6 Sol |
| gpt-6-luna | GPT 6 Luna |
| gpt-5.6-sol | GPT 5.6 sol |
| gpt-5.6-terra | GPT 5.6 terra |
| gpt-5.6-luna | GPT 5.6 luna |
| claude-fable-5-1 | Claude fable 5.1 |
| claude-fable-5 | Claude fable 5 |
| claude-sonnet-5 | Claude sonnet 5 |
| claude-opus-4-8 | Claude opus 4.8 |
| claude-opus-4-7 | Claude opus 4.7 |
| claude-opus-4-6 | Claude opus 4.6 |
| claude-sonnet-4-6 | Claude sonnet 4.6 |
| claude-haiku-4-5 | Claude haiku 4.5 |
| gpt-5.5 | GPT 5.5 |
| gpt-5.4 | GPT 5.4 |
| gemini-3.1-pro-preview | Gemini 3.1 pro(preview) |
| deepseek-flash | DeepSeek V4.1 Flash |
| deepseek-v4-pro | DeepSeek v4 pro |
| deepseek-v4-flash | DeepSeek v4 flash |
| deepseek-v4-flash-free | DeepSeek V4 Flash 福利版 |
| glm-5.3-flash | GLM 5.3 Flash |
| glm-5.3 | GLM 5.3 |
| glm-5.2 | GLM 5.2 |
| grok-4.6 | Grok 4.6 |
- 看到
Verification successful.即说明 Aimyria 接入成功。 - 在 API Compatibility 字段选择
openai。 - 后续的其余配置(消息频道、Skill 等)请根据需求配置,新手可以先选择 Skip for now。
开始使用
打开 Web UI,在 Chat 页面进行交互:
openclaw dashboard
在终端中打开 TUI:
openclaw tui
在终端中与 Openclaw 对话:
openclaw terminal
