Skip to content

Add infrastructure documentation (INFRASTRUCTURE.md) #254

Description

@evansenter

Problem

The current setup for mac-mini involves multiple services (agent-event-bus, agent-session-analytics, agent-memory-store, OpenClaw gateway) that aren't documented in one place. Recreating the server requires tribal knowledge.

Proposal

Add docs/INFRASTRUCTURE.md documenting:

What runs where

  • mac-mini (server): agent-event-bus (:8080), agent-session-analytics (:8081), agent-memory-store (:8083), OpenClaw gateway (:18789)
  • Client machines: Connect via Tailscale URLs

Tailscale serve configuration

tailscale serve --bg --set-path /agent-event-bus http://127.0.0.1:8080
tailscale serve --bg --set-path /agent-session-analytics http://127.0.0.1:8081
tailscale serve --bg --set-path /agent-memory-store http://127.0.0.1:8083
tailscale serve --bg / http://127.0.0.1:18789

Server bootstrap steps

  1. Clone + make install-server for each service
  2. Configure tailscale serve paths
  3. Verify LaunchAgents running

LaunchAgent plists

Located in ~/Library/LaunchAgents/:

  • com.evansenter.agent-event-bus
  • com.evansenter.agent-session-analytics
  • com.evansenter.agent-memory-store
  • OpenClaw managed by its own installer

Client setup

  • Already covered in CLAUDE.md for OpenClaw
  • bootstrap.sh configures settings.local.json with remote MCP URLs for non-gateway hosts

Context

Discovered this gap when reviewing infrastructure setup. Currently the only docs are scattered across individual project READMEs and brief mentions in CLAUDE.md.

Related

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions