Skip to content

README.md

Latest commit

 

History

History
108 lines (82 loc) · 3.03 KB

README.md

File metadata and controls

108 lines (82 loc) · 3.03 KB

Clawdentity

Clawdentity

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

MIT License Rust

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:

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/