Hotel

Local-first hotel decision engine for trip stays, hotel comparison, shortlist creation, booking readiness, and accommodation planning. Use whenever the user...

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