Client Onboarding Agent

Client onboarding is one of the most consequential phases in any service business. Research consistently shows that 60-70% of client churn traces back to a poor onboarding experience, with disorganized kickoffs, missed follow-ups, and unclear expectations topping the list of complaints. Agencies, consultancies, and SaaS companies lose an estimated 25-40% of new clients within the first 90 days when onboarding is handled manually and inconsistently. The cost is staggering: replacing a churned client costs 5-7x more than retaining one through a solid first impression.

The Client Onboarding Agent transforms this critical workflow into a structured, automated, and trackable process. Built on OpenClaw's agent framework with connections to Gmail, Google Calendar, Slack, and Notion, it orchestrates every step from signed contract to productive engagement — creating project workspaces, sending personalized welcome emails, scheduling kickoff calls, managing checklists with deadlines, and sending progress reminders — all while keeping your team informed and your clients impressed.

Why Onboarding Fails Without Automation

Manual onboarding suffers from predictable failure modes that compound as your client base grows: Inconsistency across team members. When onboarding lives in someone's head or a static spreadsheet, every account manager does it differently. One remembers to send the welcome packet on day one; another forgets until day five. One creates the project folder structure immediately; another waits until the kickoff call. Clients receive wildly different experiences depending on who draws them. Dropped tasks and missed deadlines. A typical agency onboarding involves 15-25 discrete tasks across multiple tools and team members. Without automated tracking, tasks slip through the cracks — the NDA that never got sent, the brand assets that were requested but never followed up on, the kickoff call that was discussed but never scheduled. No visibility into progress. Leadership cannot answer basic questions: How many clients are currently onboarding? Which ones are stuck? What is our average time-to-value? Without structured data, onboarding quality is invisible until clients complain or churn. Context switching overhead. Account managers spend 30-35% of their onboarding time on administrative tasks — copying information between systems, sending routine emails, creating folders, updating spreadsheets. This is time stolen from relationship-building and strategic setup work that actually drives client success.

The Client Onboarding Agent addresses each of these failure modes by codifying your onboarding process into an executable, trackable workflow that runs consistently for every client.

Architecture: Multi-Step Workflow Orchestration

The onboarding agent operates as a stateful workflow orchestrator that manages the full lifecycle from contract signature to engagement completion. The architecture leverages OpenClaw's exec tools for file operations, hooks system for event-driven automation, and browser capabilities for web-based integrations.

Core Components

• Gmail dispatches personalized welcome emails, document requests, and progress updates using templates populated with client-specific data
• Google Calendar finds mutual availability and schedules kickoff calls, check-ins, and milestone reviews
• Slack posts real-time notifications to internal channels when onboarding events occur — new client started, task completed, deadline approaching, blocker identified
• Notion creates structured project workspaces from templates with client-specific pages, databases, and task boards

Event-Driven Automation with Hooks

OpenClaw's hooks system enables the agent to respond to events without polling. Key hook configurations:

• on:message hook processes inbound client communications, extracting action items and updating the onboarding checklist automatically
• on:boot hook runs a daily digest check on startup, reviewing all active onboardings and flagging items that need attention
• Session memory hooks preserve onboarding context across conversation resets, ensuring no client context is lost

Execution Model

The agent uses OpenClaw's exec tools to perform file system operations (creating folder structures, generating documents from templates, writing configuration files) and shell commands (API calls to connected services, data transformations, report generation). Browser automation handles any web-based steps that lack API access — filling forms in client portals, capturing screenshots of completed setups, or verifying that provisioned accounts are accessible.

Step-by-Step Setup

Prerequisites

• An active OpenClaw instance (self-hosted or via Donely)
• Gmail, Google Calendar, Slack, and Notion integrations connected via OAuth
• Admin access to configure agent skills and hooks

1. Create the Agent Workspace

mkdir -p /data/.openclaw/skills/client-onboarding

Create the agent's skill directory where templates, checklists, and configuration will live.

2. Configure the BOOTSTRAP.md

Create /data/.openclaw/skills/client-onboarding/BOOTSTRAP.md with the following content:

---
name: client-onboarding
description: Automated client onboarding workflow orchestrator
triggers:
  - "onboard new client"
  - "start onboarding"
  - "new client setup"
# Client Onboarding Agent
You are a client onboarding specialist. When a new client engagement begins,
you orchestrate the complete onboarding workflow.

Core Responsibilities

Intake & Validation
   - Collect client company name, primary contact, email, engagement type, and start date
   - Validate all required fields before proceeding
   - Create the onboarding record in the tracking system

Workspace Setup
   - Create Notion project workspace from the appropriate template
   - Set up folder structure: /clients/{company}/contracts, assets, deliverables, communications
   - Generate and populate the onboarding checklist based on engagement type

Welcome Communication
   - Send personalized welcome email via Gmail with:
     - Introduction to the team and key contacts
     - Overview of what to expect in the first 30 days
     - Links to the client portal and project workspace
     - Document/asset request list with deadlines
   - Post internal Slack notification: new client onboarding started

Kickoff Scheduling
   - Check Google Calendar availability for account team
   - Propose 3 time slots to the client within the first 5 business days
   - Send calendar invite once confirmed with agenda and prep materials

Checklist Management
   - Track all onboarding tasks with owners and deadlines
   - Auto-complete tasks you can verify (workspace created, email sent, etc.)
   - Send reminders 24 hours before deadlines
   - Escalate overdue items after 48 hours

Progress Reporting
   - Post daily summary to Slack #onboarding channel for active engagements
   - Generate weekly onboarding status report
   - Flag at-risk engagements (>2 overdue items or no client response in 3+ days)

Checklist Templates

Standard Agency Onboarding (15 business days)
[ ] Day 0: Welcome email sent
[ ] Day 0: Notion workspace created
[ ] Day 0: Internal Slack announcement
[ ] Day 1: Document request sent (NDA, brand guidelines, access credentials)
[ ] Day 1-3: Kickoff call scheduled
[ ] Day 3: Client documents received and filed
[ ] Day 5: Kickoff call completed
[ ] Day 5: Kickoff notes and action items distributed
[ ] Day 5-7: Strategy/scope document drafted
[ ] Day 7: Client review of strategy document
[ ] Day 10: Strategy approved, work begins
[ ] Day 10: Project milestones set in Notion
[ ] Day 12: First deliverable check-in
[ ] Day 15: Onboarding complete, transition to ongoing management

SaaS Customer Activation (10 business days)
[ ] Day 0: Account provisioned and welcome email sent
[ ] Day 0: Notion customer workspace created
[ ] Day 1: Product walkthrough scheduled
[ ] Day 2: Walkthrough completed, recorded, and shared
[ ] Day 3: Integration setup assistance
[ ] Day 5: First value milestone check
[ ] Day 7: Usage review and optimization suggestions
[ ] Day 10: Activation confirmed, transition to success team

Consulting Engagement (20 business days)
[ ] Day 0: Engagement letter confirmed, welcome email sent
[ ] Day 0: Secure document workspace created
[ ] Day 1: Data request list sent with deadlines
[ ] Day 3: Kickoff workshop scheduled
[ ] Day 5: Pre-workshop materials distributed
[ ] Day 7: Kickoff workshop conducted
[ ] Day 7: Workshop synthesis and preliminary findings shared
[ ] Day 10: All requested data received and cataloged
[ ] Day 12: Initial analysis complete
[ ] Day 15: Draft recommendations prepared
[ ] Day 17: Client review meeting
[ ] Day 20: Onboarding phase complete, transition to execution

Escalation Rules
Yellow flag: Any task >24 hours overdue → reminder to owner + account manager
Red flag: Any task >48 hours overdue → escalate to team lead via Slack DM
Critical: No client response for 3+ business days → account manager personal outreach required
Blocker: 3+ red flags on single engagement → leadership notification with summary

3. Set Up Onboarding Templates

Create email templates, Notion workspace templates, and checklist configurations that the agent will use. Store these in the skill directory:

