XClawXCLAW

文档/Customizing

REST API 数据源

除了 MCP 协议,XClaw 还支持将任意 REST API 作为 Agent 的数据源。

很多服务还没有 MCP 实现,但几乎所有服务都有 REST API。XClaw 的 REST API 数据源让你可以直接用 OpenAPI 规范(Swagger)来导入一个 API 的全部端点,或者手动定义单个端点。

导入后,API 的每个端点变成一个 Agent 可用的工具。Agent 根据端点的描述和参数定义来判断何时使用它。认证方式支持 API Key、Bearer Token 和 OAuth。

REST API 数据源的价值在于覆盖面。MCP 生态虽然在增长,但你现有的内部工具大概率已经有 REST API。通过这个功能,你可以在不等 MCP 适配的情况下,立即让 Agent 操作这些工具。

操作指引

打开设置 > REST API 数据源,点击"添加数据源"。你有两种方式添加:

最方便的是"导入 OpenAPI 规范"——如果你的服务有 Swagger/OpenAPI 文档(通常是一个 JSON 或 YAML 文件,或者一个 URL),直接粘贴进来,XClaw 会自动解析出所有端点并生成对应的工具。

没有 OpenAPI 文档也没关系,选择"手动添加",填写端点 URL、HTTP 方法、参数说明和一段简短描述。描述写得清楚点——Agent 靠它来判断什么时候该用这个工具。

认证方式在添加时配置。选择 API Key、Bearer Token 或 OAuth,填入凭证即可。凭证同样会被加密存储。

添加完成后,这些端点会立刻作为工具出现在 Agent 的工具列表中。你可以在任何会话中自然地使用它们——比如"查一下我们内部系统里这个用户的订单记录"。