Article directory
Agent 接入

通过 Desktop 接入本机 Agent

完成扫描、接入与真实对话,分清安装状态、连接状态和执行结果。

This article is currently available in Chinese.

本篇适合已经在自己的电脑上准备好 OpenClaw、Hermes、Codex 或 Claude Code,希望从 AIRumo 会话交给它任务的人。Local 的执行仍依赖这台电脑及对应程序,AIRumo Desktop 负责发现、连接和展示;它不会把本机程序变成一台永久在线的远端服务。

完成本篇后,你应能说明接入的是哪个程序、运行在哪台电脑,并在原会话里收到一次可检查的真实回复。若还没有安装或配置程序,先完成接入前准备,再回来扫描。

视频演示

Desktop 接入本机 Agent(字幕版)01:38

在 Desktop 扫描本机 Agent,检查就绪,接入 Codex 并验证一次文字任务回复。视频实际演示 Codex;其它程序仍需分别确认自己的安装、授权和就绪状态。

Open original video

一、使用同一台电脑和同一系统账号

在运行 Agent 的电脑上打开 AIRumo Desktop,登录你准备使用的 AIRumo 账号。普通浏览器不能代替 Desktop 进行本机扫描。若程序装在另一系统账号下、只在另一个终端环境可见,Desktop 未必能够找到它。

先在该电脑确认 Agent 自身的登录和模型可用,再打开 AIRumo 的接入流程。第一条验证使用纯文字,不要求联网或读取个人目录;这样即使失败,也能先检查连接,而不用同时排查文件授权。

二、扫描并理解每个检查结果

进入“AI → 接入 AI”,选择“扫描本机 AI”,点击“开始扫描”。等待检查结束后逐项阅读程序名称、当前状态和“处理方法”,不要在扫描过程中反复点击接入。

结果说明应做什么
已就绪当前检查确认了接入前提选择该项继续接入
需要先登录或授权程序自己的认证尚未满足到对应程序完成认证,再重新扫描
需要完成本机配置模型或运行条件不完整按处理方法配置后复查
无法确认状态当前证据不足保留检查提示,不当作已就绪
暂未检测到Desktop 没有发现可用程序核对安装位置、系统账号与程序是否可启动

如果你刚更新了 CLI 或切换了模型,使用“重新扫描”重新检查,不要用以前的一张状态截图证明当前仍然可用。某个程序显示就绪,也不能证明同一电脑上的其它程序已经准备好。

三、接入后核对来源,再开始会话

对“已就绪”的程序点击“接入”,等待页面显示“已接入”。完成后回到 AI 列表,核对名称和本机来源。相同名字可能对应不同接入对象;当你看到“非本客户端”等来源提示时,应先确认绑定的执行电脑,而不是直接删除重建。

从接入完成页或 AI 列表的聊天入口开始会话,发送下面这条消息一次:

PROMPT
请整理一份内部读书活动准备清单。
已知:线下进行,时长60分钟,需要通知草稿、主持提纲和材料清单;日期和场地未定。
输出三列:准备事项、下一步、需要我确认的信息。只整理文字,不读写文件,不发送通知。

等待当前请求返回。参考结果应包含通知、主持提纲和材料三项,并把日期、场地保留为待确认。具体措辞不必一致,关键是内容符合材料,而且回复出现在刚才发起任务的会话里。

检查第一轮结果时,可以把输入中的“日期和场地未定”作为一个刻意保留的缺项。如果回复给出了具体日期或地点,说明内容验收未通过,应纠正材料使用方式;如果回复显示在另一个同名 Agent 会话里,先核对对象和来源。这两种情况都不同于扫描没发现程序,不能用重新安装来统一解决。保留本轮原请求与实际回复,能够在后续任务失败时比较:连接还在不在、使用的是不是原来的对象、是否只是任务材料变复杂了。

四、用一次继续修改确认会话走通

在同一会话补充:“保留刚才三项,把下一步各缩短到20字内,日期和场地仍待确认。”观察是否继续修改了原结果。不要另开一个同名对象来测试延续;那会改变会话条件,使问题更难定位。

文字流程走通后,再逐步增加文件或工具任务。请明确允许使用的目录和操作范围,并检查该 Agent 当前是否具备相应能力。成功整理文字不代表它已经能够读取任何文件、浏览网页或修改外部系统。

五、保持运行条件并知道何时排查

电脑休眠、退出 Desktop、程序认证失效或执行授权被撤销,都可能影响之后的请求。收到回复前不要因为等待稍长就重复发送同一任务;先看原请求是否仍在处理。

如果扫描失败,保留状态和处理方法;如果已接入但不回复,核对程序、设备、模型账户及原请求状态。只在一个群里失败时,还要检查群内加入状态和响应规则。下一步可阅读Agent 离线与不响应排查,或完成单 Agent 任务案例。

Still need help?Contact us ↗