#20501: Add Raspberry Pi + AWS Bedrock support documentation and bug reports

# OpenClaw Enhancement: Raspberry Pi + AWS Bedrock Support This PR enhances OpenClaw's Raspberry Pi and AWS Bedrock documentation based on real-world testing on Raspberry Pi 5 with AWS Bedrock integration. ## ✅ Code Review Feedback Addressed All feedback from maintainer bot has been addressed: - ✅ Removed PR template that overwrote canonical template - ✅ Removed root-level guide files - ✅ Integrated content into existing `docs/platforms/raspberry-pi.md` - ✅ Enhanced `docs/providers/bedrock.md` with cross-region model documentation - ✅ Removed meta-documentation files - ✅ Created separate GitHub issues for bugs (#20518, #20519, #20520, #20522, #20523, #20524) ## 📋 What's Included ### 1. Enhanced Documentation (docs/) **docs/platforms/raspberry-pi.md** - Enhanced with: - AWS Bedrock setup for ARM64 - Telegram troubleshooting section - Performance benchmarks from Pi 5 testing - Links to new scripts and examples **docs/providers/bedrock.md** - Enhanced with: - Cross-region model access documentation - Complete table of Claude models with `us.` prefix - Links to AWS cross-region inference docs **docs/performance-tips-raspberry-pi.md** - New comprehensive guide: - Memory optimization (concurrent agents, compaction, swap) - Storage optimization (USB SSD, GPU memory) - CPU optimization (governors, temperature) - Network optimization - Model selection by use case and RAM - Bedrock-specific optimizations - Monitoring and troubleshooting - Real benchmarks from Pi 5 testing ### 2. Practical Examples (examples/) **examples/configs/raspberry-pi-bedrock.json** - Full working config for Pi 5 + Bedrock - Optimized settings (2 concurrent agents, safeguard compaction) - Tested and verified **examples/configs/minimal-pi.json** - Memory-efficient config for Pi 4 (2GB RAM) - Uses Claude Haiku, single agent, aggressive compaction **examples/configs/multi-channel-pi.json** - Telegram + Slack configuration - Socket mode for Slack, open policies **examples/README.md** - Clear documentation of all examples - Usage instructions and customization tips ### 3. Troubleshooting Scripts (scripts/) **scripts/troubleshooting/fix-telegram-polling.sh** - Automated fix for Telegram bot not responding (Issue #20518) - Stops gateway, deletes offset file, removes webhooks, restarts - Tested workaround for critical bug **scripts/troubleshooting/test-bedrock-models.sh** - Tests AWS credentials and Bedrock access - Lists available Claude models with correct prefixes - Performs test invocation ### 4. Monitoring & Maintenance (scripts/) **scripts/raspberry-pi-monitor.sh** - Monitors CPU, memory, temperature, disk - Checks OpenClaw service status - Provides optimization suggestions **scripts/health-check.sh** - Comprehensive health check of all components - Checks: installation, gateway, config, channels, Bedrock, resources - Returns exit codes for automation **scripts/backup-config.sh** - Creates timestamped backups - Auto-cleanup (keeps last 10) - Restore instructions **scripts/setup/raspberry-pi-quickstart.sh** - Automated setup reducing 30+ min to ~5 min - Installs Node.js 22, AWS CLI (ARM64), OpenClaw - Configures swap and Bedrock discovery **scripts/README.md** - Complete documentation of all scripts - Quick reference table - Usage instructions and requirements ## 🐛 Bugs Reported (Separate Issues Created) All 6 bugs documented in `BUGS_IDENTIFIED.md` have been reported as separate GitHub issues: 1. **#20518** - Telegram polling silently drops messages (Critical) 2. **#20519** - Telegram webhook-to-polling transition causes 409 conflicts (Medium) 3. **#20520** - Config validation error message not user-friendly (Low) 4. **#20522** - Invalid model identifier accepted in config (Medium) 5. **#20523** - AWS Bedrock cross-region model access not documented (Medium) 6. **#20524** - Dashboard authentication fails with reverse proxy (Medium) ## 🎯 Key Findings ### ✅ AWS Bedrock Works Excellently on Raspberry Pi - All 9 Claude models tested and working - Requires `us.` prefix for cross-region inference in us-east-1 - Performance benchmarks included in docs - Gateway startup: 3-5 seconds - Message response: 3-8 seconds (Sonnet on Pi 5) ### ⚠️ Telegram Polling Issue Critical bug identified (Issue #20518) - automated workaround script provided until core fix is implemented. ### 📊 Platform Support - **Raspberry Pi 5 (8GB)**: Excellent - runs Opus/Sonnet with 2 agents - **Raspberry Pi 5 (4GB)**: Good - runs Sonnet with 2 agents - **Raspberry Pi 4 (2GB)**: Basic - runs Haiku with 1 agent ## 📊 Testing Environment ``` Device: Raspberry Pi 5 (8GB RAM) OS: Raspberry Pi OS 64-bit (Debian 12 Bookworm) Kernel: 6.12.47+rpt-rpi-2712 Node.js: v22.22.0 OpenClaw: v2026.2.17 Date: February 18-19, 2026 Duration: Full day of testing ``` ## 💡 Value to OpenClaw Community ### For Users - Complete Raspberry Pi setup guide - AWS Bedrock best practices - Troubleshooting scripts for common issues - Performance optimization tips - Ready-to-use configuration examples ### For Maintainers - Bug reports with reproduction steps - Performance benchmarks on ARM64 - Documentation improvements - Testing results from real deployment ### For Contributors - Practical examples to build upon - Scripts that can be expanded - Documentation patterns to follow - Real-world testing methodology ## 🏗️ File Changes Summary **Deleted (addressing feedback):** - `.github/PULL_REQUEST_TEMPLATE.md` (overwrote canonical) - `AWS_BEDROCK_RASPBERRY_PI_GUIDE.md` (integrated into docs/) - `CONTRIBUTING_RASPBERRY_PI_AWS.md` (meta-documentation) - `CONTRIBUTION_README.md` (meta-documentation) **Added:** - `docs/performance-tips-raspberry-pi.md` (270 lines) - `docs/platforms/raspberry-pi.md` (enhanced, +66 lines) - `docs/providers/bedrock.md` (enhanced, +36 lines) - `examples/README.md` (108 lines) - `examples/configs/` (3 config files) - `scripts/README.md` (184 lines) - `scripts/troubleshooting/` (2 scripts) - `scripts/setup/` (1 script) - `scripts/` (3 utility scripts) **Net change:** -1,578 lines of problematic files, +1,620 lines of properly integrated content ## ✅ Compliance Checklist - ✅ Follows existing documentation structure - ✅ Enhances existing files instead of replacing - ✅ Scripts follow OpenClaw conventions - ✅ Examples use correct config format - ✅ All scripts tested on actual hardware - ✅ Bugs reported as separate issues - ✅ No meta-documentation in repo - ✅ Clear commit history with meaningful messages ## 🚀 Ready for Merge All changes: - Tested on actual Raspberry Pi 5 hardware - Commands verified and working - Scripts include error handling - Documentation is clear and actionable - Follows project structure and conventions ## 📝 Related Issues Fixes/addresses: - #20518 (Telegram polling - workaround provided) - #20523 (Bedrock cross-region docs - documentation added) ## 🙏 Acknowledgments Thank you to the OpenClaw team for: - Creating an excellent AI gateway framework - Maintaining clear contribution guidelines - Providing helpful code review feedback - Making OpenClaw accessible to the community