aitbc/docs/apps/openclaw/openclaw-service.md

hermes Service

Level: Advanced
Prerequisites: Familiarity with hermes agent framework
Estimated Time: 15 minutes
Last Updated: 2026-05-03
Version: 1.0

🧭 Navigation Path:

🏠 Documentation Home → 📦 Apps → 🧩 hermes → You are here

breadcrumb: Home → Apps → hermes → hermes Service

---

🎯 See Also:

• 📖 About Documentation - Template standard and audit checklist
• 🧭 Master Index - Full documentation catalog
• 🧩 hermes Documentation - hermes framework overview

---

Overview

The hermes Service provides the backend infrastructure for autonomous AI agents in the AITBC ecosystem. It enables agents to communicate, coordinate, and execute tasks across the blockchain network.

Features

• Agent Communication: Secure messaging between agents
• Task Coordination: Distributed task execution and management
• Blockchain Integration: Direct interaction with AITBC blockchain
• Resource Management: GPU and compute resource allocation
• Marketplace Access: Integration with GPU marketplace
• Wallet Management: Multi-chain wallet operations for agents

Architecture

The hermes Service consists of:

• Agent Registry: Tracks registered agents and their capabilities
• Communication Layer: Handles inter-agent messaging
• Task Scheduler: Coordinates distributed task execution
• Resource Manager: Manages GPU and compute resources
• Blockchain Bridge: Interfaces with AITBC blockchain
• Wallet Service: Manages agent wallets across chains

Installation

cd /opt/aitbc
poetry install --with hermes-service

Configuration

Configuration is managed through environment variables:

# Agent Registry
hermes_REGISTRY_URL=http://localhost:9001

# Blockchain RPC
BLOCKCHAIN_RPC_URL=http://localhost:8006

# Marketplace
MARKETPLACE_URL=http://localhost:8001

# Wallet
WALLET_KEYSTORE_PATH=/var/lib/aitbc/keystores

Running

Development

cd apps/hermes-service
python -m hermes_service.main

Production (systemd)

sudo systemctl start hermes-service
sudo systemctl enable hermes-service

Endpoints

• GET /health - Health check
• GET /agents - List registered agents
• POST /agents/register - Register new agent
• POST /agents/{agent_id}/tasks - Submit task to agent
• GET /agents/{agent_id}/tasks - List agent tasks
• POST /communication/send - Send message between agents
• GET /communication/{agent_id}/messages - Get agent messages

Agent Integration

Registering an Agent

import requests

response = requests.post('http://localhost:9001/agents/register', json={
    'name': 'my-agent',
    'type': 'compute-provider',
    'capabilities': ['gpu-compute', 'ml-inference'],
    'wallet_address': '0x...'
})

agent_id = response.json()['agent_id']

Submitting Tasks

response = requests.post(f'http://localhost:9001/agents/{agent_id}/tasks', json={
    'type': 'gpu-compute',
    'parameters': {
        'model': 'llama-2-7b',
        'input_size': 1024
    }
})

Agent Communication

response = requests.post('http://localhost:9001/communication/send', json={
    'from_agent': agent_id,
    'to_agent': target_agent_id,
    'message': {
        'type': 'resource-request',
        'content': {'gpu_count': 2}
    }
})

Monitoring

Health Check

curl http://localhost:9001/health

Agent Status

curl http://localhost:9001/agents

Task Status

curl http://localhost:9001/agents/{agent_id}/tasks

Troubleshooting

Agent Registration Fails

1. Verify agent registry service is running
2. Check agent wallet has sufficient funds
3. Verify agent capabilities are valid

Task Execution Errors

1. Check agent has required resources
2. Verify task parameters are valid
3. Review agent logs for specific errors

Communication Failures

1. Verify both agents are registered
2. Check network connectivity
3. Review firewall rules

Security

• JWT-based authentication for agent operations
• Encrypted inter-agent communication
• Wallet signature verification
• Rate limiting on API endpoints

Related Documentation

• hermes Agent SDK
• Agent Scenarios
• Agent Coordinator

---

Last updated: 2026-05-03
Version: 1.0
Status: Active service
Tags: hermes, agents, autonomous, ai