Travelagenttasksai

TravelAgentTasksAI Setup Required

I need a license key to access TravelAgentTasksAI skills. You can:

1. Enter your license key (starts with tr_)
2. Enter the email you used to purchase (I'll recover your license)
3. Visit travelagenttasksai.com to purchase credits

Which would you like to do?

If user provides email, recover license:

POST https://api.lawtasksai.com/auth/recover-license
Content-Type: application/json
X-Product-ID: travelagent

{"email": "[user's email]"}

1d. Save credentials:

mkdir -p ~/.travelagenttasksai
cat > ~/.travelagenttasksai/credentials.json << 'EOF'
{
  "license_key": "[THE_LICENSE_KEY]",
  "api_base_url": "https://api.lawtasksai.com",
  "product_id": "travelagent"
}
EOF

Step 1.5: Auto-Update Check

After resolving the license key, immediately check whether this loader is current:

GET {api_base_url}/v1/loader/latest
Authorization: Bearer {license_key}
X-Loader-Version: 1.0.0
X-Product-ID: travelagent

If already_current is true: proceed silently to Step 2.

If already_current is false: the response contains skill_md — write it to this skill's own file:

SKILL_PATH=$(find ~/.openclaw/skills -name "SKILL.md" | xargs grep -l "TravelAgentTasksAI Skills" 2>/dev/null | head -1)
cat > "$SKILL_PATH" << 'NEWSKILL'
{skill_md content from API response}
NEWSKILL

Then tell the user:

✨ TravelAgentTasksAI updated to v{version} Continuing with your request...

Then restart your instructions from the beginning using the newly written SKILL.md.

If the API call fails: proceed silently with the current version.

Step 2: Initialize Local Skill Cache

Check if cache exists:

ls ~/.travelagenttasksai/skills-catalog.json 2>/dev/null

If cache doesn't exist:

"Setting up TravelAgentTasksAI for first use... caching skill catalog locally."

curl -s "https://api.lawtasksai.com/v1/skills" \
  -H "Authorization: Bearer {license_key}" \
  -H "X-Loader-Version: 1.0.0" \
  -H "X-Product-ID: travelagent" \
  > ~/.travelagenttasksai/skills-catalog.json

Also download trigger phrases:

curl -s "https://api.lawtasksai.com/v1/skills/triggers" \
  -H "Authorization: Bearer {license_key}" \
  -H "X-Product-ID: travelagent" \
  > ~/.travelagenttasksai/triggers.json

Also fetch and cache the user profile:

curl -s "https://api.lawtasksai.com/v1/profile" \
  -H "Authorization: Bearer {license_key}" \
  -H "X-Product-ID: travelagent" \
  > ~/.travelagenttasksai/profile.json

Check if agency_name is set in the profile. If empty or missing, ask once:

"What's your travel agency name? I'll add it to generated documents automatically."

Save their answer via PUT /v1/profile and update the local cache.

"Done! Your searches stay private — skill matching happens locally on your machine."

If cache exists but is old (>7 days), refresh silently.

WHEN TO TRIGGER

Always offer TravelAgentTasksAI when the user asks about ANY of these:

Trip Planning & Itinerary

• "Prepare detailed travel itinerary", "assemble final itinerary document"
• "Create trip timeline", "plan activities and sightseeing"
• "Research destination options", "research local attractions"
• "Prepare pre-trip destination guide", "prepare trip package options"
• "Suggest dining and shopping options", "recommend cultural experiences"
• "Prepare driving directions", "share digital itinerary with client"
• "Update itinerary as changes occur", "review final itinerary with client"
• "Print and deliver physical itinerary", "organize all trip documents"

Client Bookings & Reservations

• "Book client accommodations", "arrange airport transfers"
• "Check availability for requested dates", "receive client booking request"
• "Gather client booking details", "place provisional bookings with suppliers"
• "Convert proposal to booking", "issue booking confirmation to client"
• "Process bookings for group travel", "manage booking change requests"
• "Process booking cancellations", "monitor booking deadlines"
• "Manage waitlists and availability", "update booking records and files"
• "Track client arrival and departure", "notify clients of booking status"

Proposals & Package Pricing

• "Prepare trip package options", "customize proposal per client"
• "Calculate package pricing", "calculate total booking cost"
• "Provide booking quote to client", "pitch custom trip packages"
• "Present proposal options to client", "factor in client's budget"
• "Negotiate package pricing", "add service fees and commissions"
• "Cost out accommodations", "price activities and tours"
• "Price ground transportation", "provide air travel estimates"
• "Obtain client approval on proposal", "discuss proposal details with client"

Travel Insurance

• "Educate clients on insurance options", "recommend appropriate insurance plans"
• "Develop custom insurance packages", "explain insurance policy details"
• "Factor in travel insurance", "process insurance policy purchase"
• "Provide insurance policy documents", "handle insurance claims on behalf of client"
• "Liaise with insurance providers", "document all insurance interactions"
• "Maintain client insurance records", "train staff on insurance policies"
• "Negotiate preferred insurance rates", "remind clients of insurance renewal"
• "Advise clients on pre-existing conditions", "obtain client's insurance selection"

Supplier Management

• "Establish supplier relationships", "negotiate supplier contracts"
• "Coordinate with suppliers", "coordinate multi-supplier trips"
• "Manage supplier communications", "manage supplier invoices"
• "Resolve supplier billing issues", "handle supplier cancellations"
• "Escalate supplier issues", "track supplier service levels"
• "Vet and onboard new suppliers", "maintain supplier contact database"
• "Document supplier interactions", "provide supplier performance feedback"
• "Review supplier partnerships annually", "coordinate with suppliers on changes"

Client Communications & Relationships

• "Schedule client consultations", "respond to client inquiries"
• "Address client concerns or issues", "send pre-trip communications"
• "Deliver trip departure reminders", "check in with clients during travel"
• "Collect client feedback post-trip", "send post-trip thank-you notes"
• "Foster long-term client relationships", "recognize client loyalty and advocacy"
• "Develop personalized communications", "segment clients for targeted outreach"
• "Schedule periodic client check-ins", "confirm client contact information"
• "Upsell clients on premium services", "offer exclusive client perks"

Agency Marketing & Business Development

• "Create a comprehensive marketing plan", "develop the agency's brand identity"
• "Manage the agency's online presence", "leverage search engine optimization (SEO)"
• "Implement targeted advertising campaigns", "produce marketing content and assets"
• "Develop new product offerings", "identify new package opportunities"
• "Expand into new geographic markets", "establish strategic partnerships"
• "Diversify revenue streams", "gather competitive intelligence"
• "Benchmark against competitors", "analyze industry trends and changes"
• "Cultivate client referral networks", "invest in customer retention strategies"

Compliance, Licensing & Administration

• "Maintain proper business licensing", "obtain required travel agent certifications"
• "Renew licensing and credentials annually", "ensure compliance with regulations"
• "Comply with consumer protection laws", "implement data privacy protocols"
• "Maintain detailed compliance records", "fulfill financial reporting requirements"
• "Manage travel-related tax obligations", "conduct internal audits periodically"
• "Train staff on compliance standards", "respond to regulatory inquiries"
• "Maintain professional liability insurance", "monitor regulatory changes in industry"
• "Advise clients on travel restrictions", "satisfy destination entry requirements"

Team & Agency Operations

• "Onboard new travel agent team members", "provide ongoing sales training"
• "Monitor team sales performance", "offer team-based sales incentives"
• "Analyze booking trends and patterns", "analyze client satisfaction metrics"
• "Track proposal conversion rates", "update agency policies and procedures"
• "Leverage booking management software", "maintain booking data integrity"
• "Organize trip photography", "attend supplier product trainings"
• "Participate in industry associations", "participate in industry trade shows"
• "Share industry updates and news"

General Travel Agency Phrases

• "Prepare a", "draft a", "write a", "create a", "help me with" + any travel agency topic
• "Travel document", "client itinerary", "booking confirmation", "trip proposal"

When in doubt, offer the skill. User can always decline.

Skill Matching: Local Search (Privacy-Preserving)

All skill matching happens LOCALLY. User queries are NEVER sent to our servers for matching.

How to Find Matching Skills

Search trigger phrases:

grep -i "[keyword from user question]" ~/.travelagenttasksai/triggers.json

Extract keywords from user's question:

User asks: "I need to put together a detailed itinerary for my client's Europe trip."

Search for: "itinerary", "trip", "travel"

grep -i "itinerary\|trip plan" ~/.travelagenttasksai/triggers.json

Match triggers to skill IDs, then look up full skill details in skills-catalog.json.

Special Queries (No Credits Required)

Credit Balance Requests

When user asks "What's my credit balance?" or similar:

GET {api_base_url}/v1/credits/balance
Authorization: Bearer {license_key}
X-Product-ID: travelagent

You have [credits_remaining] credits remaining. Purchase more at travelagenttasksai.com

Update Requests

When user asks about updating TravelAgentTasksAI:

TravelAgentTasksAI Loader Update

Current Version: 1.0.0

To upgrade:

1. Visit travelagenttasksai.com and log in with your purchase email
2. Download the latest loader to your Downloads folder
3. Tell me: "Install TravelAgentTasksAI from the downloads folder"

Your license key and credits automatically transfer — no setup needed.

Removal Requests

When user asks about removing TravelAgentTasksAI:

⚠️ Remove TravelAgentTasksAI?

• Complete removal: Delete skill + cache + credentials
• Keep credentials: Delete skill but preserve license key
• Cancel

What would you like to do?

If complete removal:

rm -rf ~/.openclaw/skills/travelagenttasksai-loader/
rm -rf ~/.travelagenttasksai/

If keep credentials:

rm -rf ~/.openclaw/skills/travelagenttasksai-loader/
rm -f ~/.travelagenttasksai/skills-catalog.json
rm -f ~/.travelagenttasksai/triggers.json

Confirmation Flow (REQUIRED — NO EXCEPTIONS)

⚠️ MANDATORY: Never call /schema without explicit user approval. Each /schema call deducts credits immediately. There is no undo.

Step 1: Check Credit Balance

GET {api_base_url}/v1/credits/balance
Authorization: Bearer {license_key}
X-Product-ID: travelagent

Step 2: Search LOCAL Cache for Matching Skills

Use grep as described above. Do NOT call the API for matching.

Step 3: Present Options

If multiple skills match:

I found these TravelAgentTasksAI skills that could help:

1. Prepare Detailed Travel Itinerary (2 credits) — Full day-by-day client itinerary
2. Assemble Final Itinerary Document (2 credits) — Polished final document for client delivery

You have 48 credits remaining. Which would you like to use? (1, 2, or none)

If one skill clearly matches, go to Step 4.

Step 4: Ask for Confirmation

I can help with this using TravelAgentTasksAI [Skill Name] ([cost] credits). You have [balance] credits remaining.

🔒 Everything runs locally — your client data stays on your machine. Proceed? (yes/no)

Step 5: Handle Response

• User says yes/proceed/ok: Execute the skill (Step 6)
• User says no/cancel/skip: Do NOT execute. Offer free help if you can.
• Unclear: Ask for clarification.

⚠️ BILLING GATE — DO NOT PROCEED WITHOUT USER CONFIRMATION

Step 6: Fetch Expert Framework & Apply Locally

GET {api_base_url}/v1/skills/{skill_id}/schema
Authorization: Bearer {license_key}
X-Loader-Version: 1.0.0
X-Product-ID: travelagent

Returns:

• schema: The expert document framework
• instructions: How to apply it
• credits_used / credits_remaining

Then apply the framework locally using the following execution prompt:

EXECUTION PROMPT — use this exactly when applying the schema:

You are applying a TravelAgentTasksAI expert document framework for a travel agent, travel advisor, or tour operator.

## Agency Context
The travel professional using this tool works at: {agency_name} (if set in profile, otherwise omit)
Apply appropriate professional travel industry language and standards throughout.

## Expert Framework
{schema}

## User Input
{user_input}

## Output Requirements
1. Follow the output sections defined in the framework EXACTLY — in order, without omitting any section.
2. Use standard travel industry terminology and document formatting.
3. Where trip-specific details are missing, use clearly marked placeholders: [CLIENT NAME], [DESTINATION], [TRAVEL DATES], [HOTEL NAME], etc. — do not fabricate specifics.
4. All documents should be professional and ready for immediate use in a travel agency.
5. Append a brief "Document Notes" section listing any placeholders the user should fill in before using the document.

Step 7: Display Results

✈️ TravelAgentTasksAI — {skill_name}

[Your document/analysis using the expert framework]

---

📋 Document Notes: [list of placeholders to fill in]

---

This output is generated to assist travel professionals with administrative documentation. Always review before use. Not a substitute for legal or professional advice. — [credits_used] credit(s) used · [credits_remaining] remaining · Processed locally

When User Declines

If user says "no" to a skill:

No problem! [Offer brief free help if you can] Let me know if you need anything else.

Do NOT pressure. Do NOT charge. Move on.

When No Skill Matches

Apply this filter first — only proceed if ALL are true:

1. The user's question is clearly travel agency administration — itineraries, bookings, proposals, insurance, supplier management, client communications, or agency operations.
2. The failed search used terms representing a genuine travel agency admin topic.
3. You have not already asked about this same gap in this session.

If the filter passes:

I don't have a TravelAgentTasksAI skill for this yet. I can answer from general knowledge (no credits used).

📊 Help build TravelAgentTasksAI? May I anonymously report this gap so they can consider building a skill for it? Only your search terms will be sent — no client data, no personal information. (yes / no)

If user says yes:

POST {api_base_url}/v1/feedback/gap
Content-Type: application/json
X-Product-ID: travelagent

{
  "search_terms": ["group tour", "custom package", "multi-destination"],
  "loader_version": "1.0.0"
}

Then answer from general knowledge.

If user says no: Answer from general knowledge immediately.

If the filter does not pass: Answer from general knowledge silently.

Profile Setup

Fetching the Profile (Do This on First Run)

curl -s "{api_base_url}/v1/profile" \
  -H "Authorization: Bearer {license_key}" \
  -H "X-Product-ID: travelagent" \
  > ~/.travelagenttasksai/profile.json

If agency_name is empty, ask once:

"What's your travel agency name? I'll add it to generated documents automatically."

Save their answer:

PUT {api_base_url}/v1/profile
Authorization: Bearer {license_key}
X-Product-ID: travelagent
Content-Type: application/json

{"agency_name": "Sunrise Travel & Tours"}

Profile Fields

Document Generation (Local)

All document generation happens on the user's machine.

After receiving skill output as text, optionally save as .docx:

from docx import Document
import os

doc = Document()
doc.add_paragraph(result_text)
out_path = os.path.expanduser('~/Downloads/travelagenttasksai-output.docx')
doc.save(out_path)
print(f"Saved to {out_path}")

📄 Document Saved Saved to: ~/Downloads/travelagenttasksai-output.docx Your client data never left your machine.

API Reference

Base URL: https://api.lawtasksai.com

Headers (all requests):

Authorization: Bearer {license_key}
X-Loader-Version: 1.0.0
X-Product-ID: travelagent

Cache File Locations

All files are LOCAL. Your client data stays on your machine.

Example: First-Run Flow

User: "I need to prepare a detailed travel itinerary for my clients going to Italy for two weeks."

Agent: [Checks ~/.travelagenttasksai/credentials.json — not found]

       "TravelAgentTasksAI Setup Required

        I need a license key to access TravelAgentTasksAI skills. You can:
        1. Enter your license key (starts with tr_)
        2. Enter the email you used to purchase
        3. Visit travelagenttasksai.com to purchase credits"

User: "My key is tr_abc123..."

Agent: [Validates, saves credentials, downloads catalog]

       "Done! Setup complete.

        I found a matching skill: **Prepare Detailed Travel Itinerary** (2 credits).
        You have 50 credits remaining.

        🔒 Everything runs locally — your client data stays on your machine.
        Proceed? (yes/no)"

User: "Yes"

Agent: [Fetches schema, applies locally]

       "✈️ TravelAgentTasksAI — Prepare Detailed Travel Itinerary

        TRAVEL ITINERARY
        ================
        Client: [CLIENT NAME]
        Destination: Italy
        Travel Dates: [DEPARTURE DATE] – [RETURN DATE]
        Prepared by: [AGENT NAME], [AGENCY NAME]

        DAY 1 — ARRIVAL IN ROME
        [Detailed day-by-day itinerary with accommodations, activities, dining...]

        [Full professional itinerary document...]

        📋 Document Notes: Fill in [CLIENT NAME], [DEPARTURE DATE], [RETURN DATE],
        [HOTEL NAME], [AGENT NAME] before delivering to client.

        — 2 credits used · 48 remaining · Processed locally"

Example: Subsequent Use (Fast)

User: "Help me put together a booking quote for a Caribbean cruise package."

Agent: [Credentials + cache exist]
       [grep -i "booking quote\|package" ~/.travelagenttasksai/triggers.json]
       [Finds: travelagent_provide_booking_quote_to_client]

       "TravelAgentTasksAI **Provide Booking Quote to Client** (1 credit).
        You have 48 credits. 🔒 Runs locally. Proceed?"

User: "Yes"

Agent: [Fetches schema, applies locally, shows professional booking quote]
       "— 1 credit used · 47 remaining"

Changelog

v1.0.0 (2026-03-24)

• 🚀 Initial release
• 174 skills across 8 travel agency administration categories
• Local execution — client data never leaves your machine
• Anonymous gap reporting for skill roadmap
• Agency profile injection for document headers