前言¶
在 OpenClaw 里接第三方 MCP,常见麻烦是登录链路长、区域集群(国内 / 欧洲 / 美国)选错,以及连接配置和本地 token 缓存不一致。COROS 官方在 SkillHub 发布了 COROS MCP(坐标 @coros/coros),用统一网关 https://mcp.coros.com 做发现,再把登录、刷新、MCP 调用和本地缓存固定到网关选定的 CN、EU 或 US 集群。下面介绍它是什么、能做什么,以及怎样安装与使用。
这是什么¶
COROS MCP 是 COROS(高驰)维护的企业来源 Skill(SkillHub 分类 ai-agent,当前版本 1.0.1)。一句话定位:在 OpenClaw 内安装或刷新 COROS MCP 连接,经全局网关 mcp.coros.com 自动绑定对应区域 issuer,而不是手写多套 MCP 端点。
SkillHub 页面标注 requires_api_key=false,表示安装 Skill 本身不要求额外 API Key;实际访问 COROS MCP 仍走 OAuth 浏览器登录与本地 token 缓存(见下文脚本流程)。
官方资料入口:
- Skill 包地址:https://api.skillhub.cn/coros/coros
- SkillHub 展示页:https://www.skillhub.cn/skills/coros/coros
核心功能¶
依据 Skill 内 SKILL.md 与辅助脚本,已核实能力如下。
-
网关发现与区域固定
默认对接https://mcp.coros.com,从 discovery 读取网关选定的 issuer,并将登录、token 刷新、MCP 调用与缓存目录钉到具体区域。CN / EU / US 本地状态分目录存放(~/.coros-mcp-skill-gateway/<region>/),互不覆盖。 -
写入 OpenClaw MCP 配置
通过apply-openclaw创建或刷新名为coros的 MCP 条目;成功后可用openclaw mcp show coros核对。 -
登录方式
- 单机或快速刷新:一条apply-openclaw命令,有缓存则复用,否则输出浏览器登录链接。
- 浏览器可能在另一台设备:先login-start,用户完成登录后在原机login-finish,再apply-openclaw。
- 可选--legacy与--username走旧密码流程(密码交互输入)。
- 可用login-status查看 pending 登录并重新打印链接;logout仅在用户明确要求清除本地登录态时使用。 -
MCP 工具探测与调用
list-tools(默认带短时本地缓存,可加--refresh)、describe-tool、call-tool,走当前无状态/mcp流程;token 临近过期时会自动刷新。 -
强制区域(可选)
若必须指定集群,可传--issuer:https://mcpcn.coros.com、https://mcpeu.coros.com、https://mcpus.coros.com。
运行依赖(Skill 元数据):本机需有 python3 与 openclaw。
安装与启用¶
通过 SkillHub 安装 Skill¶
SkillHub 页面给出的安装提示为:参照 https://skillhub.cn/install/skillhub.md,安装 @coros/coros。
1、确认已安装 skillhub CLI(未安装时可按安装文档执行官方 install.sh)。
2、将 Skill 装到当前 Agent 识别的 skills 目录(须使用 --dir,否则默认 ./skills/ 可能不会被加载)。OpenClaw 及同类变体使用各自的 skills 目录;若你在 Cursor 中让 Agent 执行同一套流程,常见路径为 ~/.cursor/skills/(以你当前环境为准)。
skillhub install @coros/coros --dir <你的 Agent skills 目录>
安装成功后,Skill 目录内包含 scripts/coros_mcp_login.py,后续命令均在该 Skill 目录下执行。
在 OpenClaw 中接入 MCP¶
进入已安装的 @coros/coros Skill 目录(内含 scripts/),按需选择流程。
跨设备或可能中断终端时(推荐两步登录):
python3 scripts/coros_mcp_login.py login-start
python3 scripts/coros_mcp_login.py login-finish
python3 scripts/coros_mcp_login.py apply-openclaw --server-name coros
单机或快速刷新(一步):
python3 scripts/coros_mcp_login.py apply-openclaw --server-name coros
无本地 token 时,脚本会打印浏览器登录链接,在手机或电脑浏览器中完成 COROS 登录即可。
验证 OpenClaw 侧是否已保存 MCP 条目:
openclaw mcp show coros
Cursor / Codex CLI 等若仅安装了 Skill 文件,并不会自动替代上述 OpenClaw MCP 配置;本 Skill 的设计对象是 OpenClaw + COROS MCP 网关,其他客户端需自行确认是否支持同等 MCP 登录与配置方式,文中不展开未在官方 Skill 文档中写明的差异。
典型用法¶
安装并完成 apply-openclaw 后,可用脚本直接探测服务端当前提供的工具(示例来自官方 SKILL.md)。
列出工具(优先本地短时缓存):
python3 scripts/coros_mcp_login.py list-tools
需要强制从 /mcp 拉最新列表时:
python3 scripts/coros_mcp_login.py list-tools --refresh
查看某个工具的参数结构:
python3 scripts/coros_mcp_login.py describe-tool --tool queryUserInfo
调用工具(参数为 JSON 对象):
python3 scripts/coros_mcp_login.py call-tool --tool queryUserInfo --arguments-json '{}'
自然语言场景下,官方建议先 list-tools 匹配工具,仅在参数不明确时用 describe-tool,再 call-tool;缺必填字段时只向用户追问缺失项。
适用场景与注意¶
适合谁
- 已在或计划在 OpenClaw 中使用 COROS MCP,希望用官方网关统一入口、自动选区。
- 需要在 CN / EU / US 之间保持 token 与缓存隔离,或偶尔强制指定
--issuer。 - 希望通过脚本完成登录、刷新、列工具与调试调用,而不是手写 MCP 配置。
限制与注意
- 核心链路依赖
openclaw与 Skill 自带 helper;不要自造第二套配置路径,应始终使用该 Skill 下scripts/coros_mcp_login.py。 - 辅助脚本强调不在 stdout 打印 token,错误信息会做脱敏;仍应把浏览器登录链接仅交给账号持有人操作。
- SkillHub 统计(以抓取资料为准):评分 100000,下载 2720;与社区搜索展示的
source字段可能表述不同,以 SkillHub 企业来源信息为准。 - 本 Skill 解决的是 连接安装与刷新;具体运动数据能力以 COROS MCP 服务端当前
list-tools返回为准,工具名与字段会随服务端演进,调用前宜describe-tool或--refresh。
结尾¶
COROS MCP 把 OpenClaw 侧的高驰 MCP 接入收敛为:经 mcp.coros.com 发现区域、脚本化登录与 apply-openclaw 写配置,并附带列工具与调试调用。若你要在 Agent 工作流里稳定维护这条连接,可从 SkillHub 安装 @coros/coros,再按 Skill 目录内步骤完成 OpenClaw 配置。官方包地址:https://api.skillhub.cn/coros/coros ;展示页:https://www.skillhub.cn/skills/coros/coros 。