← 返回 Skills 市场

Discord Server Admin

Name: Discord Server Admin
Author: datarxdacted

作者 DataRxdacted · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ✓ 安全检测通过

总下载

当前安装

版本数

在 OpenClaw 中安装

/install discord-server-admin

功能描述

Manage Discord servers with a narrow, medium-risk scope using direct Bot API calls. Use when creating, renaming, moving, or deleting channels/categories; cre...

使用说明 (SKILL.md)

Discord Server Admin

Use this skill for focused Discord server administration with explicit IDs and limited write scope.

Scope

Supported operations:

List channels and roles
Create, edit, and delete channels/categories
Create, edit, delete, and reorder roles
Assign and remove roles for members

Out of scope:

Bans, kicks, timeouts, or other moderation actions
Webhooks, invites, automod, templates, events, or guild settings
Bulk/mass operations
Fuzzy matching by names when exact IDs are available

Quick start

Use scripts/discord-server-admin.sh.

Examples:

export DISCORD_BOT_TOKEN="..."

# Inspect current layout
./scripts/discord-server-admin.sh channel-list \x3Cguild_id>
./scripts/discord-server-admin.sh role-list \x3Cguild_id>

# Create a category and a text channel under it
./scripts/discord-server-admin.sh channel-create \x3Cguild_id> "CLAN HQ" --type category
./scripts/discord-server-admin.sh channel-create \x3Cguild_id> clan-chat --type text --parent-id \x3Ccategory_id> --topic "Main clan chat"

# Create or update a role
./scripts/discord-server-admin.sh role-create \x3Cguild_id> Member --color 3498DB --permissions 0 --mentionable false --hoist false
./scripts/discord-server-admin.sh role-edit \x3Cguild_id> \x3Crole_id> --color 2ECC71

# Assign/remove a role
./scripts/discord-server-admin.sh member-role-add \x3Cguild_id> \x3Crole_id> \x3Cuser_id>
./scripts/discord-server-admin.sh member-role-remove \x3Cguild_id> \x3Crole_id> \x3Cuser_id>

Workflow

Start with channel-list or role-list.
Confirm exact guild/channel/role/user IDs before writes.
Apply one targeted change at a time.
If Discord returns 403, check bot permissions and role hierarchy.
If a role sits above the bot role, reorder roles in Discord before retrying assignments or edits.

Safety rules

Treat this as a medium-risk skill because it uses a bot token and can modify server structure.
Keep the bot token in DISCORD_BOT_TOKEN; do not hardcode secrets into files.
Prefer least privilege over Administrator when practical.
Avoid destructive actions unless the user clearly asked for them.
Do not add mass-delete or bulk moderation features to this skill.
Use exact IDs for write actions to avoid touching the wrong server object.

Limitations

Discord role hierarchy still applies even when the bot has strong permissions.
role-position only moves the role you specify; it is not a full reorder planner.
channel-create supports text, voice, and category only.
Permissions must be provided as Discord integer bitfields, not named permission strings.

Resource

scripts/discord-server-admin.sh — direct HTTPS helper for channels, roles, and member role assignment.

安全使用建议

This tool is coherent with its description, but it can perform destructive actions (delete channels/roles). Only provide a bot token with the minimum permissions needed (avoid Administrator), use a dedicated bot account, and audit or rotate the token if you stop using the skill. Review and run the script in a safe environment (or a test server) first to confirm behavior. If you want to allow autonomous agent actions, ensure the agent is configured to ask for confirmation before performing writes to production servers.

功能分析

Type: OpenClaw Skill Name: discord-server-admin Version: 1.0.0 The discord-server-admin skill is a legitimate tool for managing Discord server resources via the official API. The shell script (scripts/discord-server-admin.sh) uses best practices such as environment variables for secrets, rate-limit handling, and Python-based JSON construction to avoid shell injection vulnerabilities. The SKILL.md documentation clearly defines a limited scope and provides safety guidelines for the AI agent.

能力评估

✓ Purpose & Capability

Name/description, SKILL.md, and the shipped script all align: the tool lists/edits channels and roles and assigns/removes roles via Discord Bot API. No unrelated services, credentials, or binaries are requested.

✓ Instruction Scope

SKILL.md and the script limit actions to channels, roles, and member role assignment and explicitly exclude bans/kicks/webhooks/bulk actions. The runtime instructions only reference Discord API endpoints and local tools (curl, python3).

✓ Install Mechanism

No install spec; the skill is instruction-only with a single helper script. Nothing is downloaded from external URLs or written to system locations by an installer.

✓ Credentials

The only secret required is a Discord bot token (DISCORD_BOT_TOKEN or --token). That is appropriate and proportional for a bot that performs writes to a guild via Discord's API.

✓ Persistence & Privilege

always is false and the skill does not attempt to modify other skills or system-wide configs. It can be invoked autonomously by the agent (platform default), which is expected for skills.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install discord-server-admin
安装完成后，直接呼叫该 Skill 的名称或使用 /discord-server-admin 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

Manage Discord servers with a narrow, honest scope: list/create/edit/delete channels and categories, manage roles, reorder roles, and assign or remove member roles. Built for direct Bot API use with explicit IDs and without moderation-suite features like bans, kicks, automod, webhooks, invites, or mass actions.

元数据

Slug discord-server-admin

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题