sync-discord-identity
Sync a Discord bot profile into an OpenClaw agent IDENTITY.md, save the avatar under workspace/avatars, and safely add Avatar and Discord metadata.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/0xli/sync-discord-identityOpenClaw Skill (Identity • Discord bot profile sync • Avatar bootstrap)
Use this skill when you need to inspect or update an OpenClaw agent identity for the current workspace, especially when that workspace is connected to a Discord bot and you want to synchronize Discord profile data into IDENTITY.md.
Scope
This skill is for:
- reading or updating
IDENTITY.md - reading the Discord channel config from the current workspace
openclaw.json - bootstrapping
**Avatar:**from the Discord bot profile - saving a local copy of the Discord avatar under
workspace/avatars/ - writing a
**Discord:**metadata section intoIDENTITY.md - preserving existing identity content unless a specific field should be added or changed
This skill is not for changing the Discord bot account itself. It only reads bot metadata from the Discord API and reflects it into OpenClaw identity files.
Behavior rules
When using this skill, follow these rules:
-
Operate on the current workspace only. Read
openclaw.jsonfrom the workspace where the skill is installed or where the user explicitly points you. -
Use the correct Discord config for this workspace. Read the Discord channel token from this workspace's
openclaw.json, not from another agent or workspace. -
If multiple Discord channels exist in the same workspace, do not guess silently. Prefer the single enabled Discord channel. If there are multiple candidates, ask the user which channel to use, or require an explicit channel name.
-
Do not assume OpenClaw auto-imports the Discord avatar. If
IDENTITY.mdhas no**Avatar:**, populate it explicitly. -
Prefer a static CDN avatar URL for
**Avatar:**. Use the non-animated static Discord CDN URL:https://cdn.discordapp.com/avatars/<BOT_ID>/<AVATAR_HASH>.png -
Also save a local copy under the workspace. Save the image as:
workspace/avatars/discord-<discord-username-or-bot-id>.png -
If
**Avatar:**is missing, set it. Default behavior: write the static Discord CDN URL into**Avatar:**. -
If
**Avatar:**already exists and differs, do not silently overwrite it. Ask the user whether they want to replace the existing avatar value. -
Add
**Discord:**if Discord metadata is available. Save only non-empty fields among:- username
- locale
- bio
-
Do not write empty Discord fields. For example, omit
emailif it isnull, and omitbioif it is empty. -
Preserve all unrelated identity fields. Only make local, minimal edits.
-
If a token appears in conversation or files, treat it as sensitive. Do not echo it. Recommend rotation if it has been exposed.
Expected inputs
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-0xli-sync-discord-identity": {
"enabled": true,
"auto_update": true
}
}
}