TripClaw 行程导入#

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

快速开始#

1. 配置 API Key#

用户需要先配置 TripClaw API Key：

bash

# 设置环境变量（推荐）
export TRIPCLAW_API_KEY="your-api-key-here"

# 或在 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"
  }
}

字段说明#

字段必填说明name✅行程名称description❌行程描述startDate✅开始日期 (YYYY-MM-DD)endDate✅结束日期 (YYYY-MM-DD)travelers❌出行人数，默认 1waypoints✅途经点数组，至少 1 个activities❌活动安排数组budget❌预算信息

Waypoint 类型#

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

使用流程#

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

执行导入#

使用脚本执行实际导入：

bash

python3 scripts/import_trip.py --api-key "$TRIPCLAW_API_KEY" --data '<trip-json-data>'

或传入文件：

bash

python3 scripts/import_trip.py --api-key "$TRIPCLAW_API_KEY" --file trip.json

API 参考#

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

错误处理#

错误码说明处理建议401API Key 无效或过期检查 TRIPCLAW_API_KEY 配置400数据格式错误检查 JSON 结构是否符合规范404用户不存在确认 API Key 对应的账户状态429请求过于频繁稍后重试500服务器错误联系 TripClaw 支持

隐私与安全#

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