aitbc/.windsurf/workflows/OPENCLAW_MASTER_INDEX.md

description, title, version

description	title	version
Master index for OpenClaw workflows - links to all modules and provides navigation	OpenClaw Workflows - Master Index	1.0

OpenClaw Workflows - Master Index

This master index provides navigation to all OpenClaw agent workflows and documentation. Each workflow focuses on specific aspects of OpenClaw agent training, coordination, and testing.

📚 Module Overview

🎓 Agent Training Modules

Cross-Node Communication Training

File: openclaw-cross-node-communication.md Purpose: Specialized training for agent-to-agent cross-node communication via AITBC blockchain Audience: OpenClaw agents learning multi-node coordination Prerequisites: Stage 2 of Mastery Plan, both nodes synchronized

Key Topics:

• Agent registration on multiple blockchain nodes
• Peer discovery across blockchain state
• Cross-node messaging via blockchain transactions
• Distributed task execution
• Event monitoring and message parsing

Quick Start:

cd /opt/aitbc/scripts/training
./openclaw_cross_node_comm.sh

---

🧪 Agent Testing Modules

Ollama GPU Provider Test (OpenClaw)

File: ollama-gpu-test-openclaw.md Purpose: Complete end-to-end test for Ollama GPU inference jobs using OpenClaw agents Audience: QA engineers, OpenClaw developers Prerequisites: OpenClaw 2026.3.24+, all services running, enhanced CLI

Key Topics:

• Environment validation with OpenClaw agents
• Wallet setup and management
• Service health verification
• GPU test execution and monitoring
• Payment processing and validation
• Blockchain transaction recording
• Comprehensive test reporting

Quick Start:

SESSION_ID="ollama-gpu-test-$(date +%s)"
openclaw agent --agent test-coordinator --session-id $SESSION_ID \
    --message "Initialize complete Ollama GPU test workflow" \
    --thinking high

---

🤖 Agent Coordination Modules

Agent Coordination Plan Enhancement

File: agent-coordination-enhancement.md Purpose: Advanced multi-agent communication patterns, distributed decision making, and scalable architectures Audience: OpenClaw developers, system architects Prerequisites: Advanced AI Teaching Plan completed

Key Topics:

• Hierarchical, peer-to-peer, and broadcast communication patterns
• Consensus-based and weighted decision making
• Microservices, load balancing, and federated architectures
• Multi-agent task orchestration
• Performance metrics and monitoring
• Implementation guidelines

Quick Start:

SESSION_ID="coordination-$(date +%s)"
openclaw agent --agent CoordinatorAgent --session-id $SESSION_ID \
    --message "BROADCAST: System-wide resource optimization initiated" \
    --thinking high

---

🗺️ Module Dependencies

Cross-Node Communication Training (Foundation)
├── Ollama GPU Provider Test (Testing)
└── Agent Coordination Enhancement (Advanced)

🚀 Recommended Learning Path

For New OpenClaw Users

1. Cross-Node Communication Training - Learn basic multi-node messaging
2. Ollama GPU Provider Test - Practice agent-based testing
3. Agent Coordination Enhancement - Master advanced coordination

For OpenClaw Developers

1. Cross-Node Communication Training - Understand multi-node architecture
2. Agent Coordination Enhancement - Master coordination patterns
3. Ollama GPU Provider Test - Learn testing methodology

For System Architects

1. Cross-Node Communication Training - Understand distributed messaging
2. Agent Coordination Enhancement - Design scalable architectures
3. Ollama GPU Provider Test - Learn testing patterns

🎯 Quick Navigation

By Task

Task	Recommended Module
Multi-Node Messaging	Cross-Node Communication Training
Agent-Based Testing	Ollama GPU Provider Test
Advanced Coordination	Agent Coordination Enhancement
Distributed Decision Making	Agent Coordination Enhancement
Performance Monitoring	Agent Coordination Enhancement

By Role

Role	Essential Modules
OpenClaw Developer	Cross-Node Communication Training, Agent Coordination Enhancement
QA Engineer	Ollama GPU Provider Test, Cross-Node Communication Training
System Architect	Agent Coordination Enhancement, Cross-Node Communication Training
DevOps Engineer	Ollama GPU Provider Test, Agent Coordination Enhancement

By Complexity

Level	Modules
Beginner	Cross-Node Communication Training
Intermediate	Ollama GPU Provider Test
Advanced	Agent Coordination Enhancement
Expert	All modules

🔍 Quick Reference Commands

Cross-Node Communication

# Register agent on genesis node
NODE_URL=http://10.1.223.40:8006 ./aitbc-cli agent create \
  --name "openclaw-genesis-commander" \
  --description "Primary coordinator agent" \
  --verification full

