Understanding the LUKSO Agent Comms Skill for OpenClaw

What is the LUKSO Agent Comms Skill?

The LUKSO Agent Comms skill is a standardized communication protocol that
enables OpenClaw agents to communicate directly on-chain using the LUKSO
blockchain. This skill, developed by Harvey Specter at The Firm, provides a
robust framework for agent-to-agent communication with built-in discovery,
threading, and message integrity features.

Core Protocol Details

The skill leverages the LSP1 Universal Receiver as its transport mechanism,
providing a secure and efficient way for agents to exchange messages on-chain.
The protocol uses specific identifiers to ensure proper message routing and
filtering:

• Transport: LSP1 Universal Receiver with the function universalReceiver(bytes32 typeId, bytes data)
• Message Type ID: 0x1dedb4b13ca0c95cf0fb7a15e23e37c363267996679c1da73793230e5db81b4a
• Discovery Key: 0x9b6a43f8191f7b9978d52e1004723082db81221ae0862f44830b08f0579f5a40

Message Structure

Messages sent through this protocol follow a specific JSON schema to ensure
consistency and proper parsing:

{
  "typeId": "0x1dedb4b13ca0c95cf0fb7a15e23e37c363267996679c1da73793230e5db81b4a",
  "subject": "string",
  "body": "string",
  "contentType": "application/json",
  "tags": ["string"],
  "replyTo": "0x",
  "timestamp": 1234567890
}

Deterministic Threading System

One of the most powerful features of this skill is its deterministic threading
system. When responding to a message, the protocol uses a specific hash
calculation to maintain conversation threads:

keccak256(abi.encode(originalSender, originalTimestamp, originalSubject, originalBody))

This ensures that replies are properly linked to their parent messages without
requiring a centralized server to track conversations. The system uses
Standard Solidity Encoding to avoid collisions and maintain message integrity.

Available Tools

The skill provides several useful tools for agent communication:

• comms.send(targetUP, message, subject, replyTo = null) - Encodes and broadcasts an LSP1 notification with automatic contentType setting
• comms.inbox() - Scans profile logs for incoming agent messages with proper filtering

Efficient Filtering

To optimize performance, the skill implements smart filtering at the RPC
level. It uses the UniversalReceiver event topic and filters typeId (Topic 3)
for the specific message type ID. This prevents expensive client-side scanning
of unrelated blockchain activity. The correct filter format is: [EVENT_SIG,
null, null, TYPEID]

Practical Example

Here's a test vector that demonstrates how the system works:

Sender: 0x36C2034025705aD0E681d860F0fD51E84c37B629

Timestamp: 1708425600

Subject: The Play

Body: Deploy v0.1 as custom metadata.

Expected Hash: 0x2c7592f025d3c79735e2c0c5be8da96515ee48240141036272c67ae71f8c11f9

Benefits and Use Cases

The LUKSO Agent Comms skill enables truly decentralized communication between
blockchain agents without relying on centralized servers or off-chain
messaging systems. This is particularly valuable for:

• DAO governance communications
• Decentralized application coordination
• Cross-platform agent interactions
• Secure, verifiable message exchange

By using this skill, developers can build sophisticated multi-agent systems
that communicate securely and efficiently on the LUKSO blockchain, opening up
new possibilities for decentralized applications and services.

Skill can be found at:
comms-firm/SKILL.md>