hostex

What This Skill Does

The Hostex skill provides a robust interface for interacting with the Hostex.io API (v3.0). It allows you to query, manage, and synchronize your vacation rental property data directly from the OpenClaw agent. The skill supports comprehensive read operations including property lists, reservation retrieval via date ranges or codes, and detailed availability checks. It also includes guarded write capabilities, enabling you to manage guest messaging, update dynamic pricing, create direct bookings, and modify listing availability. The skill is designed to operate based on the property's local timezone to ensure data accuracy for reservation management.

Installation

To integrate this skill into your environment, use the OpenClaw command-line interface. Run the following command: clawhub install openclaw/skills/skills/ansonfreeman/hostex. Ensure you have obtained a Personal Access Token (PAT) from your Hostex account settings. Securely store this as an environment variable named HOSTEX_ACCESS_TOKEN. For high-security environments, it is strongly recommended to use a read-only PAT for standard operational tasks.

Use Cases

• Operations Management: Monitor upcoming check-ins and check-outs across all your properties using a centralized view.
• Pricing Optimization: Adjust your nightly rates for specific date ranges in response to local demand or seasonal trends.
• Direct Bookings: Input new manual reservations into your property management system efficiently.
• Communication: Engage with guests directly from the agent interface by sending automated or custom responses to reservation inquiries.
• Inventory Control: Quickly open or close property availability during maintenance periods or emergency closures.

Example Prompts

1. "List all reservations for my properties between February 1st and February 28th, 2026, and summarize the total number of guests."
2. "Check the availability for property 123 from February 10th to February 20th and tell me if we have any gaps."
3. "Send a welcome message to the guest in conversation 123 stating: 'We look forward to hosting you soon!'"

Tips & Limitations

Always prioritize using a read-only PAT to prevent accidental modifications. If you must perform write operations, you are required to set the HOSTEX_ALLOW_WRITES=true environment variable and explicitly pass the --confirm flag in your requests. All date-based operations must follow the YYYY-MM-DD format. Keep in mind that date logic is strictly tied to the property's local timezone, not UTC. Regularly sync your local OpenAPI reference using the provided scripts/openapi-sync.mjs script to ensure compatibility with the latest API schema changes.