MaiToken
登录/注册

QClaw

适用场景：

适合希望在 QClaw 中添加 OpenAI 兼容模型，并将其用于代码问答和 Agent 操作的用户。

开始配置

  1. 打开模型设置： 启动 QClaw，进入“设置”，找到“模型”“API”或“模型提供商”。

  2. 新增提供商： 单击“添加”，服务商或协议选择 OpenAI 或 OpenAI Compatible。

  3. 填写 Base URL： 输入 https://api.maitoken.com/v1 。QClaw 会在该地址后自动拼接 /chat/completions。

  4. 填写 API Key： 粘贴您自己的 MaiToken Key，不要在前面手动添加 Bearer。

  5. 填写模型名称： 模型 ID 填写 <模型ID>；显示名称可以填写 MaiToken - 模型ID。

  6. 保存并选择模型： 保存配置后回到聊天窗口，从模型列表中选择刚刚添加的模型。

字段 填写内容
协议或服务商 OpenAI 或 OpenAI Compatible
Base URL https://api.maitoken.com/v1
API Key <你的 MaiToken Key>
Model ID <模型ID>

配置完成后这样测试

  1. 测试普通对话： 在聊天框中输入“只回复 OK”。如果收到正常回复，说明 API Key、Base URL 和模型 ID 基本正确。

  2. 测试项目读取： 打开一个测试项目，输入“请读取当前项目目录，只列出一级文件名，不要修改任何文件。”

  3. 测试 Agent： 让 Agent 新建一个名为 test-maitoken.txt 的文件并写入 hello，然后确认文件已经生成。请勿使用真实生产项目进行测试。

常见问题

问题 处理建议
404 或路径错误 确认 Base URL 只填写到 /v1，不要填写完整的 /chat/completions 路径。
模型列表为空 手动添加准确的模型 ID，或前往 MaiToken 控制台检查当前 API Key 的模型限制列表。
Agent 运行中断 确认模型支持流式输出和工具调用，必要时更换适合代码或 Agent 任务的模型。