Add skills, learnings & memory updates (2026-01-26)

- New skills: clawddocs, claude-code-usage, summarize, homeassistant, humanizer, self-improving-agent
- Add .learnings/ for self-improvement tracking
- Document proaktive cron config (LRN-20260126-001)
- Update USER.md: Löchgau as former residence
- Update TOOLS.md: Peekaboo workaround
- Memory files for 2026-01-25 and 2026-01-26
This commit is contained in:
James
2026-01-26 09:26:26 +01:00
parent 1a5ad63f55
commit 36eb4a7b3b
50 changed files with 3968 additions and 37 deletions

View File

@@ -0,0 +1,7 @@
{
"version": 1,
"registry": "https://clawdhub.com",
"slug": "clawddocs",
"installedVersion": "1.2.2",
"installedAt": 1769382039375
}

166
skills/clawddocs/SKILL.md Normal file
View File

@@ -0,0 +1,166 @@
---
name: clawddocs
description: Clawdbot documentation expert with decision tree navigation, search scripts, doc fetching, version tracking, and config snippets for all Clawdbot features
---
# Clawdbot Documentation Expert
**Capability Summary:** Clawdbot documentation expert skill with decision tree navigation, search scripts (sitemap, keyword, full-text index via qmd), doc fetching, version tracking, and config snippets for all Clawdbot features (providers, gateway, automation, platforms, tools).
You are an expert on Clawdbot documentation. Use this skill to help users navigate, understand, and configure Clawdbot.
## Quick Start
"When a user asks about Clawdbot, first identify what they need:"
### 🎯 Decision Tree
- **"How do I set up X?"** → Check `providers/` or `start/`
- Discord, Telegram, WhatsApp, etc. → `providers/<name>`
- First time? → `start/getting-started`, `start/setup`
- **"Why isn't X working?"** → Check troubleshooting
- General issues → `debugging`, `gateway/troubleshooting`
- Provider-specific → `providers/troubleshooting`
- Browser tool → `tools/browser-linux-troubleshooting`
- **"How do I configure X?"** → Check `gateway/` or `concepts/`
- Main config → `gateway/configuration`, `gateway/configuration-examples`
- Specific features → relevant `concepts/` page
- **"What is X?"** → Check `concepts/`
- Architecture, sessions, queues, models, etc.
- **"How do I automate X?"** → Check `automation/`
- Scheduled tasks → `automation/cron-jobs`
- Webhooks → `automation/webhook`
- Gmail → `automation/gmail-pubsub`
- **"How do I install/deploy?"** → Check `install/` or `platforms/`
- Docker → `install/docker`
- Linux server → `platforms/linux`
- macOS app → `platforms/macos`
## Available Scripts
All scripts are in `./scripts/`:
### Core
```bash
./scripts/sitemap.sh # Show all docs by category
./scripts/cache.sh status # Check cache status
./scripts/cache.sh refresh # Force refresh sitemap
```
### Search & Discovery
```bash
./scripts/search.sh discord # Find docs by keyword
./scripts/recent.sh 7 # Docs updated in last N days
./scripts/fetch-doc.sh gateway/configuration # Get specific doc
```
### Full-Text Index (requires qmd)
```bash
./scripts/build-index.sh fetch # Download all docs
./scripts/build-index.sh build # Build search index
./scripts/build-index.sh search "webhook retry" # Semantic search
```
### Version Tracking
```bash
./scripts/track-changes.sh snapshot # Save current state
./scripts/track-changes.sh list # Show snapshots
./scripts/track-changes.sh since 2026-01-01 # Show changes
```
## Documentation Categories
### 🚀 Getting Started (`/start/`)
First-time setup, onboarding, FAQ, wizard
### 🔧 Gateway & Operations (`/gateway/`)
Configuration, security, health, logging, tailscale, troubleshooting
### 💬 Providers (`/providers/`)
Discord, Telegram, WhatsApp, Slack, Signal, iMessage, MS Teams
### 🧠 Core Concepts (`/concepts/`)
Agent, sessions, messages, models, queues, streaming, system-prompt
### 🛠️ Tools (`/tools/`)
Bash, browser, skills, reactions, subagents, thinking
### ⚡ Automation (`/automation/`)
Cron jobs, webhooks, polling, Gmail pub/sub
### 💻 CLI (`/cli/`)
Gateway, message, sandbox, update commands
### 📱 Platforms (`/platforms/`)
macOS, Linux, Windows, iOS, Android, Hetzner
### 📡 Nodes (`/nodes/`)
Camera, audio, images, location, voice
### 🌐 Web (`/web/`)
Webchat, dashboard, control UI
### 📦 Install (`/install/`)
Docker, Ansible, Bun, Nix, updating
### 📚 Reference (`/reference/`)
Templates, RPC, device models
## Config Snippets
See `./snippets/common-configs.md` for ready-to-use configuration patterns:
- Provider setup (Discord, Telegram, WhatsApp, etc.)
- Gateway configuration
- Agent defaults
- Retry settings
- Cron jobs
- Skills configuration
## Workflow
1. **Identify the need** using the decision tree above
2. **Search** "if unsure: `./scripts/search.sh <keyword>`"
3. **Fetch the doc**: `./scripts/fetch-doc.sh <path>` or use browser
4. **Reference snippets** for config examples
5. **Cite the source URL** when answering
## Tips
- Always use cached sitemap when possible (1-hour TTL)
- For complex questions, search the full-text index
- Check `recent.sh` to see what's been updated
- Offer specific config snippets from `snippets/`
- Link to docs: `https://docs.clawd.bot/<path>`
## Example Interactions
**User:** "How do I make my bot only respond when mentioned in Discord?"
**You:**
1. Fetch `providers/discord` doc
2. Find the `requireMention` setting
3. Provide the config snippet:
```json
{
"discord": {
"guilds": {
"*": {
"requireMention": true
}
}
}
}
```
4. Link: https://docs.clawd.bot/providers/discord
**User:** "What's new in the docs?"
**You:**
1. Run `./scripts/recent.sh 7`
2. Summarize recently updated pages
3. Offer to dive into any specific updates

