Alpaclaw Architecture — Alpaca Playhouse

Agent Name

Alpaclaw

Operations orchestrator for property management

Server

Hostinger KVM 4

4 vCPU · 16 GB RAM · 200 GB NVMe

OpenClaw Version

2026.2.23

Gateway on port 43414

Primary Model

Gemini 2.5 Flash

With Pro fallback for complex reasoning

1 System Architecture

Alpaclaw runs as a Docker container on the Hostinger VPS, connected to messaging platforms and the AlpacApps backend.

Hostinger KVM 4 VPS 93.188.164.224 · Ubuntu 24.04 + Docker WhatsApp ────┐ ┌──────────────────────────────────────┐ Telegram ────┤ │ OpenClaw Gateway (Docker) │ Discord ────┼───>│ "Alpaclaw" 🦙 │ Web Chat ────┘ │ SOUL.md · USER.md · AGENTS.md │ │ Skills · Memory · Cron · Canvas │ └──────────┬──────────────┬────────────┘ │ │ ┌────────────────┘ └─────────────────┐ ▼ ▼ ┌─────────────────┐ ┌──────────────────┐ │ Supabase │ │ LLM Providers │ │ PostgreSQL │ │ Gemini 2.5 Flash│ │ Edge Functions│ │ Gemini 2.5 Pro │ │ Storage │ │ nexos.ai (soon) │ └─────────────────┘ └──────────────────┘

2 Infrastructure

Component	Details
Host	Hostinger KVM 4 VPS
IP Address	`93.188.164.224`
Hostname	`srv1433869.hstgr.cloud`
OS	Ubuntu 24.04 LTS + Docker
Resources	4 vCPU · 16 GB RAM · 200 GB NVMe · 16 TB bandwidth
Container Image	`ghcr.io/hostinger/hvps-openclaw:latest`
OpenClaw Version	`2026.2.23`
Gateway Port	`43414` (TCP)
Data Volume	`/docker/openclaw-vnfd/data/`
Cost	~$9.99/mo (Hostinger KVM 4 intro rate)

3 Messaging Channels

Alpaclaw connects to residents and operators through multiple messaging platforms simultaneously.

Channel	Status	Configuration
WhatsApp	Active	Allowlist mode, number: `424-234-1750`
Telegram	Pending	Pairing DM policy — awaiting bot token from @BotFather
Discord	Pending	Will share PAI bot token initially, split later
Slack	Unconfigured	Available but not yet connected
Google Chat	Unconfigured	Available but not yet connected

4 Multi-Agent Hierarchy

Alpaclaw delegates complex tasks to specialized sub-agents, each with their own model and scope.

Alpaclaw (CEO / Orchestrator) │ Model: Gemini 2.5 Flash │ Role: Property management, resident comms, smart home │ ├── Research Sub-Agent │ Model: Gemini 2.5 Pro │ Role: Deep analysis, market research, complex reasoning │ Scope: Read-only, no external actions │ ├── Automation Sub-Agent │ Model: Gemini 2.5 Flash Lite │ Role: Batch processing, status checks, monitoring │ Scope: Pre-approved automation patterns only │ └── [Future] Smart Home Agent Model: Flash Role: Direct IoT device control Scope: Sonos, Govee, Nest, Tesla commands

5 Model Routing & Cost Optimization

Tasks are routed to the cheapest capable model, saving 80%+ on token costs.

Task Type	Model	Cost (per 1M tokens)
Orchestration (routing, delegation)	Gemini 2.5 Flash	$0.15 / $3.50
Simple tasks (status, formatting)	Gemini 2.5 Flash Lite	Cheapest tier
Complex reasoning (analysis, strategy)	Gemini 2.5 Pro	$1.25 / $10.00
Image generation	Gemini 2.5 Flash Image	~$0.039/image

Cost Strategy: Route 80%+ of requests through Flash/Lite. Reserve Pro for explicit complex reasoning. Cache data in workspace memory files. Batch API calls. Use one-topic sessions to avoid context bloat.

6 Security

Layer	Protection
Hostinger Firewall	API-managed (ID: `221167`). Ports 22, 80, 443, 43414 only.
UFW	Default deny incoming, allow outgoing. Same port whitelist.
fail2ban	SSHD jail: 3 max retries, 2-hour ban. Already catching attackers.
Gateway Auth	Token-based (`OPENCLAW_GATEWAY_TOKEN`)
Docker Isolation	Container runs as `node` user (uid 1000)

7 AlpacApps Ecosystem

Alpaclaw is one of several AI systems in the AlpacApps infrastructure, each with a distinct role.

System	Host	Role
Alpaclaw	Hostinger VPS	Operations orchestrator (messaging, automation, multi-agent)
PAI (Edge Function)	Supabase	Resident-facing AI assistant (chat, voice, smart home)
PAI Discord Bot	Oracle Cloud	Discord ↔ PAI bridge
Bug Scout	Oracle Cloud	Automated bug detection and fixing
Feature Builder	Oracle Cloud	Automated feature implementation from PAI requests
Tesla Poller	Oracle Cloud	Vehicle data polling (6 Teslas)
LG Poller	Oracle Cloud	Washer/dryer status monitoring
Image Gen Worker	Oracle Cloud	Gemini-powered image generation

8 Workspace Configuration

File	Purpose
`SOUL.md`	Agent personality, mission, boundaries, operational context, token economy
`USER.md`	User profile (Rahulio — owner, timezone, preferences)
`IDENTITY.md`	Agent identity: Alpaclaw, alpaca, warm & proactive
`AGENTS.md`	Multi-agent hierarchy definitions and routing
`HEARTBEAT.md`	Periodic tasks: 9 AM checks, 6 PM summary, Monday report
`MEMORY.md`	Persistent memory across sessions
`TOOLS.md`	Available tool documentation and examples

9 Administration

Quick Reference: SSH to root@93.188.164.224. Docker logs: docker logs openclaw-vnfd-openclaw-1 --tail 100 -f. Restart: docker restart openclaw-vnfd-openclaw-1. Config: /docker/openclaw-vnfd/data/.openclaw/openclaw.json.

10 Roadmap

Enhancement	Priority	Description
HTTPS / TLS	High	Caddy reverse proxy for secure gateway access
Tailscale VPN	High	Mesh VPN to link Hostinger ↔ Alpaca Mac
nexos.ai Credits	Medium	Hostinger LLM credits for multi-provider routing
Supabase Integration	Medium	Direct database access for operational queries
Smart Home Skills	Medium	Custom ClawHub skills for Sonos, Govee, Nest, Tesla
Monitoring Dashboard	Low	Token usage, cost tracking, session analytics
Automatic Backups	Low	Hostinger weekly backup schedule