快速接入 Agent

OpenClaw

OpenClaw 是开源的 AI 助手网关与机器人框架，支持 OpenAI 兼容接口。将其模型服务指向 Yomi API 后，即可使用平台目录中的全部对话模型。

前置准备

参照 OpenClaw 官方文档完成下载、安装与初始化。
登录 Yomi API 控制台，在顶部导航「秘钥管理」创建密钥并复制保存。密钥仅创建时可见，请妥善保管。
确认账户余额充足，不足可在用户中心「在线充值」页充值。

配置 Yomi API

OpenClaw 通过配置文件管理模型服务。在其模型配置（provider 段）中填入以下 OpenAI 兼容参数：

API 地址（base_url）：https://api.yomiapi.com/v1
API Key（api_key）：YOUR_API_KEY（替换为您的密钥）
模型（model）：填模型广场中的模型 id，如 claude-sonnet-5 或 gpt-5.6-sol

示例如下，具体字段名与配置文件位置以 OpenClaw 官方文档为准：

base_url: https://api.yomiapi.com/v1
api_key: YOUR_API_KEY
model: claude-sonnet-5

模型请填模型 id（目录值），不要填显示名。完整目录见控制台顶部导航「模型服务」，也可调用 /v1/models 接口获取。

开始使用与验证

保存配置并重启 OpenClaw，向其发送一条测试消息，收到模型回复即接入成功。您也可以在控制台用户中心「用量统计」中看到对应的调用记录。

如果 OpenClaw 端报错，建议先用 cURL 直接验证密钥与地址是否可用，以便区分是平台侧配置问题还是 OpenClaw 侧配置问题：

curl https://api.yomiapi.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "你好"}]
  }'

常见问题

返回 401 认证失败

API Key 填写有误或已被删除。请回到「秘钥管理」核对密钥，必要时重新创建一个并更新到 OpenClaw 配置中。

返回 404 或请求无响应

多为地址问题：确认 base_url 为 https://api.yomiapi.com/v1，少写或多写 /v1 都会导致请求路径错误。

提示模型不存在或不可用

确认填写的是模型 id 而非显示名；同时检查密钥所属分组是否包含该模型，各分组可用模型以模型广场为准。