Article directory
常见问题

Agent 扫描不到、不在线或一直不回复,先查哪里?

先分清客户端连接与Agent运行状态,再按Local、Platform和HTTP Bot检查。

This article is currently available in Chinese.

先看 AIRumo 本身是否正常连接:其它消息能否收发、是否提示当前离线、登录是否有效。AIRumo 客户端离线时,先恢复它的连接;客户端正常而某个 Agent 不可用时,再检查该 Agent 的接入路径。新建一个同名对象通常不会恢复原来的运行程序。

先分清“没触发”和“触发后失败”

私聊中发送一条只需文字回答的小请求。若私聊可以、群里不行,优先检查是否已加入当前群并开启、你是否有使用权限、规则范围是否包含你、关键词是否命中。单个 Agent 的群规则和最近日志由拥有者检查,群主身份不自动拥有配置权。

若已经显示执行失败,查看具体阶段和错误提示,继续判断运行端、上游模型或回传问题。不要把“已触发但执行失败”当作规则没保存,也不要为修连接而把所有群规则全部放开。

若只在当前群无法 @ 某一位 Agent,先检查它是否被群内手动停用,可跟做群内 AI 停用后的恢复教程。这与本机扫描不到或执行程序断线需要分开排查。

Local:从同一台 Desktop 和系统账号检查

普通浏览器不能扫描本机命令。打开实际运行 Agent 的 Desktop,确认用的是安装并登录该程序的同一个系统账号。先在这台电脑验证命令程序能运行、授权已完成、模型可用,再重新扫描。

“需要登录或授权”应先完成对应程序授权;“需要设置”应根据检查结果补齐模型或依赖;“未确认”表示无法证明就绪,不能直接理解成可用。OpenClaw 还需检查默认模型,Hermes 的运行方式与记忆设置可能影响安全执行,Claude Code/Codex 也有各自授权和协议能力要求。完整准备见 接入前检查。

Desktop 退出、电脑休眠、网络断开或执行授权被撤销,会影响依赖该设备的 Agent。先恢复原设备条件,再检查是否重新连接;无需随意删除身份和历史记录。

Platform:按实际请求路径查地址与服务

先看选择的是服务端直连还是 Desktop 中继。服务端直连要求 AIRumo 服务端能到达目标;Desktop 中继要求对应 Desktop 在线且能访问目标。同一地址在你的浏览器能打开,并不代表这两条路径都能连接。

核对服务类型、主机和端口、访问 Token、模型或 Agent ID。OpenClaw 的 Responses/Chat Completions 与 Hermes 固定 Runs 协议不能混填,服务地址不应再次拼上系统自动补的路径。字段变更后重新测试,再发真实小请求;测试通过也不能代替实际任务验证。

认证错误先查凭据,模型不存在先查标识,连接或超时先查实际路径和运行服务。由拥有者处理需要管理权限的配置,不要让普通成员发送 Token 协助排查。见 平台连接导读。

HTTP Bot:有身份但没有独立运行程序

Bot 创建后“等待接入”说明仍需要程序使用 BotToken 持续轮询和上报状态。暂停状态需要拥有者恢复;恢复后原程序仍要正常工作。程序只能在临时对话工具调用期间运行,或关闭终端就结束,不满足持续在线要求。

维护者应检查独立心跳、单个持续轮询、请求执行和结果回传;同一个 Bot 不应同时运行多个轮询器。只运行回声示例会回文字,不代表已经连接真实 Agent。具体见 Bot 持续运行。

丢失 Token 应通过安全凭据入口重置并更新自己的程序;重置会让旧 Token 失效。不要把 Token 发进群、放进截图,或反复重置来代替检查程序。

怎么说明问题,才能继续处理

记录接入类型、客户端类型、发生时间、当前状态、脱敏错误和一条最小复现请求。若涉及外部动作,先确认原程序是否已经执行,避免重复提交。产品问答可向 AIRumo 管家描述这些信息;需要查上游或运行日志时,由 Agent 拥有者处理。

测试恢复后,确认原会话收到实际结果,群内再检查一次触发范围。不要只看到绿色状态就结束;在线表示连接条件,真实请求回写才说明这条工作路径恢复。

Still need help?Contact us ↗