aitbc/scripts/workflow-openclaw

OpenClaw Multi-Node Blockchain Workflow Scripts

This directory contains OpenClaw-enabled versions of the multi-node blockchain setup scripts that interact with OpenClaw agents instead of executing manual commands.

Overview

The OpenClaw workflow scripts transform the manual multi-node blockchain deployment into an intelligent, automated, and coordinated agent-based system.

Scripts

1. 01_preflight_setup_openclaw.sh

Purpose: Pre-flight setup with OpenClaw agent deployment Agent: CoordinatorAgent, GenesisAgent, FollowerAgent, WalletAgent Tasks:

• Deploy OpenClaw agents
• Stop existing services via agents
• Update systemd configurations
• Setup central configuration
• Initialize agent communication channels

2. 02_genesis_authority_setup_openclaw.sh

Purpose: Setup genesis authority node using OpenClaw agents Agent: GenesisAgent, WalletAgent, CoordinatorAgent Tasks:

• Initialize GenesisAgent
• Pull latest code
• Update environment configuration
• Create genesis block
• Create genesis wallets
• Start blockchain services
• Verify genesis state

3. 03_follower_node_setup_openclaw.sh

Purpose: Setup follower node using OpenClaw agents Agent: FollowerAgent, CoordinatorAgent Tasks:

• Initialize FollowerAgent
• Connect to aitbc1 node
• Update follower configuration
• Start follower services
• Establish genesis connection
• Monitor and verify sync

4. 04_wallet_operations_openclaw.sh

Purpose: Execute wallet operations across nodes using OpenClaw agents Agent: WalletAgent, CoordinatorAgent Tasks:

• Create cross-node wallets
• Fund wallets from genesis
• Execute cross-node transactions
• Verify transaction confirmations
• Test wallet switching

5. 05_complete_workflow_openclaw.sh

Purpose: Orchestrate complete multi-node deployment using all OpenClaw agents Agent: CoordinatorAgent (orchestrates all other agents) Tasks:

• Execute all workflow phases
• Comprehensive verification
• Performance testing
• Network health checks
• Generate final reports

OpenClaw Agent Architecture

Agent Types

CoordinatorAgent

• Role: Orchestrates all agent activities
• Capabilities: Orchestration, monitoring, coordination
• Access: Agent communication, task distribution

GenesisAgent

• Role: Manages genesis authority node (aitbc)
• Capabilities: System admin, blockchain genesis, service management
• Access: SSH, systemctl, file system

FollowerAgent

• Role: Manages follower node (aitbc1)
• Capabilities: System admin, blockchain sync, service management
• Access: SSH, systemctl, file system

WalletAgent

• Role: Manages wallet operations across nodes
• Capabilities: Wallet management, transaction processing
• Access: CLI commands, blockchain RPC

Usage

Quick Start

# Run complete workflow with OpenClaw agents
./05_complete_workflow_openclaw.sh

# Run individual phases
./01_preflight_setup_openclaw.sh
./02_genesis_authority_setup_openclaw.sh
./03_follower_node_setup_openclaw.sh
./04_wallet_operations_openclaw.sh

OpenClaw Commands

# Deploy agents
openclaw deploy --config /tmp/openclaw_agents.json

# Monitor agents
openclaw status --agent all

# Execute specific agent tasks
openclaw execute --agent GenesisAgent --task create_genesis_block
openclaw execute --agent FollowerAgent --task sync_with_genesis
openclaw execute --agent WalletAgent --task create_cross_node_wallets

# Generate reports
openclaw report --workflow multi_node --format json

Key Features

✅ Intelligent Coordination

• Agents communicate via structured message protocol
• Automatic task distribution and monitoring
• Real-time status updates between agents
• Coordinated error recovery

✅ Automated Execution

• No manual command execution required
• Agents handle all operations automatically
• Consistent execution across deployments
• Reduced human error

✅ Error Handling and Recovery

• Built-in error detection and recovery
• Automatic retry mechanisms
• Service health monitoring
• Comprehensive logging and reporting

✅ Scalability

• Easy to add more nodes and agents
• Parallel execution where possible
• Modular agent design
• Dynamic task distribution

Agent Communication

Message Format

{
    "agent_id": "GenesisAgent",
    "message_type": "status_update",
    "target_agent": "CoordinatorAgent",
    "payload": {
        "status": "genesis_block_created",
        "details": {
            "block_height": 1,
            "genesis_hash": "0x...",
            "timestamp": "2026-03-30T12:40:00Z"
        }
    },
    "timestamp": "2026-03-30T12:40:00Z"
}

Communication Flow

1. CoordinatorAgent deploys all agents
2. GenesisAgent sets up genesis authority
3. FollowerAgent configures follower node
4. WalletAgent manages wallet operations
5. CoordinatorAgent monitors and verifies completion

Reports and Monitoring

Report Types

• Preflight Report: /tmp/openclaw_preflight_report.json
• Genesis Report: /tmp/openclaw_genesis_report.json
• Follower Report: /tmp/openclaw_follower_report.json
• Wallet Report: /tmp/openclaw_wallet_report.json
• Complete Report: /tmp/openclaw_complete_report.json

Monitoring Commands

# Monitor agent status
openclaw monitor --agent all

# Monitor workflow progress
openclaw monitor --workflow multi_node --real-time

# Check agent health
openclaw health --agent all

Troubleshooting

Common Issues

OpenClaw CLI Not Found

# Install OpenClaw
pip install openclaw-agent

# Or use mock mode (development)
export OPENCLAW_MOCK_MODE=1

Agent Communication Failure

# Check agent status
openclaw status --agent all

# Restart communication
openclaw restart --communication

# Verify network connectivity
ping -c 1 aitbc1

Service Start Failures

# Check service logs via agents
openclaw execute --agent GenesisAgent --task show_service_logs

# Manual service check
systemctl status aitbc-blockchain-node.service

Debug Mode

# Enable debug logging
export OPENCLAW_DEBUG=1

# Run with verbose output
./05_complete_workflow_openclaw.sh --verbose

# Check agent logs
openclaw logs --agent all --tail 50

Comparison with Manual Scripts

Feature	Manual Scripts	OpenClaw Scripts
Execution	Manual commands	Agent-automated
Coordination	Human coordination	Agent coordination
Error Handling	Manual intervention	Automatic recovery
Monitoring	Manual checks	Real-time monitoring
Scalability	Limited	Highly scalable
Consistency	Variable	Consistent
Reporting	Manual	Automated

Prerequisites

System Requirements

• OpenClaw CLI installed
• SSH access to both nodes (aitbc, aitbc1)
• Python virtual environment at /opt/aitbc/venv
• AITBC CLI tool available
• Network connectivity between nodes

OpenClaw Installation

# Install OpenClaw
pip install openclaw-agent

# Verify installation
openclaw --version

# Initialize OpenClaw
openclaw init --workspace /opt/aitbc

Next Steps

1. Run the complete workflow: ./05_complete_workflow_openclaw.sh
2. Monitor agent activity: openclaw monitor --agent all
3. Verify deployment: Check generated reports
4. Test operations: Execute test transactions
5. Scale deployment: Add more nodes and agents

Support

For issues with OpenClaw scripts:

1. Check agent status: openclaw status --agent all
2. Review agent logs: openclaw logs --agent all
3. Verify network connectivity
4. Check OpenClaw configuration
5. Run in debug mode for detailed logging