LobeHub
LobeHub

连接外部助理

LobeHub 将你的助理汇聚在同一个工作空间。除了在 LobeHub 中创建助理,你也可以接入外部编程助理和个人助理平台。

从创建助理 → 连接外部助理(Connect External Agents)进入,将本机或其他已连接设备上的助理接入 LobeHub。你在 LobeHub 中聊天,外部助理则通过自己的软件在所选设备上运行。

这不同于选择 AI 模型或添加 MCP 连接器:你接入的是一个助理运行环境,而不只是它使用的模型。

使用条件

  • 可用的执行设备:在目标电脑上使用 LobeHub 桌面应用,或通过 LobeHub CLI 连接该电脑。
  • 已安装的外部助理:在该设备上安装对应 CLI 或平台,并检查桌面应用或 CLI 进程能否找到其可执行程序。
  • 已完成外部助理设置:在同一设备上完成该产品要求的登录、模型配置或平台初始化。
  • 可访问的项目文件:处理项目任务时,选择该设备上已有的工作目录,并检查相应系统权限。

显示聊天的电脑,不一定是实际运行助理的电脑。 请在实际执行任务的电脑上完成安装和登录。

连接向导扫描本机桌面环境或已连接设备,不负责创建云沙箱。使用原生 CLI 还需要桌面端或 CLI 设备连接,浏览器配对本身无法运行原生 CLI。设备准备方法见执行设备。

支持的外部助理

接入清单包含以下 15 种助理:13 种编程 CLI 和 2 种个人助理平台。 每个条目均附有对应产品的官方安装或入门资料。

编程助理

助理接入的是什么官方准备方式
CodexOpenAI 的终端编程助理,可读取文件、修改代码和运行命令安装 Codex CLI,并完成登录。 安装指南
AmpAmp 的编程助理 CLI安装 CLI,并完成账号设置。 安装指南
Claude CodeAnthropic 的终端编程助理安装 Claude Code,并完成认证。 安装指南
CodeBuddy腾讯的 CodeBuddy Code CLI安装 CLI 产品,而不只是编辑器扩展。 安装指南
CursorCursor 的编程助理 CLI按官方指南准备 Cursor CLI;仅安装编辑器不一定足够。 安装指南
Factory DroidFactory 的 Droid 编程助理 CLI安装 Droid,并完成 Factory 登录。 安装指南
DevinCognition 的 Devin CLI在执行设备上准备 CLI,而不只是创建云端 Devin 会话。 安装指南
Grok BuildxAI 面向终端和自动化工作流的编程助理完成 Grok Build 的安装与认证。 安装指南
Kimi CodeMoonshot AI 的 Kimi Code CLI安装 Kimi Code CLI,并完成初始化。 安装指南
OpenCode支持多个模型服务商的开源编程助理安装 OpenCode,并配置模型服务商。 安装指南
Pi可扩展的 Pi 终端编程助理,不是 Inflection 的 Pi 聊天产品安装编程助理,并配置模型访问。 安装指南
QoderQoder 的编程助理 CLI安装 Qoder CLI,并完成账号设置。 安装指南
TRAE CLI官方文档称为 TraeCode CLI 的企业版 CLI准备企业账号权限并安装 CLI,这是与 Trae Agent 项目不同的产品。 安装指南

个人助理平台

助理接入的是什么官方准备方式
OpenClaw支持网关和消息渠道的自托管个人助理平台在目标设备上安装 OpenClaw,并完成引导与模型配置。 安装指南
HermesNous Research 的 Hermes Agent,支持终端和消息渠道的个人助理安装 Hermes Agent,并完成模型与平台配置。 安装指南

OpenClaw 和 Hermes 与编程 CLI 使用同一个连接向导。LobeHub 可以读取它们已有的助理档案,预填可用的档案信息。

接入清单中的产品前,请先安装对应软件,并确认账号有使用权限。操作系统支持、订阅、企业权限和地区可用性取决于外部产品。TRAE 的链接指向中文文档中的企业版 CLI 指南。

安装并准备外部助理

  1. 打开所选助理的官方安装或入门指南。
  2. 在实际执行任务的设备上安装所需 CLI 或平台。
  3. 在同一设备上完成登录或模型配置。
  4. 先在该产品的终端界面中运行一个简单任务,检查是否可用。
  5. 回到 LobeHub,扫描该设备。

安装编辑器后,可能还需要单独安装助理 CLI。本机助理也需要单独配置,即使你已经能使用服务商的聊天网站。

向导会检测已安装的助理,并在能获取版本时显示版本号。扫描完成后,请在开始任务前检查登录、模型访问和项目权限。

在 LobeHub 中连接

