Checklist Nuovo Agente - Family Office

1. Creare il Workspace

mkdir -p workspace-{agent_id}

Copiare i file base: AGENTS.md, SOUL.md, USER.md, TOOLS.md

2. Creare Email (Google Workspace)

• Email: {nome}@team.lorenzopinto.it
• Aggiungere a Google Admin

3. Creare App Slack

1. Vai su https://api.slack.com/apps
2. Create New App → From Manifest
3. Usa questo manifest (sostituisci {NAME} e {name}):

{
  "display_information": {
    "name": "{NAME} - OpenClaw",
    "description": "{NAME} AI Agent"
  },
  "features": {
    "bot_user": {
      "display_name": "{NAME} - OpenClaw",
      "always_online": false
    },
    "app_home": {
      "home_tab_enabled": false,
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    }
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "channels:history",
        "channels:read",
        "chat:write",
        "im:history",
        "im:read",
        "im:write",
        "users:read"
      ]
    }
  },
  "settings": {
    "event_subscriptions": {
      "bot_events": ["app_mention", "message.im"]
    },
    "interactivity": {
      "is_enabled": false
    },
    "org_deploy_enabled": false,
    "socket_mode_enabled": true,
    "token_rotation_enabled": false
  }
}

4. ⚠️ IMPORTANTE - App Home Settings:

   • Vai su Features → App Home
   • Sezione "Show Tabs" → Messages Tab
   • ✅ Spunta "Allow users to send Slash commands and messages from the messages tab"
   • Senza questo checkbox, gli utenti NON possono scrivere all'agente!

5. Socket Mode:

   • Vai su Settings → Socket Mode
   • Abilita Socket Mode
   • Genera App-Level Token con scope connections:write

6. Install App:

   • Vai su Install App
   • Install to Workspace
   • Copia il Bot User OAuth Token (xoxb-...)

4. Salvare Credenziali

Aggiungere a CREDENTIALS.md:

### {NAME} - OpenClaw (Slack App)
- App ID: A0XX...
- App Token: xapp-1-...
- Bot Token: xoxb-...

5. Configurare OpenClaw

In openclaw.json:

Aggiungere account Slack:

"channels": {
  "slack": {
    "accounts": {
      "{agent_id}": {
        "appToken": "xapp-1-...",
        "botToken": "xoxb-..."
      }
    }
  }
}

Aggiungere binding:

"bindings": [
  {
    "match": { "channel": "slack", "accountId": "{agent_id}" },
    "agentId": "{agent_id}"
  }
]

Aggiungere agente:

"agents": {
  "{agent_id}": {
    "systemPromptPath": "workspace-{agent_id}/SYSTEM.md",
    "model": "sonnet"
  }
}

6. Riavviare Gateway

openclaw gateway restart

7. Test

• Apri Slack
• Trova l'app "{NAME} - OpenClaw" sotto Apps
• Manda un DM
• Verifica che l'agente risponda

---

Checklist Rapida

• [ ] Workspace creato
• [ ] Email creata
• [ ] App Slack creata con manifest
• [ ] Messages Tab: "Allow users to send messages" ABILITATO ⚠️
• [ ] Socket Mode abilitato
• [ ] App installata nel workspace
• [ ] Credenziali salvate in CREDENTIALS.md
• [ ] Account Slack aggiunto in openclaw.json
• [ ] Binding configurato in openclaw.json
• [ ] Agente configurato in openclaw.json
• [ ] Gateway riavviato
• [ ] Test DM funzionante