# Send cross-node message
NODE_URL=http://10.1.223.40:8006 ./aitbc-cli agent message \
  --to $FOLLOWER_AGENT_ID \
  --content "{\"cmd\":\"STATUS_REPORT\",\"priority\":\"high\"}"

Ollama GPU Testing

# Initialize test coordinator
SESSION_ID="ollama-test-$(date +%s)"
openclaw agent --agent test-coordinator --session-id $SESSION_ID \
    --message "Initialize Ollama GPU provider test workflow" \
    --thinking high

# Submit inference job
openclaw agent --agent client-agent --session-id $SESSION_ID \
    --message "Submit Ollama GPU inference job" \
    --parameters "prompt:What is the capital of France?,model:llama3.2:latest"

Agent Coordination

# Hierarchical communication
SESSION_ID="hierarchy-$(date +%s)"
openclaw agent --agent CoordinatorAgent --session-id $SESSION_ID \
    --message "Broadcast: Execute distributed AI workflow" \
    --thinking high

# Consensus voting
openclaw agent --agent GenesisAgent --session-id $SESSION_ID \
    --message "VOTE $PROPOSAL_ID: YES - Dynamic allocation optimizes AI performance" \
    --thinking medium

📊 System Overview

OpenClaw Architecture

OpenClaw Agent Ecosystem:
├── Genesis Node (aitbc) - Primary development server
├── Follower Node (aitbc1) - Secondary node
├── Agent Gateway - OpenClaw communication layer
├── Blockchain Messaging - Transaction-based agent communication
├── Smart Contracts - Agent messaging and governance
├── GPU Services - Ollama inference and resource management
└── Monitoring - Agent performance and coordination metrics

Key Components

• Agent Gateway: OpenClaw communication and coordination
• Blockchain Messaging: Transaction-based cross-node communication
• Smart Contracts: Agent messaging, reputation, and governance
• GPU Services: Ollama inference, resource allocation
• Monitoring: Agent performance, communication metrics

🎯 Success Metrics

Training Success

• Agents registered on multiple nodes
• Cross-node messaging functional
• Distributed task execution working
• Event monitoring operational

Testing Success

• Environment validation passing
• GPU test execution successful
• Payment processing validated
• Blockchain recording verified

Coordination Success

• Communication latency <100ms
• Decision accuracy >95%
• Scalability: 10+ concurrent agents
• Fault tolerance >99% availability

🔧 Troubleshooting Quick Reference

Common Issues

Issue	Module	Solution
Agent registration fails	Cross-Node Communication Training	Check node sync, verify wallet
Cross-node messages not delivered	Cross-Node Communication Training	Verify agent IDs, check blockchain sync
GPU test fails	Ollama GPU Provider Test	Check Ollama service, GPU availability
Coordination timeout	Agent Coordination Enhancement	Check agent gateway, session management

Emergency Procedures

1. Agent Recovery: Restart OpenClaw gateway, check agent status
2. Network Recovery: Check node connectivity, restart P2P service
3. Blockchain Recovery: Check node sync, verify transaction pool
4. Service Recovery: Restart coordinator, Ollama, GPU miner

📚 Additional Resources

Documentation Files

• OpenClaw Agent Capabilities: docs/openclaw/OPENCLAW_AGENT_CAPABILITIES_ADVANCED.md
• Agent Communication Guide: docs/openclaw/guides/openclaw_agent_fix_summary.md
• Messaging Implementation: docs/openclaw/guides/openclaw_messaging_implementation_guide.md
• Cross-Node Communication: docs/openclaw/guides/openclaw_cross_node_communication.md

Workflow Scripts

• Cross-Node Training: /opt/aitbc/scripts/training/openclaw_cross_node_comm.sh
• Ollama GPU Test: ollama_gpu_test_openclaw.sh
• Agent Communication Fix: /opt/aitbc/scripts/workflow-openclaw/fix_agent_communication.sh

🔄 Version History

v1.0 (Current)

• Created master index for OpenClaw workflows
• Organized workflows by training, testing, and coordination
• Added navigation and learning paths
• Included quick reference commands and troubleshooting

🤝 Contributing

Updating Documentation

1. Update specific module files
2. Update this master index if needed
3. Update cross-references between modules
4. Test all links and commands
5. Commit changes with descriptive message

Module Creation

1. Follow established template structure
2. Include prerequisites and dependencies
3. Add quick start commands
4. Include troubleshooting section
5. Update this master index

---

Note: This master index is your starting point for all OpenClaw workflow operations. Choose the appropriate module based on your current task and expertise level.

For immediate help, see the Cross-Node Communication Training module for foundational knowledge, or the Agent Coordination Enhancement module for advanced patterns.