openclaw-tour-planner

name: openclaw-tour-planner description: "OpenClaw代理的通用旅行规划工具：通过自然语言对话即可制定行程计划、查询天气信息、查找景点以及估算旅行预算。该工具使用免费的API，核心功能无需API密钥即可使用。" version: 1.0.2 author: Asif2BD license: MIT tags: [travel, itinerary, weather, tourism, planning] website: https://openclaw.tours repository: https://github.com/Asif2BD/openclaw.tours

OpenCLAW 旅行规划工具

专为 OpenClaw 代理设计的通用旅行规划工具

通过自然语言对话，您可以规划行程、查询天气、探索景点并估算预算。

快速入门

安装

# 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

使用方法

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]

功能

核心功能

命令

架构

数据流

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 集成

免费 tier 的 API（无需付费）

配置

环境变量

# 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

技能配置（openclaw.json）

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

输出格式

Markdown 格式的行程信息（默认）

# 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 格式（供代理处理）

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

开发

开发环境设置

# 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

项目结构

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

制定计划

第一阶段：MVP（已完成）

• 基本行程生成 |
• 天气信息集成 |
• Wikivoyage 指南整合 |
• Markdown 格式输出

第二阶段：功能增强（进行中）

• 航班搜索（使用 Amadeus API） |
• 酒店价格估算 |
• 多城市行程优化 |
• PDF 文件导出

第三阶段：高级功能（计划中）

• 实时事件更新 |
• 餐厅预订 |
• 协作式行程规划 |
• 移动应用适配

贡献方式

我们欢迎您的贡献！请参阅 CONTRIBUTING.md 以获取详细指南。

添加新目的地

1. 检查 Wikivoyage 是否提供了该目的地的信息 |
2. 将目的地信息添加到 data/destinations.json 文件中 |
3. 测试行程生成功能 |
4. 提交代码更改请求（PR） |

许可证

本项目采用 MIT 许可证——详情请参阅 LICENSE。

链接

• 官方网站： https://openclaw.tours |
• GitHub 仓库： https://github.com/Asif2BD/openclaw.tours |
• 文档： https://openclaw.tours/docs |
• 问题反馈： https://github.com/Asif2BD/openclaw.tours/issues |

本项目专为 OpenClaw 社区精心开发。