必须手动注入自定义Base URL和认证方式才能接入私有API；先完成TaoToken或厂商Key初始配置并测试成功，再在「大模型接口」页签添加「自定义OpenAI兼容接口」，填写模型名称、Base URL（须含/v1）和API Key，或通过config.yaml手动注入，Agent中选择该模型即可路由请求。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在 AionClaw 中接入你已有的私有 API 服务（比如内部报表生成接口、CRM 数据查询接口或自建 RAG 检索服务），必须绕过默认的模型网关，手动注入自定义 Base URL 和认证方式，否则 AionClaw 会始终将请求发往 TaoToken 或厂商原生地址。
确认 AionClaw 当前是否处于可配置状态
启动 AionClaw 客户端 → 点击左下角齿轮图标进入「设置」→ 切换到「大模型接口」页签 → 查看右上角是否显示「已连接」或「测试成功」。若显示「未配置」或「连接失败」，说明尚未完成基础模型对接，【必须先完成 TaoToken Key 或任一厂商 Key 的初始填写并点击「测试连接」通过】，否则「自定义接口」选项将灰显不可点。
添加自定义 API 接口
方法一：通过「大模型接口」页签直接新增
在「大模型接口」页签 → 点击右上角「+ 添加模型」按钮 → 在弹出窗口中选择「自定义 OpenAI 兼容接口」→ 填写以下三项：
① 模型名称：输入你希望在 Agent 配置里看到的名称，例如「内部BI-API」或「CRM-Query-v2」，不能含空格和特殊符号；
② Base URL：填入你的 API 服务根地址，例如 https://api.yourcompany.com/v1，结尾【必须带 /v1，且不能有多余斜杠】；
③ API Key：填入你服务要求的认证凭据，可能是 Bearer Token、API Secret 或空字符串（若走 IP 白名单或 cookie 认证）；
点击「保存」→ 系统自动发起一次 OPTIONS 预检请求，若返回 200 且无 CORS 报错，即表示地址可达。
方法二：通过 config.yaml 手动注入（适用于高级用户或批量部署）
关闭 AionClaw → 打开安装目录下的 config/config.yaml → 在 llm_providers: 节点下新增一段：
- name: 内部BI-API
type: openai
base_url: https://api.yourcompany.com/v1
api_key: sk-xxxxx
model: bi-report-gen
注意：model 字段值需与你后端实际接受的 model 参数一致，AionClaw 会透传该字段，不校验合法性。
在 Agent 中调用该接口
打开「Agent 管理」→ 新建或编辑任意 Agent → 在「模型配置」下拉菜单中找到你刚添加的「内部BI-API」→ 保存 Agent；
此时该 Agent 发出的所有 LLM 请求（包括技能调用中的推理环节、SKILL.md 中的 prompt 执行）都会被路由至你指定的 Base URL；
若你的接口不兼容 OpenAI 格式（如返回非 ChatCompletion 结构），AionClaw 将抛出「Response format error」，此时需在后端加一层轻量适配层，或启用「Raw Mode」开关（位于 Agent 高级设置中）跳过结构校验，直接透传原始响应体给技能逻辑处理。
