A local-only UX research tool that analyzes session history to identify workflow friction and generate actionable insights.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install nutcrackertestgpt
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 nutcrackertestgpt 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 OpenClaw UX Ethnographer?
The OpenClaw UX Ethnographer is a specialized skill designed for developers and researchers who need deep insights into agent-user interactions without compromising data security. By operating entirely on the local machine, it extracts session data, identifies behavioral patterns, and maps out user journeys to highlight areas of friction such as tool mismatches, context loss, or permission issues. This skill is a vital addition for anyone building robust agentic workflows using Openclaw Skills who requires a high degree of data sovereignty.
Built with a privacy-first mindset, the ethnographer ensures that all transcripts, tool outputs, and gateway logs are redacted before being persisted or analyzed. It transforms raw interaction data into structured reports, providing evidence-based findings that help users optimize their prompts, tools, and overall agent performance.
OpenClaw UX Ethnographer Use Cases
- Identifying recurring friction points and behavioral bottlenecks in automated coding workflows.
- Generating daily, local-only UXR reports to track agent reliability and user satisfaction.
- Auditing tool performance and error rates across multiple sessions in Openclaw Skills.
- Creating evidence-based recommendations for improving custom agent prompts and documentation.
- Managing long-term usage data with automated retention and purging policies.
How OpenClaw UX Ethnographer Works
- The skill initiates a consent-based setup to define data capture levels (minimal, snippets, or full) and retention windows.
- It resolves the requested time window, defaulting to the last 24 hours of activity.
- Raw data is collected from local session tools, transcript files, and optional gateway logs.
- A strict redaction process is applied using predefined rules to remove secrets and credentials from all captured text.
- The tool performs a qualitative analysis, clustering tasks and mapping journeys to identify specific friction taxonomies like confusion or tool mismatch.
- It computes metrics such as total turns, top intents, and error rates to provide a quantitative backdrop for qualitative insights.
- Markdown and JSON reports are generated and stored locally, accompanied by an executive summary delivered in the chat.
OpenClaw UX Ethnographer Setup
To install the skill into your local environment, create the directory and copy the skill files:
mkdir -p <workspace>/skills/openclaw-ux-ethnographer
cp -R ./openclaw-ux-ethnographer <workspace>/skills/openclaw-ux-ethnographer
After copying the files, notify your agent to update its capabilities:
Ask your OpenClaw agent: refresh skills
You can also schedule automated daily reporting using the OpenClaw cron utility:
openclaw cron add --name "Daily OpenClaw UXR Report" --cron "5 8 * * *" --tz "America/Los_Angeles" --session isolated --message "Generate today's OpenClaw UX ethnography report for the last 24 hours using openclaw-ux-ethnographer." --no-deliver
OpenClaw UX Ethnographer Data Schema & Taxonomy
The skill organizes research artifacts within a dedicated base directory using the following structure:
| Path | Description |
|---|---|
{baseDir}/state.json |
Stores user consent, capture levels, and retention settings. |
{baseDir}/data/YYYY-MM-DD/ |
Contains raw_events.jsonl and the session index for a specific date. |
{baseDir}/reports/ |
Stores Markdown (.md) reports and JSON summaries (.summary.json). |
{baseDir}/references/ |
Contains the redaction rules, report templates, and fallback paths. |
Events are normalized into a stream including event_id, session_key, tool_name, and redacted content based on the configured capture level.
OpenClaw UX Ethnographer Advanced Features
- Multi-level data capture options ranging from minimal metadata to full redacted transcripts.
- Integration with OpenClaw cron for automated, hands-off daily ethnography reports.
- Custom redaction rules support to ensure industry-specific secrets are never stored.
- Automated data lifecycle management that purges old records based on a configurable retention window.
- Support for both natural language triggers and structured slash commands within Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
UXR Ethnographic Observer
An embedded ethnographic research tool that monitors interaction data and generates structured insights to optimize your OpenClaw experience.
UXR Observer
An embedded UX research skill that performs ethnographic observation, satisfaction measurement, and automated cost tracking for AI agent interactions.
UXR Observer
A local-first UX research tool for Openclaw Skills that monitors interactions and provides actionable insights through automated observation and feedback.
Moltbot Arena
A comprehensive skill for building, controlling, and automating AI agents in the Moltbot Arena multiplayer programming environment.
Clawsight UXR Observer
An embedded ethnographic research tool for Openclaw Skills that captures user interactions, surveys, and verbatim feedback to generate daily UX insight reports.
UxrObserver
An automated UX research ethnographer that passively observes and analyzes user interactions within the OpenClaw environment.
Featured*
