目录

Droid 安装配置指南

分支
  1. OpenCode 安装配置指南
  2. OpenClaw模型配置教程
  3. 自动配置插件
  4. mcp-生图插件
本指南教你在 5 分钟内，把 Droid（Factory 出品的 AI 编程助手）接到本站模型。完全照着抄就行，不用懂原理。

一、安装并登录

第 1 步：安装 Droid

Windows（用管理员身份打开 PowerShell）： 

irm https://app.factory.ai/cli/windows | iex

macOS / Linux： 

curl -fsSL https://app.factory.ai/cli | sh

第 2 步：登录账号

Droid 需要谷歌老账号登录才能启动（账号找群主购买）。

在终端输入 droid 回车，会自动打开浏览器，登录 Google 账号即可。

如果你以前设过 FACTORY_API_KEY 环境变量（旧版的假 Key），请先删掉它，否则会和登录冲突。

第 3 步：启动

cd 你的项目目录
droid

二、配置本站模型（duojie.games）

第 1 步：获取 API Key

  1. 闲鱼买的兑换码是用来兑换额度的，不是 API Key
  2. API Key 要去 令牌页面 自己生成一个

第 2 步（二选一）：写入配置

方式一：一键配置工具（推荐，最省事）

本站的 duojie-helper 会自动把模型写进 Droid，不用手动改任何文件（需先装好 Node.js）。 

npx duojie-helper@latest

按提示操作：粘贴 API Key → 方向键选中 droid（空格勾选）→ 回车，搞定。

也可以直接只配 Droid： 

npx duojie-helper@latest config droid
这个工具会自动写好正确的模型地址、接口类型，还会顺手配好「压缩模型」，避免压缩报错。新手强烈推荐用它。

方式二：手动编辑 settings.json

适合想自己掌控配置、或一键工具出问题的同学。

配置文件在哪：

系统 路径
Windows C:\Users\<用户名>\.factory\settings.json
macOS / Linux ~/.factory/settings.json
文件不存在就自己建一个。Windows 快速打开：在资源管理器地址栏输入 %USERPROFILE%\.factory 回车。

打开（或新建）settings.json，填入下面这段——把“你的密钥”换成你在令牌页面生成的 API Key： 

{
  "customModels": [
    {
      "model": "claude-opus-5",
      "displayName": "Opus 5 [duojie.games]",
      "baseUrl": "https://api.duojie.games",
      "apiKey": "你的密钥",
      "provider": "anthropic",
      "maxOutputTokens": 16384
    },
    {
      "model": "gpt-5.6-sol",
      "displayName": "GPT 5.6 Sol [duojie.games]",
      "baseUrl": "https://api.duojie.games/v1",
      "apiKey": "你的密钥",
      "provider": "openai",
      "maxOutputTokens": 16384
    },
    {
      "model": "glm-5.2",
      "displayName": "GLM 5.2 [duojie.games]",
      "baseUrl": "https://api.duojie.games/v1",
      "apiKey": "你的密钥",
      "provider": "generic-chat-completion-api",
      "maxOutputTokens": 16384
    }
  ],
  "compactionModel": "same"
}

想要更多模型，照着往 customModels 数组里照葫芦画瓢加就行，本站全部模型见 定价页。

字段说明

字段 说明 必填
model 模型 ID，在定价页复制 是
displayName 在 Droid 里显示的名字，随便起 是
baseUrl API 地址（怎么选见下方） 是
apiKey 你的 API Key 是
provider 接口类型，只有 3 种：anthropic / openai / generic-chat-completion-api 是
maxOutputTokens 单次最大输出长度，可省略 否
provider 和 baseUrl 怎么选（选错直接报错，务必看）：
和旧版的区别：以前是写在 config.json、用 custom_models（下划线）的老格式；现在官方改成 settings.json、customModels（驼峰）。老格式还能用，但推荐换成新的，settings.json 的优先级更高。两个文件都配了的话，以 settings.json 为准。

三、切换模型

在 Droid 聊天框输入 /model，在列表里选你配的模型即可。

看不到你配的模型？八成是 JSON 语法错了（多了逗号、少了引号）。去 JSON 校验工具 查一下，改完会自动生效，不用重启。

四、开启「思考模式」（让模型想得更深）

思考模式让模型在回答前先深入推理，适合复杂任务。

最简单的方式：用 /settings

  1. 输入 /settings
  2. 找到 Reasoning Effort（思考深度），调高（比如 high）
  3. 想看到思考过程，把 Show Thinking 打开
  4. 保存即可

思考深度从低到高：off（关）→ low → medium → high → xhigh → max。具体能选哪几档取决于模型，不同模型支持的不一样。

也可以直接改 settings.json 里这两个字段： 
{
  "reasoningEffort": "high",
  "showThinkingInMainView": true
}

五、常用命令

命令 作用
/model 切换模型
/settings 打开设置（思考、压缩、声音等都在这）
/clear 清空当前对话
/compact 手动压缩上下文
/help 查看帮助
Esc 按两下 打断当前操作
Ctrl+C 退出 Droid
droid –version 查看版本

六、常见问题

Q：提示 400 错误？

A：通常是模型 ID 写错，或 provider 选错。去定价页核对模型 ID，并按上面的「provider 怎么选」对照。

Q：提示 401 错误 / API Key 无效？

A：确认已用谷歌账号登录，且 apiKey 填对了。注意：闲鱼兑换码≠API Key，API Key 要在令牌页面单独生成。

Q：/model 列表里看不到我配的模型？

A：settings.json 的 JSON 语法错了。用JSON 校验工具检查，改完自动生效。

Q：找不到 settings.json 文件？

A：它默认不存在，自己在 .factory 目录下新建一个即可。

Q：如何添加更多模型？

A：在 customModels 数组里照着已有的格式加一条就行。

Q：压缩失败（compaction failed）？

A：用第三方模型时，压缩默认会去找官方模型，因没权限而失败。解决方法二选一：

  1. 用 duojie-helper 一键配置（会自动帮你设好，最省心）
  2. 或在 settings.json 里加上 “compactionModel”: “same”（压缩用当前模型），也可以在 /settings 里把压缩模型（Summarization/Compaction Model）手动选成当前在用的模型

Q：创建会话失败（Failed to create session / daemon running）？

A：旧版可能残留了 FACTORY_API_KEY 环境变量（假 Key），和新版登录冲突。解决：

  1. 删掉系统环境变量里的 FACTORY_API_KEY（Windows：系统属性 → 环境变量 → 删除；macOS/Linux：编辑 ~/.bashrc 或 ~/.zshrc 删掉对应 export 行）
  2. 关掉并重新打开终端
  3. 运行 droid，用谷歌账号重新登录

如果还不行，把 %USERPROFILE%\.factory\settings.json（macOS/Linux：~/.factory/settings.json）删掉，重新登录、重新配置一遍。

Q：如何更新 Droid？

A：重新运行一遍安装命令即可覆盖更新。

Q：代理 / VPN 下连不上？

A：设置环境变量： 

# Linux / macOS
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
 
# Windows PowerShell
$env:HTTP_PROXY="http://127.0.0.1:7890"
$env:HTTPS_PROXY="http://127.0.0.1:7890"

Q：如何完全卸载？

A：

官方资源