A unified identity resolution system that maps multi-channel user IDs to a single canonical identifier to prevent state fragmentation.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install identity-resolver
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 identity-resolver 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 Identity Resolver?
The Identity Resolver is a critical utility within the ecosystem of Openclaw Skills designed to solve the problem of fragmented user data. When users interact with an agent through multiple channels like Telegram, WhatsApp, or Discord, they often appear as separate entities. This skill maps these disparate channel identities to one canonical user ID automatically.
By unifying these identities, the skill ensures that memory, access control, and per-user preferences remain consistent across the entire workspace. It serves as a foundational layer for developers building sophisticated, cross-platform agentic workflows that require a single source of truth for user identification.
Identity Resolver Use Cases
- Unifying user memory across different messaging platforms like Discord and Telegram to maintain conversational context.
- Implementing global access control by identifying the workspace owner across all integrated communication channels.
- Preventing duplicate user state fragmentation in multi-agent environments that interact with the same person on various apps.
- Streamlining secure file-based storage by using sanitized canonical IDs for user-specific data directories.
How Identity Resolver Works
- The skill initializes by reading the USER.md file in the workspace to auto-detect and register the primary owner.
- When a message is received, the system extracts the channel (e.g., telegram) and the provider-specific user ID.
- The resolve_canonical_id function queries the identity-map.json to find a match for the provider-specific ID.
- If the user is registered, it returns their unique canonical ID; if not, it returns a safe, platform-prefixed stranger ID.
- Developers then use this canonical ID to fetch relevant user data, ensuring a seamless experience regardless of the entry point.
Identity Resolver Setup
To get started, ensure you have uv installed on your system:
curl -LsSf https://astral.sh/uv/install.sh | sh
Next, install the identity-resolver skill via ClawHub:
cd /path/to/openclaw/workspace
clawhub install identity-resolver
Finally, initialize your identity map to link your local user settings to the resolution engine:
uv run python skills/identity-resolver/scripts/identity_cli.py init
Identity Resolver Data Schema & Taxonomy
The skill manages its mappings within an identity-map.json file, typically stored in the data or memory directory. It uses the following structure:
| Attribute | Description |
|---|---|
canonical_id |
A sanitized, alphanumeric identifier safe for filesystem paths. |
is_owner |
A boolean flag indicating if the identity belongs to the workspace owner. |
channels |
A list of platform-specific IDs in the format channel:user_id. |
display_name |
An optional human-readable name for the resolved user. |
updated_at |
A timestamp indicating the last time the identity mapping was modified. |
Identity Resolver Advanced Features
- Thread-safe storage operations utilizing fcntl file locking to ensure data integrity during simultaneous multi-agent access.
- Built-in path traversal protection that strictly sanitizes canonical IDs to prevent security vulnerabilities in file operations.
- A comprehensive CLI and Python API that allows Openclaw Skills to programmatically manage identity mappings and owner verification.
- Zero-dependency architecture relying strictly on the Python standard library for high performance and minimal environment overhead.
SKILL.md
Loading
Related Openclaw Skills
gopls-lsp
A powerful Go language server integration providing real-time code intelligence, diagnostics, and refactoring support for Go developers.
FearHarvester Skill
An autonomous sentiment-based trading agent that executes DCA strategies into BTC and ETH during periods of extreme market fear.
Skill Designer Agent
A framework and toolkit for developing, initializing, and packaging modular extensions for AI agents.
ClawChain RPC Client
An RPC client connecting EvoClaw agents to the ClawChain L1 blockchain for on-chain identity, reputation, and tokenomics.
Intelligent Router
A core infrastructure skill for Openclaw Skills that dynamically routes agent tasks to the most cost-effective and capable AI models.
Pyright LSP
A high-performance Python language server providing static type checking, code intelligence, and real-time diagnostics for professional development.
Featured*
