QClaw

QClaw 接入逻辑与其他兼容 API 工具一致：改 Base URL、填 Key、选模型。

统一接入信息

• 平台名称：FreeDom API
• 控制台 / API Base URL：https://api.yonghu.shop
• 鉴权方式：API Key
• API Key 获取：登录控制台 → 令牌 / API Key 页面创建

一、适用场景

• 想把 QClaw 的模型请求接到 FreeDom API
• 已经有平台 API Key
• 需要统一使用平台里的 Claude、GPT、Gemini 或图像模型

二、安装 / 准备

安装 QClaw 后进入 Provider 设置。

三、配置接入

推荐配置：

Base URL: https://api.yonghu.shop
API Key: 你的_API_Key
Model: 平台模型名

若支持多 Provider，建议分别创建 OpenAI 兼容与 Anthropic 兼容配置。

四、启动验证

保存后执行一次问答或代码生成测试。

五、推荐模型填写方式

优先使用控制台里真实展示的模型名。常见可尝试：

• Claude：claude-sonnet-4-5-20250929、claude-opus-4-8、claude-opus-4-8-thinking
• Gemini：gemini-2.5-pro、gemini-2.5-flash
• OpenAI 兼容工具：按平台模型广场/控制台展示为准

六、常见问题

401 Unauthorized

API Key 错误、没保存成功，或请求头没有带上密钥。

403 Forbidden

通常是余额不足、Key 没有权限、模型未开放，或服务返回拒绝。

404 Model Not Found

模型名写错，或者当前 Key 没有这个模型权限。

429 Too Many Requests

请求过快或服务繁忙。降低并发、稍后重试，或切换模型或稍后重试。

七、实用建议

不要同时在一个配置里混用 OpenAI 和 Anthropic 的模型名/环境变量。

配置前检查

配置客户端前，先确认平台在线：

curl https://api.yonghu.shop/api/status

看到 success: true 或 HTTP 200，说明平台主入口正常。

如果客户端配置失败，优先按这个顺序排查：

1. API Key 是否复制完整，没有多余空格。
2. Base URL 是否该带 /v1。
3. 模型名是否与平台模型广场完全一致。
4. 当前 API Key 是否有该模型权限。
5. 余额是否充足。

成功后建议到 FreeDom API 控制台查看日志，确认请求确实打到了平台。

QClaw 成功判据

QClaw 通常按 OpenAI 兼容客户端处理：

export OPENAI_API_KEY="你的_API_Key"
export OPENAI_BASE_URL="https://api.yonghu.shop"

失败时切到：

export OPENAI_BASE_URL="https://api.yonghu.shop/v1"

成功判据：CLI 返回正常文本，平台控制台日志中出现对应请求。