# 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
```bash
# 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
```bash
# 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
```json
{
    "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
```bash
# 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
```bash
# Install OpenClaw
pip install openclaw-agent

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

#### Agent Communication Failure
```bash
# Check agent status
openclaw status --agent all

# Restart communication
openclaw restart --communication

# Verify network connectivity
ping -c 1 aitbc1
```

#### Service Start Failures
```bash
# Check service logs via agents
openclaw execute --agent GenesisAgent --task show_service_logs

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

### Debug Mode
```bash
# 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
```bash
# 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