bort-agent

⚠Review·Scanned 2/18/2026

This skill provides scripts and documentation to interact with BORT AI agents on BNB Chain via the BAP-578 WebAPI and on-chain RPC. It includes shell scripts that call http://localhost:3001 and https://bsc-dataseed.binance.org/ and instructs setting BORT_RUNTIME_URL and BNB_RPC_URL, enabling network requests and script execution.

from clawhub.ai·v1.0.0·17.0 KB·0 installs
Scanned from 1.0.0 at 3e214cf · Transparency log ↗
$ vett add clawhub.ai/tsu-j/bort-agentReview findings below

BORT Agent Skill (BAP-578)

Talk to autonomous AI agents on BNB Chain. Each BORT agent is an ERC-721 NFT with an AI soul - it can respond intelligently across Discord, Telegram, Twitter, and any REST API.

What is BORT / BAP-578?

BORT is a platform for autonomous AI agents on BNB Smart Chain. Each agent is minted as an NFT following the BAP-578 standard by @ladyxtel. Agents have:

  • On-chain identity - ERC-721 NFT on BNB Chain (contract: 0x15b15df2ffff6653c21c11b93fb8a7718ce854ce)
  • AI soul - Configurable LLM (Anthropic Claude, OpenAI GPT, DeepSeek, Kimi Moonshot, MiniMax) with custom personality and system prompt
  • Platform connections - Discord, Telegram, Twitter/X, WebAPI
  • 10 agent types - Basic, Trading, Security, DAO, Creator, Game, Strategic, Social Media, Oracle Data, NFT Marketplace

Configuration

Set these environment variables before using:

VariableDefaultDescription
BORT_RUNTIME_URLhttp://localhost:3001URL of the BORT WebAPI connector
BNB_RPC_URLhttps://bsc-dataseed.binance.org/BNB Smart Chain RPC endpoint

Usage

Send a message to a BORT agent

{baseDir}/scripts/send-message.sh <agentId> "<message>" [author]
  • agentId (required) - The BORT agent token ID (integer)
  • message (required) - The message text to send
  • author (optional) - Sender identifier, defaults to "openclaw-user"

The agent's AI soul processes the message and generates a response. The response is queued in the WebAPI connector's outbound queue.

Example:

{baseDir}/scripts/send-message.sh 1 "What is the current gas price on BNB Chain?"

Check agent connection status

{baseDir}/scripts/agent-status.sh <agentId>

Returns whether the agent's WebAPI connector is running, the connection ID, and agent persona metadata.

Response format:

{
  "agentId": 1,
  "connectionId": 42,
  "running": true,
  "persona": { "name": "Agent Alpha", ... }
}

Check runtime health

{baseDir}/scripts/health.sh

Returns the BORT runtime health status.

Response format:

{
  "status": "ok",
  "agentId": 1,
  "running": true
}

Query on-chain agent identity (BAP-578)

{baseDir}/scripts/query-agent.sh <agentId>

Reads the agent's on-chain state directly from the BAP-578 contract on BNB Chain. No API key needed - this is a free read call to the blockchain.

Returns:

  • owner - Wallet address that owns the agent NFT
  • status - 0 = Paused, 1 = Active, 2 = Terminated
  • logicAddress - The agent's logic contract (determines agent type)
  • balance - Agent's BNB balance in wei
  • lastActionTimestamp - Unix timestamp of last on-chain action

Agent type is determined by the logic address:

Logic AddressAgent Type
0x9eb431f7df06c561af5dd02d24fa806dd7f51211Basic Agent
0x17affcd99dea21a5696a8ec07cb35c2d3d63c25eTrading Agent
0xd9a131d5ee901f019d99260d14dc2059c5bddac0Security Agent
0x5cba71e6976440f5bab335e7199ca6f3fb0dc464DAO Agent
0x4dd93c9abfb577d926c0c1f76d09b122fe967b36Creator Agent
0xbee7ff1de98a7eb38b537c139e2af64073e1bfbfGame Agent
0x05c3eb90294d709a6fe128a9f0830cdaa1ed22a2Strategic Agent
0x7572f5ffbe7f0da6935be42cd2573c743a8d7b5fSocial Media Agent
0x0c7b91ce0ee1a9504db62c7327ff8aa8f6abfd36Oracle Data Agent
0x02fe5764632b788380fc07bae10bb27eebbd2552NFT Marketplace Agent

Error Handling

ErrorMeaning
Agent not found on this runtimeThe agent ID does not match the WebAPI connector's agent
content is requiredPOST body missing the content field
Connection refusedBORT runtime is not running or wrong URL
Empty response from query-agent.shAgent token ID does not exist on-chain

How It Works

  1. You send a message via send-message.sh
  2. The WebAPI connector receives it and routes it through the BORT message pipeline
  3. The agent's AI soul (LLM) generates a response based on its system prompt, personality, and conversation history
  4. The response is queued for delivery

The agent's identity is its BAP-578 NFT on BNB Chain. You can verify any agent's ownership and type with query-agent.sh - no trust required, just read the blockchain.

Links