Auto Rename Session Label
Installs an OpenClaw internal hook that auto-titles each new chat session using the session's current model (on message:received), with a safe fallback to truncating the first message. Triggers: install auto rename session label, auto title sessions, auto-name chats, session auto rename.
Auto Rename Session Label (OpenClaw hook installer)
Triggers (highest priority): install auto rename session label, auto title sessions, auto-name chats, session auto rename. See / hear any → run the install workflow below.
This skill installs an OpenClaw internal hook named auto-rename-session-label.
Once installed and enabled, every time a message arrives for a session that has
no title yet, the hook generates a short title using the same model that
session is currently using, and writes it as the session label. On any
failure it falls back to truncating the first user message, so a label is always
set.
The hook is portable — it contains no hardcoded paths and no personal data;
it resolves OpenClaw home, agent id, and the OpenClaw dist directory at runtime.
What's in this package
auto-rename-session-label/
├── SKILL.md # this file (SkillHub/ClawHub entry)
├── README.md
├── LICENSE
└── hook/
├── HOOK.md # the hook's own metadata + docs
└── handler.ts # the hook implementation (portable)
hook/ is a ready-to-drop OpenClaw internal hook directory.
Install workflow
-
Resolve the OpenClaw home dir:
OPENCLAW_HOMEif set, else~/.openclaw. -
Copy the bundled
hook/directory into the managed hooks dir:bash OPENCLAW_HOME="${OPENCLAW_HOME:-$HOME/.openclaw}" SKILL_DIR="<absolute path to this skill directory>" mkdir -p "$OPENCLAW_HOME/hooks/auto-rename-session-label" cp "$SKILL_DIR/hook/HOOK.md" "$SKILL_DIR/hook/handler.ts" \ "$OPENCLAW_HOME/hooks/auto-rename-session-label/"Resolve
<SKILL_DIR>to where this SKILL.md actually lives (the parent of this file). Do not guess an absolute path. -
Enable the hook (this is the required step;
hooks.internal.entries.*is a protected config path and cannot be set viagateway config.patch— use the CLI):bash openclaw hooks enable auto-rename-session-label -
Restart or reload the gateway so the hook loads, then verify:
bash openclaw hooks list # auto-rename-session-label should show ✓ ready openclaw hooks info auto-rename-session-label
Verify it works
Start a fresh session and send one message. After the reply, that session's
entry in ~/.openclaw/agents/<agentId>/sessions/sessions.json should have a
short label generated by the model (not a truncated copy of your message).
If the label is always a truncated copy of your first message, the LLM branch is
failing and falling back. Check openclaw hooks info auto-rename-session-label
and the gateway logs; the most common cause is a too-small maxTokens for
proxied models (this hook already uses 1024 to avoid that).
Uninstall
openclaw hooks disable auto-rename-session-label
rm -rf "${OPENCLAW_HOME:-$HOME/.openclaw}/hooks/auto-rename-session-label"
Notes
- This hook is an operator-managed side effect (it writes the session
label). It does not modify prompts, tools, or message flow. - See
hook/HOOK.mdfor full implementation detail.
- Downloads
- 511All time
- Security audit
- Review
- Last updated
- 5mo ago
- Current version
- v1.0.0
- License
- MIT-0
