OpenClaw

OpenClaw 适合搭建多工具 AI 助手、自动化消息处理、工具编排和长期运行代理。将模型供应商配置接到 FreeDom API 后，就可以统一调用 FreeDom API 中的模型。

一、适用场景

• Telegram / Discord / Signal / Webhook 助手
• 需要工具调用、记忆、cron、节点能力的智能体
• 希望把所有模型统一接入到FreeDom API

二、配置思路

在 OpenClaw 的模型或供应商配置中，把默认的模型服务地址替换为 FreeDom API。

核心信息：

• Base URL：https://api.yonghu.shop
• API Key：你的平台密钥

三、推荐接入策略

建议至少配置三类模型：

1. 默认模型：稳定、性价比高，适合日常对话
2. 高性能模型：用于复杂推理、代码或长上下文
3. 轻量模型：用于心跳、低成本批处理、简单任务

四、验证方式

完成配置后，发送一条最简单的测试消息，确认：

• 模型能出字
• 无认证报错
• 工具调用流程正常

五、排错建议

能启动但不出字

优先检查模型名、供应商映射和默认模型设置。

报认证失败

检查 API Key 与 Base URL。

某些模型可用，某些不可用

说明Key 权限、模型开放范围或模型别名配置不一致。

配置前检查

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

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 控制台查看日志，确认请求确实打到了平台。

OpenClaw 成功判据

OpenClaw 接入 FreeDom API 时，配置的模型 Provider 应指向 OpenAI / Anthropic 兼容接口。常见判断：

• OpenAI 兼容模型走 /v1/chat/completions。
• Claude 兼容模型走 /v1/messages。
• Base URL 使用 https://api.yonghu.shop，如果底层 SDK 要完整 OpenAI 根路径再改 https://api.yonghu.shop/v1。

成功判据：/status 能看到当前模型，发一条最小消息能正常返回，FreeDom API 控制台日志中有同模型记录。