打开连接向导

打开创建助理菜单,选择连接外部助理(Connect External Agents)。

选择执行设备

在桌面端,选择这台电脑,使用安装在本机的助理。也可以从已连接设备列表中选择一台在线电脑。

如果没有可用设备,先通过桌面应用或 LobeHub CLI 连接设备。在团队工作空间中,请使用属于该工作空间的设备。

扫描并选择助理

LobeHub 自动扫描所选设备。可用助理排在前面,能获取版本时也会显示版本号。

勾选一个或多个助理。标记为未安装的条目不可选择。完成安装或调整设置后,点击重新扫描。

接入并开始对话

点击接入,添加选中的助理。每个选项都会在 LobeHub 中创建一个独立助理。

只选一个助理时,可以在接入前按需自定义名称和描述。选择多个助理时,会一起接入,不经过这个自定义步骤。

在成功页面中打开对话。开始第一项项目任务前,检查执行设备和工作目录。

向导显示三个设置步骤,但第三步是仅适用于单选助理的可选档案自定义步骤。

工作目录

对于编程任务,工作目录是执行设备上的项目路径,不是只用来显示聊天的电脑上的文件夹。

第一项任务前,先选择设备和项目。可以从只读任务开始,例如:

读取项目说明并总结仓库结构。不要修改文件,也不要运行安装命令。

切换目录可能需要开启新的外部助理会话。聊天记录不会把运行时会话状态或项目文件迁移到另一目录或设备。

OpenClaw 和 Hermes 的平台配置、工作空间、记忆和已保存上下文仍单独保留,与 LobeHub 话题分开管理。

项目说明与技能

项目说明和技能仍遵循各个外部助理的约定。例如,Claude Code 使用 CLAUDE.md,Codex 使用 AGENTS.md 提供项目指引。

在 LobeHub 服务端运行的助理还可以查找项目中的 .agents/skills、.claude/skills、AGENTS.md 和 CLAUDE.md。目录存放技能,Markdown 文件存放项目说明,不是技能包。详见执行设备。

各集成可读取的文件和可用的 LobeHub 技能有所不同。请遵循所选助理的约定,并在修改前要求它读取相关项目说明。

权限

层级控制内容
LobeHub 工具权限已提供的连接器工具直接运行、先询问,还是关闭
外部助理权限CLI 或平台自身对文件访问、命令、审批和其他操作的规则
设备权限操作系统账号和进程实际能够访问的范围

LobeHub 连接器权限不能替代外部助理自身的权限系统。外部助理的原生命令也不一定经过 LobeHub 连接器。

工作目录不是安全沙箱。 开始任务前,请检查助理的访问范围和审批设置。破坏性命令、发布或其他会产生实际影响的修改,应先由你审核。

聊天中能看到什么

LobeHub 在对话中显示外部助理的回复。根据集成方式和助理返回的信息,你还可能看到:

  • 工具调用和命令输出:包括可用的状态与执行结果
  • 文件变更:包括可用的差异内容
  • 计划和进度:助理返回的任务进展
  • 询问或审批请求:适用于集成支持对应交互的情况。

可见的进度信息、控件和工具因集成而异。外部产品中的部分原生功能可能暂时无法通过 LobeHub 使用。

会话与恢复

后续工作可以继续在同一话题中进行。运行时会话能否恢复,取决于外部助理、集成方式以及原会话是否仍可用。

更换设备、切换目录或遇到中断后,先检查运行状态,再继续操作。即使聊天记录仍在,也请检查原始助理会话是否已恢复。如果 LobeHub 提示已开启新会话,请重新说明必要的背景。

常见问题

问题排查方法
没有执行设备连接桌面应用或 LobeHub CLI。在工作空间中,还需检查设备的所属范围。
设备离线或扫描失败恢复设备连接后,重新扫描。
助理显示未安装检查是否安装在所选设备上,以及桌面应用或 CLI 进程能否找到可执行程序,然后重新扫描。
检测到了,但无法启动在该设备上直接运行助理,检查认证、模型访问、版本兼容性和账号要求。
找不到项目检查执行设备上的路径和权限,不要只检查聊天所在的电脑。
任务中途停止重试前检查输出和文件改动,不要假定已完成部分会自动回滚。
缺少产品原生功能查看集成支持的工具和控件,部分原生功能可能尚不可用。

使用技巧

  • 在实际执行设备上准备每个助理。
  • 先运行只读任务,再开始文件修改。
  • 如果不同项目使用不同设备或目录,可分别创建助理,减少混淆。
  • 检查结果和文件变更,再决定下一步操作。
  • 如果当前集成可使用浏览器工具,网页任务和手动接手方法见内置浏览器。