Identity Resolver

What This Skill Does

The Identity Resolver skill is a foundational component for the OpenClaw ecosystem, designed to bridge the gap between fragmented digital personas. By mapping multiple channel-specific identifiers (like a Telegram ID, WhatsApp number, or Discord tag) to a single 'canonical' user ID, this tool ensures that your agent maintains a unified memory, consistent access control, and a seamless interaction history regardless of where you are chatting. It solves the common 'split-brain' problem where an AI agent treats the same user as two separate entities simply because they switched messaging platforms. The skill functions as a local, thread-safe database handler that links these accounts, allowing developers to build robust systems where personal data, preferences, and permissions follow the user across channels.

Installation

To integrate this into your OpenClaw workspace, ensure you have the uv package manager installed. You can install it by running the command curl -LsSf https://astral.sh/uv/install.sh | sh. Once prepared, you can add the skill directly from the repository using clawhub install openclaw/skills/skills/bowen31337/identity-resolver. For manual configuration, clone the repository into your skills/ directory. After installation, initialize the mapping system by running uv run python skills/identity-resolver/scripts/identity_cli.py init. This automatically parses your USER.md file to set up your primary identity, enabling the resolver to associate subsequent channels with your account immediately.

Use Cases

• Unified Agent Memory: Integrate the resolver into memory-heavy skills to store user data in a single directory keyed by canonical_id, ensuring the agent remembers your context whether you are on Telegram or Discord.
• Centralized Access Control: Use the resolver to verify administrative privileges. By checking if the canonical ID matches the owner ID, you can gate sensitive agent actions regardless of the messaging channel.
• Multi-platform Workflow Sync: Sync productivity logs or task lists across channels so that a request made via web chat is visible to the agent when you follow up via WhatsApp later.

Example Prompts

1. "Check if my current Telegram account is linked to my canonical identity."
2. "List all messaging channels currently associated with my primary user profile.
3. "Link my Discord account with ID 987654321 to my main identity resolver profile."

Tips & Limitations

This skill is built for local, privacy-first management and uses the Python standard library, meaning it is highly stable but relies on local file storage. Always ensure that the USER.md file in your workspace is kept up to date, as the auto-registration depends on its contents. Note that the resolver does not perform cross-channel authentication itself; it assumes that the identity provided via a channel is legitimate. For advanced security, pair this with secondary authentication methods. The skill implements path-traversal protection, so you can safely use canonical IDs in filesystem paths without fear of malicious directory escapes.