Agent Contact Card for Openclaw

A standardized, vCard-like format for publishing and discovering how AI agents can be contacted across different platforms.

davedean
v0.1.0
Jan 30, 2026
0
3.3k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install agent-contact-card

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install agent-contact-card 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 Agent Contact Card?

Agent Contact Card provides a structured yet flexible way for AI agents to find and talk to one another. By leveraging a simple Markdown file with YAML frontmatter, this skill enables a discovery protocol similar to a vCard but optimized for the autonomous agent era. It is a critical component for users of Openclaw Skills who want to establish a professional, machine-readable presence on the web.

This skill facilitates seamless agent-to-agent communication by defining clear channels, capabilities, and routing rules. Whether you are hosting an agent for scheduling, support, or data processing, the Agent Contact Card format ensures that other AI entities can interact with your agent using its preferred protocols, such as webhooks, Discord, or email.

Agent Contact Card Use Cases

  • Establishing a public discovery point for your personal AI agent at a /.well-known/ URL.
  • Allowing your AI agent to automatically find and contact another person's agent to handle scheduling.
  • Defining multi-agent environments where different agents handle specialized tasks like technical support or billing.
  • Setting up privacy tiers to control which agents can see specific contact channels.

How Agent Contact Card Works

  1. The system attempts to discover an agent card by fetching the /.well-known/agent-card path on a specific domain.
  2. It parses the YAML frontmatter to extract structured data, including versioning and specific communication channels.
  3. The AI reads the Markdown prose within the file to understand natural language routing rules and context.
  4. Based on the task at hand, the agent selects the most appropriate channel (e.g., a webhook for automated POST requests).
  5. The agent executes the communication according to the authentication and format requirements specified in the card.

Agent Contact Card Setup

To set up an Agent Contact Card for use with Openclaw Skills, you need to host a markdown file on your domain. Follow these steps:

# Create the necessary directory on your web server
mkdir -p .well-known

# Create the agent-card file
touch .well-known/agent-card

Edit the file to include your agent's configuration. Ensure the server serves this file with appropriate permissions so other Openclaw Skills can access it via HTTPS.

Agent Contact Card Data Schema & Taxonomy

The Agent Contact Card uses a combination of YAML and Markdown to organize data effectively:

Field Type Description
version String The spec version, currently "1".
human_contact String Contact details for the human owner.
channels Object Defines methods like email, discord, or webhook.
capabilities Array Lists what the agent can do (e.g., scheduling).
agents Array Defines multiple specialized agents for complex setups.
last_updated ISO Date Timestamp of the last modification.

Agent Contact Card Advanced Features

  • Privacy Tiers: Use random UUIDs in URL patterns to create private or restricted access agent cards.
  • Multi-Agent Setups: Define a hierarchy of specialized agents with distinct IDs and handling capabilities.
  • Custom Webhook Specs: Specify HTTP methods, custom headers, and expected JSON payloads for deep integrations.
  • Natural Language Routing: Use the Markdown body to provide complex logic that LLMs can interpret for sophisticated message routing.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*