目录

Droid 安装配置指南

分支
  1. OpenCode 安装配置指南
  2. OpenClaw模型配置教程
  3. 自动配置插件
  4. mcp-生图插件

简要步骤说明：

完整配置只需 4 步：

  1. 步骤1 - 安装 Droid：运行安装命令
  2. 步骤2 - 登录账号：用谷歌老账号登录（找群主购买）
  3. 步骤3 - 配置第三方模型（二选一）：
    • 推荐：运行 duojie-helper 一键自动配置
    • 备选：手动编辑 config.json，填入 API Key
  4. 步骤4 - 用 /model 切换到本站模型；用 /settings 配置压缩选项（200k，当前模型）

30秒快速开始

第一步：安装 Droid

Windows 用户（PowerShell 管理员）： 

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

macOS / Linux 用户： 

curl -fsSL https://app.factory.ai/cli | sh
第二步：登录账号
Droid 现在需要使用谷歌老账号登录才能启动。账号可联系群主购买。

运行 droid 命令后，会自动跳转浏览器完成 Google 账号登录，登录成功后即可使用。

如果你之前设置过 FACTORY_API_KEY 环境变量（旧版假Key方式），请删除它，否则可能引起冲突。
第三步：启动 Droid
cd 你的项目目录
droid

配置文件位置

系统 配置文件路径
Windows C:\Users\<用户名>\.factory\config.json
macOS ~/.factory/config.json
Linux ~/.factory/config.json
如果 config.json 文件不存在，需要自己手动创建。

快速打开方式：

配置第三方渠道 (duojie.games)

获取 API Key

  1. 闲鱼购买的兑换码是用于兑换额度的，不是 API Key
  2. API Key 需要在 令牌页面 自行生成创建

方式一：一键配置工具（推荐）

duojie-helper 可以自动将配置写入 Droid，无需手动编辑文件。需要先安装 Node.js。 

npx duojie-helper@latest

运行后按提示操作：输入 API Key → 勾选 droid → 自动写入完成。

也可直接指定只配置 droid： 

npx duojie-helper@latest config droid

方式二：手动配置 config.json

在 config.json 中添加以下配置： 

{
  "custom_models": [
    {
      "model_display_name": "Opus 4.6 [duojie.games]",
      "model": "claude-opus-4-6-gemini",
      "base_url": "https://api.duojie.games",
      "api_key": "你的密钥",
      "provider": "anthropic",
      "supports_vision": true,
      "max_tokens": 8192
    },
    {
      "model_display_name": "Sonnet 4.6 [duojie.games]",
      "model": "claude-sonnet-4-6",
      "base_url": "https://api.duojie.games",
      "api_key": "你的密钥",
      "provider": "anthropic",
      "supports_vision": true,
      "max_tokens": 8192
    },
    {
      "model_display_name": "GLM-5 [duojie.games]",
      "model": "glm-5",
      "base_url": "https://api.duojie.games",
      "api_key": "你的密钥",
      "provider": "anthropic",
      "supports_vision": true,
      "max_tokens": 8192
    },
    {
      "model_display_name": "Sonnet 4.5 [duojie.games]",
      "model": "claude-sonnet-4-5",
      "base_url": "https://api.duojie.games",
      "api_key": "你的密钥",
      "provider": "anthropic",
      "supports_vision": true,
      "max_tokens": 8192
    },
    {
      "model_display_name": "GPT 5.4 [duojie.games]",
      "model": "gpt-5.4",
      "base_url": "https://api.duojie.games/v1",
      "api_key": "你的密钥",
      "provider": "openai-responses",
      "supports_vision": true,
      "max_tokens": 8192
    },
    {
      "model_display_name": "Gemini 3.1 Pro [duojie.games]",
      "model": "gemini-3.1-pro",
      "base_url": "https://api.duojie.games/v1",
      "api_key": "你的密钥",
      "provider": "openai",
      "supports_vision": true,
      "max_tokens": 8192
    }
  ]
}

配置字段说明

