Discord Output Metrics Footer

---

name: discord-output-metrics-footer description: Install, configure, maintain, or troubleshoot a compact Discord output footer for OpenClaw that shows live context usage, output tokens, Codex quota remaining, model used, and optional subagent token aggregate under each Discord response.

---

Discord Output Metrics Footer

Use this skill when an OpenClaw workspace should show compact runtime metrics under Discord outputs.

Default footer:

_🟢 ↑54k ↓157 · 21%ctx · 5h 89% · kimi-k2.6:cloud_

With subagent aggregate:

_🟢 ↑54k ↓157 · 21%ctx · 5h 89% · openai-codex/gpt-5.5 · sub ↑31k ↓4k_

What it does

Adds a Discord delivery-time footer using OpenClaw plugin hooks.

Uses llm_output for actual model/token metrics.

Uses message_sending to append the footer without adding prompt tokens.

Uses live/cached OpenAI Codex OAuth usage for 5h 89%.

Uses color status from context usage and quota remaining.

Optionally aggregates nearby subagent LLM usage.

Install into an OpenClaw workspace

Copy the bundled extension template:

mkdir -p ~/.openclaw/extensions/discord-output-metrics-footer
cp -R assets/extension-template/* ~/.openclaw/extensions/discord-output-metrics-footer/

Add this plugin config to ~/.openclaw/openclaw.json:

{
  "plugins": {
    "allow": ["discord-output-metrics-footer"],
    "load": {
      "paths": ["~/.openclaw/extensions/discord-output-metrics-footer"]
    },
    "entries": {
      "discord-output-metrics-footer": {
        "enabled": true,
        "config": {
          "cacheMs": 120000,
          "quotaCacheMs": 60000,
          "contextReserveTokens": 40000,
          "appendSubagents": true,
          "disabledConversations": []
        }
      }
    }
  }
}

Then validate and restart:

openclaw config validate
openclaw gateway restart

Channel deployment

The plugin can run for any Discord channel. To disable specific Discord channel IDs, add them to disabledConversations.

Recommended defaults:

Enable in active work channels like #general, #coding, #reasoning, and audit channels.

Disable in status-only channels like #feed and incident channels like #system if noise matters.

Configuration

Fields:

cacheMs: window for matching recent LLM output and subagent output.

quotaCacheMs: minimum interval between Codex quota refreshes.

contextReserveTokens: safety reserve subtracted from usable context calculations.

appendSubagents: append sub ↑x ↓y when nearby subagent usage is detected.

disabledConversations: Discord channel IDs where no footer should be appended.

Color status

🟢: context under 50% and quota over 50%.

🟡: context 50-80% or quota 20-50%.

🔴: context over 80% or quota under 20%.

If context and quota disagree, show the worse status.

Guardrails

Do not put footer instructions in agent prompts.

Do not call an LLM to calculate footer metrics.

Do not fetch Codex quota on every message; use cache.

Do not show emails, OAuth profile names, token values, API key prefixes, or auth file paths.

Do not add the footer when it would exceed Discord's message limit.

Read references/implementation.md before changing the extension code.

Fields:

cacheMs: window for matching recent LLM output and subagent output.

quotaCacheMs: minimum interval between Codex quota refreshes.

contextReserveTokens: safety reserve subtracted from usable context calculations.

appendSubagents: append sub ↑x ↓y when nearby subagent usage is detected.

disabledConversations: Discord channel IDs where no footer should be appended.