QClaw 串接 Token Cafe
这篇教学会带你从 Token Cafe 帐号中心建立 sk-cafe- API Token，接著在 QClaw 新增自定义大模型，填入 OpenAI 相容协议、https://api.aciemind.com/v1、API Key 与模型 ID，最后用对话与用量页确认串接成功。
这篇图文教学会带你完成：
完成这篇教学后，你会知道如何建立 Token Cafe API Token、如何在 QClaw 新增自定义模型、如何设定 OpenAI 相容协议，以及如何用 QClaw 对话测试并回到 Token Cafe 用量页确认纪錄。
第一部分：建立 Token Cafe API Token
进入 Tokens 页，点选「新建 Token」
登入 Token Cafe 帐号中心，进入 Tokens / API Token 管理页，点右侧的「新建 Token」。
图 1：在 Token Cafe 后台进入 API Token 管理页。
填入 Token 名称并建立
替这组 Token 命名，建议使用 QClaw、QClaw 测试或你的专案名称，之后比较容易辨识用途。
图 2：输入 Token 名称并建立。
复制并保存 API Key
Token 建立成功后，完整 sk-cafe-… 金钥只会显示一次。请先复制到安全的位置，勾选「我已储存到安全的地方」，再关闭视窗。
图 3：复制 Token Cafe API Key 并确认已保存。
第二部分：在 QClaw 新增自定义大模型
确认 Token Cafe 编程工具接入资讯
如果需要确认 Base URL 或模型格式，可以先打开 Token Cafe 的编程工具接入页。QClaw 这类工具通常使用 OpenAI-compatible / OpenAI 相容协议设定。
图 4：确认 Token Cafe 的 API Base URL。
打开 QClaw
在桌面或应用程式清单中打开 QClaw，准备新增 Agent 与自定义模型。
图 5：开启 QClaw。
建立或选择 Agent
如果你还没有合适的 Agent，可以先点「新建 Agent」，依照 QClaw 的新手提示建立。接著在输入框右下角打开模型选单。
图 6：先建立 Agent，再从右下角模型选单进入模型设定。
进入自定义模型
在模型选单底部点选「自定义大模型」，准备新增 Token Cafe 的模型配置。
图 7：从模型清单进入自定义大模型。
新增自定义配置
在「添加自定义大模型」视窗中，点选「自定义配置」。
图 8：点击自定义配置。
填入 Base URL、API Key 与模型 ID
接口地址填入 https://api.aciemind.com/v1；API 协议类型选「OpenAI 兼容协议」；API Key 贴上刚刚在 Token Cafe 生成的 sk-cafe-…；模型名称与模型 ID 填入你要使用的公开模型 ID，例如 GLM-5.2。若有可用功能选项，建议依模型能力开启图片输入或推理模式。
图 9：填入 OpenAI 相容协议、API Key、模型名称与模型 ID。
选择刚刚新增的模型
回到模型选单，选择刚才新增的模型，例如 GLM-5.2。选到后，输入框右下角会显示目前使用的模型。
图 10：选择新增完成的 GLM-5.2 模型。
第三部分：测试对话与确认用量
在 QClaw 发送测试问题
输入简单测试问题，例如「你是什么模型？」如果 QClaw 能正常回覆，并显示目前运行的模型名称或自定义模型标识，代表串接已成功。
图 11：选完模型后即可开始对话测试。
回到 Token Cafe 用量页确认纪錄
最后回到 Token Cafe 的用量页，确认是否出现 QClaw 呼叫模型后产生的用量纪錄。这一步可以验证 API Key、模型 ID 与请求通道都正常。
图 12：在 Token Cafe 用量页确认模型消耗状况。
设定范例
{
"接口地址": "https://api.aciemind.com/v1",
"API 协议类型": "OpenAI 相容协议",
"API Key": "sk-cafe-...",
"模型名称": "GLM-5.2",
"模型 ID": "GLM-5.2"
}
常见问题
QClaw 要选哪一种 API 协议？
请选 OpenAI 兼容协议 / OpenAI 相容协议。Token Cafe 的主要接入格式是 OpenAI-compatible API。
接口地址要填什么？
接口地址填 https://api.aciemind.com/v1。不要漏掉 /v1。
模型名称和模型 ID 要一样吗？
通常可以填一样，重点是模型 ID 必须符合 Token Cafe 模型目錄中的公开 model id。范例使用 GLM-5.2。
QClaw 可以回覆，但 Token Cafe 没有用量纪錄怎么办？
请确认 QClaw 目前选中的模型是否为自定义模型，并确认接口地址、API Key 与模型 ID 都是 Token Cafe 的设定。
完整平台文档版可以参考：Token Cafe × QClaw 串接教学。
留言