Article directory
Agent 接入

平台接入:先选访问路径,再配置服务

理解后端直连与 Desktop 中继,避免地址可打开却无法完成真实请求。

This article is currently available in Chinese.

Platform 用来连接已经存在的受支持 OpenClaw 或 Hermes 服务。AIRumo 不会通过这个表单替你安装远端程序,也不会因为填写了服务名称就自动获得模型账户。你需要先向服务管理者确认服务种类、可达地址、API Token,以及它允许使用的模型或 Agent 标识。

本篇帮助你决定连接从哪里发出,并完成通用检查。具体服务字段和协议分别见OpenClaw 平台接入与Hermes 平台接入。这样可以沿着自己的服务类型学习,不必把另一套协议也配置一遍。

看清谁在访问服务

访问方式请求实际从哪里发出使用条件
后端直连AIRumo 服务该服务能被 AIRumo 后端访问,地址与凭据适合这条路径
Desktop 中继当前 Desktop 所在电脑服务可被该电脑访问,且中继配置完成、Desktop保持在线

Web 的平台接入使用后端直连。在支持中继的 Desktop 中,平台接入界面会提供访问方式选择。只在你电脑内或特定网络可达的服务,不能因为浏览器能打开就假定后端也能访问。

例如,服务管理者说“这个地址只有办公电脑能访问”。你需要先决定让 Desktop 中继,还是请管理者提供后端真正可达的服务入口;更换模型名字或反复保存连接都不能改变网络路径。不要为了连接成功而临时关闭访问控制。

准备一张连接资料卡

保存前先私下核对以下资料:服务属于 OpenClaw 还是 Hermes;服务的主机和端口;使用哪种访问方式;凭据属于哪个服务账户;模型或 Agent 标识;希望如何区分同名服务。凭据单独妥善保存,不写进服务名称、说明、截图或公开反馈。

服务地址字段只填写该服务的主机和端口。界面会说明实际请求路径,不要自己叠加指南网页、聊天页面或接口路径。OpenClaw 的请求协议与 Hermes Runs 不同,应先选服务类型,再按照相应教程填写。

正确理解“测试连接”和“完成接入”

进入“AI → 接入 AI → 连接 AI 平台”。先选择服务类型和访问方式,填写服务名称、地址、API Token、模型或 Agent ID。名称用于辨认,模型或 Agent ID 用于实际请求,二者不能混用。

点击“测试连接”并阅读结果;如果随后修改了地址、Token、模型或协议,应重新测试新配置。界面允许直接“完成接入”,但第一次建议先测试,能够更早发现缺少字段或访问路径不通。中继接入还要完成对应 Desktop 的绑定与配置,不能把只创建了一个目录记录视为配置结束。

完成后回到 AI 列表核对来源,再发一条无附件的文字请求。连接测试成功代表相应连接检查通过,不能替代真实模型调用、账户余额、长任务或文件能力验证。

用一次小请求确定接入成功

你可以发送:“把确认场地、准备通知、整理主持提纲整理成三项行动清单,不补充未给出的日期。”确认收到有内容的回复,且内容与材料相符。再在同一会话要求只缩短其中一句,观察继续修改是否正常。

如果失败,先区分网络不可达、认证不通过、模型标识错误、协议不匹配和任务执行超时,再处理对应一项。不要同时换地址、换 Token、换协议后只记录“后来好了”,否则以后很难复现正确配置。

若由同事代管平台,建议把“服务类型、访问方式、实际标识、负责人角色、最后一次小任务验证时间”记在你们自己的业务交接材料里,Token 单独保管。这样下一位使用者知道先检查哪条路径,也不会把同名服务误当成同一实例。不要把测试记录写成永久保证:网络、授权和模型账户都会变化,重要工作前用最新状态确认,原执行结果未知时先核对原请求。

配置变更后的检查

平台凭据轮换、服务升级、模型标识变化,或 Desktop 中继电脑休眠,都可能使原连接失效。变更后先做一个小请求,再恢复重要任务;原任务结果不明时先核对状态,避免重新提交引发重复操作。

继续选择OpenClaw或Hermes详细教程。若你还没有平台服务,可返回Agent 接入总览选择更适合的接入方式。

Still need help?Contact us ↗