复制接口地址
大多数客户端选择“OpenAI Compatible”或“自定义兼容接口”，Base URL 填：
https://api.openclawui.icu/v1
API Key
填你的用户密钥，格式通常为 sk- 开头
Base URL
OpenAI 兼容工具使用 /v1 结尾
不泄露
文档页不会保存、上传或校验你的密钥
Quick Start
三步完成接入
填入你的密钥
API Key 填你在 openclawui 后台创建的密钥，不要把管理员账号或上游密钥填到客户端里。
选择模型并测试
模型 ID 以后台可用列表为准。先用短问题测试连通性，再开始正式任务。
Agent Setup
主流 Agent 与客户端配置
以下配置以“自定义兼容接口”为主。不同版本名称可能略有变化，核心只看 Base URL、API Key、Model 三项。
小白先看这里
所有工具基本都只填三样：接口地址、密钥、模型 ID。
OpenAI 兼容地址
https://api.openclawui.icu/v1
Claude 兼容地址
https://api.openclawui.icu/v1
Models
模型和倍率怎么理解
文档不硬编码具体模型价格，避免和后台不一致。用户实际可用模型、倍率、额度限制，以 openclawui 后台配置为准。
| 类型 | 适用场景 | 填写方式 |
|---|---|---|
| 通用对话 | 日常问答、资料整理、轻量写作 | your-chat-model |
| 代码 Agent | 项目阅读、代码修改、命令执行建议 | your-code-model |
| 长上下文 | 大文件阅读、长文档总结、多轮分析 | your-long-context-model |
| 图像生成 | 图标、宣传图、素材草案 | your-image-model |
建议
先在后台确认模型是否启用，再把模型 ID 配到 Agent。遇到 “model not found” 时，优先检查模型 ID 和分组权限。
Usage
余额与用量查询
用户自助查询
打开密钥查询页，输入用户自己的密钥，即可查看余额、额度、今日用量、累计用量、每日趋势和模型统计。
Troubleshooting
常见错误
401 或提示 API key required
密钥没有传入，或没有使用 Bearer 方式。检查客户端 API Key 是否为空，接口地址是否填错。
model not found
模型 ID 不存在、未启用，或当前密钥所在分组没有权限。请以后台可用模型列表为准。
余额不足或额度耗尽
打开密钥查询页查看剩余额度。如果是限额 Key，检查总额度、日限额、周限额或过期时间。
请求慢或超时
先用短问题测试；再检查客户端超时时间、网络连接、所选模型负载，以及是否正在上传超长上下文。
Claude 兼容工具无法连接
这类工具现在统一使用带 /v1 的 Base URL。优先检查 https://api.openclawui.icu/v1、密钥和模型映射是否填写一致。