OpenClaw 格式特点
-
结构化数据格式
类似 JSON 或 YAML,但可能包含特定于任务或工具的元数据,如工具名称、参数、类型提示等。
-
支持工具调用(Function Calling)
常用于 AI 智能体或工作流中,将自然语言指令转换为结构化工具调用请求。
示例:{ "tool": "search", "parameters": { "query": "天气预报", "location": "北京" } } -
类型系统支持
支持定义参数类型(字符串、数字、布尔值、数组等),并可嵌套复杂结构。 -
可扩展性
允许添加自定义字段(如版本、时间戳、认证信息)。
常见支持场景
-
AI 智能体框架
如 LangChain、AutoGPT 等可通过 OpenClaw 格式调用工具。
-
API 网关/中间件
将 HTTP 请求转换为 OpenClaw 格式,或将结果转换回客户端需要的格式(如 JSON-RPC)。 -
自动化工作流
在 Zapier、n8n 等平台中作为动作/触发器的数据传递格式。
基本结构示例
{
"command": "execute_tool",
"tool_name": "calculate_distance",
"input": {
"point_a": {"lat": 40.7128, "lng": -74.0060},
"point_b": {"lat": 34.0522, "lng": -118.2437}
},
"metadata": {
"request_id": "12345",
"timestamp": "2024-01-01T12:00:00Z"
}
}
开发支持
如果你需要在代码中处理 OpenClaw 格式:
- Python:使用
json或pydantic解析,或封装为类(如OpenClawRequest)。 - JavaScript/TypeScript:可通过接口类型定义确保类型安全。
- 验证工具:可用 JSON Schema 校验格式合规性。
注意事项
- 规范版本:OpenClaw 可能指特定版本(如 v1.2),需确认兼容性。
- 工具兼容性:确保目标工具支持该格式的参数结构。
- 错误处理:建议包含
error字段返回错误信息。
如果需要更具体的实现示例或工具推荐,可以补充说明使用场景(如开发框架、集成平台等)! 🛠️