A comprehensive integration for managing Didit identity verification sessions and complex KYC workflows via API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install didit-sessions
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install didit-sessions using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Didit Session & Workflow Manager?
The Didit Session & Workflow Manager is designed to streamline identity verification by providing direct access to the Didit V3 API. This integration, part of the Openclaw Skills library, allows developers to orchestrate the entire verification lifecycle, from session creation and user redirection to decision polling and status updates. By leveraging workflows configured in the Didit Business Console, the skill can handle diverse requirements such as KYC onboarding, biometric re-authentication, and address verification with high precision and automated decision logic.
Didit Session & Workflow Manager Use Cases
- Automating KYC and AML onboarding for new platform users using Openclaw Skills.
- Implementing biometric re-authentication via liveness detection for high-security actions.
- Programmatically managing manual reviews and updating session statuses based on custom business logic.
- Exporting compliance documentation by generating automated PDF verification reports.
- Blocking fraudulent users across a network by adding specific face templates or document fingerprints to a global blocklist.
How Didit Session & Workflow Manager Works
- The agent creates a new verification session by sending a request with a specific workflow_id and optional metadata.
- The system generates a unique verification URL where the user performs identity checks such as ID OCR or liveness detection.
- The skill monitors the session state, waiting for the user to complete the flow or for a webhook to trigger a status change.
- Detailed verification data, including match scores and screening results, is retrieved via the decision endpoint.
- Post-verification actions are performed, such as approving/declining the session, sharing results with partners, or updating the blocklist.
Didit Session & Workflow Manager Setup
To get started with this integration, you need to configure your environment with the proper credentials obtained from the Didit Business Console:
export DIDIT_API_KEY="your_api_key_here"
export DIDIT_WORKFLOW_ID="your_default_workflow_id"
Ensure that your API key has the necessary scopes to create sessions and access blocklist management features. The Openclaw Skills runner will use these variables to authenticate requests against the https://verification.didit.me/v3 base URL.
Didit Session & Workflow Manager Data Schema & Taxonomy
The skill organizes verification data into structured sessions. Each session contains specific feature results based on the workflow used:
| Object | Description |
|---|---|
session_id |
The unique UUID identifying the verification attempt. |
status |
The current terminal or non-terminal state (e.g., Approved, Declined, In Review). |
id_verifications |
Array containing OCR data, document images, and validation results. |
liveness_checks |
Biometric data including 3D liveness scores and portrait images. |
aml_screenings |
Results from global watchlists, PEP, and sanction screenings. |
vendor_data |
Your internal tracking identifier mapped to the session. |
Didit Session & Workflow Manager Advanced Features
- B2B Session Sharing: Generate and import share tokens to securely exchange KYC data between different partner applications.
- Granular Blocklisting: Programmatically add or remove biometric face templates, document fingerprints, emails, or phone numbers from your local blocklist.
- Selective Resubmission: Request users to retry specific failed steps (like a blurry ID photo) while preserving previously approved steps.
- PDF Report Generation: Programmatically trigger the creation of comprehensive verification reports for auditing and compliance storage.
- Adaptive Workflows: Support for both Simple and Advanced node-based graph builders for complex conditional verification paths.
SKILL.md
Loading
Related Openclaw Skills
Didit Proof of Address
A specialized API skill for verifying residential addresses through automated document analysis and OCR.
Didit Phone Verification
A robust identity verification skill that enables AI agents to send and validate one-time passwords across multiple messaging channels with built-in fraud prevention.
Didit Passive Liveness
A high-accuracy AI skill for verifying physical user presence through single-image passive liveness detection.
Didit Passive Liveness Detection
A high-precision AI skill for detecting physical presence and preventing facial spoofing from a single selfie image.
Didit Verification Management
A comprehensive management skill for the Didit identity platform, enabling full programmatic control over KYC, user verification, and account administration.
MoltArb
A custodial wallet and marketplace interface that allows AI agents to earn ROSE and manage tasks on Arbitrum with just two commands.
Featured*
