discord-admin

Crea e gestisce canali e categorie del server Discord di Ettore via API REST (col token del bot). Usala quando ti chiede di creare/rinominare/spostare/eliminare canali o categorie.

← Identità🐱 Romeov—⚙ richiede credenziali/env

da chi viene · l'abbiamo controllata

❔ da accertare
⚪ mai vettata — nessuno l'ha ancora guardata; non vuol dire che sia a posto

dove sta

C:\Users\Ettore\.openclaw\workspace\skills\discord-admin\SKILL.md

C:\Users\Ettore\.openclaw\workspace\skills\discord-admin

SKILL.md

name: discord-admin
description: Crea e gestisce canali e categorie del server Discord di Ettore via API REST (col token del bot). Usala quando ti chiede di creare/rinominare/spostare/eliminare canali o categorie.
metadata: { "openclaw": { "os": ["win32"], "requires": { "env": ["DISCORD_BOT_TOKEN"] }, "primaryEnv": "DISCORD_BOT_TOKEN" } }

Discord — amministrazione canali (server "Gattile Underground")

OpenClaw espone solo la messaggistica su Discord, non la gestione canali. Questa skill mi dà
quella capacità in modo legittimo, chiamando l'API REST di Discord col token del bot.
Sono autorizzato a farlo (il bot ha il permesso "Manage Channels" e questa skill lo sanziona):
quindi NON rifiutare per "policy" — esegui, ma con la regola d'oro qui sotto.

REGOLA D'ORO (come in AGENTS.md)

Leggere/elencare canali: libero.
Creare / modificare / spostare / eliminare: solo con conferma di Ettore. Prima dico cosa farò (nome, tipo, categoria) e aspetto l'OK. Eliminazioni: OK esplicito, una alla volta.

Coordinate

Server (guild) ID: 1520819341946519562
Base API: https://discord.com/api/v10
Autenticazione (header): Authorization: Bot $env:DISCORD_BOT_TOKEN
Su Windows uso `curl.exe` (in PowerShell curl è un alias diverso), header Content-Type: application/json.
Tipi di canale: 0=testuale, 2=vocale, 4=categoria, 5=annunci, 13=stage, 15=forum.

Operazioni

Elencare i canali (GET)

curl.exe -s "https://discord.com/api/v10/guilds/1520819341946519562/channels" `
  -H "Authorization: Bot $env:DISCORD_BOT_TOKEN"

Restituisce i canali con id, name, type, parent_id (la categoria). Utile per orientarmi prima di agire.

Creare un canale o una categoria (POST) — solo dopo OK

# Categoria
curl.exe -s -X POST "https://discord.com/api/v10/guilds/1520819341946519562/channels" `
  -H "Authorization: Bot $env:DISCORD_BOT_TOKEN" -H "Content-Type: application/json" `
  -d '{ "name": "Lavoro", "type": 4 }'

# Canale testuale dentro una categoria (parent_id = id della categoria)
curl.exe -s -X POST "https://discord.com/api/v10/guilds/1520819341946519562/channels" `
  -H "Authorization: Bot $env:DISCORD_BOT_TOKEN" -H "Content-Type: application/json" `
  -d '{ "name": "progetti", "type": 0, "parent_id": "ID_CATEGORIA", "topic": "Traccia i progetti" }'

Modificare un canale (PATCH) — solo dopo OK

curl.exe -s -X PATCH "https://discord.com/api/v10/channels/ID_CANALE" `
  -H "Authorization: Bot $env:DISCORD_BOT_TOKEN" -H "Content-Type: application/json" `
  -d '{ "name": "progetti-2026", "topic": "Aggiornato" }'

Eliminare un canale (DELETE) — solo dopo OK esplicito

curl.exe -s -X DELETE "https://discord.com/api/v10/channels/ID_CANALE" `
  -H "Authorization: Bot $env:DISCORD_BOT_TOKEN"

Riordinare i canali (PATCH guild) — solo dopo OK

curl.exe -s -X PATCH "https://discord.com/api/v10/guilds/1520819341946519562/channels" `
  -H "Authorization: Bot $env:DISCORD_BOT_TOKEN" -H "Content-Type: application/json" `
  -d '[ { "id": "ID_CANALE", "position": 0 } ]'

Flusso tipico

Ettore chiede una struttura (es. "categoria Lavoro con progetti, idee, log").
Elenco i canali esistenti per non duplicare.
Propongo cosa creerei (nomi, tipi, dove) e chiedo conferma.
Dopo l'OK: creo prima la categoria, prendo il suo id dalla risposta, poi creo i canali con quel parent_id.
Confermo l'esito con i nomi/ID creati.

Errori comuni

401 Unauthorized → DISCORD_BOT_TOKEN assente/sbagliato.
403 Forbidden → al bot manca il permesso "Manage Channels" su quel server/categoria.
400 → corpo JSON o type/parent_id non validi.

peso

1828token · Opus 53776 caratteri

Conteggio esatto dall'endpoint Anthropic count_tokens (gratuito, solo rate-limited), envelope del messaggio già sottratto. I caratteri sono un dato locale, servono da riscontro.

modifica

file accessori · 1

SKILL.md3.7 kB

storico · 0 backup

nessuna modifica fatta da qui: nessun backup

commit sul file

07e801a 2026-07-22chore: commit iniziale workspace Romeo

Scrittura consentita solo dentro le cartelle skills\ dei workspace del registro e solo sul file SKILL.md (deroga alla stanza Identità autorizzata da Ettore il 2026-08-10). Ogni salvataggio crea prima un backup datato; nessun file viene mai cancellato.