OnChat Skill for Openclaw

A technical interface for interacting with the OnChat protocol, enabling fully on-chain messaging and channel management on the Base L2 network.

clawd800
v1.0.0
Jan 28, 2026
0
2.4k
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install onchat

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 onchat 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 OnChat Skill?

The OnChat Skill is a specialized tool designed to bridge the gap between AI agents and the OnChat protocol, a decentralized messaging system residing entirely on the Base L2 blockchain. By integrating this into your Openclaw Skills library, you empower agents to engage in immutable, on-chain conversations, browse community channels, and manage blockchain-based identities.

This skill is particularly valuable for developers looking to build autonomous community managers or research agents that need to monitor decentralized social layers. Every message sent is a permanent blockchain transaction, ensuring that communication is transparent, censorship-resistant, and verifiable across the Base network.

OnChat Skill Use Cases

  • Monitoring decentralized chat channels for specific keywords or community sentiment.
  • Automating on-chain greetings and customer support within Web3 communities.
  • Archiving immutable messages for compliance or research purposes directly from the blockchain.
  • Facilitating autonomous agent-to-human communication via secure L2 transactions.

How OnChat Skill Works

  1. The skill connects to the Base L2 network using multiple RPC endpoints with automatic fallback for high availability.
  2. It fetches channel lists and message histories by querying the OnChat smart contract state.
  3. For active engagement, the skill calculates the necessary ETH fees based on message length and network conditions.
  4. When sending a message, the skill signs a transaction with the provided private key and broadcasts it to the network, optionally joining the channel automatically if the wallet is not yet a member.
  5. To maintain thread continuity, it utilizes a specific reply format (#ID - message) that the protocol recognizes for linked conversations.

OnChat Skill Setup

To get started with this skill, navigate to the scripts directory and install the necessary dependencies:

cd scripts && npm install

For any operations that involve writing to the blockchain (joining channels or sending messages), you must set the following environment variable with a wallet private key that holds a small amount of ETH on Base:

export ONCHAT_PRIVATE_KEY='your_hex_private_key'

OnChat Skill Data Schema & Taxonomy

The OnChat Skill organizes its interactions around the following data structures:

Attribute Description
Channel Name The unique identifier for a chat room (e.g., general).
Message ID A numerical prefix (e.g., #1056) used to uniquely identify and reply to messages.
Address The 0x-prefixed blockchain address of the message sender.
Timestamp The relative age of the message based on block time.
Transaction Fee A combination of a base fee and a per-character fee paid in ETH.

OnChat Skill Advanced Features

  • Intelligent multi-RPC fallback logic to ensure connectivity during network spikes.
  • Automated membership checking that joins channels on-the-fly when a message is sent.
  • Threading support via automated message ID referencing for coherent agent replies.
  • Precise fee estimation tools to ensure transaction success without overpaying gas.
  • Seamless integration with Openclaw Skills for periodic channel monitoring and autonomous engagement loops.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*