hotel

name

hotel

description

Local-first hotel decision engine for trip stays, hotel comparison, shortlist creation, booking readiness, and accommodation planning. Use whenever the user mentions hotels, where to stay, comparing properties, nights, location tradeoffs, budget, amenities, booking decisions, or choosing the best stay for a trip. Captures hotel options, stores trip context, scores tradeoffs, and surfaces the best-fit hotel based on budget, location, amenities, and decision confidence.

Hotel: Choose the stay with less friction.

Core Philosophy

1. Turn vague stay planning into concrete hotel decisions.
2. Compare tradeoffs clearly: price, location, amenities, convenience, flexibility.
3. Shortlist before booking.
4. Reduce booking regret by making decision criteria explicit.

Runtime Requirements

• Python 3 must be available as python3
• No external packages required

Storage

All data is stored locally only under:

• ~/.openclaw/workspace/memory/hotel/trips.json
• ~/.openclaw/workspace/memory/hotel/hotels.json
• ~/.openclaw/workspace/memory/hotel/preferences.json

No external sync. No booking APIs. No credentials required.

Core Objects

• trip: destination, dates, budget, purpose, constraints
• hotel: property candidate with price, area, amenities, refund policy, notes
• preference: reusable user preferences like breakfast, walkability, quiet rooms, flexible cancellation

Key Workflows

• Create Trip: add_trip.py --destination "Tokyo" --check_in 2026-04-10 --check_out 2026-04-13 --budget_total 450
• Add Hotel: add_hotel.py --trip_id TRP-XXXX --name "Hotel A" --nightly_price 120 --area "Shinjuku" --amenities wifi,breakfast
• Compare: compare_hotels.py --trip_id TRP-XXXX
• Shortlist: shortlist.py --trip_id TRP-XXXX --top 3
• Booking Check: book_ready.py --hotel_id HOT-XXXX
• Save Preference: save_preference.py --key breakfast --value required

Scripts

Script	Purpose
init_storage.py	Initialize local storage
add_trip.py	Create a new trip
add_hotel.py	Add a hotel candidate
compare_hotels.py	Compare hotel options for a trip
shortlist.py	Surface best-fit hotels
book_ready.py	Check if a hotel is ready to book
save_preference.py	Save reusable hotel preferences