Factory Droid

Factory Droid 是 Factory 的终端 Agent。通过 BYOK 自定义模型，可以让 Droid 使用 ModelGo 的 OpenAI 兼容接口。

接入前准备

• 已安装 Node.js 18+ 和 Droid CLI。
• 已在 ModelGo 控制台创建 API Key。
• 已在模型广场确认逻辑模型名。

1. 安装并启动 Droid

npm install -g droid
droid --version
droid

也可以使用 Factory 官方安装器。进入 Droid 后输入 /settings 可打开设置。

2. 配置 ModelGo 自定义模型

编辑 ~/.factory/settings.json（Windows：%USERPROFILE%\\.factory\\settings.json），合并以下 customModels 配置：

{
  "customModels": [
    {
      "model": "你的模型名",
      "displayName": "ModelGo / 你的模型名",
      "baseUrl": "https://api.modelgo.com/v1",
      "apiKey": "${MODELGO_API_KEY}",
      "provider": "openai"
    }
  ]
}

先设置 Key：

export MODELGO_API_KEY="sk-你的token"

重新启动 Droid，在 /models 或模型选择器中选择 ModelGo / 你的模型名。

3. 验证请求

curl https://api.modelgo.com/v1/models \
  -H "Authorization: Bearer $MODELGO_API_KEY"
droid exec --model "你的模型名" "请用一句话介绍当前项目"

常见问题

模型没有出现在列表中

检查 JSON 是否有效、customModels 是否位于文件顶层，并完全退出后重新启动 Droid。

认证失败或接口路径错误

确认环境变量已在启动 Droid 的同一终端中设置，且 baseUrl 没有重复的 /v1 或完整接口路径。

相关文档

• 首次调用：创建 API Key、查询模型并验证 ModelGo 接口。
• Factory Droid 设置：查看 settings.json 的位置和设置入口。
• Factory BYOK：了解自定义模型字段和模型独立性。