How to Connect OpenClaw to HubSpot

# 1. Go to HubSpot → Settings (gear icon) → Integrations → Private Apps
# 2. Click "Create a private app"
# 3. Set:
#    - App name: OpenClaw AI
#    - Description: AI-powered CRM automation
# 4. Note the app will appear in your integrations list

# In the Private App settings → Scopes tab:
# Enable scopes:
#   CRM:
#     - crm.objects.contacts.read
#     - crm.objects.contacts.write
#     - crm.objects.companies.read
#     - crm.objects.deals.read
#     - crm.objects.deals.write
#   Other:
#     - crm.schemas.contacts.read (for custom properties)
#     - timeline (for activity logging)
# Click "Create app"
# Copy the Access Token (shown once)

# In config/skills/hubspot.yaml:
hubspot:
  enabled: true
  access_token: "YOUR_HUBSPOT_PRIVATE_APP_TOKEN"
  portal_id: "YOUR_HUBSPOT_PORTAL_ID"  # Found in Settings → Account Defaults

# Install the HubSpot skill:
openclaw skill install hubspot

# Test connection:
openclaw skill test hubspot --action get_account_info

# In config/skills/hubspot.yaml (continued):
field_mapping:
  contacts:
    email: email  # HubSpot standard property
    first_name: firstname
    last_name: lastname
    phone: phone
    company_name: company
    # Custom properties (create in HubSpot first):
    ai_sentiment: ai_sentiment_score  # Custom property
    last_ai_interaction: last_openclaw_chat
    lead_quality: ai_lead_quality_rating

# Create a contact:
openclaw chat "Create a HubSpot contact: email=john@example.com, name=John Doe, company=Acme Corp"

# Read contact:
openclaw chat "Show me the HubSpot contact for email john@example.com"

# Update contact:
openclaw chat "Update the HubSpot contact john@example.com with phone number +1-555-0123"

# Search contacts:
openclaw chat "Find all HubSpot contacts from company 'Acme Corp'"

# Check logs:
tail -f ~/.openclaw/logs/skills.log | grep hubspot

# Example: Lead scoring workflow
# config/workflows/hubspot_lead_scoring.yaml:
workflows:
  hubspot_lead_scoring:
    trigger:
      type: webhook
      path: /webhooks/hubspot/contact-created
    steps:
      - name: Get contact details
        action: hubspot.get_contact
        params:
          email: "{{ webhook.body.email }}"
      - name: Analyze lead quality
        action: ai.analyze
        input: |
          Analyze this lead and assign a score (1-10):
          Name: {{ steps.get_contact_details.output.firstname }} {{ steps.get_contact_details.output.lastname }}
          Company: {{ steps.get_contact_details.output.company }}
          Email domain: {{ steps.get_contact_details.output.email | domain }}
      - name: Update HubSpot with score
        action: hubspot.update_contact
        params:
          email: "{{ webhook.body.email }}"
          properties:
            ai_lead_quality_rating: "{{ steps.analyze_lead_quality.output.score }}"
            lead_status: "{{ steps.analyze_lead_quality.output.score >= 7 ? 'hot' : 'warm' }}"