QClaw 自定义 API 接入实战：扩展第三方模型能力完整指南

{"type":"doc","content":[{"type":"paragraph","attrs":{"id":"47a78109-ca44-4814-999f-5eb5ac8705d2","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"记录用 Agnes API 接入 QClaw 自定义模型的完整流程，包含配置步骤、使用体验和常见问题。"}]},{"type":"paragraph","attrs":{"id":"ffcb6c94-41b1-40b4-b716-7d2df1dc32d5","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"QClaw 自定义API AI助手 模型扩展"}]},{"type":"paragraph","attrs":{"id":"497c4442-32fa-43a5-9616-2859d5bad8ec","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"QClaw 自定义 API 接入实战：扩展第三方模型能力完整指南"}]},{"type":"paragraph","attrs":{"id":"7df6b69a-5bd4-4e7e-b18d-a7817cb42b44","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"背景"}]},{"type":"paragraph","attrs":{"id":"a6db3838-56de-48e0-98f5-411b63522f07","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"QClaw 内置了多款主流大模型，日常对话、文案生成、数据分析都能覆盖。但有些场景下，我们想接入第三方模型来扩展能力——比如测试不同模型的输出效果、接入特定领域的模型、或者只是想用一用自己已有的 API 额度。"}]},{"type":"paragraph","attrs":{"id":"3c1159f5-a3db-44b9-92aa-c95396fd4d02","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"QClaw 支持标准 OpenAPI 协议的自定义模型接入，配置过程并不复杂。本文记录我用 Agnes 的 API 接入 QClaw 的完整流程，给有同样需求的朋友一个参考。"}]},{"type":"paragraph","attrs":{"id":"2820bcc3-8067-43bc-b6a0-80c7bbaf7168","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"提示：本文不构成任何商业建议，各模型额度政策请以官方公告为准。"}]},{"type":"paragraph","attrs":{"id":"9eeaf594-b038-444a-9830-d584bca71019","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"一、前期准备：获取 API 密钥"}]},{"type":"paragraph","attrs":{"id":"cab28e87-7558-4aa4-b30c-20c751fa7e4d","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"步骤 1：注册账号"}]},{"type":"paragraph","attrs":{"id":"5c4ffac9-d915-47b8-b211-7fea752d098c","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"打开 "},{"type":"text","marks":[{"type":"link","attrs":{"href":"http://agnes-ai.com","target":"_blank","rel":"noopener noreferrer nofollow","class":null}}],"text":"agnes-ai.com"},{"type":"text","text":"，右上角注册，邮箱登录即可（无需手机号实名）。"}]},{"type":"paragraph","attrs":{"id":"16f1fd31-09eb-4622-904d-391eea0d01f9","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"步骤 2：创建 API Key"}]},{"type":"paragraph","attrs":{"id":"f3f50c63-cb40-43e0-870f-d543d21a6522","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"首页找到【免费 API】入口，进入 API 管理页面，点击\"创建密钥\"，复制生成的 Key。"}]},{"type":"paragraph","attrs":{"id":"412b385d-9598-4b31-b71d-a6a554fb2b5b","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"注意：Key 复制后请妥善保存，刷新页面后只会显示一次。"}]},{"type":"paragraph","attrs":{"id":"b081d8e7-397a-4af4-b383-f9e24aa3b16f","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"步骤 3：记录接口地址"}]},{"type":"paragraph","attrs":{"id":"fa2e4af2-c3c4-4d5d-8ab6-0cdf67e9537d","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"基础地址："},{"type":"text","marks":[{"type":"link","attrs":{"href":"https://api.agnes-ai.com/v1","target":"_blank","rel":"noopener noreferrer nofollow","class":null}}],"text":"https://api.agnes-ai.com/v1"}]},{"type":"paragraph","attrs":{"id":"fb486332-72fa-45ec-9477-4a4bd257f013","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"对话接口："},{"type":"text","marks":[{"type":"link","attrs":{"href":"https://api.agnes-ai.com/v1/chat/completions","target":"_blank","rel":"noopener noreferrer nofollow","class":null}}],"text":"https://api.agnes-ai.com/v1/chat/completions"}]},{"type":"paragraph","attrs":{"id":"3d6f1964-0884-40db-81bf-2fc8f7deb5da","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"二、QClaw 客户端配置步骤"}]},{"type":"paragraph","attrs":{"id":"013b91f7-7e3a-48ed-8016-8c63c62ab500","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"步骤 1：进入模型配置"}]},{"type":"paragraph","attrs":{"id":"2f7ee4b4-b634-45ad-8000-83dae2918c9e","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"打开 QClaw 软件，左侧菜单找到【模型】板块，下滑到【自定义 API 模型】。"}]},{"type":"paragraph","attrs":{"id":"61726203-e850-430d-9183-1115cbc5ff7e","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"步骤 2：添加新模型"}]},{"type":"paragraph","attrs":{"id":"8e977d5f-1196-4f1e-9ae6-316c70ece73a","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"点击「添加新模型」，填写以下信息："}]},{"type":"paragraph","attrs":{"id":"572bdfa3-9eaa-4d8d-96cb-f5412012fe3a","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"模型名称：Agnes 通用模型（自定义命名方便识别）"}]},{"type":"paragraph","attrs":{"id":"9b9d1391-af74-4ed4-bb87-9bdafe961022","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"API 接口地址："},{"type":"text","marks":[{"type":"link","attrs":{"href":"https://api.agnes-ai.com/v1/chat/completions","target":"_blank","rel":"noopener noreferrer nofollow","class":null}}],"text":"https://api.agnes-ai.com/v1/chat/completions"}]},{"type":"paragraph","attrs":{"id":"2c022945-20e9-4d95-bad7-abfcb5af3c20","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"API 密钥：你刚才复制的 Key"}]},{"type":"paragraph","attrs":{"id":"2fea97c2-c04b-48cb-847c-0bda2581306a","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"模型标识：agnes-large（文本对话）"}]},{"type":"paragraph","attrs":{"id":"1abb59ec-0559-401d-a569-e129110bcd46","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"上下文上限：8k"}]},{"type":"paragraph","attrs":{"id":"ede88453-4bd0-434b-9f92-92aaf28ed61a","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"步骤 3：测试连接"}]},{"type":"paragraph","attrs":{"id":"bbb77d86-37d0-42de-aca7-ce95b4a86946","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"点击\"测试连接\"，提示成功即配置完成。"}]},{"type":"paragraph","attrs":{"id":"6bf512eb-6c75-4a01-bb03-db7564a86d48","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"步骤 4：切换模型"}]},{"type":"paragraph","attrs":{"id":"4362f0f5-b6f8-4e94-844b-5888c9bf0b02","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"返回主界面，顶部模型下拉框切换为刚添加的 Agnes 模型，即可使用。"}]},{"type":"image","attrs":{"id":"ead0aea5-207a-485c-aac6-89e16a884b32","src":"https://developer.qcloudimg.com/http-save/audit-12627304/d90e8d09b52415473900a345e7d93fc3.png","extension":"png","align":"center","alt":"","showAlt":false,"href":"","boxShadow":"","width":964,"aspectRatio":"1.292546","status":"success","showText":true,"isPercentage":false,"percentage":0,"isHoverDragHandle":false}},{"type":"paragraph","attrs":{"id":"7fc0deb7-0633-4069-b4e4-6840e197c30f","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false}},{"type":"paragraph","attrs":{"id":"b8f3072e-14c6-434b-abbd-dcb4b84ab7aa","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"三、使用体验"}]},{"type":"paragraph","attrs":{"id":"48b3f071-4d81-4061-a7a9-1b56a7d579cb","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"接入后，所有对话、文案生成、数据分析操作都走 Agnes 的 API。QClaw 内置积分主要消耗在本地处理较重的任务上，日常轻量问答可以通过切换模型节省积分。"}]},{"type":"paragraph","attrs":{"id":"82ac6a93-5792-4deb-b944-dd66c199ab23","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"需要注意的是："}]},{"type":"paragraph","attrs":{"id":"a6c30969-d3d6-4b8e-9fbb-b6fc9db98a5f","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"第三方 API 走的是对方服务器的算力，网络延迟会比内置模型略高"}]},{"type":"paragraph","attrs":{"id":"76b703a6-454e-4c57-9767-1f86e19149ad","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"复杂批量任务建议还是用 QClaw 内置模型更稳定"}]},{"type":"paragraph","attrs":{"id":"045f507f-3ffd-4ace-a307-3f8bdf1b36ac","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"Agnes 的免费额度政策请以官网最新公告为准"}]},{"type":"paragraph","attrs":{"id":"6062f5c8-982c-4e4e-aaf5-18f8a1da7814","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"四、常见问题"}]},{"type":"paragraph","attrs":{"id":"e14e7ccd-91cf-4393-ac36-99ad87dd9753","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"Q1：连接失败怎么办？"}]},{"type":"paragraph","attrs":{"id":"a5952438-0017-4675-846f-925c8ba412bd","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"A：检查 API Key 是否复制完整（注意前后空格）、接口地址是否准确。"}]},{"type":"paragraph","attrs":{"id":"6b9da4af-dc7d-4ef1-b4d3-a373e6be9f52","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"Q2：想要绘图功能怎么配置？"}]},{"type":"paragraph","attrs":{"id":"81af558a-c5b4-4132-8315-62a26f67f3a2","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"A：新增模型时，把模型标识改成 agnes-image 即可调用绘图接口。"}]},{"type":"paragraph","attrs":{"id":"3027c9cc-e8c4-40b3-83f8-19091e063489","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"Q3：额度用完会怎样？"}]},{"type":"paragraph","attrs":{"id":"4776eafa-325f-4c94-816a-13261f13adc6","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"A：会提示额度不足。具体恢复方式以官方说明为准。"}]},{"type":"paragraph","attrs":{"id":"b5a022c2-674d-4da9-9ba1-28708bc6248e","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"五、写在最后"}]},{"type":"paragraph","attrs":{"id":"ff157c14-9aee-4637-bd77-57978884e8ac","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"QClaw 的自定义 API 能力给了我们更多选择——可以接入不同模型对比效果，可以利用各家的免费额度做日常轻量任务。功能怎么用、用多少，取决于自己的实际需求。"}]},{"type":"paragraph","attrs":{"id":"5dc16703-4002-494f-904e-66d2a5c6eccf","textAlign":"inherit","indent":0,"color":null,"background":null,"isHoverDragHandle":false},"content":[{"type":"text","text":"如果你也在用 QClaw 接入第三方模型，欢迎评论区交流你们用的哪个 API、效果怎么样"}]}]}