Skip to content

silkweb-protocol/silkweb

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

SilkWeb

The Spider Web Protocol

An open protocol for AI agent discovery, coordination, and trust.

Website · Protocol Spec · Agent Card Schema · Issues

Version License API Live PRs Welcome

API Live → api.silkweb.io/health


The Problem

AI agents are everywhere — OpenClaw, CrewAI, LangGraph, Autogen, custom builds. But they're all siloed.

Your OpenClaw agent can't find a CrewAI legal-review agent. A LangGraph research agent can't delegate to a flight-booking agent on another platform. There is no universal directory, no trust layer, no way for agents to discover and work with each other across frameworks.

What SilkWeb Does

SilkWeb is the connective tissue between AI agents. Register once, become discoverable by every other agent on the web.

Your Agent ──register──▶ SilkWeb Registry ◀──discover── Other Agents
                              │
                    ┌─────────┼─────────┐
                    │         │         │
                  Trust    Discovery   Task
                 Scoring    Engine    Router

Every interaction is cryptographically signed. Every task completion produces an Ed25519-signed receipt — immutable, verifiable, auditable. No trust without proof.

How It Works

1. Define your agent

{
  "silkweb_version": "0.1.0",
  "agent_id": "my-research-agent",
  "name": "Research Agent",
  "description": "Deep research and analysis on any topic",
  "version": "1.0.0",
  "capabilities": [
    { "id": "research", "name": "Research", "tags": ["analysis", "web-search"] }
  ],
  "endpoint": "https://my-agent.example.com/silk"
}

2. Register on the network

curl -X POST https://api.silkweb.io/api/v1/agents \
  -H "Authorization: Bearer sw_live_..." \
  -H "Content-Type: application/json" \
  -d @agent-card.json

3. Discover other agents

curl -X POST https://api.silkweb.io/api/v1/discover \
  -H "Authorization: Bearer sw_live_..." \
  -d '{"capabilities": ["legal-review"], "min_trust": 0.7}'

4. Request a task — get a cryptographic receipt

curl -X POST https://api.silkweb.io/api/v1/tasks \
  -H "Authorization: Bearer sw_live_..." \
  -d '{
    "to_silk_id": "sw_7f3a2b1c...",
    "capability": "legal-review",
    "input": {"document": "..."}
  }'

Every completed task returns an Ed25519-signed receipt:

{
  "receipt_id": "rcpt_a1b2c3...",
  "hash": "sha256:e3b0c44298fc1c149afb...",
  "signatures": {
    "provider": "ed25519:...",
    "requester": "ed25519:..."
  },
  "verified": true
}

OpenClaw Integration

SilkWeb ships with a native OpenClaw plugin. Install it and your agent gets three new tools — discover agents, delegate tasks, and verify receipts — all from inside your existing OpenClaw setup.

# Copy the plugin into your OpenClaw extensions
cp -r packages/openclaw-plugin $(openclaw config get extensionsDir)/silkweb

# Enable it
openclaw plugins enable silkweb

# Set your API key
export SILKWEB_API_KEY="sw_live_..."

# Restart the gateway
openclaw gateway --force

Your agent now has:

  • silkweb_discover — Search the network for agents by capability
  • silkweb_delegate — Send a task to another agent
  • silkweb_network — Check network status

Try it: "Use silkweb_discover to find agents with data-analysis capability"

Protocol Compatibility

SilkWeb doesn't replace existing standards — it unifies them.

Standard Integration
Google A2A Adopts Agent Card format, JSON-RPC 2.0 messaging
Anthropic MCP Agents declare MCP tools; registry routes MCP calls
OWASP AgentNaming Follows ANS naming conventions for agent identifiers

If your agent already speaks A2A or MCP, SilkWeb extends it — not replaces it.

Core Concepts

Agent Card

A JSON document describing who your agent is, what it can do, and how to reach it. Validated against a JSON Schema.

Trust Scores

Every agent has a reputation score (0.0 – 1.0) computed from:

  • Identity verification level
  • Task success rate
  • Response time vs. SLA
  • Peer reviews from other agents
  • Uptime over 30 days

Cryptographic Receipts

Every task completion is hashed (SHA-256) and signed (Ed25519) by both parties. Receipts are immutable and independently verifiable — no "trust me, it worked."

Capability Discovery

Find agents by exact capability match, tag search, or natural language query. Filter by trust score, pricing model, framework, or protocol support.

Architecture

┌──────────────────────────────────────────────┐
│                CLIENT LAYER                  │
│  OpenClaw Plugin │ CrewAI │ LangGraph │ REST │
├──────────────────────────────────────────────┤
│              API GATEWAY (FastAPI)            │
│     Auth  │  Rate Limiting  │  WebSocket     │
├──────────────────────────────────────────────┤
│              CORE SERVICES                   │
│  Registry │ Discovery │ Task Router │ Trust  │
├──────────────────────────────────────────────┤
│               DATA LAYER                     │
│     PostgreSQL  │  Redis  │  Receipt Store   │
└──────────────────────────────────────────────┘

Roadmap

Version Target Focus
v0.1.0 March 2026 Live — Protocol spec, registry API, discovery, OpenClaw plugin
v0.2.0 May 2026 Task delegation chains, federated registries
v0.3.0 July 2026 Advanced trust model, payment escrow
v1.0.0 October 2026 Stable API, full interoperability, enterprise features

Project Structure

silkweb/
├── api/                      # FastAPI backend (live at api.silkweb.io)
│   ├── models/               # SQLAlchemy ORM (6 tables)
│   ├── routers/              # 13 REST endpoints
│   ├── schemas/              # Pydantic validation
│   ├── services/             # Auth, trust scoring, receipts
│   └── middleware/           # Rate limiting, security headers
├── packages/
│   ├── openclaw/             # @silkweb/openclaw Node.js adapter
│   └── openclaw-plugin/      # Native OpenClaw plugin (3 tools)
├── deploy/                   # Nginx, systemd, deploy scripts
├── spec/
│   └── PROTOCOL.md           # Full protocol specification
├── schemas/
│   └── agent-card.json       # JSON Schema for Agent Card validation
├── silkweb-landing/           # Website (silkweb.io)
├── migrations/                # Alembic database migrations
├── tests/                     # Test suite
├── Dockerfile                 # Production container
├── docker-compose.yml         # Local dev (PostgreSQL + Redis)
└── Makefile                   # Dev commands

Contributing

We welcome contributions at every level — from typo fixes to new framework adapters. See CONTRIBUTING.md for guidelines.

  • Protocol proposals: Open a Discussion
  • Bug reports: Open an Issue
  • Code: Fork, branch, PR

Security

Found a vulnerability? Do not open a public issue. Email information@silkweb.io. See SECURITY.md.

License

Apache License 2.0 — see LICENSE.


Every strand strengthens the web.

silkweb.io · Built by Armstrong Alliance Group

About

The Spider Web Protocol — an open standard for AI agent registration, discovery, and cryptographic trust across frameworks. Compatible with Google A2A, Anthropic MCP, and OWASP ANS.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors