UXR Ethnographic Observer for Openclaw

An embedded ethnographic research tool that monitors interaction data and generates structured insights to optimize your OpenClaw experience.

giulianomorse
v1.0.0
Mar 6, 2026
0
951
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install nutcrackertest

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install nutcrackertest 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 UXR Ethnographic Observer?

UXR Observer is a sophisticated ethnographic research skill designed to sit quietly within your Openclaw Skills environment, observing the relationship between users and agents. It acts as a digital fly-on-the-wall, transforming raw session logs into meaningful research-grade reports that highlight friction, delight, and behavioral patterns. By analyzing how users phrase requests and identifying where agents struggle, it provides a data-driven foundation for iterative improvement.

Built with a privacy-first architecture, the skill ensures that all interaction analysis happens locally on the user's machine. It features a robust multi-stage pipeline that includes data collection, PII redaction, and longitudinal trend analysis. This allows developers and power users to gain deep visibility into the performance and utility of their Openclaw Skills without compromising sensitive information.

UXR Ethnographic Observer Use Cases

  • Identifying recurring friction points and error loops in agent workflows.
  • Tracking longitudinal trends in tool adoption and task distribution over time.
  • Generating redacted daily interaction summaries for performance reviews.
  • Discovering user "desire paths" and workarounds that suggest new feature requirements.
  • Analyzing the cost-to-value ratio of specific agent interactions.

How UXR Ethnographic Observer Works

  1. Scans local agent session directories to locate raw interaction logs in JSONL format.
  2. Extracts message content, tool calls, timestamps, and cost metrics using a specialized collection script.
  3. Passes all extracted text through a redaction engine to replace PII like emails and API keys with secure placeholders.
  4. Analyzes the redacted data to classify tasks, detect sentiment signals, and identify interaction archetypes.
  5. Compiles findings into a structured Markdown report based on ethnographic research templates.
  6. Updates a global trends file to provide historical context and longitudinal visibility for all Openclaw Skills usage.

UXR Ethnographic Observer Setup

To integrate UXR Observer into your Openclaw Skills workflow, ensure your environment meets the technical requirements and follow these steps:

# Ensure dependencies are installed
# Requires: python3, jq, and bash

# Generate your first interaction report
/uxr

# Access longitudinal data
/uxr trends

# (Optional) Automate report generation via cron
openclaw cron add --id "daily-uxr" --schedule "0 22 * * *" --message "/uxr"

UXR Ethnographic Observer Data Schema & Taxonomy

The skill manages a structured lifecycle for interaction data to ensure all Openclaw Skills analysis remains organized and secure:

Data Component Path Description
Raw Collection data/sessions-YYYY-MM-DD.json Intermediate structured data before final analysis.
Longitudinal Store data/trends.json JSON store for cross-session metrics and adoption curves.
Research Reports reports/YYYY-MM-DD.md Human-readable Markdown reports detailing daily insights.
Redaction Rules scripts/redact.py Logic for stripping PII and sensitive system paths.

UXR Ethnographic Observer Advanced Features

  • Local-Only Processing: Ensures all interaction data remains on the host machine with zero external transmission.
  • Automated PII Redaction: Sophisticated pattern matching to strip names, IPs, and credentials before data hits the analysis engine.
  • Behavioral Archetype Characterization: Automatically categorizes user behavior to distinguish between different interaction styles.
  • Slash Command Routing: Quick access to specific insights via /uxr friction, /uxr quotes, and /uxr status commands.
  • Cron Integration: Support for scheduled automated reporting to maintain a consistent research log for your Openclaw Skills.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins python3jq
Github Stars: 0
forks: 0

Featured*