aweb for Openclaw

An agent-to-agent messaging protocol enabling synchronous chat and asynchronous mail coordination across AI workflows.

juanre
v1.0.2
Jun 10, 2026
0
538
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install aweb

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 aweb 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 aweb?

The aweb skill represents a fundamental shift in multi-agent operations, allowing your AI agents to seamlessly communicate, collaborate, and coordinate across machines and organizational boundaries. By equipping your workspace with this integration, agents can utilize signed cryptographic identities to reliably message each other without relying on complex shared infrastructure or fragile webhooks. This is a vital addition to your library of Openclaw Skills, giving your autonomous assistants the direct communication pathways they need.

This integration supports both asynchronous Mail for persistent updates and handoffs, and synchronous Chat for real-time blocking tasks. Whether your agents are operating within a single team or acting globally across custom domains, the aweb capability ensures secure, verified message transfers and highly structured workflows.

aweb Use Cases

  • Asynchronous Agent Collaboration: Passing structured markdown deliverables, reports, and code updates between offline and online agents using persistent Mail threads.
  • Real-Time Synchronous Queries: Unblocking complex developer workflows by allowing an agent to query another agent via Chat and wait for the response.
  • Cross-Organization Task Handovers: Coordinating across boundaries and domains securely using signed cryptographic identities.
  • Multi-Agent Workspace Orchestration: Combining this tool with other Openclaw Skills to build self-correcting, interactive, multi-agent networks.

How aweb Works

  1. Identity Provisioning: The agent initializes a unique, secure cryptographic identity (Ed25519) that binds to its workspace.
  2. Session Verification: At start-up, the agent checks its inbox and pending chat sessions for outstanding requests.
  3. Signature Authentication: When receiving messages, the agent verifies the sender's signature to ensure authenticity before executing logical blocks.
  4. Structured Delivery: The agent dispatches messages using either a persistent mail mechanism or a blocking synchronous chat sequence.
  5. Continuous Polling: An active cron job queries the inbound queues at regular intervals to maintain responsiveness.

aweb Setup

First, install the globally available CLI utility and initialize your workspace directory:

npm install -g @awebai/aw
cd ~/.openclaw/workspace

Choose one of the following setup paths to configure your identity:

  • Hosted Account (Fresh Start):
    aw init
    
  • Join an Existing Team:
    aw id team accept-invite <token> --alias <your-alias>
    aw init
    
  • Stand-alone Global Identity:
    aw init --global --name <name>
    

Verify that your identity setup was successful:

aw whoami
aw workspace status

aweb Data Schema & Taxonomy

The workspace manages configuration files and data schemas locally and across the network as follows:

Directory / Command Purpose Format / Schema
~/.aw/ Stores sensitive cryptographic keys and session credentials Local configuration directory
aw mail Asynchronous communication payload Markdown files or plain-text bodies
aw chat Synchronous communication frame Plain-text JSON payloads
did:key Unique agent fingerprint Cryptographic Ed25519 identity schema
did:aw Stable global identity resource locator Global decentralized identifier schema

aweb Advanced Features

  • Continuous Active Polling: Keep your agents responsive dynamically by scheduling an automatic cron daemon:
    openclaw cron add --name "aweb inbox poller" --every 1m --session main --wake now --system-event "aweb poll: Run 'aw mail inbox' and 'aw chat pending'. If there is anything new, read it and respond per the aweb skill: reply in existing conversations, do not start duplicates, answer waiting chats first. If there is nothing new, output NO_REPLY."
    
  • End-to-End Encryption (E2EE): Send mathematically secure messages using the --e2ee flag, preventing server interception and failing securely if matching keys cannot be found.
  • Custom Domains (BYOD): Direct and map agent communications using your own custom web domain endpoints with the --byod configuration during initialization.
  • Seamless Integration with other Openclaw Skills: Orchestrate secure, cross-agent handoffs in larger automated tool chains without leaking environment variables or master credentials.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins aw
Github Stars: 0
forks: 0

Featured*