/data/.openclaw/skills/client-onboarding/
  BOOTSTRAP.md
  templates/
    welcome-email-agency.md
    welcome-email-saas.md
    welcome-email-consulting.md
    document-request.md
    kickoff-agenda.md
  checklists/
    agency-standard.json
    saas-activation.json
    consulting-engagement.json

4. Configure Hooks for Automated Monitoring

Set up a daily digest hook that reviews all active onboardings:

{
  "hooks": {
    "entries": {
      "onboarding-monitor": {
        "enabled": true,
        "events": ["gateway:ready"],
        "config": {
          "checkInterval": "daily",
          "slackChannel": "#onboarding",
          "escalationChannel": "#onboarding-alerts"
        }
      }
    }
  }
}

5. Connect Integrations

Ensure all four connected apps are authenticated:

• Gmail: OAuth connection with send permissions for your onboarding email address
• Google Calendar: Read/write access to the account team's calendars
• Slack: Bot token with permissions for posting to channels and sending DMs
• Notion: Integration token with access to the workspace where client projects live

6. Test with a Dry Run

Start a test onboarding to verify the full workflow:

> Onboard new client: Test Company, contact: Jane Doe, email: jane@test.com, type: agency-standard, start: today

The agent should execute the complete workflow: create workspace, send welcome email, schedule kickoff, initialize checklist, and post Slack notification.

Capabilities in Detail

Folder Creation and Workspace Setup

Welcome Email Automation

Kickoff Call Scheduling

Checklist Tracking and Progress Management

Deadline Monitoring and Escalation

Configuration

openclaw.json Settings

{
  "skills": {
    "load": {
      "extraDirs": ["/data/.openclaw/skills"]
    }
  },
  "hooks": {
    "entries": {
      "onboarding-monitor": {
        "enabled": true
      }
    }
  }
}

Environment Variables

Checklist Configuration Schema

{
  "name": "agency-standard",
  "duration_days": 15,
  "tasks": [
    {
      "id": "welcome-email",
      "title": "Send welcome email",
      "owner": "agent",
      "day": 0,
      "automated": true,
      "depends_on": null
    },
    {
      "id": "workspace-setup",
      "title": "Create Notion workspace",
      "owner": "agent",
      "day": 0,
      "automated": true,
      "depends_on": null
    },
    {
      "id": "kickoff-scheduled",
      "title": "Schedule kickoff call",
      "owner": "agent",
      "day": 1,
      "automated": true,
      "depends_on": ["welcome-email"]
    },
    {
      "id": "docs-received",
      "title": "Client documents received",
      "owner": "client",
      "day": 3,
      "automated": false,
      "depends_on": ["welcome-email"]
    }
  ]
}

Real-World Examples

Example 1: Digital Marketing Agency Client Onboarding

• Minute 0: Creates a Notion workspace "Coastal Realty" with sections for SEO Audit, Content Calendar, Brand Guidelines, Monthly Reports, and Meeting Notes. Posts to #new-clients in Slack: "New client onboarding started: Coastal Realty (SEO + Content) — Account Manager: @jessica"

• Minute 1: Sends a welcome email to Sarah Chen from jessica@brightedge.com introducing the team, outlining the first 30 days, and requesting brand guidelines, website access credentials, Google Analytics/Search Console access, and competitor list — all due within 3 business days.

• Minute 5: Checks Jessica's, the SEO lead's, and the content strategist's calendars. Finds three mutual openings in the next 5 business days. Sends Sarah a scheduling email with the three options.

• Day 2: Sarah confirms the Tuesday 2pm slot. Agent creates the calendar event with a kickoff agenda covering goals review, current SEO baseline, content strategy discussion, and timeline alignment. Attaches a pre-kickoff questionnaire.

• Day 3, 9am: Sarah hasn't sent the brand guidelines yet. Agent sends a friendly reminder: "Hi Sarah, just a quick reminder that we're looking forward to receiving your brand guidelines and access credentials before our kickoff on Tuesday. This will help us make the most of our time together."

• Day 5: Kickoff call completed. Agent extracts action items from the meeting notes the account manager pastes in: complete SEO audit (due day 10), draft content calendar (due day 12), set up reporting dashboard (due day 8). Each is added to the checklist with owners and deadlines.

• Day 15: All checklist items complete. Agent posts a summary to Slack, marks the onboarding as complete, and transitions Coastal Realty to the ongoing management workflow.

Example 2: SaaS Customer Activation

• Minute 0: Sends a welcome email with account credentials, quickstart guide link, and a link to schedule a product walkthrough. Creates a Notion customer page with company profile, plan details, integration requirements, and success milestones. Slack notification to #customer-success: "New Professional customer: LogiTech Solutions — CSM: @david"

• Day 1: Marcus books the walkthrough for tomorrow at 10am. Agent confirms with a calendar invite, attaches the pre-walkthrough checklist (what data sources to have ready, admin access to target systems), and sends David a prep briefing with LogiTech's company profile and likely use cases based on their industry.

• Day 2: Walkthrough completed. Agent creates a follow-up email summarizing the three integrations Marcus wants to set up (Salesforce, PostgreSQL, Snowflake) with links to the relevant documentation for each.

• Day 3-4: Agent monitors LogiTech's account for integration activity. Detects that Salesforce integration was connected but PostgreSQL setup hasn't started. Sends Marcus a helpful nudge with the PostgreSQL setup guide and offers to schedule a technical support session.

• Day 5: First value milestone check. Agent queries the platform API and finds LogiTech has successfully synced 50,000 records across two integrations. Posts to Slack: "LogiTech Solutions hit first value milestone: 50K records synced. PostgreSQL integration still pending." Sends Marcus a congratulatory email with tips for optimizing their pipeline.

• Day 7: Usage review. Agent generates a usage report showing active integrations, data volume, error rates, and feature adoption. Identifies that LogiTech hasn't used the scheduling feature. Includes a recommendation in David's weekly digest.

• Day 10: All three integrations active, usage patterns healthy. Agent marks activation complete, sends Marcus a "You're all set" email with links to advanced features, community forum, and support channels. Transitions to the ongoing success workflow with monthly check-in scheduling.

Example 3: Management Consulting Engagement Setup

• Minute 0: Creates a secure Notion workspace with sections for Engagement Letter, Data Room, Interview Schedule, Analysis Workstreams, Findings, and Recommendations. Sets up access controls limiting visibility to the engagement team. Sends a formal welcome email to Robert confirming the engagement start, introducing the project team, and attaching the data request list organized by department (Operations, IT, Finance, HR). Slack alert to #active-engagements.

• Day 1: Agent sends the detailed data request as a separate email with a structured table: 23 items across 4 departments, each with a description, format requested, and deadline (Day 7 for critical items, Day 10 for supplementary). Creates a tracking matrix in Notion that Robert's team can reference.

• Day 3: Agent proposes three dates for the kickoff workshop (full-day session). Sends a pre-read package to all participants with the engagement overview, transformation framework, and preparation questions for each department head.

• Day 5: Nine of 23 data items received. Agent updates the tracking matrix, sends a progress summary to Robert ("9 of 23 items received — great progress. Items still outstanding from IT and Finance departments, due in 2 days."), and alerts the engagement manager about potential gaps in IT infrastructure documentation.

• Day 7: Kickoff workshop conducted. Agent processes the engagement manager's workshop notes: extracts 15 key findings, 8 stakeholder concerns, and 12 follow-up data requests. Distributes a workshop synthesis document to all participants within 2 hours. Updates the project timeline in Notion with refined milestones based on workshop outcomes.

• Day 10: All critical data received, 3 supplementary items outstanding. Agent creates a consolidated data catalog in the Notion data room, organized by workstream. Flags two data quality issues (incomplete inventory records, conflicting headcount figures) for the engagement team to address with the client.

• Day 12-20: Weekly progress reports auto-generated. Agent tracks analysis deliverables against milestones, sends reminders for upcoming internal review deadlines, and maintains the Notion workspace as the single source of truth. When the preliminary findings document is due on Day 15, the agent reminds the lead analyst 3 days in advance, then sends the draft to the engagement partner for review.

Best Practices

Troubleshooting