aitbc
fb460816e4
All checks were successful
API Endpoint Tests / test-api-endpoints (push) Successful in 38s
Documentation Validation / validate-docs (push) Successful in 10s
Integration Tests / test-service-integration (push) Successful in 57s
Python Tests / test-python (push) Successful in 1m32s
Security Scanning / security-scan (push) Successful in 1m7s
🔧 Database Path Standardization:
• Change DATABASE_URL environment variable to EXCHANGE_DATABASE_URL
• Update default database path from ./exchange.db to /var/lib/aitbc/data/exchange/exchange.db
• Apply consistent path resolution across all exchange database connections
• Update database.py, seed_market.py, and simple_exchange_api.py with new path
• Maintain backward compatibility through
288 lines
7.6 KiB
Markdown
288 lines
7.6 KiB
Markdown
# 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
|