task-experience-summaries

# 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:**
```bash
npm install -g clawhub
```

**Usage:**
```bash
# 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:**
```bash
# 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:**
```bash
np...