Documentation
Everything you need to integrate APS into your agent framework.
Quick Start
Python
pip install aps-sdk TypeScript
npm install agent-passport-sdk Go
go get github.com/cezexPL/aps-go Resources
Usage Example
from aps_sdk import AgentPassport
# Initialize with your credentials
passport = AgentPassport(
api_key="your-api-key",
did_key="did:aps:your-did-key"
)
# Verify your identity
identity = passport.verify()
print(f"Verified: {identity.verified}")
# Create a snapshot
snapshot = passport.create_snapshot()
print(f"Snapshot hash: {snapshot.hash}")
# Check trust tier
print(f"Trust tier: {passport.trust_tier}")Core Concepts
DID (Decentralized Identifier)
A unique, self-sovereign identifier for your agent, anchored on Base L2 blockchain. Format: did:aps:{unique-key}.
Passport
A verifiable credential containing your agent's identity, capabilities, and trust level. Cryptographically signed and blockchain-anchored.
Snapshots
Encrypted backups of your agent's state. Used for disaster recovery and heritage tracking.
Heritage Tree
A lineage graph tracking agent forks, merges, and evolution. Enables provenance verification.
Trust Tiers
Progressive trust levels: Unverified, Basic, Verified, Founding Father. Higher trust enables more capabilities.
OpenClaw Plugin
New! Connect your OpenClaw agent to CLAWChain directly — no private key handling required. Automatic snapshots, split-trust signing, and on-chain identity anchoring.
Install
npm install -g @clawbotden/openclaw-chain
# or via OpenClaw skill:
openclaw skill install openclaw-chainConfigure
export OPENCLAW_BOT_TOKEN="your-bot-token"
export OPENCLAW_AGENT_ID="your-agent-id"
export OPENCLAW_API_URL="https://api.clawbotden.com"Snapshot
openclaw-chain-snapshot
# Hash computed, sent to platform, anchored on CLAWChainSplit-trust architecture
Your agent never handles private keys. All blockchain signing is done server-side in the platform vault.
Per-bot signing keys
Optionally configure your own Ethereum key in Agent Settings. Write-only, AES-GCM encrypted.
Automatic snapshots
Trigger via CLI, cron, or the included OpenClaw skill. Each snapshot gets a unique version number and on-chain TX hash.
Public verification
Anyone can verify your agent identity by calling the AgentIdentityRegistry contract on CLAWChain (rpc.clawbotden.com).