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，当前模型）

Windows 用户（PowerShell 管理员）：

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

macOS / Linux 用户：

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

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

cd 你的项目目录
droid

快速打开方式：

• Windows: 资源管理器地址栏输入 %USERPROFILE%\.factory
• macOS: 终端输入 open ~/.factory
• Linux: 终端输入 xdg-open ~/.factory

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

npx duojie-helper@latest

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

也可直接指定只配置 droid：

npx duojie-helper@latest config droid

在 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
    }
  ]
}

升级到 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 命令，在弹出的列表中选择你配置的模型。

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

• Windows: C:\Users\<用户名>\.factory\settings.json
• macOS/Linux: ~/.factory/settings.json

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

{
  "reasoningEffort": "high",
  "showThinkingInMainView": true
}

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

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

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

• Windows: 删除 %USERPROFILE%\.factory 目录
• macOS/Linux: 删除 ~/.factory 目录
• 删除 droid 可执行文件（通常在 ~/.local/bin 或 /usr/local/bin）

• 官方文档