trecio

Trecio Platform Setup Guide

This guide walks through setting up Trecio on a fresh Mac Mini (or macOS machine).

Prerequisites

Step 1: Install OpenClaw

brew install openclaw

Verify installation:

openclaw --version
openclaw gateway status

Step 2: Set Up Anthropic API Key

export ANTHROPIC_API_KEY=sk-ant-...
echo "export ANTHROPIC_API_KEY=sk-ant-..." >> ~/.zshrc

Verify:

openclaw models

Should show at least one configured model.

Step 3: Clone or Create Trecio Repository

cd ~/Workspace
git clone https://github.com/{org}/trecio.git
cd trecio

Or initialize fresh:

mkdir -p ~/Workspace/trecio
cd ~/Workspace/trecio
git init

Step 4: Set Up OpenClaw Workspace

# Create OpenClaw workspace if fresh machine
mkdir -p ~/.openclaw/workspace
cd ~/.openclaw/workspace

# Copy project context files (if cloning from repo)
cp ~/Workspace/trecio/trecio.md .

# Create bootstrap files (only needed on fresh setup)
# See BOOTSTRAP.md template in OpenClaw docs

Step 5: Configure Models (Optional)

Edit ~/.openclaw/openclaw.json:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-haiku-4-5"
      },
      "models": {
        "anthropic/claude-haiku-4-5": { "alias": "haiku" },
        "anthropic/claude-sonnet-4-6": { "alias": "sonnet" },
        "anthropic/claude-opus-4-7": { "alias": "opus" }
      }
    }
  }
}

Create Slack App

  1. Go to https://api.slack.com/apps → Create New App → From a manifest
  2. Select your workspace
  3. Paste manifest from trecio/core/slack_manifest.json
  4. Generate tokens:
    • App-Level Token (xapp-...) with scope connections:write
    • Bot Token (xoxb-...)

Configure OpenClaw

# Add to ~/.zshrc
export SLACK_BOT_TOKEN=xoxb-...
export SLACK_APP_TOKEN=xapp-...

# Source and verify
source ~/.zshrc
printenv | grep SLACK

Update OpenClaw Config

openclaw config patch --raw '{
  "channels": {
    "slack": {
      "enabled": true,
      "mode": "socket",
      "botToken": "env:SLACK_BOT_TOKEN",
      "appToken": "env:SLACK_APP_TOKEN",
      "groupPolicy": "open",
      "allowFrom": ["*"]
    }
  }
}'

openclaw gateway restart

Create Slack Channels

# Use the Slack web UI or API to create:
# - #core (platform coordination)
# - #dev (Marcus's agent work)
# - #social (Nina's agent work)
# - #general (team chat)

Step 7: Start the Gateway

openclaw gateway start
# or
openclaw gateway

Verify connectivity:

curl http://127.0.0.1:18789/

Step 8: Initialize Git & Push

cd ~/Workspace/trecio

git config user.name "Your Name"
git config user.email "your@email.com"

git add .
git commit -m "Initial Trecio platform setup"

# Add remote (if not already done)
git remote add origin https://github.com/{org}/trecio.git

# Push
git branch -M main
git push -u origin main

Step 9: Verify Trecio is Running

# Check gateway
openclaw gateway status

# Try messaging Cleo in Slack (if configured)
# @Cleo status

# Or in terminal
openclaw /btw "what's the status of the Trecio platform?"

Troubleshooting

OpenClaw won’t start

openclaw gateway restart
# Check logs
tail -f /tmp/openclaw/openclaw-*.log

Slack not responding

# Check token env vars
printenv | grep SLACK

# Verify Socket Mode in logs
grep -i "socket\|slack" /tmp/openclaw/openclaw-*.log

# Verify event subscriptions in Slack app settings

Models not available

openclaw models
# Should list haiku, sonnet, opus
# If not, check ANTHROPIC_API_KEY

Next Steps

  1. Customize platform context in trecio.md
  2. Define agent-specific prompts in agents/{name}/
  3. Set up CI/CD in .github/workflows/ (optional)
  4. Begin building first agent (dev or ops)
  5. Invite team members to Slack workspace

File Structure

trecio/
├── core/                # Platform config, manifests
│   ├── slack_manifest.json
│   └── ...
├── agents/              # Agent definitions
│   ├── core/
│   ├── dev/
│   ├── ops/
│   └── social/
├── docs/                # Documentation + team info
│   ├── AGENTS.md
│   ├── SETUP.md
│   ├── team/
│   │   ├── marcus.md
│   │   └── nina.md
│   └── ...
├── projects/            # Work outputs: repos, code, content
├── infra/               # Scripts, configs, deployment
└── scratch/             # Temp files, safe to delete

Support

For issues or questions: