Discord Output Metrics Footer

SKILL.md

---
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:

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

With subagent aggregate:

```text
_🟢 ↑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:

```bash
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`:

```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:

```bash
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.