字段 说明 必填
model_display_name 在 Droid 中显示的模型名称 是
model 实际调用的模型 ID 是
base_url API 地址 是
api_key 你的 API 密钥（在令牌页面生成） 是
provider 提供商类型: anthropic, openai, gemini, openrouter 是
supports_vision 是否支持图片识别 否
max_tokens 最大输出 token 数 否
supports_prompt_caching 是否支持提示缓存 否
2025年12月25日后，如果你改了 config.json 里的已有模型，需要同时删除 settings.json 让配置重新生效。

v100+ 升级后出现错误？(Failed to create session.Is the daemon running?)

升级到 v100 版本之后如果出现各种报错，按以下步骤重置：

  1. 删除 settings.json：
    • Windows: %USERPROFILE%\.factory\settings.json
    • macOS/Linux: ~/.factory/settings.json
  2. 删除系统环境变量中的 FACTORY_API_KEY（旧版假Key残留）
  3. 重新打开终端，运行 droid，用谷歌老账号重新登录
  4. 用 /model 重新切换到本站模型
  5. 用 /settings 重新配置压缩选项：
    • 压缩上下文大小：200k
    • 压缩模型：选当前使用的主模型

切换模型

在 Droid 聊天界面输入 /model 命令，在弹出的列表中选择你配置的模型。

如果 /model 列表中看不到你配置的模型，说明 config.json 配置格式有误，请检查 JSON 语法。

如何开启思考模式

思考模式（Extended Thinking）可以让模型在回答前进行更深入的推理，适合复杂任务。

重要提示

每次切换模型后，settings.json 会被刷新！

如果你需要开启思考模式，必须在切换模型后手动修改 settings.json 文件。

配置文件位置

关键配置字段

在 settings.json 中找到并修改以下字段： 

{
  "reasoningEffort": "high",
  "showThinkingInMainView": true
}
字段 说明 可选值
reasoningEffort 开启思考：设置思考深度级别 low / medium / high
showThinkingInMainView 显示思考过程：是否在界面显示思考内容 true / false

思考深度说明

使用模型：`claude-opus-4-5-think`

操作步骤

  1. 使用 /model 切换到你想要的模型
  2. 打开配置目录 `C:\Users\用户名\.factory`
  3. 编辑 settings.json 文件
  4. 如果想看到思考过程，将 showThinkingInMainView 改为 true
  5. 保存文件，配置立即生效

常用命令速查

命令/快捷键 功能
/model 切换模型
/settings 打开设置
/clear 清空对话
/help 查看帮助
/compact 压缩上下文
Esc 两次 中断当前操作
Ctrl+C 退出 Droid
droid –version 查看版本

常见问题

Q: Windows 安装失败？

A: 确保以管理员身份运行 PowerShell。如仍失败，检查网络或尝试使用代理。

Q: 提示 400 错误？

A: 模型名称错误，检查 config.json 中的 model 字段是否正确。

Q: 提示 401 错误？

A: API Key 无效或未登录。确认已用谷歌老账号登录，并检查 config.json 中的 api_key 是否正确。

Q: 提示 API Key 无效？

A: 检查 api_key 是否正确填写。注意：闲鱼买的兑换码是兑换额度用的，API Key 需要在令牌页面单独生成。

Q: 模型列表中看不到配置的模型？

A: config.json 格式错误。使用在线 JSON 校验工具检查语法，然后重启 Droid。

Q: 找不到 config.json 文件？

A: 该文件默认不存在，需要自己在 .factory 目录下手动创建。

Q: 如何添加多个模型？

A: 在 custom_models 数组中添加多个配置项即可，参考上方多模型配置示例。

Q: 压缩失败（compaction failed）？

A: 使用第三方模型时，压缩功能的默认模型指向官方模型，会因无权限而失败。解决方法：

  1. 在 Droid 中输入 /settings
  2. 找到压缩模型（Summarization Model）选项，从官方模型切换为当前正在使用的第三方模型
  3. 找到压缩上下文大小，设置为 200k
  4. 保存即可

Q: 创建会话失败（session creation failed）？

A: 旧版安装时可能设置了 FACTORY_API_KEY 环境变量（假Key），导致与新版登录机制冲突。解决方法：

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

Q: 升级后登录失败或模型全部消失？

A: 参考上方「v100+ 升级后出现错误？」章节，按步骤重置即可。

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: 删除配置目录和可执行文件：

官方资源