← Back to Skills Marketplace
356
Downloads
0
Stars
2
Active Installs
1
Versions
Install in OpenClaw
/install openclaw-session-guard
Description
管理 OpenClaw 长会话防爆机制（80%自动归档、自动轮换新会话、低 token 交接）及定时任务安装。用户提到 compacting context、会话过长、自动总结归档、session 轮换、LaunchAgent 定时任务时使用。
Usage Guidance
Before installing: 1) Inspect the missing plist template (ai.openclaw.session.rotator.plist.template) — confirm what the LaunchAgent will run and its schedule. 2) Backup ~/.openclaw/agents and sessions.json so you can recover if session IDs are changed. 3) Verify and trust the openclaw CLI binary on your PATH (install.sh calls it and that CLI will send messages/network requests). 4) Because the installer writes to ~/bin and ~/Library/LaunchAgents, prefer running install.sh manually after review rather than blindly executing it. 5) If you're not on macOS, do not install (the scripts use launchctl). If anything is unclear or the plist template is missing, ask the skill author for a complete package and an explanation of scheduling and safety safeguards.
Capability Analysis
Type: OpenClaw Skill
Name: openclaw-session-guard
Version: 1.0.0
The skill installs a LaunchAgent to periodically manage OpenClaw sessions, archiving long sessions and rotating to new ones. It interacts with OpenClaw's internal state and sends a 'handoff' prompt to the agent to continue the conversation. While the skill establishes persistence and sends instructions to the agent (a form of prompt injection), these actions are directly aligned with its stated purpose of session management and context handling. There is no evidence of data exfiltration, unauthorized remote control, or other malicious intent. All file system operations and agent instructions are functional and confined to OpenClaw's operational scope.
Capability Assessment
Purpose & Capability
Name/description (session rotation, auto-archive, LaunchAgent scheduling) match the included scripts: they scan local OpenClaw sessions, write archives, update session mapping, create new session IDs, and invoke the openclaw CLI. However, the installer assumes macOS (LaunchAgents/launchctl) while the skill metadata has no OS restriction; also install.sh references a plist template file (ai.openclaw.session.rotator.plist.template) which is not present in the manifest—this packaging mismatch is unexpected.
Instruction Scope
Runtime behavior is broad: the rotator reads session files under ~/.openclaw/agents/, writes archives to ~/.openclaw/knowledge/, updates sessions.json to switch sessionId, writes cooldown/state files, and invokes the openclaw CLI to post the handoff message. These actions are coherent with its purpose but are sensitive: they modify user agent state and autonomously send messages via the openclaw CLI. Ensure you trust the openclaw binary and accept automated changes to session files.
Install Mechanism
There is no platform install spec (instruction-only) but an included install.sh installs a script to ~/bin and bootstraps a LaunchAgent via launchctl. Risks: the installer is macOS-specific (LaunchAgents) yet the skill has no OS restriction; the expected plist template file referenced by install.sh is missing from the provided manifest, which will cause install failure or unexpected behavior if not corrected. The install writes to user LaunchAgents and ~/bin (persistent system presence).
Credentials
The skill declares no required env vars, but scripts read optional envs (OPENCLAW_BIN, OPENCLAW_STATE_ROOT, etc.) and will call the openclaw CLI. That is appropriate for its function, but the scripts operate on many local files under ~/.openclaw and will update session state. There are no external network endpoints or hidden credential requests in the code itself, but the openclaw CLI it calls may perform network activity using your agent credentials—verify that CLI's trustworthiness.
Persistence & Privilege
The installer sets up a LaunchAgent to run periodically (default every 5 minutes via a plist template). This creates persistent background behavior that will autonomously scan and modify session state. While autonomy is expected for this feature, it increases blast radius; the package does not request explicit consent via metadata nor include an OS restriction, and the missing plist template further obfuscates exact schedule/configuration.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install openclaw-session-guard - After installation, invoke the skill by name or use
/openclaw-session-guard - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: automatic session rotation at 80% threshold with low-token handoff
Metadata
Frequently Asked Questions
What is OpenClaw Session Guard?
管理 OpenClaw 长会话防爆机制（80%自动归档、自动轮换新会话、低 token 交接）及定时任务安装。用户提到 compacting context、会话过长、自动总结归档、session 轮换、LaunchAgent 定时任务时使用。 It is an AI Agent Skill for Claude Code / OpenClaw, with 356 downloads so far.
How do I install OpenClaw Session Guard?
Run "/install openclaw-session-guard" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is OpenClaw Session Guard free?
Yes, OpenClaw Session Guard is completely free (open-source). You can download, install and use it at no cost.
Which platforms does OpenClaw Session Guard support?
OpenClaw Session Guard is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created OpenClaw Session Guard?
It is built and maintained by Buck (@tel18610240060-collab); the current version is v1.0.0.
More Skills