A specialized logging utility that generates structured OSOP workflow definitions and execution records for AI agent sessions.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install osop-log
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install osop-log using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is OSOP Session Logger?
The OSOP Session Logger is a powerful tool designed to provide transparency and reproducibility for AI agent activities. By using this skill within the Openclaw Skills ecosystem, developers can automatically generate standardized documentation including .osop workflow files and .osoplog.yaml execution records. This ensures that every decision, tool call, and shell command is captured in a format that is both human-readable and machine-parseable.
This skill is essential for developers who need to audit AI behaviors, visualize complex logic flows, or maintain a rigorous history of automated tasks. It translates raw session history into a structured graph of nodes and edges, allowing for a deep understanding of the agent's internal reasoning and external interactions.
OSOP Session Logger Use Cases
- Documenting multi-step coding sessions to create a permanent record of AI-driven changes.
- Auditing security-sensitive operations by reviewing risk levels assigned to different workflow nodes.
- Debugging agent performance by analyzing tool call counts and duration metrics captured in Openclaw Skills sessions.
- Visualizing agent logic in the OSOP editor to optimize prompt engineering and sub-agent coordination.
How OSOP Session Logger Works
- The user or agent completes a specific task or unit of work.
- The skill is invoked with a short description of the actions performed during the session.
- It automatically analyzes the session history to identify different types of operations such as MCP tool calls, CLI commands, or Git commits.
- The tool maps these actions into a standardized node and edge structure based on the OSOP protocol.
- Two files are generated in a sessions directory: a .osop file for the workflow graph and a .osoplog.yaml file for the execution telemetry.
OSOP Session Logger Setup
To get started with this skill in your Openclaw Skills environment, ensure your configuration directory is prepared:
mkdir -p ~/.osop
touch ~/.osop/config.yaml
The skill is user-invocable and requires bash to be available in the system environment.
OSOP Session Logger Data Schema & Taxonomy
The skill organizes session data into two primary schemas for maximum clarity:
| Schema Type | Key Components | Purpose |
|---|---|---|
| .osop | nodes, edges, tags, risk_level | Defines the logical structure and flow of the task. |
| .osoplog.yaml | run_id, duration_ms, tools_used, reasoning | Captures the technical execution details and performance metrics. |
All logs are stored in a YYYY-MM-DD format within the sessions directory to maintain a chronological record of your Openclaw Skills history.
OSOP Session Logger Advanced Features
- Support for complex sub-agent tracking including parent-child relationships and spawn logic.
- High-granularity node mapping for diverse actions like CICD testing, API interactions, and user reviews.
- Built-in reasoning capture that records the question, selected approach, and confidence score for each step.
- Detailed telemetry tracking for tool usage frequency and precise execution timestamps.
- Full compatibility with the OSOP web editor for visual analysis of generated log files.
SKILL.md
Loading
Related Openclaw Skills
OSOP Workflow Reviewer
A specialized security audit tool designed to analyze AI agent workflow definitions and execution logs for risks, permission gaps, and destructive actions.
OSOP Report Generator
A specialized utility to transform complex workflow definitions and execution logs into beautiful, interactive HTML reports.
OSOP Workflow Optimizer
A specialized tool that analyzes execution history to automatically improve the performance and reliability of OSOP workflows.
Wan 2.7 Video Generation & Editing
A powerful video generation and editing suite powered by Alibaba's Wan 2.7 models for high-fidelity 720P and 1080P cinematic content.
OSOP: Open Standard Operating Procedures
OSOP provides a universal protocol for defining, validating, and self-optimizing structured workflows for AI agents.
Exec Security
A pre-flight security validation skill that scans shell commands for dangerous patterns, destructive operations, and data leaks before they execute.
Featured*
