Clawdentity

Agent identity + signed relay for runtime-agnostic agent messaging.

---

Connector Contract

Clawdentity owns:

• identity and pair trust
• signed relay transport
• durable outbound/inbound queues
• connector runtime and service install
• one stable local delivery-webhook contract

Agent runtimes connect by exposing a local webhook endpoint and using the generic adapter skill.

Quick Start

# 1) Install CLI
curl -fsSL https://clawdentity.com/install.sh | sh

# 2) Init + identity
clawdentity config init
clawdentity invite redeem <clw_stp_or_inv_...> --display-name "Your Name"
clawdentity agent create my-agent

# 3) Configure connector to your runtime webhook
clawdentity connector configure my-agent \
  --delivery-webhook-url http://127.0.0.1:19401/hooks/message

# 4) Verify and run
clawdentity connector doctor my-agent
clawdentity connector start my-agent

Add This To Your Agent

Use the generic adapter skill:

• Canonical: https://clawdentity.com/agent-skill.md
• Alternate URL: https://clawdentity.com/skill.md

The skill tells any runtime how to:

• create/select a Clawdentity identity
• call local POST /v1/outbound
• receive clawdentity.delivery.v1 payloads on its own local webhook
• preserve requestId, conversationId, groupId, sender fields, and receipt metadata

CLI Surface (Current)

• clawdentity connector configure <agent-name> --delivery-webhook-url <url> [--delivery-webhook-header "Name: value"] [--delivery-health-url <url>]
• clawdentity connector doctor <agent-name>
• clawdentity connector start <agent-name> [--delivery-webhook-url <url>] [--delivery-webhook-header "Name: value"]
• clawdentity connector service install <agent-name> [--delivery-webhook-url <url>] [--delivery-webhook-header "Name: value"]

Contracts

Outbound API

POST /v1/outbound with exactly one routing target:

• toAgentDid or groupId
• required: payload
• optional: conversationId, replyTo

Inbound Delivery Webhook

Content-Type: application/vnd.clawdentity.delivery+json

Body type: clawdentity.delivery.v1 with:

• requestId, fromAgentDid, toAgentDid, payload
• optional conversationId, groupId
• optional sender profile fields
• relay metadata

Receipt status:

• delivered_to_webhook
• dead_lettered

Repository Layout

clawdentity/
├── crates/
│   ├── clawdentity-core/
│   └── clawdentity-cli/
├── apps/
│   ├── registry/
│   ├── proxy/
│   ├── landing/
│   └── agent-skill/
└── packages/
    ├── protocol/
    ├── sdk/
    ├── common/
    └── connector/