Task Experience Summaries

Overview

This skill provides curated experience summaries from real OpenClaw tasks, including:

• Installation/packaging problems and solutions
• Common error messages and root causes
• Package search and discovery methods
• Configuration patterns and environment setups
• Tool-specific troubleshooting steps
• Best practices for documenting new experiences

Each entry includes: Problem → Solutions → Key Lessons → Prevention Steps.

Common Installation Packages

ClawHub CLI

Purpose: Search, install, update, and publish OpenClaw skills from clawhub.com.

Installation:

npm install -g clawhub

Usage:

# Search for skills
clawhub search "keyword"

# Install a skill
clawhub install "skill-name"

# List installed skills
clawhub list

# Publish a new skill (when ready)
clawhub publish "skill-directory"

Authentication:

• Token: clh_<token>
• Username: @<username>
• Available at: https://clawhub.ai

Tavily Search

Purpose: AI-optimized web search via Tavily API.

Configuration:

# Set environment variable
set TAVILY_API_KEY=your-api-key-here

Usage:

• Search query: web_search tool
• API key location: <skill-dir>/README_CONFIG.md
• Quality: High relevance for AI agents

Troubleshooting Categories

1. Package Installation Issues

Problem: npm 404 Not Found

Scenario: Install command fails with "404 Not Found"

Solutions:

1. Check package name spelling
2. Search ClawHub: clawhub search "keyword"
3. Try npm search: npm search "keyword"
4. Verify the package exists in npm registry

Typical Fixes:

• Wrong package name (e.g., tavily-search → correct: tavily-mcp)
• Package removed or renamed
• Typo in command

Key Lesson: Always verify package existence before installation. Use search tools.

Problem: Windows Permission EEXIST Error

Scenario: Installation fails with "EEXIST: file already exists"

Solution:

npm i -g clawhub --force

Root Cause: Old version files remain, blocking installation

Prevention: Use --force for global installations on Windows if issues occur

Problem: Unknown Package Name

Scenario Package not found in npm registry

Solutions:

1. Use ClawHub search: clawhub search "keyword"
2. Try broader search terms
3. Check if the skill is hosted on ClawHub (OpenClaw's official registry)

Example:

Initial attempt: npm install "find-skills" → 404
Solution: clawhub search "find-skills" → Found "find-skills v0.1.0"
Result: clawhub install "find-skills" → Success

Key Lesson: ClawHub is the first place to check for OpenClaw skills

2. Configuration Issues

Environment Variables

Standard Pattern:

# SET in current session
set ENV_VAR=value

# For persistent settings, add to shell config
# (e.g., .bashrc, .zshrc, PowerShell profile)