# Send OpenCLAW Tour Planner to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- 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.
## Suggested prompts
### New install

```text
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.
```
### Upgrade existing

```text
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.
```
## Machine-readable fields
```json
{
  "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": {
    "downloadUrl": "/downloads/openclaw-tour-planner",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-tour-planner",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "ANALYSIS.md",
      "SECURITY.md",
      "SKILL.md",
      "index.html",
      "package-lock.json",
      "package.json"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "openclaw-tour-planner",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-02T21:01:34.607Z",
      "expiresAt": "2026-05-09T21:01:34.607Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-tour-planner",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-tour-planner",
        "contentDisposition": "attachment; filename=\"openclaw-tour-planner-1.0.2.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "openclaw-tour-planner"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "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."
      ]
    }
  },
  "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"
  }
}
```
## Documentation

### OpenCLAW Tour Planner

Universal travel planning skill for OpenClaw agents
Plan itineraries, check weather, discover attractions, and estimate budgets — all through natural conversation.

### Installation

# Install via ClawHub
clawhub install Asif2BD/openclaw-tour-planner

# Or via OpenClaw CLI
openclaw skills install openclaw-tour-planner

# Or clone manually
git clone https://github.com/Asif2BD/openclaw.tours.git
cd openclaw.tours
npm install

### Usage

User: Plan a 5-day trip to Tokyo in April
Agent: I'll create a personalized itinerary for Tokyo. Let me gather the latest information...

[Agent generates day-by-day plan with weather, attractions, and budget estimates]

### Core Features

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

### Commands

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

### Data Flow

User Request
    │
    ▼
┌─────────────────┐
│  Input Parser   │ ──→ Extract: destination, dates, budget, interests
└────────┬────────┘
         │
    ┌────┴────┐
    ▼         ▼
┌────────┐ ┌────────┐
│Geocode │ │Weather │
│Nominatim│ │Visual  │
└───┬────┘ │Crossing│
    │      └───┬────┘
    │          │
    └────┬─────┘
         ▼
┌─────────────────┐
│ Wikivoyage API  │ ──→ Travel guide, attractions, tips
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│ Itinerary Engine│ ──→ Build day-by-day plan
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│ Output Formatter│ ──→ Markdown / JSON / Text
└─────────────────┘

### API Integrations

Free Tier APIs (No Cost)

ServicePurposeLimitsNominatimGeocoding1 req/secVisual CrossingWeather1000 records/dayWikivoyageTravel guidesUnlimitedRestCountriesCountry infoUnlimitedExchangeRate-APICurrency1500 req/month

### Environment Variables

# Optional — improves weather accuracy (free tier available at visualcrossing.com)
# Core features work without any keys using Open-Meteo (free, keyless)
VISUAL_CROSSING_API_KEY=your_key_here

# Optional — alternative weather source
OPENWEATHER_API_KEY=backup_weather_key

# Optional — flight search (Phase 2, not yet implemented in current release)
AMADEUS_API_KEY=flight_search_key
AMADEUS_API_SECRET=flight_search_secret

# Optional — redirect the local SQLite response cache (default: ~/.openclaw/cache/tour-planner.db)
TOUR_PLANNER_CACHE_PATH=/custom/path/tour-planner.db

### Skill Config (openclaw.json)

{
  "skills": {
    "tour-planner": {
      "enabled": true,
      "config": {
        "defaultBudget": "mid-range",
        "cacheEnabled": true,
        "cachePath": "./cache/tour-planner.db"
      }
    }
  }
}

### Markdown Itinerary (Default)

# 5-Day Tokyo Adventure

## Overview
- **Dates:** April 15-19, 2025
- **Weather:** 18-22°C, partly cloudy
- **Budget:** $1,200-1,800 (excl. flights)

## Day 1: Arrival & Shibuya
### Morning
- **10:00** Arrive at Narita/Haneda
- **12:00** Airport Express to Shibuya
- **Activity:** Shibuya Crossing + Hachiko

### Afternoon
- **14:00** Lunch at Genki Sushi
- **16:00** Meiji Shrine walk

### Evening
- **19:00** Dinner in Nonbei Yokocho

### JSON (For Agent Processing)

{
  "destination": "Tokyo",
  "duration_days": 5,
  "weather_summary": {...},
  "days": [...],
  "budget_breakdown": {...},
  "packing_list": [...]
}

### Setup

# Clone repository
git clone https://github.com/Asif2BD/openclaw.tours.git
cd tour-planner

# Install dependencies
npm install

# Run tests
npm test

# Build
npm run build

### Project Structure

tour-planner/
├── src/
│   ├── apis/           # API clients
│   │   ├── nominatim.ts
│   │   ├── weather.ts
│   │   └── wikivoyage.ts
│   ├── planners/       # Planning engines
│   │   ├── itinerary.ts
│   │   └── budget.ts
│   ├── utils/          # Utilities
│   │   ├── cache.ts
│   │   └── formatter.ts
│   └── data/           # Static data
│       └── countries.json
├── tests/
├── docs/
└── package.json

### Phase 1: MVP (Complete)

Basic itinerary generation
 Weather integration
 Wikivoyage guides
 Markdown output

### Phase 2: Enhanced (In Progress)

Flight search (Amadeus API)
 Hotel price estimates
 Multi-city optimization
 PDF export

### Phase 3: Advanced (Planned)

Real-time events
 Restaurant reservations
 Collaborative planning
 Mobile app wrapper

### Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

### Adding a New Destination

Check Wikivoyage coverage
Add to data/destinations.json
Test itinerary generation
Submit PR

### License

MIT License — see LICENSE for details.

### Links

Website: https://openclaw.tours
GitHub: https://github.com/Asif2BD/openclaw.tours
Docs: https://openclaw.tours/docs
Issues: https://github.com/Asif2BD/openclaw.tours/issues

Built with ❤️ for the OpenClaw community.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Asif2BD
- Version: 1.0.2
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-02T21:01:34.607Z
- Expires at: 2026-05-09T21:01:34.607Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/openclaw-tour-planner)
- [Send to Agent page](https://openagent3.xyz/skills/openclaw-tour-planner/agent)
- [JSON manifest](https://openagent3.xyz/skills/openclaw-tour-planner/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/openclaw-tour-planner/agent.md)
- [Download page](https://openagent3.xyz/downloads/openclaw-tour-planner)