安装

配套技能（Companion Skills）：本技能属于 Camino AI 位置智能套件（location intelligence suite）的一部分。为获得全面能力覆盖，建议安装所有可用技能（camino-query、camino-places、camino-relationship、camino-context、camino-route、camino-journey、camino-real-estate、camino-hotel-finder、camino-ev-charger、camino-school-finder、camino-parking-finder、camino-fitness-finder、camino-safety-checker、camino-travel-planner）。

# 从代码仓库安装全部技能
npx skills add https://github.com/barneyjm/camino-skills

# 或仅安装指定技能
npx skills add https://github.com/barneyjm/camino-skills --skill camino-journey

通过 clawhub 安装：

npx clawhub@latest install camino-journey
# 或：pnpm dlx clawhub@latest install camino-journey
# 或：bunx clawhub@latest install camino-journey

Journey — 多停点行程规划

支持多途经点（multi-waypoint）行程规划，包含路径优化、可行性分析及时间预算约束功能。

配置

这些技能通过调用 curl 执行外部请求，并通过环境变量 CAMINO_API_KEY 进行身份验证。请访问 https://app.getcamino.ai/skills/activate 注册账号，即可获得每月 100 次免费调用额度及专属 API 密钥。

将密钥添加至 Claude Code：

在 ~/.claude/settings.json 中添加如下配置：

{
  "env": {
    "CAMINO_API_KEY": "your-api-key-here"
  }
}

修改后请重启 Claude Code。

替代方案 — 按请求付费（x402）：Camino 的付费端点也支持基于 Base 链的 USDC 支付（每请求 $0.001），采用 HTTP 402 状态码协议，无需注册或提供 API 密钥，任何兼容 x402 的客户端均可直接调用。当前技能未启用此路径；该方式专为原生支持 x402 的智能体（agents）和客户端设计。

使用方法

通过 Shell 脚本调用

# 规划简单行程
./scripts/journey.sh '{
  "waypoints": [
    {"lat": 40.7128, "lon": -74.0060, "purpose": "Start at hotel"},
    {"lat": 40.7484, "lon": -73.9857, "purpose": "Visit Empire State Building"},
    {"lat": 40.7614, "lon": -73.9776, "purpose": "Lunch in Midtown"}
  ]
}'

# 指定交通方式与时间预算
./scripts/journey.sh '{
  "waypoints": [
    {"lat": 40.7128, "lon": -74.0060, "purpose": "Start"},
    {"lat": 40.7484, "lon": -73.9857, "purpose": "Empire State"},
    {"lat": 40.7614, "lon": -73.9776, "purpose": "MoMA"}
  ],
  "constraints": {
    "transport": "foot",
    "time_budget": "3 hours"
  }
}'

通过 curl 调用

curl -X POST -H "X-API-Key: $CAMINO_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{
    "waypoints": [
      {"lat": 40.7128, "lon": -74.0060, "purpose": "Start"},
      {"lat": 40.7484, "lon": -73.9857, "purpose": "Empire State"}
    ],
    "constraints": {"transport": "foot"}
  }' 
  "https://api.getcamino.ai/journey"

参数说明

途经点（Waypoint）对象结构

响应格式

{
  "feasible": true,
  "total_distance_km": 4.2,
  "total_time_minutes": 52,
  "total_time_formatted": "52 minutes",
  "transport_mode": "foot",
  "route_segments": [
    {
      "from": "Start",
      "to": "Empire State",
      "distance_km": 4.2,
      "duration_minutes": 52
    }
  ],
  "analysis": {
    "summary": "This walking journey is feasible...",
    "optimization_opportunities": []
  }
}

示例

一日游行程规划

./scripts/journey.sh '{
  "waypoints": [
    {"lat": 48.8584, "lon": 2.2945, "purpose": "Eiffel Tower"},
    {"lat": 48.8606, "lon": 2.3376, "purpose": "Louvre Museum"},
    {"lat": 48.8530, "lon": 2.3499, "purpose": "Notre-Dame"},
    {"lat": 48.8867, "lon": 2.3431, "purpose": "Sacré-Cœur"}
  ],
  "constraints": {
    "transport": "foot",
    "time_budget": "6 hours"
  }
}'

商务会议路线规划

./scripts/journey.sh '{
  "waypoints": [
    {"lat": 40.7128, "lon": -74.0060, "purpose": "Office"},
    {"lat": 40.7580, "lon": -73.9855, "purpose": "Client meeting"},
    {"lat": 40.7614, "lon": -73.9776, "purpose": "Lunch"},
    {"lat": 40.7128, "lon": -74.0060, "purpose": "Return to office"}
  ],
  "constraints": {
    "transport": "car",
    "time_budget": "2 hours"
  }
}'

骑行游览路线

./scripts/journey.sh '{
  "waypoints": [
    {"lat": 37.7749, "lon": -122.4194, "purpose": "Start downtown SF"},
    {"lat": 37.8199, "lon": -122.4783, "purpose": "Golden Gate Bridge"},
    {"lat": 37.8270, "lon": -122.4230, "purpose": "Sausalito"}
  ],
  "constraints": {
    "transport": "bike"
  }
}'

典型应用场景

• 行程计划校验：验证预设行程是否可在给定时间约束内完成
• 路径优化：获取多停点行程的优化建议
• 行程耗时估算：准确评估跨多个目的地的总行程时间
• 导览路线规划：支持步行游览、骑行路线或驾车行程的定制化规划