文档目录
Agent 接入

连接 OpenClaw:填写字段、选择协议并验证回复

按 OpenClaw 服务实际开放的接口完成接入,检查从连接到真实任务的完整链路。

本篇用于把已有 OpenClaw 平台服务接入 AIRumo。它与“扫描本机 AI”是两条入口:本机方式由 Desktop 发现该电脑上的 CLI;本篇通过服务地址和凭据调用平台。如果你只是本机装好了程序,还没有可访问的服务,请先阅读本机接入。

开始前,向服务管理者确认服务已经运行、允许谁访问,以及当前开放 Responses 还是 Chat Completions。不要根据一个网页登录页面的外观判断 API 已开放,也不要把账户登录密码直接当作 API Token。

视频演示

连接 OpenClaw 平台服务(字幕版)01:46

通过 Desktop 中继配置 OpenClaw 平台服务,使用 Responses 协议,连接测试后检查一次真实任务回复。服务端直连的访问条件仍按本文另行确认。

打开原视频

先决定访问路径

在“AI → 接入 AI → 连接 AI 平台”选择 OpenClaw。Web 使用后端直连;支持中继的 Desktop 可以按条件选择后端直连或 Desktop 中继。选择以后,服务地址必须对这条路径真正可达。

直连适用于 AIRumo 后端能访问的服务。中继适用于当前 Desktop 能访问的服务,需要保持该电脑和 Desktop 在线。若管理者只给了本机或特定网络可访问的入口,应先确认访问路径,再填写连接,而不是猜测一个新的端口。

逐项填写表单

字段填什么容易混淆的地方
服务名称自己容易识别的名称,例如“内容整理服务”名称不决定调用哪个模型
服务地址管理者提供的主机和端口不填写指南网页或手动叠加接口路径
API Token该服务允许你使用的凭据不使用 AIRumo 登录令牌或 Bot Token
模型或 Agent ID服务真实提供的标识main是初始默认值,仍需与服务配置核对
协议Responses 或 Chat Completions按服务实际开放的协议选择
请求超时与任务耗时相符的秒数延长等待不能修复认证和协议错误

当前表单默认 Responses,实际请求路径为 /v1/responses;选择 Chat Completions 时为 /v1/chat/completions。界面会显示所选路径,地址字段只保留服务入口。某个服务只开放其中一个接口时,另一个选择可能连接失败,并不表示所有 OpenClaw 服务都不可用。

请求超时默认300秒,表单允许300至3600秒。先用简短文字验证,再根据确实需要的任务时长调整;不要一开始把等待时间调长以掩盖服务错误。

测试时一次只改变一项

填完后点击“测试连接”。成功后检查它测试的是刚才选择的协议、地址与标识。如果你为了排错修改了任一连接字段,重新点击测试;旧成功提示不代表新配置已经验证。

遇到失败,按顺序检查:服务端是否运行、请求发出方能否访问、Token是否属于该服务、模型标识是否有效、协议是否开放。身份或协议不对时,反复点击“完成接入”只会重复同样的问题。只把脱敏错误交给管理者,不发送凭据值。

完成接入并做真实任务

点击“完成接入”,在 AI 列表核对 OpenClaw 来源与名称,从聊天入口发送下面的请求一次:

PROMPT
已知材料:内部阅读分享会,线下进行,时长60分钟;日期、地点、报名方式都未确定。
请列出三项最先要确认的事情,每项写一个确认动作。不要编造具体时间,不读取外部资料,不发送通知。

参考检查点是:结果确实围绕日期、地点和报名方式,列出了可执行的确认动作,没有虚构已经确定的安排。AI每次的措辞可以不同,不能只凭“返回了一段文字”就认为符合要求。

继续追问:“只保留刚才的三项,把每项缩短到15字以内。”如果新回复延续了原材料,说明这次会话的继续修改也走通。需要附件或外部工具时再单独验证,不从纯文字成功推断这些能力都具备。

首次交给同事使用前,请让她从自己的权限范围完成同样的小任务。拥有者自己能调用,不代表共享成员已经取得使用权;你在 Desktop 中继路径成功,也不证明同事选择后端直连时一定可达。记录实际成功的服务类型、协议和访问方式,凭据继续私密管理。这样能够把后续问题定位到授权、路径或任务内容,避免每个人各自尝试一组不同配置。

使用中继或更新配置后的注意事项

中继电脑离线会影响后续请求,改变平台 Token 也不会自动更新每个旧连接。服务升级或凭据轮换后,先做小请求确认实际目标。正在运行的任务应先查原状态,未知结果不能通过重复发送来恢复。

返回平台接入选择可重新比较访问路径。需要进入群里使用时,继续配置群响应规则,平台接入成功并不自动授予所有群成员使用权。

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