Agent Onboarding Checklist

Guida completa per aggiungere un nuovo membro al Family Office AI Team.

---

1. Workspace Setup

1.1 Creare Directory

mkdir -p ~/.openclaw/workspace-{agent}

1.2 Creare File Base

Copiare e personalizzare:

• SOUL.md - Personalità e ruolo dell'agente
• AGENTS.md - Regole operative (copiare da template)
• USER.md - Info su Lorenzo (copiare da main workspace)

---

2. Gateway Config

2.1 Aggiungere Agente

In ~/.openclaw/openclaw.json sotto "agents":

"{agent}": {
  "model": "anthropic/claude-sonnet-4-5",
  "thinking": "low",
  "workspace": "~/.openclaw/workspace-{agent}"
}

2.2 Abilitare Agent-to-Agent

Assicurarsi che "agentToAgent": true sia presente nella config.

---

3. Email Setup (Zoho Mail)

3.1 Creare Account

1. Accedere a Zoho Mail Admin
2. Users → Add User
3. Email: {agent}@team.lorenzopinto.it
4. Password: generare password sicura

3.2 Salvare Credenziali

Aggiungere in CREDENTIALS.md:

### {Agent} Email
- Email: {agent}@team.lorenzopinto.it
- Password: {password}

⚠️ Limite Zoho Free: 5 utenti max

---

4. Slack Setup

4.1 Creare Slack App

1. Vai su api.slack.com/apps
2. Create New App → From scratch
3. Nome: {Agent} - OpenClaw
4. Workspace: Lorenzo Pinto

4.2 Configurare OAuth Scopes

In OAuth & Permissions → Bot Token Scopes, aggiungere:

• app_mentions:read
• channels:history
• channels:read
• chat:write
• im:history
• im:read
• im:write
• users:read

4.3 Abilitare Socket Mode

1. Socket Mode → Enable
2. Generare App-Level Token con scope connections:write
3. Salvare il token xapp-...

4.4 Configurare Eventi

In Event Subscriptions → Enable Events → Subscribe to bot events:

• app_mention
• message.im

4.5 Installare App

1. Install App → Install to Workspace
2. Autorizzare
3. Copiare Bot User OAuth Token (xoxb-...)

4.6 Salvare Token

In CREDENTIALS.md:

### {Agent} Slack App
- App ID: {app_id}
- Bot Token: xoxb-...
- App Token: xapp-...

---

5. OpenClaw Slack Config

5.1 Aggiungere Config

Aggiornare ~/.openclaw/openclaw.json:

"slack": {
  "agents": {
    "{agent}": {
      "botToken": "xoxb-...",
      "appToken": "xapp-..."
    }
  }
}

5.2 Restart Gateway

openclaw gateway restart

---

6. Invitare a Slack Workspace

Se l'agente deve apparire come utente separato:

1. Invitare email {agent}@team.lorenzopinto.it al workspace
2. Accettare invito da Zoho Mail
3. Completare profilo Slack

---

7. Test Finale

7.1 Test DM

Mandare DM all'agente su Slack e verificare risposta.

7.2 Test Inter-Agent

Da Asia: sessions_send verso il nuovo agente.

7.3 Test Menzioni

Menzionare @{Agent} in un canale.

---

Quick Reference - Agenti Attuali

| Agent | Email | Slack App ID | Status | |-------|-------|--------------|--------| | Asia | [email protected] | A0AG3LQ0CQN | ✅ Completo | | Homer | [email protected] | A0AG587L4F8 | 🔄 Socket Mode ✅, Scopes/Install ⏳ | | Frank | [email protected] | ⏳ | Da creare | | Marco | [email protected] | ⏳ | Da creare | | Paolo | [email protected] | ⏳ | Da creare |

Scopes Necessari (Bot Token)

app_mentions:read
channels:history
channels:read
chat:write
im:history
im:read
im:write
users:read

Eventi Bot Necessari

app_mention
message.im

---

Note

• Zoho Mail Free: Max 5 utenti (tutti usati)
• Slack Free: Nessun limite app, ma 90 giorni retention messaggi
• Model default: Sonnet per team, Opus per Asia
• Socket Mode: Preferito vs webhooks (no server pubblico)

---

Ultimo aggiornamento: 2026-02-20