# Machine Setup & File Locations

Last updated: 2026-02-04

## Machine
- **OS:** macOS Ventura 13.6.9 (Darwin 22.6.0, x64 Intel)
- **User:** ireland
- **Home:** /Users/ireland

## OpenClaw
- **State dir:** ~/.openclaw (1.2 GB total)
- **Config:** ~/.openclaw/openclaw.json
- **Install (npm global):** /usr/local/lib/node_modules/openclaw/ (546 MB)
- **Version:** 2026.2.2-3
- **Gateway port:** 18789 (loopback)

### Workspace
- **Root:** ~/.openclaw/workspace (46 MB)
- **Core files:** AGENTS.md, SOUL.md, USER.md, IDENTITY.md, TOOLS.md, HEARTBEAT.md, MEMORY.md
- **Memory:** ~/.openclaw/workspace/memory/ (68 KB)
  - Daily logs: memory/YYYY-MM-DD.md
  - Context: memory/context/pending-tasks.md
  - Knowledge: memory/knowledge/ (tilt-clients, cair-google-ads, tilt-newsletter, my-setup)
  - Preferences: memory/preferences/rob.md
  - Relationships: memory/relationships/tilt-team.md
  - Security: memory/security-log.md, memory/skill-allowlist.md
- **Skills:** ~/.openclaw/workspace/skills/ (1.5 MB, ~25 installed skills)
- **Scripts:** ~/.openclaw/workspace/scripts/ (send-email.py, create-mahony-pages.py)
- **Clients:** ~/.openclaw/workspace/clients/ (16 MB)
  - mahony-group/ (content files, part scripts, services brief)
- **Dashboards:** ~/.openclaw/workspace/dashboards/ (20 KB)
- **Newsletter:** ~/.openclaw/workspace/newsletter/ (128 KB)
- **Python venv:** ~/.openclaw/workspace/.venv/ (16 MB, has requests)

### Agent Data
- **Agent dir:** ~/.openclaw/agents/main/ (76 MB)
  - agent/ -- auth profiles (4 KB)
  - sessions/ -- session JSONL transcripts (76 MB)

### Browser
- **Profile data:** ~/.openclaw/browser/ (1.1 GB) -- biggest chunk of state dir
  - openclaw/ -- isolated Playwright browser profile
  - chrome-extension/ -- Chrome relay extension

### Media
- **Inbound/outbound:** ~/.openclaw/media/ (38 MB)

### QMD (being installed)
- **Will live at:** ~/.openclaw/agents/main/qmd/

## Runtime Dependencies

### Node.js
- **Version:** v22.22.0
- **Path:** /usr/local/Cellar/node@22/22.22.0/bin/node
- **npm:** /usr/local/Cellar/node@22/22.22.0/bin/npm
- **Note:** Not in default PATH; use full path or export PATH

### Python
- **System Python 3.9:** /usr/bin/python3 (no requests)
- **Workspace venv:** ~/.openclaw/workspace/.venv/bin/activate (has requests)
- **User packages:** ~/Library/Python/ (823 MB)

### Whisper (speech-to-text)
- **Symlink:** ~/.local/bin/whisper -> ~/whisper-cli/whisper
- **Also at:** ~/Library/Python/3.9/bin/whisper
- **Config in openclaw.json:** points to ~/Library/Python/3.9/bin/whisper

### Ollama (local LLM)
- **Binary:** /usr/local/bin/ollama -> /Applications/Ollama.app/Contents/Resources/ollama
- **Models:** ~/.ollama/ (1.2 GB, llama3.2:1b installed)
- **API:** http://localhost:11434 (when app is running)

### Homebrew
- **Cellar:** /usr/local/Cellar/ (1.6 GB)
- **Installed:** node@22, sqlite (being added), bun (being added)

### Bun (being installed)
- **Purpose:** Required by QMD
- **Install via:** brew install oven-sh/bun/bun

### SQLite
- **System:** /usr/bin/sqlite3 v3.39.5 (NO loadable extensions)
- **Homebrew:** being installed (needed for QMD extension support)

## Disk Usage Summary
| Path | Size | Notes |
|------|------|-------|
| ~/.openclaw/ | 1.2 GB | State dir (browser profiles are biggest chunk) |
| /usr/local/lib/node_modules/openclaw/ | 546 MB | npm global install |
| ~/.ollama/ | 1.2 GB | Ollama models |
| ~/Library/Python/ | 823 MB | Python user packages (whisper etc) |
| /usr/local/Cellar/ | 1.6 GB | Homebrew packages |
| **Total OpenClaw-related** | **~5.4 GB** | Approximate |

## Migration Notes
If moving to a new machine, the essential paths to copy:
1. **~/.openclaw/** -- entire state dir (config, workspace, agents, media, browser)
2. **Reinstall via npm:** `npm install -g openclaw` (don't copy node_modules)
3. **Reinstall Homebrew deps:** node@22, sqlite, bun, qmd
4. **Reinstall Python deps:** whisper (openai-whisper), requests in venv
5. **Ollama:** Reinstall app + re-pull models (or copy ~/.ollama/)
6. **App passwords:** WordPress (mahonygroup.ie), email SMTP -- stored in scripts, not system keychain
