← Back to Skills Marketplace
266
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install neckr0ik-session-healer
Description
Automatically detects and heals locked OpenClaw session files. Use when you see "session file locked" errors or models failing due to lock timeouts. Clears s...
Usage Guidance
This skill appears to do what it says: find stale .jsonl.lock files, check owning PIDs, remove stale locks, and recover/bak session files. Before installing or running: 1) Inspect the full scripts/healer.py (confirm there are no network calls or unexpected behaviors such as HTTP requests, telemetry, or exec/spawning of arbitrary commands). 2) Run in --dry-run mode first and verify reported targets. 3) Ensure recent backups of ~/.openclaw exist (the tool creates backups, but keep your own). 4) Avoid using --force unless you understand the risk of clearing locks for live processes (can cause data corruption). 5) If you allow the agent to invoke this skill autonomously, prefer limiting its scope or require manual confirmation for destructive actions. If you want higher assurance, provide the remaining truncated portion of healer.py for a complete review (my confidence is medium because a portion of the source was truncated in the supplied content).
Capability Analysis
Type: OpenClaw Skill
Name: neckr0ik-session-healer
Version: 1.0.0
The neckr0ik-session-healer skill is a maintenance utility designed to manage stale lock files and recover corrupted session data within the OpenClaw environment (~/.openclaw). The Python script (scripts/healer.py) uses standard library functions to safely check process status via os.kill(pid, 0), creates backups before file modifications, and lacks any indicators of data exfiltration, remote execution, or malicious intent.
Capability Assessment
Purpose & Capability
Name, description, SKILL.md, and the included healer.py all focus on scanning ~/.openclaw/agents/*/sessions for .jsonl.lock files, checking PIDs, removing stale locks, and recovering session files — the required actions match the stated purpose and no unrelated credentials/binaries are requested.
Instruction Scope
Instructions and code operate only on the OpenClaw session directory and session files (checking PIDs, unlinking lock files, backing up and sanitizing session JSONL). SKILL.md references a CLI name (neckr0ik-session-healer) but no install mechanism is provided — the shipped healer.py appears to be the implementation. The script reads and modifies session content (expected for recovery) so run with care and use --dry-run/backups first.
Install Mechanism
No install spec or external downloads are present — this is an instruction-only skill with an included Python script, which minimizes install risk. Nothing is fetched from remote URLs in the provided artifacts.
Credentials
The skill declares no required env vars, credentials, or config paths beyond the OpenClaw home (~/.openclaw). That access is proportional to its job of fixing session files.
Persistence & Privilege
always is false and there is no indication the skill modifies other skills or system-wide configuration. It acts on local files only and does not demand persistent elevated privileges in the provided material.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install neckr0ik-session-healer - After installation, invoke the skill by name or use
/neckr0ik-session-healer - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of neckr0ik-session-healer.
- Detects and reports locked OpenClaw session files, including lock status and owner process.
- Automatically heals stale (dead) session locks and recovers sessions after failure.
- Offers commands to check, heal, unlock, and recover session files.
- Provides safety features: avoids clearing active locks, creates backups, and validates integrity.
- Includes detailed command-line usage and informative output for each operation.
Metadata
Frequently Asked Questions
What is Neckr0ik Session Healer?
Automatically detects and heals locked OpenClaw session files. Use when you see "session file locked" errors or models failing due to lock timeouts. Clears s... It is an AI Agent Skill for Claude Code / OpenClaw, with 266 downloads so far.
How do I install Neckr0ik Session Healer?
Run "/install neckr0ik-session-healer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Neckr0ik Session Healer free?
Yes, Neckr0ik Session Healer is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Neckr0ik Session Healer support?
Neckr0ik Session Healer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Neckr0ik Session Healer?
It is built and maintained by Neckr0ik (@neckr0ik); the current version is v1.0.0.
More Skills