OpenCLAW 旅行规划器

面向OpenClaw代理的通用旅行规划技能
规划行程、查看天气、发现景点、估算预算——全部通过自然对话完成。

---

快速开始

安装

bash

通过ClawHub安装

clawhub install Asif2BD/openclaw-tour-planner

或通过OpenClaw CLI安装

openclaw skills install openclaw-tour-planner

或手动克隆

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

使用示例

用户：规划一次四月东京5日游
代理：我将为您创建一份东京个性化行程。让我收集最新信息...

[代理生成包含天气、景点和预算估算的逐日计划]

---

功能特性

核心功能

功能	描述	数据来源
行程规划	逐日旅行计划	Wikivoyage + OSM
天气预报

15天天气展望 | Visual Crossing | | 地理编码 | 位置查询 | Nominatim | | 预算估算 | 按类别费用明细 | 本地数据 + API | | 景点发现 | 热门景点与隐藏宝藏 | Wikivoyage | | 文化贴士 | 当地风俗礼仪 | Wikivoyage |

命令

命令	描述	示例
plan	生成完整行程	/tour plan Tokyo 5 days in April
weather

获取目的地天气 | /tour weather Tokyo next week | | budget | 估算旅行费用 | /tour budget Tokyo 5 days mid-range | | attractions | 查找可做之事 | /tour attractions Tokyo family-friendly | | guide | 获取目的地指南 | /tour guide Tokyo |

---

架构

数据流

用户请求
│
▼
┌─────────────────┐
│ 输入解析器 │ ──→ 提取：目的地、日期、预算、兴趣
└────────┬────────┘
│
┌────┴────┐
▼ ▼
┌────────┐ ┌────────┐
│地理编码 │ │天气 │
│Nominatim│ │Visual │
└───┬────┘ │Crossing│
│ └───┬────┘
│ │
└────┬─────┘
▼
┌─────────────────┐
│ Wikivoyage API │ ──→ 旅行指南、景点、贴士
└────────┬────────┘
│
▼
┌─────────────────┐
│ 行程引擎 │ ──→ 构建逐日计划
└────────┬────────┘
│
▼
┌─────────────────┐
│ 输出格式化器 │ ──→ Markdown / JSON / 文本
└─────────────────┘

API集成

免费层API（零成本）

服务	用途	限制
Nominatim	地理编码	1次请求/秒
Visual Crossing

天气 | 1000条记录/天 | | Wikivoyage | 旅行指南 | 无限制 | | RestCountries | 国家信息 | 无限制 | | ExchangeRate-API | 货币汇率 | 1500次请求/月 |

---

配置

环境变量

bash

可选——提高天气准确性（visualcrossing.com提供免费层）

核心功能无需任何密钥即可使用Open-Meteo（免费，无需密钥）

VISUALCROSSINGAPIKEY=yourkey_here

可选——备用天气数据源

OPENWEATHERAPIKEY=backupweatherkey

可选——航班搜索（第二阶段，当前版本尚未实现）

AMADEUSAPIKEY=flightsearchkey AMADEUSAPISECRET=flightsearchsecret

可选——重定向本地SQLite响应缓存（默认：~/.openclaw/cache/tour-planner.db）

TOURPLANNERCACHE_PATH=/custom/path/tour-planner.db

技能配置（openclaw.json）

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

---

输出格式

Markdown行程（默认）

markdown

5天东京探险之旅

概览

• - 日期： 2025年4月15-19日
• 天气： 18-22°C，局部多云
• 预算： $1,200-1,800（不含机票）

第1天：抵达与涩谷

上午

• - 10:00 抵达成田/羽田机场
• 12:00 机场快线至涩谷
• 活动： 涩谷十字路口 + 忠犬八公像

下午

• - 14:00 元祖寿司午餐
• 16:00 明治神宫散步

晚上

• - 19:00 思出横丁晚餐

JSON（供代理处理）

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

---

开发

环境搭建

bash

克隆仓库

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

安装依赖

npm install

运行测试

npm test

构建

npm run build

项目结构

tour-planner/
├── src/
│ ├── apis/ # API客户端
│ │ ├── nominatim.ts
│ │ ├── weather.ts
│ │ └── wikivoyage.ts
│ ├── planners/ # 规划引擎
│ │ ├── itinerary.ts
│ │ └── budget.ts
│ ├── utils/ # 工具函数
│ │ ├── cache.ts
│ │ └── formatter.ts
│ └── data/ # 静态数据
│ └── countries.json
├── tests/
├── docs/
└── package.json

---

路线图

第一阶段：最小可行产品（已完成）

• - [x] 基础行程生成
• [x] 天气集成
• [x] Wikivoyage指南
• [x] Markdown输出

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

• - [ ] 航班搜索（Amadeus API）
• [ ] 酒店价格估算
• [ ] 多城市优化
• [ ] PDF导出

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

• - [ ] 实时活动
• [ ] 餐厅预订
• [ ] 协作规划
• [ ] 移动应用封装

---

贡献指南

欢迎贡献！详见CONTRIBUTING.md。

添加新目的地

1. 1. 检查Wikivoyage覆盖范围
2. 添加到data/destinations.json
3. 测试行程生成
4. 提交拉取请求

---

许可证

MIT许可证——详见LICENSE。

---

链接

• - 网站： https://openclaw.tours
• GitHub： https://github.com/Asif2BD/openclaw.tours
• 文档： https://openclaw.tours/docs
• 问题反馈： https://github.com/Asif2BD/openclaw.tours/issues

---

为OpenClaw社区倾心打造 ❤️