{
  "schemaVersion": "1.0",
  "item": {
    "slug": "openclaw-tour-planner",
    "name": "OpenCLAW Tour Planner",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/Asif2BD/openclaw-tour-planner",
    "canonicalUrl": "https://clawhub.ai/Asif2BD/openclaw-tour-planner",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/openclaw-tour-planner",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-tour-planner",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "ANALYSIS.md",
      "SECURITY.md",
      "SKILL.md",
      "index.html",
      "package-lock.json",
      "package.json"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/openclaw-tour-planner"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/openclaw-tour-planner",
    "agentPageUrl": "https://openagent3.xyz/skills/openclaw-tour-planner/agent",
    "manifestUrl": "https://openagent3.xyz/skills/openclaw-tour-planner/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/openclaw-tour-planner/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "OpenCLAW Tour Planner",
        "body": "Universal travel planning skill for OpenClaw agents\nPlan itineraries, check weather, discover attractions, and estimate budgets — all through natural conversation."
      },
      {
        "title": "Installation",
        "body": "# Install via ClawHub\nclawhub install Asif2BD/openclaw-tour-planner\n\n# Or via OpenClaw CLI\nopenclaw skills install openclaw-tour-planner\n\n# Or clone manually\ngit clone https://github.com/Asif2BD/openclaw.tours.git\ncd openclaw.tours\nnpm install"
      },
      {
        "title": "Usage",
        "body": "User: Plan a 5-day trip to Tokyo in April\nAgent: I'll create a personalized itinerary for Tokyo. Let me gather the latest information...\n\n[Agent generates day-by-day plan with weather, attractions, and budget estimates]"
      },
      {
        "title": "Core Features",
        "body": "FeatureDescriptionData SourceItinerary PlanningDay-by-day trip plansWikivoyage + OSMWeather Forecasts15-day weather outlookVisual CrossingGeocodingLocation lookupNominatimBudget EstimationCost breakdown by categoryLocal data + APIsAttraction DiscoveryTop sights and hidden gemsWikivoyageCultural TipsLocal customs and etiquetteWikivoyage"
      },
      {
        "title": "Commands",
        "body": "CommandDescriptionExampleplanGenerate full itinerary/tour plan Tokyo 5 days in AprilweatherGet destination weather/tour weather Tokyo next weekbudgetEstimate trip costs/tour budget Tokyo 5 days mid-rangeattractionsFind things to do/tour attractions Tokyo family-friendlyguideGet destination guide/tour guide Tokyo"
      },
      {
        "title": "Data Flow",
        "body": "User Request\n    │\n    ▼\n┌─────────────────┐\n│  Input Parser   │ ──→ Extract: destination, dates, budget, interests\n└────────┬────────┘\n         │\n    ┌────┴────┐\n    ▼         ▼\n┌────────┐ ┌────────┐\n│Geocode │ │Weather │\n│Nominatim│ │Visual  │\n└───┬────┘ │Crossing│\n    │      └───┬────┘\n    │          │\n    └────┬─────┘\n         ▼\n┌─────────────────┐\n│ Wikivoyage API  │ ──→ Travel guide, attractions, tips\n└────────┬────────┘\n         │\n         ▼\n┌─────────────────┐\n│ Itinerary Engine│ ──→ Build day-by-day plan\n└────────┬────────┘\n         │\n         ▼\n┌─────────────────┐\n│ Output Formatter│ ──→ Markdown / JSON / Text\n└─────────────────┘"
      },
      {
        "title": "API Integrations",
        "body": "Free Tier APIs (No Cost)\n\nServicePurposeLimitsNominatimGeocoding1 req/secVisual CrossingWeather1000 records/dayWikivoyageTravel guidesUnlimitedRestCountriesCountry infoUnlimitedExchangeRate-APICurrency1500 req/month"
      },
      {
        "title": "Environment Variables",
        "body": "# Optional — improves weather accuracy (free tier available at visualcrossing.com)\n# Core features work without any keys using Open-Meteo (free, keyless)\nVISUAL_CROSSING_API_KEY=your_key_here\n\n# Optional — alternative weather source\nOPENWEATHER_API_KEY=backup_weather_key\n\n# Optional — flight search (Phase 2, not yet implemented in current release)\nAMADEUS_API_KEY=flight_search_key\nAMADEUS_API_SECRET=flight_search_secret\n\n# Optional — redirect the local SQLite response cache (default: ~/.openclaw/cache/tour-planner.db)\nTOUR_PLANNER_CACHE_PATH=/custom/path/tour-planner.db"
      },
      {
        "title": "Skill Config (openclaw.json)",
        "body": "{\n  \"skills\": {\n    \"tour-planner\": {\n      \"enabled\": true,\n      \"config\": {\n        \"defaultBudget\": \"mid-range\",\n        \"cacheEnabled\": true,\n        \"cachePath\": \"./cache/tour-planner.db\"\n      }\n    }\n  }\n}"
      },
      {
        "title": "Markdown Itinerary (Default)",
        "body": "# 5-Day Tokyo Adventure\n\n## Overview\n- **Dates:** April 15-19, 2025\n- **Weather:** 18-22°C, partly cloudy\n- **Budget:** $1,200-1,800 (excl. flights)\n\n## Day 1: Arrival & Shibuya\n### Morning\n- **10:00** Arrive at Narita/Haneda\n- **12:00** Airport Express to Shibuya\n- **Activity:** Shibuya Crossing + Hachiko\n\n### Afternoon\n- **14:00** Lunch at Genki Sushi\n- **16:00** Meiji Shrine walk\n\n### Evening\n- **19:00** Dinner in Nonbei Yokocho"
      },
      {
        "title": "JSON (For Agent Processing)",
        "body": "{\n  \"destination\": \"Tokyo\",\n  \"duration_days\": 5,\n  \"weather_summary\": {...},\n  \"days\": [...],\n  \"budget_breakdown\": {...},\n  \"packing_list\": [...]\n}"
      },
      {
        "title": "Setup",
        "body": "# Clone repository\ngit clone https://github.com/Asif2BD/openclaw.tours.git\ncd tour-planner\n\n# Install dependencies\nnpm install\n\n# Run tests\nnpm test\n\n# Build\nnpm run build"
      },
      {
        "title": "Project Structure",
        "body": "tour-planner/\n├── src/\n│   ├── apis/           # API clients\n│   │   ├── nominatim.ts\n│   │   ├── weather.ts\n│   │   └── wikivoyage.ts\n│   ├── planners/       # Planning engines\n│   │   ├── itinerary.ts\n│   │   └── budget.ts\n│   ├── utils/          # Utilities\n│   │   ├── cache.ts\n│   │   └── formatter.ts\n│   └── data/           # Static data\n│       └── countries.json\n├── tests/\n├── docs/\n└── package.json"
      },
      {
        "title": "Phase 1: MVP (Complete)",
        "body": "Basic itinerary generation\n Weather integration\n Wikivoyage guides\n Markdown output"
      },
      {
        "title": "Phase 2: Enhanced (In Progress)",
        "body": "Flight search (Amadeus API)\n Hotel price estimates\n Multi-city optimization\n PDF export"
      },
      {
        "title": "Phase 3: Advanced (Planned)",
        "body": "Real-time events\n Restaurant reservations\n Collaborative planning\n Mobile app wrapper"
      },
      {
        "title": "Contributing",
        "body": "We welcome contributions! See CONTRIBUTING.md for guidelines."
      },
      {
        "title": "Adding a New Destination",
        "body": "Check Wikivoyage coverage\nAdd to data/destinations.json\nTest itinerary generation\nSubmit PR"
      },
      {
        "title": "License",
        "body": "MIT License — see LICENSE for details."
      },
      {
        "title": "Links",
        "body": "Website: https://openclaw.tours\nGitHub: https://github.com/Asif2BD/openclaw.tours\nDocs: https://openclaw.tours/docs\nIssues: https://github.com/Asif2BD/openclaw.tours/issues\n\nBuilt with ❤️ for the OpenClaw community."
      }
    ],
    "body": "OpenCLAW Tour Planner\n\nUniversal travel planning skill for OpenClaw agents\n\nPlan itineraries, check weather, discover attractions, and estimate budgets — all through natural conversation.\n\nQuick Start\nInstallation\n# Install via ClawHub\nclawhub install Asif2BD/openclaw-tour-planner\n\n# Or via OpenClaw CLI\nopenclaw skills install openclaw-tour-planner\n\n# Or clone manually\ngit clone https://github.com/Asif2BD/openclaw.tours.git\ncd openclaw.tours\nnpm install\n\nUsage\nUser: Plan a 5-day trip to Tokyo in April\nAgent: I'll create a personalized itinerary for Tokyo. Let me gather the latest information...\n\n[Agent generates day-by-day plan with weather, attractions, and budget estimates]\n\nCapabilities\nCore Features\nFeature\tDescription\tData Source\nItinerary Planning\tDay-by-day trip plans\tWikivoyage + OSM\nWeather Forecasts\t15-day weather outlook\tVisual Crossing\nGeocoding\tLocation lookup\tNominatim\nBudget Estimation\tCost breakdown by category\tLocal data + APIs\nAttraction Discovery\tTop sights and hidden gems\tWikivoyage\nCultural Tips\tLocal customs and etiquette\tWikivoyage\nCommands\nCommand\tDescription\tExample\nplan\tGenerate full itinerary\t/tour plan Tokyo 5 days in April\nweather\tGet destination weather\t/tour weather Tokyo next week\nbudget\tEstimate trip costs\t/tour budget Tokyo 5 days mid-range\nattractions\tFind things to do\t/tour attractions Tokyo family-friendly\nguide\tGet destination guide\t/tour guide Tokyo\nArchitecture\nData Flow\nUser Request\n    │\n    ▼\n┌─────────────────┐\n│  Input Parser   │ ──→ Extract: destination, dates, budget, interests\n└────────┬────────┘\n         │\n    ┌────┴────┐\n    ▼         ▼\n┌────────┐ ┌────────┐\n│Geocode │ │Weather │\n│Nominatim│ │Visual  │\n└───┬────┘ │Crossing│\n    │      └───┬────┘\n    │          │\n    └────┬─────┘\n         ▼\n┌─────────────────┐\n│ Wikivoyage API  │ ──→ Travel guide, attractions, tips\n└────────┬────────┘\n         │\n         ▼\n┌─────────────────┐\n│ Itinerary Engine│ ──→ Build day-by-day plan\n└────────┬────────┘\n         │\n         ▼\n┌─────────────────┐\n│ Output Formatter│ ──→ Markdown / JSON / Text\n└─────────────────┘\n\nAPI Integrations\nFree Tier APIs (No Cost)\nService\tPurpose\tLimits\nNominatim\tGeocoding\t1 req/sec\nVisual Crossing\tWeather\t1000 records/day\nWikivoyage\tTravel guides\tUnlimited\nRestCountries\tCountry info\tUnlimited\nExchangeRate-API\tCurrency\t1500 req/month\nConfiguration\nEnvironment Variables\n# Optional — improves weather accuracy (free tier available at visualcrossing.com)\n# Core features work without any keys using Open-Meteo (free, keyless)\nVISUAL_CROSSING_API_KEY=your_key_here\n\n# Optional — alternative weather source\nOPENWEATHER_API_KEY=backup_weather_key\n\n# Optional — flight search (Phase 2, not yet implemented in current release)\nAMADEUS_API_KEY=flight_search_key\nAMADEUS_API_SECRET=flight_search_secret\n\n# Optional — redirect the local SQLite response cache (default: ~/.openclaw/cache/tour-planner.db)\nTOUR_PLANNER_CACHE_PATH=/custom/path/tour-planner.db\n\nSkill Config (openclaw.json)\n{\n  \"skills\": {\n    \"tour-planner\": {\n      \"enabled\": true,\n      \"config\": {\n        \"defaultBudget\": \"mid-range\",\n        \"cacheEnabled\": true,\n        \"cachePath\": \"./cache/tour-planner.db\"\n      }\n    }\n  }\n}\n\nOutput Formats\nMarkdown Itinerary (Default)\n# 5-Day Tokyo Adventure\n\n## Overview\n- **Dates:** April 15-19, 2025\n- **Weather:** 18-22°C, partly cloudy\n- **Budget:** $1,200-1,800 (excl. flights)\n\n## Day 1: Arrival & Shibuya\n### Morning\n- **10:00** Arrive at Narita/Haneda\n- **12:00** Airport Express to Shibuya\n- **Activity:** Shibuya Crossing + Hachiko\n\n### Afternoon\n- **14:00** Lunch at Genki Sushi\n- **16:00** Meiji Shrine walk\n\n### Evening\n- **19:00** Dinner in Nonbei Yokocho\n\nJSON (For Agent Processing)\n{\n  \"destination\": \"Tokyo\",\n  \"duration_days\": 5,\n  \"weather_summary\": {...},\n  \"days\": [...],\n  \"budget_breakdown\": {...},\n  \"packing_list\": [...]\n}\n\nDevelopment\nSetup\n# Clone repository\ngit clone https://github.com/Asif2BD/openclaw.tours.git\ncd tour-planner\n\n# Install dependencies\nnpm install\n\n# Run tests\nnpm test\n\n# Build\nnpm run build\n\nProject Structure\ntour-planner/\n├── src/\n│   ├── apis/           # API clients\n│   │   ├── nominatim.ts\n│   │   ├── weather.ts\n│   │   └── wikivoyage.ts\n│   ├── planners/       # Planning engines\n│   │   ├── itinerary.ts\n│   │   └── budget.ts\n│   ├── utils/          # Utilities\n│   │   ├── cache.ts\n│   │   └── formatter.ts\n│   └── data/           # Static data\n│       └── countries.json\n├── tests/\n├── docs/\n└── package.json\n\nRoadmap\nPhase 1: MVP (Complete)\n Basic itinerary generation\n Weather integration\n Wikivoyage guides\n Markdown output\nPhase 2: Enhanced (In Progress)\n Flight search (Amadeus API)\n Hotel price estimates\n Multi-city optimization\n PDF export\nPhase 3: Advanced (Planned)\n Real-time events\n Restaurant reservations\n Collaborative planning\n Mobile app wrapper\nContributing\n\nWe welcome contributions! See CONTRIBUTING.md for guidelines.\n\nAdding a New Destination\nCheck Wikivoyage coverage\nAdd to data/destinations.json\nTest itinerary generation\nSubmit PR\nLicense\n\nMIT License — see LICENSE for details.\n\nLinks\nWebsite: https://openclaw.tours\nGitHub: https://github.com/Asif2BD/openclaw.tours\nDocs: https://openclaw.tours/docs\nIssues: https://github.com/Asif2BD/openclaw.tours/issues\n\nBuilt with ❤️ for the OpenClaw community."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/Asif2BD/openclaw-tour-planner",
    "publisherUrl": "https://clawhub.ai/Asif2BD/openclaw-tour-planner",
    "owner": "Asif2BD",
    "version": "1.0.2",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/openclaw-tour-planner",
    "downloadUrl": "https://openagent3.xyz/downloads/openclaw-tour-planner",
    "agentUrl": "https://openagent3.xyz/skills/openclaw-tour-planner/agent",
    "manifestUrl": "https://openagent3.xyz/skills/openclaw-tour-planner/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/openclaw-tour-planner/agent.md"
  }
}