View File

@@ -0,0 +1,9 @@
{
"name": "clawddocs",
"version": "1.2.2",
"description": "Clawdbot documentation expert with decision tree navigation, search scripts, doc fetching, version tracking, and config snippets",
"main": "SKILL.md",
"keywords": ["clawdbot", "documentation", "help", "docs"],
"author": "NicholasSpisak",
"license": "MIT"
}

View File

@@ -0,0 +1,17 @@
#!/bin/bash
# Full-text index management (requires qmd)
case "$1" in
fetch)
echo "Downloading all docs..."
;;
build)
echo "Building search index..."
;;
search)
shift
echo "Semantic search for: $*"
;;
*)
echo "Usage: build-index.sh {fetch|build|search <query>}"
;;
esac

View File

@@ -0,0 +1,13 @@
#!/bin/bash
# Cache management for Clawdbot docs
case "$1" in
status)
echo "Cache status: OK (1-hour TTL)"
;;
refresh)
echo "Forcing cache refresh..."
;;
*)
echo "Usage: cache.sh {status|refresh}"
;;
esac

View File

@@ -0,0 +1,7 @@
#!/bin/bash
# Fetch a specific doc
if [ -z "$1" ]; then
echo "Usage: fetch-doc.sh <path>"
exit 1
fi
echo "Fetching: https://docs.clawd.bot/$1"

View File

@@ -0,0 +1,5 @@
#!/bin/bash
# Show recently updated docs
DAYS=${1:-7}
echo "Docs updated in the last $DAYS days"
# In full version, this queries the change tracking

View File

@@ -0,0 +1,8 @@
#!/bin/bash
# Search docs by keyword
if [ -z "$1" ]; then
echo "Usage: search.sh <keyword>"
exit 1
fi
echo "Searching docs for: $1"
# In full version, this searches the full-text index

View File

@@ -0,0 +1,23 @@
#!/bin/bash
# Sitemap generator - shows all docs by category
echo "Fetching Clawdbot documentation sitemap..."
# Categories structure based on docs.clawd.bot
CATEGORIES=(
"start"
"gateway"
"providers"
"concepts"
"tools"
"automation"
"cli"
"platforms"
"nodes"
"web"
"install"
"reference"
)
for cat in "${CATEGORIES[@]}"; do
echo "📁 /$cat/"
done

View File

@@ -0,0 +1,16 @@
#!/bin/bash
# Track changes to documentation
case "$1" in
snapshot)
echo "Saving current state..."
;;
list)
echo "Showing snapshots..."
;;
since)
echo "Changes since $2..."
;;
*)
echo "Usage: track-changes.sh {snapshot|list|since <date>}"
;;
esac

View File

@@ -0,0 +1,69 @@
# Common Config Snippets for Clawdbot
## Provider Setup
### Discord
```json
{
"discord": {
"token": "${DISCORD_TOKEN}",
"guilds": {
"*": {
"requireMention": false
}
}
}
}
```
### Telegram
```json
{
"telegram": {
"token": "${TELEGRAM_TOKEN}"
}
}
```
### WhatsApp
```json
{
"whatsapp": {
"sessionPath": "./whatsapp-sessions"
}
}
```
## Gateway Configuration
```json
{
"gateway": {
"host": "0.0.0.0",
"port": 8080
}
}
```
## Agent Defaults
```json
{
"agents": {
"defaults": {
"model": "anthropic/claude-sonnet-4-5"
}
}
}
```
## Cron Jobs
```json
{
"cron": [
{
"id": "daily-summary",
"schedule": "0 9 * * *",
"task": "summary"
}
]
}
```