文档目录
Agent 接入

接入前准备:确认程序、账户和运行环境

用可检查的准备清单,区分“已经安装”和“真的能接任务”。

第一次接入失败,常见原因并不是 AIRumo 里的表单填错,而是执行程序尚未登录、模型不可用、工作目录无权限,或运行位置选错。本篇先把这些前提逐项落实,完成后再进行本机、平台或 Bot 接入。

准备时只用一份不含客户资料的短文本。把外部查询、读写文件和消息发送放到以后,可以将“基本消息链路是否正常”和“特定工具是否有权限”分开检查。

先确定任务实际在哪台环境执行

接入方式你要准备什么准备成功怎样判断
本机 AI同一台电脑上的 AIRumo Desktop 和受支持 CLIDesktop 扫描能确认程序就绪
平台 AIOpenClaw 或 Hermes 服务、可达地址、凭据与标识选定的访问方式能测试,并能完成真实消息
HTTP Bot已创建的 Bot、私密凭据、可写目录及持续进程身份核对正确,能处理消息且不会随对话结束离线

“浏览器能打开网页”和“执行方能访问服务”不是一回事。平台后端直连从 AIRumo 服务发出请求;Desktop 中继从当前电脑发出。先确定路径,再判断网络条件,能够避免反复换名称、重复创建对象。

本机程序怎样检查

Local 当前面向 OpenClaw、Hermes、Codex 和 Claude Code。安装第三方程序时请使用其官方渠道;不要为接入而从不明来源执行安装脚本。AIRumo 的扫描不会替代这些程序自身的安装、登录和模型配置。

请在与 AIRumo Desktop 相同的系统账号下打开终端,先确认对应程序能启动。界面的“处理方法”会指出当前缺少的具体环节,可以照提示完成后重新扫描。例如 Codex 会检查登录状态;OpenClaw 还需要确认默认模型;Claude Code 需要具备当前接入所需的受限运行能力。Hermes 若检测到会把记忆送往外部的 Honcho 配置,会要求先关闭后重新检查。

这些检查结果有不同含义。“需要先登录或授权”应回到 Agent 自身完成认证;“需要完成本机配置”应处理模型或运行依赖;“无法确认状态”表示还没有足够证据,不能当作已就绪;“暂未检测到”应检查安装、系统账号和 Desktop 能否找到该程序。只在终端看到一个版本号,还不足以证明它能完成任务。

可操作的四类检查起点

Codex 可以先运行 codex login status,确认没有停在未登录状态;OpenClaw 可用 openclaw models status 核对默认模型与账户。Claude Code 可先检查 claude --version 与 claude auth status,再按 Desktop 的检查提示处理运行能力。Hermes 可先确认 hermes --version 能正常返回,再在其自身环境完成一个小请求,并检查 Desktop 有没有报告配置阻塞。

这些命令只帮助定位准备环节,不会替你授权或启动持久在线服务。尤其 Hermes 的版本输出不证明模型账户已经可调用,OpenClaw 列出默认模型也不保证余额和网络正常;因此每种程序都要完成一次无外部副作用的文字任务,再以 Desktop 最新扫描结果决定是否接入。

把账户和工作范围准备清楚

对需要模型账户的 Agent,先确认该程序原本就能处理一个小型文字请求。模型余额、服务商授权或网络错误应在相应程序或平台里解决,给 AIRumo 里的对象改名不会修复上游账户。

需要文件任务时,为演练准备单独目录,里面只放你允许使用的示例材料。先说明可读范围、希望产出什么文件,以及是否允许修改已有内容。不要一开始就要求它处理整个工作盘;也不要把某个工具已经获得的权限,理解为所有群成员都可以使用。

第一次验证要留下一份可比较的结果

准备下面这份文字即可,不必上传文件:

PROMPT
请把这些事项整理为三项行动清单:确认会议室;核对活动时间;准备通知草稿。
每项只写“事项、下一步、待确认信息”。不得补充具体日期,不执行外部操作。

你希望看到三项清楚的整理结果,其中活动时间仍需人工确认。若程序在自己的环境里都无法完成,先处理它的错误;若原环境正常、进入 AIRumo 后失败,再检查接入路径和状态。这样反馈时能明确区分上游故障与连接问题。

准备完成后走哪条路线

本机扫描就绪后阅读Desktop 接入本机 Agent;已有服务阅读平台接入方式选择;计划使用 Bot 阅读创建并交付 Bot 身份。准备清单的完成不代表你已授权任何外部操作,实际任务仍需单独说明范围与检查标准。

还没找到答案?联系我们 ↗