这里会显示出您选择的修订版和当前版本之间的差别。
| 两侧同时换到之前的修订记录前一修订版后一修订版 | 前一修订版 | ||
| 知识库:droid指南 [2026/02/25 14:06] – 邪让多杰 | 知识库:droid指南 [2026/04/17 17:37] (当前版本) – [v100+ 升级后出现错误?] 邪让多杰 | ||
|---|---|---|---|
| 行 4: | 行 4: | ||
| - [[opencode指南|OpenCode 安装配置指南]] | - [[opencode指南|OpenCode 安装配置指南]] | ||
| - [[openclaw_小龙虾_指南|OpenClaw模型配置教程]] | - [[openclaw_小龙虾_指南|OpenClaw模型配置教程]] | ||
| - | + | - [[配置插件|自动配置插件]] | |
| - | < | + | - [[mcp-生图插件]] |
| - | < | + | |
| - | npx duojie-helper@latest | + | |
| - | </ | + | |
| ===== 简要步骤说明:===== | ===== 简要步骤说明:===== | ||
| 行 15: | 行 12: | ||
| - **步骤1** - 安装 Droid:运行安装命令 | - **步骤1** - 安装 Droid:运行安装命令 | ||
| - | - **步骤2** - 设置环境变量:让 Droid 能启动(FACTORY_API_KEY 随便填个值) | + | - **步骤2** - 登录账号:用< |
| - | - **步骤3** - 配置 | + | - **步骤3** - 配置第三方模型(二选一): |
| - | * 在中转站 <color # | + | * 推荐:运行 |
| - | * 在 <color #22b14c>令牌</ | + | * 备选:手动编辑 |
| - | * 把 Key 填入 | + | - **步骤4** - 用 <color # |
| - | * 如果以前有用过,需要更新或删除< | + | |
| - | - **步骤4** - 切换模型:在 Droid 里用 <color # | + | |
| 行 40: | 行 35: | ||
| </ | </ | ||
| - | == 第二步:设置环境变量(必须!) | + | == 第二步:登录账号 |
| - | <note important> | + | <note important> |
| - | **Windows | + | 运行 '' |
| - | 方法一:PowerShell 临时设置(关闭窗口后失效) | + | <note warning>如果你之前设置过 '' |
| - | <code powershell> | + | |
| - | $env: | + | |
| - | </ | + | |
| - | + | ||
| - | 方法二:永久设置系统环境变量(推荐) | + | |
| - | <code powershell> | + | |
| - | # 以管理员身份运行 PowerShell | + | |
| - | [System.Environment]:: | + | |
| - | </ | + | |
| - | 或者:右键" | + | |
| - | * 变量名:'' | + | |
| - | * 变量值:'' | + | |
| - | + | ||
| - | **macOS 用户:** | + | |
| - | + | ||
| - | 方法一:临时设置(关闭终端后失效) | + | |
| - | <code bash> | + | |
| - | export FACTORY_API_KEY=" | + | |
| - | </ | + | |
| - | + | ||
| - | 方法二:永久设置(推荐) | + | |
| - | <code bash> | + | |
| - | # 添加到 ~/ | + | |
| - | echo ' | + | |
| - | source ~/.zshrc | + | |
| - | </ | + | |
| - | + | ||
| - | **Linux 用户:** | + | |
| - | + | ||
| - | 方法一:临时设置(关闭终端后失效) | + | |
| - | <code bash> | + | |
| - | export FACTORY_API_KEY=" | + | |
| - | </ | + | |
| - | + | ||
| - | 方法二:永久设置(推荐) | + | |
| - | <code bash> | + | |
| - | # Bash 用户添加到 ~/.bashrc | + | |
| - | echo ' | + | |
| - | source ~/.bashrc | + | |
| - | + | ||
| - | # Zsh 用户添加到 ~/.zshrc | + | |
| - | echo ' | + | |
| - | source ~/.zshrc | + | |
| - | </code> | + | |
| == 第三步:启动 Droid == | == 第三步:启动 Droid == | ||
| 行 112: | 行 63: | ||
| * **macOS**: 终端输入 '' | * **macOS**: 终端输入 '' | ||
| * **Linux**: 终端输入 '' | * **Linux**: 终端输入 '' | ||
| - | |||
| - | < | ||
| ===== 配置第三方渠道 (duojie.games) ===== | ===== 配置第三方渠道 (duojie.games) ===== | ||
| 行 124: | 行 73: | ||
| </ | </ | ||
| - | === 配置示例 === | + | === 方式一:一键配置工具(推荐) === |
| + | |||
| + | '' | ||
| + | |||
| + | <code bash> | ||
| + | npx duojie-helper@latest | ||
| + | </ | ||
| + | |||
| + | 运行后按提示操作:输入 API Key → 勾选 '' | ||
| + | |||
| + | 也可直接指定只配置 droid: | ||
| + | |||
| + | <code bash> | ||
| + | npx duojie-helper@latest config droid | ||
| + | </ | ||
| + | |||
| + | === 方式二:手动配置 config.json | ||
| 在 '' | 在 '' | ||
| 行 132: | 行 97: | ||
| " | " | ||
| { | { | ||
| - | " | + | " |
| - | " | + | " |
| " | " | ||
| " | " | ||
| 行 141: | 行 106: | ||
| }, | }, | ||
| { | { | ||
| - | " | + | " |
| - | " | + | " |
| " | " | ||
| " | " | ||
| 行 150: | 行 115: | ||
| }, | }, | ||
| { | { | ||
| - | " | + | " |
| - | " | + | " |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | }, | + | |
| - | { | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | }, | + | |
| - | { | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | }, | + | |
| - | { | + | |
| - | " | + | |
| - | " | + | |
| " | " | ||
| " | " | ||
| 行 195: | 行 133: | ||
| }, | }, | ||
| { | { | ||
| - | " | + | " |
| - | " | + | " |
| - | " | + | " |
| " | " | ||
| - | " | + | " |
| " | " | ||
| " | " | ||
| }, | }, | ||
| { | { | ||
| - | " | + | " |
| - | " | + | " |
| - | " | + | " |
| " | " | ||
| - | " | + | " |
| - | " | + | |
| - | " | + | |
| - | }, | + | |
| - | { | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| " | " | ||
| " | " | ||
| 行 237: | 行 166: | ||
| | '' | | '' | ||
| - | <note important> | + | <note important> |
| + | |||
| + | ===== v100+ 升级后出现错误?(Failed to create session.Is the daemon running?) ===== | ||
| + | |||
| + | 升级到 v100 版本之后如果出现各种报错,按以下步骤重置: | ||
| + | |||
| + | - 删除 '' | ||
| + | * Windows: '' | ||
| + | * macOS/ | ||
| + | - 删除系统环境变量中的 '' | ||
| + | - 重新打开终端,运行 '' | ||
| + | - 用 ''/ | ||
| + | - 用 ''/ | ||
| + | * 压缩上下文大小:**200k** | ||
| + | * 压缩模型:选**当前使用的主模型** | ||
| ===== 切换模型 ===== | ===== 切换模型 ===== | ||
| 行 316: | 行 260: | ||
| **Q: 提示 401 错误?** | **Q: 提示 401 错误?** | ||
| - | A: 环境变量未设置或 | + | A: API Key 无效或未登录。确认已用谷歌老账号登录,并检查 |
| ---- | ---- | ||
| 行 341: | 行 285: | ||
| A: 在 '' | A: 在 '' | ||
| + | |||
| + | ---- | ||
| + | |||
| + | **Q: 压缩失败(compaction failed)?** | ||
| + | |||
| + | A: 使用第三方模型时,压缩功能的默认模型指向官方模型,会因无权限而失败。解决方法: | ||
| + | - 在 Droid 中输入 ''/ | ||
| + | - 找到**压缩模型(Summarization Model)**选项,从官方模型切换为**当前正在使用的第三方模型** | ||
| + | - 找到**压缩上下文大小**,设置为 '' | ||
| + | - 保存即可 | ||
| + | |||
| + | ---- | ||
| + | |||
| + | **Q: 创建会话失败(session creation failed)?** | ||
| + | |||
| + | A: 旧版安装时可能设置了 '' | ||
| + | - **删除系统环境变量**中的 '' | ||
| + | - **关闭并重新打开终端**(确保环境变量生效) | ||
| + | - 运行 '' | ||
| + | |||
| + | ---- | ||
| + | |||
| + | **Q: 升级后登录失败或模型全部消失?** | ||
| + | |||
| + | A: 参考上方「v100+ 升级后出现错误?」章节,按步骤重置即可。 | ||
| ---- | ---- | ||
| 行 371: | 行 340: | ||
| * macOS/ | * macOS/ | ||
| * 删除 '' | * 删除 '' | ||
| - | |||
| - | ===== 重要警告 ===== | ||
| - | |||
| - | <note important> | ||
| - | **不要将中转站的 API Key 设置到 Factory 的环境变量中!** | ||
| - | |||
| - | * 中转站的 Key 只能用于 '' | ||
| - | * Factory 自身的环境变量(如 '' | ||
| - | * 混用会导致认证失败 | ||
| - | </ | ||
| ===== 官方资源 ===== | ===== 官方资源 ===== | ||