Bamboo Relay

Factory Droid CLI

通过 BYOK 自定义模型将 Factory Droid CLI 连接到 Bamboo Relay。

Bamboo 兼容接入

Factory Droid CLI 由 Factory 提供。本页使用其 BYOK 自定义模型能力接入 Bamboo,不涉及 Factory 托管模型。

Factory Droid CLI 支持在本地配置 OpenAI 兼容的自定义模型。API Key 可以通过环境变量引用,不需要写入明文配置。

配置 API Key

先在令牌管理创建 Bamboo API Key:

export BAMBOO_API_KEY="sk-your-api-key"

添加自定义模型

将以下条目合并到 ~/.factory/settings.json,并把 your-model-id 替换为模型广场中的模型 ID:

{
  "customModels": [
    {
      "model": "your-model-id",
      "displayName": "Bamboo Model",
      "baseUrl": "https://api.bamboonode.cn/v1",
      "apiKey": "${BAMBOO_API_KEY}",
      "provider": "generic-chat-completion-api",
      "maxOutputTokens": 16384
    }
  ]
}

maxOutputTokens 应根据所选模型能力调整。若配置文件已有 customModels,请只追加数组项,不要覆盖其他模型。

启动与验证

  1. Droid CLI 快速开始完成安装。
  2. 重启 Droid CLI,使环境变量和配置重新加载。
  3. 使用 /model 选择 Bamboo Model
  4. 发送一个只读任务,确认回复与流式输出正常。

常见问题

  • 模型未出现在选择器:检查 JSON 语法、字段大小写,并确认配置位于 ~/.factory/settings.json
  • 鉴权失败:确认启动 Droid 的进程能读取 BAMBOO_API_KEY
  • 工具调用失败:优先选择明确支持 OpenAI Chat Completions 工具调用的模型。

相关文档

本页目录