Factory Droid 接入猫云
Droid 的 BYOK 可读取本地自定义模型。本页选择 OpenAI Chat Completions；openai 在 Droid 中指 Responses API，不能只因模型名字像 OpenAI 就使用它。1 本站尚未逐个工具链验收，不承诺所有模型或工具调用可用。
1. 准备
按官方 Quickstart 安装并启动 Droid，若要求 Factory 登录，完成其自身登录；猫云 Key 不是 Factory 账号凭证。2 创建猫云密钥，核对余额、分组权限和模型广场中的模型 ID。备份 ~/.factory/settings.json，若已有 customModels，只追加一个对象，保留其他模型和设置。
2. 最小配置
在启动 Droid 的终端先设置变量：
export NEKOCLOUD_API_KEY="REPLACE_WITH_API_KEY"新建文件时可使用下列完整 JSON；已有文件不要整份覆盖：
{
"customModels": [
{
"model": "REPLACE_WITH_MODEL_ID",
"displayName": "NekoCloud",
"baseUrl": "https://api.nekocloud.vip/v1",
"apiKey": "${NEKOCLOUD_API_KEY}",
"provider": "generic-chat-completion-api"
}
]
}| 字段 | 含义 |
|---|---|
customModels | 顶层自定义模型数组 |
model / displayName | API 模型 ID / 选择器标签 |
baseUrl | 基础地址，客户端拼接接口 |
apiKey | ${NEKOCLOUD_API_KEY} 引用进程变量 |
provider | generic-chat-completion-api 为 Chat Completions |
当前推荐文件及字段是 camelCase；旧 config.json 的 snake_case 虽兼容，但没有相同的密钥变量展开行为。1 不照抄未知的 maxOutputTokens，需要限制时先核实模型实际能力。
3. 选择与重载
保存后退出并在设置变量的终端重新运行 droid；输入 /model，在 Custom models 中选择 NekoCloud。1 如使用单独的 Spec Mode 模型，也确认它没有继续走其他供应商。客户端显示条目不代表猫云授权成功。
4. 只读验证与用量
测试可能收费，确认后先发一句问候，再进入 Spec Mode（Shift+Tab），要求读取 README 并引用原句总结；不要批准退出规划进入实施，不接受写入或 Shell 执行。3 观察真实读取工具结果和最终回答，核对项目文件无变化。用 /cost 查看客户端统计，并与猫云用量记录的时间、模型、token 对照；本地估价或缓存展示不是本站账单。1
密钥及备份不要提交 Git；实际输入建议隐藏录入，重启后确认变量继承。401 查认证，404 查模型及路径，工具失败查模型能力和协议；脱敏排查，不开启高自治绕过错误。