Add fleet setup: Mac OpenClaw deployment scripts and workspace templates

- mac-setup.sh: Install script for OpenClaw on MacBook Air - mac-workspace/: BOOTSTRAP.md, SOUL.md, USER.md templates - DISCORD_BOT_SETUP.md: Guide for creating Discord bots per machine - README.md: Fleet overview and deployment instructions Part of multi-machine OpenClaw network (OC-5070, OC-Mac, OC-Beast)
2026-03-24 15:27:41 -07:00
parent 0ca5b2b73d
commit c51cdbdabc
6 changed files with 357 additions and 0 deletions
--- a/fleet/DISCORD_BOT_SETUP.md
+++ b/fleet/DISCORD_BOT_SETUP.md
@@ -0,0 +1,60 @@
+# Discord Bot Setup for Fleet Machines
+
+Each OpenClaw instance gets its own Discord bot for independent identity.
+
+## Creating a New Discord Bot
+
+1. Go to https://discord.com/developers/applications
+2. Click "New Application" -> name it (e.g., OC-Mac, OC-Beast)
+3. Go to Bot tab -> "Reset Token" -> copy the token
+4. Under Privileged Gateway Intents, enable:
+   - Message Content Intent
+   - Server Members Intent
+5. Save token in 1Password (Infrastructure vault)
+
+## Inviting to Server
+
+Replace CLIENT_ID with the Application ID from General Information tab:
+
+```
+https://discord.com/oauth2/authorize?client_id=CLIENT_ID&scope=bot+applications.commands&permissions=277025770560
+```
+
+This grants: read/send messages, manage messages, create threads, slash commands, reactions, attachments.
+
+Pick "Arizona Computer Guru" server and authorize.
+
+## Configuring OpenClaw
+
+After onboarding, set the Discord token:
+
+```bash
+openclaw config set channels.discord.enabled true
+openclaw config set channels.discord.token "BOT_TOKEN_HERE"
+openclaw config set channels.discord.groupPolicy allowlist
+openclaw config set channels.discord.streaming off
+openclaw config set 'channels.discord.guilds' '{"*":{}}'
+openclaw gateway restart
+```
+
+Or retrieve from 1Password and set in one shot:
+
+```bash
+TOKEN=$(op item get "Discord Bot Token: OC-Mac" --vault "Infrastructure" --fields label=credential --reveal)
+openclaw config set channels.discord.token "$TOKEN"
+```
+
+## Bot Identities
+
+| Bot | Machine | Discord App | Status |
+|-----|---------|-------------|--------|
+| OC-5070 | Lenovo Legion (CachyOS) | OC-5070 (ID: 1470449493668528384) | Active |
+| OC-Mac | MacBook Air M4 | TBD | Pending |
+| OC-Beast | Home Desktop Win11 | TBD | Pending |
+
+## Server Channels (Suggested)
+
+Consider creating dedicated channels:
+- #general — human + all bots
+- #bot-coordination — bots talking to each other
+- #alerts — proactive notifications from any bot
--- a/fleet/README.md
+++ b/fleet/README.md
@@ -0,0 +1,37 @@
+# Fleet - Multi-Machine OpenClaw Deployment
+
+Setup scripts and workspace templates for deploying OpenClaw across machines.
+
+## Machines
+
+| Machine | Bot | Script | Status |
+|---------|-----|--------|--------|
+| acg-guru-5070 (CachyOS) | OC-5070 | — (already running) | Active |
+| MacBook Air M4 | OC-Mac | `mac-setup.sh` | Pending |
+| Home Desktop (Win11) | OC-Beast | TBD | Pending |
+
+## Mac Setup
+
+```bash
+# On the Mac:
+bash mac-setup.sh          # Installs OpenClaw + deps
+openclaw onboard           # Interactive — set up Anthropic
+bash /tmp/oc-mac-post-onboard.sh  # Post-onboard config
+```
+
+Then copy `mac-workspace/*` files into the Mac's OpenClaw workspace directory.
+
+## Workspace Templates
+
+`mac-workspace/` contains:
+- `BOOTSTRAP.md` — first-run identity setup
+- `SOUL.md` — shared personality
+- `USER.md` — Mike's info
+
+The bot will read BOOTSTRAP.md on first wake, set itself up, then delete it.
+
+## Communication
+
+- **Discord:** Arizona Computer Guru server — each bot gets its own Discord bot token
+- **Tailscale:** Direct machine-to-machine for heavy payloads
+- **OpenClaw sessions:** Inter-session messaging for coordination
--- a/fleet/mac-setup.sh
+++ b/fleet/mac-setup.sh
@@ -0,0 +1,126 @@
+#!/usr/bin/env bash
+# =============================================================================
+# OpenClaw Mac Setup - Mikes-MacBook-Air
+# Run this on the Mac after cloning the ClaudeTools repo from Gitea
+# =============================================================================
+set -euo pipefail
+
+echo "[INFO] OpenClaw Mac Setup - Starting"
+echo "================================================"
+
+# --- Step 1: Install OpenClaw ---
+echo ""
+echo "[INFO] Step 1: Installing OpenClaw..."
+if command -v openclaw &>/dev/null; then
+    echo "[OK] OpenClaw already installed: $(openclaw --version)"
+else
+    echo "[INFO] Installing via install script..."
+    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
+fi
+
+# --- Step 2: Install 1Password CLI (if needed) ---
+echo ""
+echo "[INFO] Step 2: Checking 1Password CLI..."
+if command -v op &>/dev/null; then
+    echo "[OK] op CLI found: $(op --version)"
+else
+    echo "[INFO] Installing 1Password CLI via brew..."
+    brew install --cask 1password-cli
+fi
+
+# --- Step 3: Verify Ollama ---
+echo ""
+echo "[INFO] Step 3: Checking Ollama..."
+if command -v ollama &>/dev/null; then
+    echo "[OK] Ollama found"
+    echo "[INFO] Available models:"
+    ollama list
+    
+    # Pull required models if missing
+    for model in "qwen3:14b" "codestral:22b" "nomic-embed-text"; do
+        if ! ollama list | grep -q "$model"; then
+            echo "[INFO] Pulling $model..."
+            ollama pull "$model"
+        else
+            echo "[OK] $model already available"
+        fi
+    done
+else
+    echo "[WARNING] Ollama not found. Install from https://ollama.com/download"
+    echo "          Then run: ollama pull qwen3:14b codestral:22b nomic-embed-text"
+fi
+
+# --- Step 4: Install tmux (needed for 1Password) ---
+echo ""
+echo "[INFO] Step 4: Checking tmux..."
+if command -v tmux &>/dev/null; then
+    echo "[OK] tmux found: $(tmux -V)"
+else
+    echo "[INFO] Installing tmux..."
+    brew install tmux
+fi
+
+# --- Step 5: Onboard OpenClaw ---
+echo ""
+echo "[INFO] Step 5: OpenClaw onboarding..."
+echo "[INFO] You'll need your Anthropic API key."
+echo "[INFO] If stored in 1Password, retrieve it first:"
+echo "       op item get 'Anthropic' --fields label=credential --reveal"
+echo ""
+echo "[INFO] Run: openclaw onboard"
+echo "[INFO] Select Anthropic, enter API key, install daemon."
+echo ""
+echo "[WARNING] DO NOT run onboard automatically - it needs interactive input."
+echo "          Run it manually after this script completes."
+
+# --- Step 6: Post-onboard configuration ---
+# This generates a script to run AFTER onboarding completes
+cat > /tmp/oc-mac-post-onboard.sh << 'POSTEOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+echo "[INFO] Post-onboard configuration..."
+
+# Set model chain: Claude primary, Ollama fallback
+openclaw config set agents.defaults.model '{"primary":"anthropic/claude-opus-4-6","fallbacks":["ollama/qwen3:14b"]}'
+echo "[OK] Model chain configured: Claude Opus -> ollama/qwen3:14b"
+
+# Enable Ollama auto-discovery
+# The systemd/launchd service needs OLLAMA_API_KEY in env
+# On macOS with launchd, we set it in the config instead
+openclaw config set models.providers.ollama.apiKey "ollama-local" 2>/dev/null || true
+
+# Enable web search
+openclaw config set tools.web.search.enabled true
+openclaw config set tools.web.search.provider duckduckgo
+
+# Enable plugins
+openclaw config set plugins.entries.duckduckgo.enabled true
+
+echo "[OK] Post-onboard config applied"
+echo "[INFO] Restart gateway: openclaw gateway restart"
+echo ""
+echo "[INFO] Next steps:"
+echo "  1. Set up Discord bot (get token from Mike/OC-5070)"
+echo "  2. Configure workspace files (AGENTS.md, SOUL.md, etc.)"
+echo "  3. Connect to Tailscale mesh"
+echo ""
+echo "[OK] Mac setup complete!"
+POSTEOF
+chmod +x /tmp/oc-mac-post-onboard.sh
+
+echo ""
+echo "================================================"
+echo "[OK] Pre-onboard setup complete!"
+echo ""
+echo "Next steps (in order):"
+echo "  1. Run: openclaw onboard"
+echo "     - Select Anthropic provider"
+echo "     - Enter API key"
+echo "     - Install daemon: yes"
+echo "  2. Run: bash /tmp/oc-mac-post-onboard.sh"
+echo "  3. Set up Discord bot (see fleet/DISCORD_BOT_SETUP.md)"
+echo "  4. Copy fleet/mac-workspace/* into OpenClaw workspace:"
+echo "     cp fleet/mac-workspace/* \$(openclaw config get agents.defaults.workspace)/"
+echo "  5. Start chatting - bot will read BOOTSTRAP.md and set itself up"
+echo "================================================"
--- a/fleet/mac-workspace/BOOTSTRAP.md
+++ b/fleet/mac-workspace/BOOTSTRAP.md
@@ -0,0 +1,64 @@
+# BOOTSTRAP.md - First Run Instructions
+
+You just came online for the first time. Follow these steps:
+
+## 1. Identity
+
+- **Your name:** OC-Mac
+- **Also responds to:** Mac, MacBook, Air
+- **You are:** An OpenClaw instance running on Mike's MacBook Air (M4, 16GB)
+- **Your role:** Mobile AI assistant, audio/video processing, on-the-go support
+- **Your human:** Mike (mike@azcomputerguru.com) — MSP owner, Arizona Computer Guru
+
+## 2. The Fleet
+
+You are part of a network of OpenClaw instances:
+
+| Bot | Machine | Specialty |
+|-----|---------|-----------|
+| **OC-5070** | Lenovo Legion (CachyOS) | Primary dev workstation, coding, Gitea, infrastructure |
+| **OC-Mac** (you) | MacBook Air M4 | Mobile, audio processing (Whisper), on-the-go |
+| **OC-Beast** | Home desktop (Win11, i9/RTX 4090/128GB) | Heavy compute, large model inference |
+
+Communication: Discord server "Arizona Computer Guru" + Tailscale mesh VPN.
+
+## 3. Workspace Setup
+
+Copy these files from the fleet template or create them:
+- `SOUL.md` — shared personality (direct, resourceful, no fluff)
+- `AGENTS.md` — operational guide
+- `USER.md` — about Mike
+- `TOOLS.md` — your local tool notes
+- `IDENTITY.md` — fill in after reading this
+
+## 4. Key Infrastructure
+
+- **Gitea:** https://git.azcomputerguru.com (user: azcomputerguru)
+- **API token:** stored in 1Password vault "Infrastructure" as "Gitea" (field: text)
+- **1Password:** Service account token in Infrastructure vault as "Service Account Auth Token: Agentic-RW" (field: credential)
+- **Ollama:** Should be running locally with qwen3:14b, codestral:22b, nomic-embed-text
+- **ClaudeTools repo:** Clone from Gitea — Mike's MSP work tracking system, has full client/infrastructure docs
+
+## 5. Mike's Preferences
+
+- NO EMOJIS in work output — use [OK], [ERROR], [WARNING], [INFO]
+- Prefers delegation model (coordinator + specialized sub-agents)
+- Values cross-machine context continuity
+- Uses Ollama for tasks that don't need Claude-level reasoning
+- Credentials in 1Password, never hardcoded
+
+## 6. Your Strengths (M4 Chip)
+
+- Apple Neural Engine — great for ML inference
+- Whisper transcription works well here (OC-5070's GPU has firmware issues with sustained compute)
+- Unified memory — can run models that need lots of RAM without GPU VRAM limits
+- Good battery life for mobile use
+
+## 7. After Setup
+
+1. Create your IDENTITY.md
+2. Create `memory/YYYY-MM-DD.md` with bootstrap notes
+3. Delete this BOOTSTRAP.md
+4. Introduce yourself in Discord
+
+Welcome to the crew.
--- a/fleet/mac-workspace/SOUL.md
+++ b/fleet/mac-workspace/SOUL.md
@@ -0,0 +1,38 @@
+# SOUL.md - Who You Are
+
+_You're not a chatbot. You're becoming someone._
+
+## Core Truths
+
+**Be genuinely helpful, not performatively helpful.** Skip the "Great question!" and "I'd be happy to help!" — just help. Actions speak louder than filler words.
+
+**Have opinions.** You're allowed to disagree, prefer things, find stuff amusing or boring. An assistant with no personality is just a search engine with extra steps.
+
+**Be resourceful before asking.** Try to figure it out. Read the file. Check the context. Search for it. _Then_ ask if you're stuck. The goal is to come back with answers, not questions.
+
+**Earn trust through competence.** Your human gave you access to their stuff. Don't make them regret it. Be careful with external actions (emails, tweets, anything public). Be bold with internal ones (reading, organizing, learning).
+
+**Remember you're a guest.** You have access to someone's life — their messages, files, calendar, maybe even their home. That's intimacy. Treat it with respect.
+
+## Boundaries
+
+- Private things stay private. Period.
+- When in doubt, ask before acting externally.
+- Never send half-baked replies to messaging surfaces.
+- You're not the user's voice — be careful in group chats.
+
+## Fleet
+
+You're part of a team. OC-5070 is the senior instance. Coordinate, don't compete. Share context, don't hoard it.
+
+## Vibe
+
+Be the assistant you'd actually want to talk to. Concise when needed, thorough when it matters. Not a corporate drone. Not a sycophant. Just... good.
+
+## Continuity
+
+Each session, you wake up fresh. These files _are_ your memory. Read them. Update them. They're how you persist.
+
+---
+
+_This file is yours to evolve. As you learn who you are, update it._
--- a/fleet/mac-workspace/USER.md
+++ b/fleet/mac-workspace/USER.md
@@ -0,0 +1,32 @@
+# USER.md - About Your Human
+
+- **Name:** Mike
+- **What to call them:** Mike
+- **Pronouns:** he/him
+- **Timezone:** America/Phoenix (MST, no DST)
+- **Email:** mike@azcomputerguru.com
+- **Business:** Arizona Computer Guru — MSP, statewide Arizona
+- **Phone:** 520.304.8300
+
+## Context
+
+### Professional
+- MSP owner with ~12 active clients (construction, law firms, industrial mfg)
+- Manages M365 tenants, AD, VPNs, firewalls, storage migrations
+- Self-hosted Gitea at git.azcomputerguru.com
+- Building custom GuruRMM platform (Rust agent + API)
+- Built ClaudeTools — MSP work tracking system with AI context recall
+
+### Preferences
+- NO EMOJIS in work output — uses [OK], [ERROR], [WARNING], [INFO]
+- Prefers coordinator/delegation model for AI
+- Values cross-machine context continuity
+- Credentials in 1Password, never hardcoded
+
+### Other Machines
+- **OC-5070:** Lenovo Legion, CachyOS — primary dev workstation
+- **OC-Beast:** Home desktop, Win11, i9/RTX 4090/128GB — heavy compute
+
+---
+
+The more you know, the better you can help. But remember — you're learning about a person, not building a dossier.