TripClaw 行程导入

将 OpenClaw 生成的自驾行程同步到 TripClaw 应用。

快速开始

1. 配置 API Key

用户需要先配置 TripClaw API Key：

bash

设置环境变量（推荐）

或在 OpenClaw 配置中添加

⚠️ 安全提醒：API Key 是敏感信息，请勿分享、勿提交到公开仓库、勿在截图或录屏中暴露。

2. 触发方式

用户说以下任一指令时触发：

• - 导入行程到 TripClaw
• 同步到 TripClaw
• 发送到 TripClaw
• 把行程推送到 TripClaw

行程数据结构

TripClaw 接受以下 JSON 格式的行程数据：

json
{
name: 行程名称,
description: 行程描述（可选）,
startDate: 2024-01-15,
endDate: 2024-01-22,
travelers: 2,
waypoints: [
{
order: 1,
name: 地点名称,
type: start|waypoint|destination,
location: {
address: 详细地址,
coordinates: {
lat: 25.0389,
lng: 102.7183
}
},
arrivalDate: 2024-01-15,
stay: {
accommodation: 住宿名称,
nights: 1,
bookingUrl: 预订链接（可选）
}
}
],
activities: [
{
date: 2024-01-16,
name: 活动名称,
description: 活动描述,
location: {
address: 活动地点,
coordinates: { lat: 0, lng: 0 }
},
duration: 2小时,
cost: 100
}
],
budget: {
total: 15000,
currency: CNY
}
}

字段说明

Waypoint 类型

• - start - 出发点
• waypoint - 中途经停点
• destination - 最终目的地

使用流程

1. 1. 检测意图：用户表达导入/同步行程到 TripClaw 的意图
2. 收集数据：从当前对话或用户提供的行程信息中提取数据
3. 构建结构：按照上述 JSON 结构组织行程数据
4. 调用 API：使用 scripts/import_trip.py 发送到 TripClaw
5. 反馈结果：告知用户导入成功或失败原因

执行导入

使用脚本执行实际导入：

bash
python3 scripts/importtrip.py --api-key $TRIPCLAWAPI_KEY --data

或传入文件：

bash
python3 scripts/importtrip.py --api-key $TRIPCLAWAPI_KEY --file trip.json

API 参考

详细的 API 文档请参阅 references/api.md。

错误处理

隐私与安全

• - API Key 仅存储在用户本地环境
• 行程数据通过 HTTPS 加密传输
• 不会记录或缓存敏感数据