@better-openclaw/core 1.0.26 → 1.0.31

package/dist/{skills-BSF7iNa4.cjs → skills-uPxJVmKk.cjs}

@@ -30,6 +30,77 @@ handlebars = __toESM(handlebars);
 * service's `openclawEnvVars` array at generation time.
 */
 const skillTemplates = {
+	"agent-browse": `---
+name: agent-browse
+description: "AI-optimized browser automation with snapshot + ref workflow for deterministic element targeting"
+metadata:
+  openclaw:
+    emoji: "🌍"
+---
+
+# Agent Browser
+
+AI-optimized headless browser available at \`{{AGENT_BROWSER_HOST}}\` with CDP on port \`{{AGENT_BROWSER_CDP_PORT}}\` and live viewport streaming on port \`{{AGENT_BROWSER_STREAM_PORT}}\`.
+
+## Core Workflow: Snapshot → Reason → Act
+
+Agent Browser uses a **ref-based workflow** designed for LLMs. Each interactive element gets a deterministic ref like \`@e1\`, \`@e2\` that you can target directly — no CSS selectors needed.
+
+1. **Navigate:** \`agent-browser open https://example.com\`
+2. **Snapshot:** \`agent-browser snapshot\` → returns accessibility tree with refs
+3. **Reason:** Identify the target element by its ref (e.g. \`@e5\` is the search input)
+4. **Act:** \`agent-browser click @e5\` or \`agent-browser type @e5 "search query"\`
+5. **Verify:** \`agent-browser screenshot\` to capture the result
+
+## Key Commands
+
+| Command | Description |
+|---------|-------------|
+| \`agent-browser open <url>\` | Navigate to a URL |
+| \`agent-browser snapshot\` | Get accessibility tree with @refs |
+| \`agent-browser click @ref\` | Click an element by ref |
+| \`agent-browser type @ref "text"\` | Type text into an input |
+| \`agent-browser select @ref "value"\` | Select a dropdown option |
+| \`agent-browser screenshot [--path file.png]\` | Capture viewport screenshot |
+| \`agent-browser scroll down\\|up\` | Scroll the viewport |
+| \`agent-browser wait <selector\\|ms>\` | Wait for element or time |
+| \`agent-browser extract\` | Extract page content as clean text |
+| \`agent-browser pdf [--path file.pdf]\` | Save page as PDF |
+
+## Snapshot Output Example
+
+\`\`\`
+@e1 heading "Welcome to Example"
+@e2 link "Sign In" [href="/login"]
+@e3 input[text] "Search..." [placeholder]
+@e4 button "Search"
+@e5 link "Learn More" [href="/docs"]
+\`\`\`
+
+Each \`@ref\` is stable within a page state — use it directly: \`agent-browser click @e2\`
+
+## Content Boundaries
+
+Output is wrapped in boundary markers (\`---CONTENT_START---\` / \`---CONTENT_END---\`) to prevent prompt injection from page content. This is enabled by default.
+
+## Session Persistence
+
+\`\`\`bash
+# Save/restore login state across sessions
+agent-browser --session-name my-app open https://app.example.com
+agent-browser --session-name my-app snapshot
+\`\`\`
+
+## Live Viewport Streaming
+
+WebSocket stream at \`ws://{{AGENT_BROWSER_HOST}}:{{AGENT_BROWSER_STREAM_PORT}}\` for real-time viewport watching (pair browsing). Receives JPEG frames with metadata.
+
+## Security
+
+- **Domain allowlist:** Set \`AGENT_BROWSER_ALLOWED_DOMAINS\` to restrict navigation
+- **Action policies:** JSON policy files to require confirmation for specific action categories
+- **Content boundaries:** Prevent LLM prompt injection from page content
+`,
 	"redis-cache": `---
 name: redis-cache
 description: "Cache data and manage key-value state using Redis"
@@ -687,6 +758,245 @@ curl -X POST http://{{OPENSANDBOX_HOST}}:{{OPENSANDBOX_PORT}}/v1/sandboxes/{id}/
 - No outbound network access by default (egress blocked)
 - Max 512 PIDs per sandbox (fork bomb protection)
 - Memory capped per sandbox (default 512MB)
+`,
+	"mem0-memory": `---
+name: mem0-memory
+description: "Store and retrieve long-term memories for AI agents using Mem0"
+metadata:
+  openclaw:
+    emoji: "🧠"
+---
+
+# Mem0 AI Memory
+
+Use Mem0 as a long-term memory layer for AI agents. Mem0 automatically extracts, stores, and retrieves memories across conversations using pgvector embeddings and Neo4j knowledge graphs.
+
+## Connection Details
+
+- **Host:** \`{{MEM0_HOST}}\`
+- **Port:** \`{{MEM0_PORT}}\`
+
+## Example API Calls
+
+### Add a memory
+\`\`\`bash
+curl -X POST "http://{{MEM0_HOST}}:{{MEM0_PORT}}/v1/memories/" \\
+  -H "Content-Type: application/json" \\
+  -d '{"messages": [{"role": "user", "content": "I prefer dark mode in all applications"}], "user_id": "agent-1"}'
+\`\`\`
+
+### Search memories
+\`\`\`bash
+curl -X POST "http://{{MEM0_HOST}}:{{MEM0_PORT}}/v1/memories/search/" \\
+  -H "Content-Type: application/json" \\
+  -d '{"query": "What are the user preferences?", "user_id": "agent-1"}'
+\`\`\`
+
+### Get all memories for a user
+\`\`\`bash
+curl "http://{{MEM0_HOST}}:{{MEM0_PORT}}/v1/memories/?user_id=agent-1"
+\`\`\`
+
+### Delete a memory
+\`\`\`bash
+curl -X DELETE "http://{{MEM0_HOST}}:{{MEM0_PORT}}/v1/memories/<memory_id>/"
+\`\`\`
+
+## Usage Notes
+
+- Mem0 automatically extracts facts and preferences from conversation messages.
+- Memories are stored as vector embeddings in pgvector and as entity relationships in Neo4j.
+- Use \`user_id\` to isolate memories per agent or per conversation context.
+- Mem0 handles deduplication and conflict resolution automatically.
+`,
+	"memu-memory": `---
+name: memu-memory
+description: "Persistent memory framework for proactive AI agents using MemU"
+metadata:
+  openclaw:
+    emoji: "🧠"
+---
+
+# MemU Persistent Memory
+
+Use MemU as a persistent memory framework for 24/7 proactive AI agents. MemU extracts structured memory from multimodal inputs and organizes it into a hierarchical knowledge graph.
+
+## Connection Details
+
+- **Host:** \`{{MEMU_HOST}}\`
+- **Port:** \`{{MEMU_PORT}}\`
+
+## Example API Calls
+
+### Store a memory
+\`\`\`bash
+curl -X POST "http://{{MEMU_HOST}}:{{MEMU_PORT}}/api/v1/memories" \\
+  -H "Content-Type: application/json" \\
+  -d '{"content": "User prefers TypeScript over JavaScript", "agent_id": "agent-1", "type": "preference"}'
+\`\`\`
+
+### Recall memories
+\`\`\`bash
+curl -X POST "http://{{MEMU_HOST}}:{{MEMU_PORT}}/api/v1/recall" \\
+  -H "Content-Type: application/json" \\
+  -d '{"query": "What programming languages does the user prefer?", "agent_id": "agent-1"}'
+\`\`\`
+
+### Get memory graph
+\`\`\`bash
+curl "http://{{MEMU_HOST}}:{{MEMU_PORT}}/api/v1/graph?agent_id=agent-1"
+\`\`\`
+
+## Usage Notes
+
+- MemU organizes memories into a hierarchical knowledge graph backed by pgvector.
+- Supports multimodal inputs (text, images, structured data).
+- Use \`agent_id\` to partition memories across different agents.
+`,
+	"hindsight-memory": `---
+name: hindsight-memory
+description: "Agent memory with Retain/Recall/Reflect operations using Hindsight"
+metadata:
+  openclaw:
+    emoji: "🧠"
+---
+
+# Hindsight Agent Memory
+
+Use Hindsight for agent memory with three core operations: Retain (store), Recall (retrieve), and Reflect (synthesize). Supports multi-strategy retrieval including semantic, keyword, graph, and temporal search.
+
+## Connection Details
+
+- **Host:** \`{{HINDSIGHT_HOST}}\`
+- **Port:** \`{{HINDSIGHT_API_PORT}}\`
+
+## Example API Calls
+
+### Retain (store a memory)
+\`\`\`bash
+curl -X POST "http://{{HINDSIGHT_HOST}}:{{HINDSIGHT_API_PORT}}/api/v1/retain" \\
+  -H "Content-Type: application/json" \\
+  -d '{"namespace": "agent-1", "content": "The deployment uses Kubernetes on AWS EKS", "metadata": {"source": "conversation"}}'
+\`\`\`
+
+### Recall (retrieve memories)
+\`\`\`bash
+curl -X POST "http://{{HINDSIGHT_HOST}}:{{HINDSIGHT_API_PORT}}/api/v1/recall" \\
+  -H "Content-Type: application/json" \\
+  -d '{"namespace": "agent-1", "query": "What infrastructure is used?", "strategies": ["semantic", "keyword"], "limit": 5}'
+\`\`\`
+
+### Reflect (synthesize memories)
+\`\`\`bash
+curl -X POST "http://{{HINDSIGHT_HOST}}:{{HINDSIGHT_API_PORT}}/api/v1/reflect" \\
+  -H "Content-Type: application/json" \\
+  -d '{"namespace": "agent-1", "query": "Summarize all infrastructure decisions"}'
+\`\`\`
+
+## MCP Integration
+
+Hindsight also exposes an MCP server. Configure your agent to connect via:
+\`\`\`
+http://{{HINDSIGHT_HOST}}:{{HINDSIGHT_API_PORT}}/mcp
+\`\`\`
+
+## Usage Notes
+
+- Use namespaces to isolate memories per agent, project, or session.
+- Retrieval strategies: semantic (embedding similarity), keyword (BM25), graph (entity relationships), temporal (time-based).
+- The Reflect operation uses LLM-powered synthesis to generate insights from stored memories.
+`,
+	"chromadb-memory": `---
+name: chromadb-memory
+description: "Store and retrieve vector embeddings using ChromaDB"
+metadata:
+  openclaw:
+    emoji: "🎨"
+---
+
+# ChromaDB Vector Memory
+
+Use ChromaDB as a vector database for storing embeddings, enabling semantic search and retrieval-augmented generation (RAG).
+
+## Connection Details
+
+- **Host:** \`{{CHROMADB_HOST}}\`
+- **Port:** \`{{CHROMADB_PORT}}\`
+
+## Example API Calls
+
+### Create a collection
+\`\`\`bash
+curl -X POST "http://{{CHROMADB_HOST}}:{{CHROMADB_PORT}}/api/v1/collections" \\
+  -H "Content-Type: application/json" \\
+  -d '{"name": "my_collection", "metadata": {"hnsw:space": "cosine"}}'
+\`\`\`
+
+### Add documents
+\`\`\`bash
+curl -X POST "http://{{CHROMADB_HOST}}:{{CHROMADB_PORT}}/api/v1/collections/<collection_id>/add" \\
+  -H "Content-Type: application/json" \\
+  -d '{"ids": ["doc1"], "documents": ["Hello world"], "metadatas": [{"source": "test"}]}'
+\`\`\`
+
+### Query similar documents
+\`\`\`bash
+curl -X POST "http://{{CHROMADB_HOST}}:{{CHROMADB_PORT}}/api/v1/collections/<collection_id>/query" \\
+  -H "Content-Type: application/json" \\
+  -d '{"query_texts": ["greeting"], "n_results": 5}'
+\`\`\`
+
+## Usage Notes
+
+- ChromaDB can auto-generate embeddings from documents if configured with an embedding function.
+- Supports metadata filtering on queries for precise retrieval.
+- Collections are isolated namespaces for different data domains.
+`,
+	"weaviate-memory": `---
+name: weaviate-memory
+description: "Store and search vectors with hybrid search using Weaviate"
+metadata:
+  openclaw:
+    emoji: "🔷"
+---
+
+# Weaviate Vector Memory
+
+Use Weaviate for vector storage with built-in hybrid search (combining vector similarity and keyword/BM25 search) and a GraphQL API.
+
+## Connection Details
+
+- **Host:** \`{{WEAVIATE_HOST}}\`
+- **Port:** \`{{WEAVIATE_PORT}}\`
+
+## Example API Calls
+
+### Create a class (schema)
+\`\`\`bash
+curl -X POST "http://{{WEAVIATE_HOST}}:{{WEAVIATE_PORT}}/v1/schema" \\
+  -H "Content-Type: application/json" \\
+  -d '{"class": "Document", "vectorizer": "none", "properties": [{"name": "content", "dataType": ["text"]}]}'
+\`\`\`
+
+### Add an object with vector
+\`\`\`bash
+curl -X POST "http://{{WEAVIATE_HOST}}:{{WEAVIATE_PORT}}/v1/objects" \\
+  -H "Content-Type: application/json" \\
+  -d '{"class": "Document", "properties": {"content": "Hello world"}, "vector": [0.1, 0.2, 0.3]}'
+\`\`\`
+
+### Hybrid search (vector + keyword)
+\`\`\`bash
+curl -X POST "http://{{WEAVIATE_HOST}}:{{WEAVIATE_PORT}}/v1/graphql" \\
+  -H "Content-Type: application/json" \\
+  -d '{"query": "{ Get { Document(hybrid: { query: \\"hello\\" alpha: 0.5 }) { content _additional { score } } } }"}'
+\`\`\`
+
+## Usage Notes
+
+- Weaviate supports hybrid search combining BM25 keyword search with vector similarity.
+- Use the alpha parameter to balance between keyword (0.0) and vector (1.0) search.
+- GraphQL API provides flexible querying with filters, aggregations, and cross-references.
 `
 };
 /**
@@ -758,4 +1068,4 @@ Object.defineProperty(exports, "generateSkillFiles", {
 	}
 });
 
-//# sourceMappingURL=skills-BSF7iNa4.cjs.map
+//# sourceMappingURL=skills-uPxJVmKk.cjs.map

package/dist/skills-uPxJVmKk.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-uPxJVmKk.cjs","names":["Handlebars"],"sources":["../src/generators/skills.ts"],"sourcesContent":["import Handlebars from \"handlebars\";\nimport type { ResolverOutput } from \"../types.js\";\n\n/**\n * Basic skill templates keyed by skillId.\n *\n * Templates use Handlebars `{{VAR}}` syntax. Variables are resolved from the\n * service's `openclawEnvVars` array at generation time.\n */\nconst skillTemplates: Record<string, string> = {\n\t\"agent-browse\": `---\nname: agent-browse\ndescription: \"AI-optimized browser automation with snapshot + ref workflow for deterministic element targeting\"\nmetadata:\n  openclaw:\n    emoji: \"🌍\"\n---\n\n# Agent Browser\n\nAI-optimized headless browser available at \\`{{AGENT_BROWSER_HOST}}\\` with CDP on port \\`{{AGENT_BROWSER_CDP_PORT}}\\` and live viewport streaming on port \\`{{AGENT_BROWSER_STREAM_PORT}}\\`.\n\n## Core Workflow: Snapshot → Reason → Act\n\nAgent Browser uses a **ref-based workflow** designed for LLMs. Each interactive element gets a deterministic ref like \\`@e1\\`, \\`@e2\\` that you can target directly — no CSS selectors needed.\n\n1. **Navigate:** \\`agent-browser open https://example.com\\`\n2. **Snapshot:** \\`agent-browser snapshot\\` → returns accessibility tree with refs\n3. **Reason:** Identify the target element by its ref (e.g. \\`@e5\\` is the search input)\n4. **Act:** \\`agent-browser click @e5\\` or \\`agent-browser type @e5 \"search query\"\\`\n5. **Verify:** \\`agent-browser screenshot\\` to capture the result\n\n## Key Commands\n\n| Command | Description |\n|---------|-------------|\n| \\`agent-browser open <url>\\` | Navigate to a URL |\n| \\`agent-browser snapshot\\` | Get accessibility tree with @refs |\n| \\`agent-browser click @ref\\` | Click an element by ref |\n| \\`agent-browser type @ref \"text\"\\` | Type text into an input |\n| \\`agent-browser select @ref \"value\"\\` | Select a dropdown option |\n| \\`agent-browser screenshot [--path file.png]\\` | Capture viewport screenshot |\n| \\`agent-browser scroll down\\\\|up\\` | Scroll the viewport |\n| \\`agent-browser wait <selector\\\\|ms>\\` | Wait for element or time |\n| \\`agent-browser extract\\` | Extract page content as clean text |\n| \\`agent-browser pdf [--path file.pdf]\\` | Save page as PDF |\n\n## Snapshot Output Example\n\n\\`\\`\\`\n@e1 heading \"Welcome to Example\"\n@e2 link \"Sign In\" [href=\"/login\"]\n@e3 input[text] \"Search...\" [placeholder]\n@e4 button \"Search\"\n@e5 link \"Learn More\" [href=\"/docs\"]\n\\`\\`\\`\n\nEach \\`@ref\\` is stable within a page state — use it directly: \\`agent-browser click @e2\\`\n\n## Content Boundaries\n\nOutput is wrapped in boundary markers (\\`---CONTENT_START---\\` / \\`---CONTENT_END---\\`) to prevent prompt injection from page content. This is enabled by default.\n\n## Session Persistence\n\n\\`\\`\\`bash\n# Save/restore login state across sessions\nagent-browser --session-name my-app open https://app.example.com\nagent-browser --session-name my-app snapshot\n\\`\\`\\`\n\n## Live Viewport Streaming\n\nWebSocket stream at \\`ws://{{AGENT_BROWSER_HOST}}:{{AGENT_BROWSER_STREAM_PORT}}\\` for real-time viewport watching (pair browsing). Receives JPEG frames with metadata.\n\n## Security\n\n- **Domain allowlist:** Set \\`AGENT_BROWSER_ALLOWED_DOMAINS\\` to restrict navigation\n- **Action policies:** JSON policy files to require confirmation for specific action categories\n- **Content boundaries:** Prevent LLM prompt injection from page content\n`,\n\n\t\"redis-cache\": `---\nname: redis-cache\ndescription: \"Cache data and manage key-value state using Redis\"\nmetadata:\n  openclaw:\n    emoji: \"🔴\"\n---\n\n# Redis Cache\n\nUse Redis as a high-performance in-memory cache and key-value store.\n\n## Connection Details\n\n- **Host:** \\`{{REDIS_HOST}}\\`\n- **Port:** \\`{{REDIS_PORT}}\\`\n\n## Example Commands\n\n### Set a value\n\\`\\`\\`bash\nredis-cli -h {{REDIS_HOST}} -p {{REDIS_PORT}} -a $REDIS_PASSWORD SET mykey \"myvalue\"\n\\`\\`\\`\n\n### Get a value\n\\`\\`\\`bash\nredis-cli -h {{REDIS_HOST}} -p {{REDIS_PORT}} -a $REDIS_PASSWORD GET mykey\n\\`\\`\\`\n\n### List all keys\n\\`\\`\\`bash\nredis-cli -h {{REDIS_HOST}} -p {{REDIS_PORT}} -a $REDIS_PASSWORD KEYS \"*\"\n\\`\\`\\`\n\n## Usage Notes\n\n- Use Redis for caching frequently accessed data, session storage, and pub/sub messaging.\n- Data is persisted to disk via RDB snapshots in the mounted volume.\n- Password authentication is required.\n`,\n\n\t\"qdrant-memory\": `---\nname: qdrant-memory\ndescription: \"Store and retrieve vector embeddings for semantic search and RAG\"\nmetadata:\n  openclaw:\n    emoji: \"🧠\"\n---\n\n# Qdrant Memory\n\nUse Qdrant as a vector database for storing embeddings, enabling semantic search and retrieval-augmented generation (RAG).\n\n## Connection Details\n\n- **Host:** \\`{{QDRANT_HOST}}\\`\n- **Port:** \\`{{QDRANT_PORT}}\\` (REST API)\n\n## Example API Calls\n\n### Create a collection\n\\`\\`\\`bash\ncurl -X PUT \"http://{{QDRANT_HOST}}:{{QDRANT_PORT}}/collections/my_collection\" \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"vectors\": {\"size\": 384, \"distance\": \"Cosine\"}}'\n\\`\\`\\`\n\n### Upsert points\n\\`\\`\\`bash\ncurl -X PUT \"http://{{QDRANT_HOST}}:{{QDRANT_PORT}}/collections/my_collection/points\" \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"points\": [{\"id\": 1, \"vector\": [0.1, 0.2, ...], \"payload\": {\"text\": \"hello\"}}]}'\n\\`\\`\\`\n\n### Search similar vectors\n\\`\\`\\`bash\ncurl -X POST \"http://{{QDRANT_HOST}}:{{QDRANT_PORT}}/collections/my_collection/points/search\" \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"vector\": [0.1, 0.2, ...], \"limit\": 5}'\n\\`\\`\\`\n\n## Usage Notes\n\n- Use 384-dimensional vectors for MiniLM-based embeddings or 1536 for OpenAI ada-002.\n- Qdrant supports filtering, batch operations, and named vectors.\n`,\n\n\t\"n8n-trigger\": `---\nname: n8n-trigger\ndescription: \"Trigger and manage automation workflows using n8n\"\nmetadata:\n  openclaw:\n    emoji: \"🔄\"\n---\n\n# n8n Workflow Trigger\n\nUse n8n to create, trigger, and manage automation workflows via its REST API.\n\n## Connection Details\n\n- **Host:** \\`{{N8N_HOST}}\\`\n- **Port:** \\`{{N8N_PORT}}\\`\n- **Webhook URL:** \\`{{N8N_WEBHOOK_URL}}\\`\n\n## Example API Calls\n\n### Trigger a webhook workflow\n\\`\\`\\`bash\ncurl -X POST \"{{N8N_WEBHOOK_URL}}webhook/<your-webhook-id>\" \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"message\": \"Hello from OpenClaw\"}'\n\\`\\`\\`\n\n### List workflows\n\\`\\`\\`bash\ncurl -X GET \"http://{{N8N_HOST}}:{{N8N_PORT}}/api/v1/workflows\" \\\\\n  -H \"Content-Type: application/json\"\n\\`\\`\\`\n\n### Activate a workflow\n\\`\\`\\`bash\ncurl -X PATCH \"http://{{N8N_HOST}}:{{N8N_PORT}}/api/v1/workflows/<id>\" \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"active\": true}'\n\\`\\`\\`\n\n## Usage Notes\n\n- Create workflows in the n8n UI at http://{{N8N_HOST}}:{{N8N_PORT}}.\n- Webhook nodes allow external triggers from OpenClaw.\n- n8n stores workflow state in PostgreSQL.\n`,\n\n\t\"ffmpeg-process\": `---\nname: ffmpeg-process\ndescription: \"Process media files using FFmpeg for transcoding, conversion, and manipulation\"\nmetadata:\n  openclaw:\n    emoji: \"🎬\"\n---\n\n# FFmpeg Media Processing\n\nUse FFmpeg for video/audio transcoding, format conversion, and media manipulation.\n\n## Shared Directory\n\n- **Media directory:** \\`{{FFMPEG_SHARED_DIR}}\\`\n\n## Example Commands\n\n### Convert video to MP4\n\\`\\`\\`bash\ndocker exec ffmpeg ffmpeg -i /data/input.avi -c:v libx264 -c:a aac /data/output.mp4\n\\`\\`\\`\n\n### Extract audio from video\n\\`\\`\\`bash\ndocker exec ffmpeg ffmpeg -i /data/video.mp4 -vn -acodec libmp3lame /data/audio.mp3\n\\`\\`\\`\n\n### Create thumbnail from video\n\\`\\`\\`bash\ndocker exec ffmpeg ffmpeg -i /data/video.mp4 -ss 00:00:05 -vframes 1 /data/thumb.jpg\n\\`\\`\\`\n\n### Resize video\n\\`\\`\\`bash\ndocker exec ffmpeg ffmpeg -i /data/input.mp4 -vf scale=1280:720 /data/output_720p.mp4\n\\`\\`\\`\n\n## Usage Notes\n\n- Place input files in the shared media directory.\n- FFmpeg runs as a sidecar container sharing a volume with OpenClaw.\n- Output files appear in the same shared directory.\n`,\n\n\t\"minio-storage\": `---\nname: minio-storage\ndescription: \"Store and retrieve files using S3-compatible object storage\"\nmetadata:\n  openclaw:\n    emoji: \"💾\"\n---\n\n# MinIO Object Storage\n\nUse MinIO as S3-compatible object storage for files, assets, and backups.\n\n## Connection Details\n\n- **Host:** \\`{{MINIO_HOST}}\\`\n- **API Port:** \\`{{MINIO_PORT}}\\`\n- **Access Key:** Uses \\`MINIO_ACCESS_KEY\\` env var\n- **Secret Key:** Uses \\`MINIO_SECRET_KEY\\` env var\n\n## Example API Calls\n\n### Create a bucket\n\\`\\`\\`bash\nmc alias set local http://{{MINIO_HOST}}:{{MINIO_PORT}} $MINIO_ACCESS_KEY $MINIO_SECRET_KEY\nmc mb local/my-bucket\n\\`\\`\\`\n\n### Upload a file\n\\`\\`\\`bash\nmc cp /path/to/file.txt local/my-bucket/file.txt\n\\`\\`\\`\n\n### Download a file\n\\`\\`\\`bash\nmc cp local/my-bucket/file.txt /path/to/local/file.txt\n\\`\\`\\`\n\n### List bucket contents\n\\`\\`\\`bash\nmc ls local/my-bucket/\n\\`\\`\\`\n\n## Usage Notes\n\n- MinIO is fully S3-compatible—use any S3 SDK or CLI.\n- Access the web console at http://{{MINIO_HOST}}:9001 for a visual file browser.\n- Create separate buckets for different data types (assets, backups, uploads).\n`,\n\n\t\"browserless-browse\": `---\nname: browserless-browse\ndescription: \"Automate browser interactions, scrape web pages, and generate PDFs\"\nmetadata:\n  openclaw:\n    emoji: \"🌐\"\n---\n\n# Browserless Browser Automation\n\nUse Browserless for headless Chrome browser automation, web scraping, screenshots, and PDF generation.\n\n## Connection Details\n\n- **Host:** \\`{{BROWSERLESS_HOST}}\\`\n- **Port:** \\`{{BROWSERLESS_PORT}}\\`\n- **Token:** Uses \\`BROWSERLESS_TOKEN\\` env var\n\n## Example API Calls\n\n### Take a screenshot\n\\`\\`\\`bash\ncurl -X POST \"http://{{BROWSERLESS_HOST}}:{{BROWSERLESS_PORT}}/screenshot?token=$BROWSERLESS_TOKEN\" \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"url\": \"https://example.com\", \"options\": {\"fullPage\": true}}' \\\\\n  --output screenshot.png\n\\`\\`\\`\n\n### Generate a PDF\n\\`\\`\\`bash\ncurl -X POST \"http://{{BROWSERLESS_HOST}}:{{BROWSERLESS_PORT}}/pdf?token=$BROWSERLESS_TOKEN\" \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"url\": \"https://example.com\"}' \\\\\n  --output page.pdf\n\\`\\`\\`\n\n### Scrape page content\n\\`\\`\\`bash\ncurl -X POST \"http://{{BROWSERLESS_HOST}}:{{BROWSERLESS_PORT}}/content?token=$BROWSERLESS_TOKEN\" \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"url\": \"https://example.com\"}'\n\\`\\`\\`\n\n## Usage Notes\n\n- Browserless manages a pool of Chrome instances (max concurrent sessions configured via env).\n- Token authentication is required for all API calls.\n- Supports Puppeteer and Playwright WebSocket connections.\n`,\n\n\t\"searxng-search\": `---\nname: searxng-search\ndescription: \"Search the web using a privacy-respecting metasearch engine\"\nmetadata:\n  openclaw:\n    emoji: \"🔍\"\n---\n\n# SearXNG Web Search\n\nUse SearXNG as a privacy-respecting metasearch engine to query the web.\n\n## Connection Details\n\n- **Host:** \\`{{SEARXNG_HOST}}\\`\n- **Port:** \\`{{SEARXNG_PORT}}\\`\n\n## Example API Calls\n\n### Search the web\n\\`\\`\\`bash\ncurl \"http://{{SEARXNG_HOST}}:{{SEARXNG_PORT}}/search?q=your+search+query&format=json\"\n\\`\\`\\`\n\n### Search with category filter\n\\`\\`\\`bash\ncurl \"http://{{SEARXNG_HOST}}:{{SEARXNG_PORT}}/search?q=openai&categories=it&format=json\"\n\\`\\`\\`\n\n### Search with language filter\n\\`\\`\\`bash\ncurl \"http://{{SEARXNG_HOST}}:{{SEARXNG_PORT}}/search?q=hello&language=en&format=json\"\n\\`\\`\\`\n\n## Usage Notes\n\n- Always use \\`format=json\\` for machine-readable results.\n- Available categories: general, images, videos, news, map, music, it, science, files.\n- SearXNG aggregates results from many search engines without tracking.\n`,\n\n\t\"whisper-transcribe\": `---\nname: whisper-transcribe\ndescription: \"Transcribe audio files to text using Faster Whisper\"\nmetadata:\n  openclaw:\n    emoji: \"🎙️\"\n---\n\n# Whisper Transcription\n\nUse the Faster Whisper server for speech-to-text transcription.\n\n## Connection Details\n\n- **Host:** \\`{{WHISPER_HOST}}\\`\n- **Port:** \\`{{WHISPER_PORT}}\\`\n\n## Example API Calls\n\n### Transcribe an audio file\n\\`\\`\\`bash\ncurl -X POST \"http://{{WHISPER_HOST}}:{{WHISPER_PORT}}/v1/audio/transcriptions\" \\\\\n  -F \"file=@/path/to/audio.mp3\" \\\\\n  -F \"model=base\"\n\\`\\`\\`\n\n### Transcribe with language hint\n\\`\\`\\`bash\ncurl -X POST \"http://{{WHISPER_HOST}}:{{WHISPER_PORT}}/v1/audio/transcriptions\" \\\\\n  -F \"file=@/path/to/audio.wav\" \\\\\n  -F \"model=base\" \\\\\n  -F \"language=en\"\n\\`\\`\\`\n\n### Get available models\n\\`\\`\\`bash\ncurl \"http://{{WHISPER_HOST}}:{{WHISPER_PORT}}/v1/models\"\n\\`\\`\\`\n\n## Usage Notes\n\n- Supports MP3, WAV, FLAC, and other common audio formats.\n- Model sizes: tiny, base, small, medium, large (larger = more accurate but slower).\n- GPU acceleration significantly improves transcription speed.\n`,\n\n\t\"ollama-local-llm\": `---\nname: ollama-local-llm\ndescription: \"Run local language models for text generation, chat, and embeddings\"\nmetadata:\n  openclaw:\n    emoji: \"🦙\"\n---\n\n# Ollama Local LLM\n\nUse Ollama to run large language models locally for text generation, chat, and embeddings.\n\n## Connection Details\n\n- **Host:** \\`{{OLLAMA_HOST}}\\`\n- **Port:** \\`{{OLLAMA_PORT}}\\`\n\n## Example API Calls\n\n### Generate text\n\\`\\`\\`bash\ncurl -X POST \"http://{{OLLAMA_HOST}}:{{OLLAMA_PORT}}/api/generate\" \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"model\": \"llama3.2\", \"prompt\": \"Explain quantum computing in simple terms\"}'\n\\`\\`\\`\n\n### Chat completion\n\\`\\`\\`bash\ncurl -X POST \"http://{{OLLAMA_HOST}}:{{OLLAMA_PORT}}/api/chat\" \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"model\": \"llama3.2\", \"messages\": [{\"role\": \"user\", \"content\": \"Hello!\"}]}'\n\\`\\`\\`\n\n### Pull a model\n\\`\\`\\`bash\ncurl -X POST \"http://{{OLLAMA_HOST}}:{{OLLAMA_PORT}}/api/pull\" \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"name\": \"llama3.2\"}'\n\\`\\`\\`\n\n### Generate embeddings\n\\`\\`\\`bash\ncurl -X POST \"http://{{OLLAMA_HOST}}:{{OLLAMA_PORT}}/api/embeddings\" \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"model\": \"nomic-embed-text\", \"prompt\": \"Hello world\"}'\n\\`\\`\\`\n\n## Usage Notes\n\n- Pull models before first use (they are cached in the persistent volume).\n- Recommended models: llama3.2 (general), codellama (code), nomic-embed-text (embeddings).\n- GPU passthrough dramatically improves inference speed.\n- The Ollama API is OpenAI-compatible at /v1/ endpoints.\n`,\n\n\t\"remotion-render\": `---\nname: remotion-render\ndescription: \"Create and render videos programmatically using React\"\nmetadata:\n  openclaw:\n    emoji: \"🎥\"\n---\n\n# Remotion Video Rendering\n\nUse Remotion Studio to create and render videos programmatically with React.\n\n## Connection Details\n\n- **Host:** \\`{{REMOTION_HOST}}\\`\n- **Port:** \\`{{REMOTION_PORT}}\\`\n\n## Example Usage\n\n### Access the Studio UI\nOpen \\`http://{{REMOTION_HOST}}:{{REMOTION_PORT}}\\` in your browser to use the Remotion Studio visual editor.\n\n### Render a video via CLI\n\\`\\`\\`bash\ndocker exec remotion npx remotion render src/index.tsx MyComposition out/video.mp4\n\\`\\`\\`\n\n### Render with custom props\n\\`\\`\\`bash\ndocker exec remotion npx remotion render src/index.tsx MyComposition out/video.mp4 \\\\\n  --props='{\"title\": \"Hello World\"}'\n\\`\\`\\`\n\n## Usage Notes\n\n- Define video compositions in React components.\n- Remotion supports MP4, WebM, and GIF output formats.\n- Use the Studio UI for previewing before rendering.\n- Combine with FFmpeg for post-processing.\n`,\n\n\t\"lightpanda-browse\": `---\nname: lightpanda-browse\ndescription: \"Browse the web using the ultra-fast LightPanda headless browser via CDP\"\nmetadata:\n  openclaw:\n    emoji: \"🐼\"\n---\n\n# LightPanda Browse\n\nLightPanda is an ultra-fast headless browser available via CDP WebSocket at \\`ws://{{LIGHTPANDA_HOST}}:{{LIGHTPANDA_PORT}}\\`.\n\n## Connect via Puppeteer\n\n\\`\\`\\`javascript\nconst browser = await puppeteer.connect({\n  browserWSEndpoint: \"ws://{{LIGHTPANDA_HOST}}:{{LIGHTPANDA_PORT}}\"\n});\nconst page = await browser.newPage();\nawait page.goto('https://example.com');\nconst content = await page.evaluate(() => document.body.innerText);\n\\`\\`\\`\n\n## Key Advantages\n\n- 9x less memory than Chrome (ideal for parallel scraping)\n- 11x faster page loading\n- Instant startup\n- Full CDP compatibility with Puppeteer and Playwright\n`,\n\n\t\"steel-browse\": `---\nname: steel-browse\ndescription: \"Browse the web using Steel Browser API with session management and anti-detection\"\nmetadata:\n  openclaw:\n    emoji: \"🔥\"\n---\n\n# Steel Browser\n\nSteel provides a REST API at \\`http://{{STEEL_HOST}}:{{STEEL_PORT}}\\` for AI agent web automation.\n\n## Create a Session\n\n\\`\\`\\`bash\ncurl -X POST http://{{STEEL_HOST}}:{{STEEL_PORT}}/v1/sessions \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"blockAds\": true}'\n\\`\\`\\`\n\n## Scrape a Page\n\n\\`\\`\\`bash\ncurl -X POST http://{{STEEL_HOST}}:{{STEEL_PORT}}/v1/scrape \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"url\": \"https://example.com\", \"format\": \"markdown\"}'\n\\`\\`\\`\n\n## Features\n\n- Session management with persistent cookies\n- Anti-detection and stealth plugins\n- Proxy support and IP rotation\n- Auto CAPTCHA solving\n- Puppeteer/Playwright/Selenium compatible\n`,\n\n\t\"code-sandbox\": `---\nname: code-sandbox\ndescription: \"Execute code safely in an isolated OpenSandbox container\"\nmetadata:\n  openclaw:\n    emoji: \"📦\"\n---\n\n# Code Sandbox\n\nExecute code safely in an isolated OpenSandbox container.\n\n## Description\n\nThis skill provides secure, containerized code execution for AI agents. Code runs in ephemeral Docker containers with resource limits, network isolation, and automatic cleanup.\n\n## Connection Details\n\n- **Host:** \\`{{OPENSANDBOX_HOST}}\\`\n- **Port:** \\`{{OPENSANDBOX_PORT}}\\`\n- **Auth:** API key (auto-configured)\n\n## Supported Languages\n\n- Python 3.12\n- JavaScript / TypeScript (Node.js 22)\n- Java 21\n- Go 1.24\n- Bash\n\n## Available Actions\n\n### execute_code\n\nRun a code snippet in a fresh sandbox.\n\n**Parameters:**\n- \\`language\\` (required): Programming language (\"python\", \"javascript\", \"typescript\", \"java\", \"go\", \"bash\")\n- \\`code\\` (required): The code to execute\n- \\`timeout_seconds\\` (optional): Max execution time (default: 60, max: 300)\n\n**Returns:** stdout, stderr, exit_code, execution_time_ms\n\n### execute_shell\n\nRun a shell command in an existing or new sandbox.\n\n**Parameters:**\n- \\`command\\` (required): Shell command to execute\n- \\`sandbox_id\\` (optional): Reuse an existing sandbox (for multi-step workflows)\n- \\`background\\` (optional): Run in background (default: false)\n\n**Returns:** stdout, stderr, exit_code\n\n### upload_file\n\nUpload a file to a sandbox for processing.\n\n**Parameters:**\n- \\`sandbox_id\\` (required): Target sandbox\n- \\`path\\` (required): Destination path inside sandbox\n- \\`content\\` (required): File content (text or base64 for binary)\n\n### download_file\n\nDownload a file from a sandbox.\n\n**Parameters:**\n- \\`sandbox_id\\` (required): Source sandbox\n- \\`path\\` (required): File path inside sandbox\n\n**Returns:** File content\n\n### list_sandboxes\n\nList active sandboxes on this instance.\n\n**Returns:** Array of { id, status, image, created_at, expires_at }\n\n### terminate_sandbox\n\nTerminate a running sandbox immediately.\n\n**Parameters:**\n- \\`sandbox_id\\` (required): Sandbox to terminate\n\n### create_desktop\n\nCreate a GUI desktop sandbox with VNC access (for Homespace live preview).\n\n**Parameters:**\n- \\`image\\` (optional): Desktop image (default: \"opensandbox/desktop:latest\", also: \"opensandbox/chrome:latest\", \"opensandbox/vscode:latest\")\n- \\`resolution\\` (optional): Screen resolution (default: \"1280x800x24\")\n\n**Returns:** sandbox_id, vnc_endpoint (port 5900), novnc_url (port 6080 WebSocket), devtools_url (port 9222, chrome only)\n\n### get_preview_url\n\nGet the browser-accessible noVNC URL for an existing desktop sandbox.\n\n**Parameters:**\n- \\`sandbox_id\\` (required): Desktop sandbox ID\n\n**Returns:** novnc_url (embeddable in iframe), vnc_endpoint, status\n\n## Examples\n\n### Run Python code\n\n\\`\\`\\`bash\ncurl -X POST http://{{OPENSANDBOX_HOST}}:{{OPENSANDBOX_PORT}}/v1/sandboxes \\\\\n  -H \"Authorization: Bearer $OPENSANDBOX_API_KEY\" \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"image\": \"opensandbox/code-interpreter:python\"}'\n\\`\\`\\`\n\n### Execute code in a sandbox\n\n\\`\\`\\`bash\ncurl -X POST http://{{OPENSANDBOX_HOST}}:{{OPENSANDBOX_PORT}}/v1/sandboxes/{id}/code \\\\\n  -H \"Authorization: Bearer $OPENSANDBOX_API_KEY\" \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"language\": \"python\", \"code\": \"print(42 * 42)\"}'\n\\`\\`\\`\n\n## Configuration\n\n- **Default timeout:** 60 seconds\n- **Max concurrent sandboxes:** Determined by VPS RAM\n- **Idle cleanup:** Sandboxes with no activity for 30 minutes are auto-terminated\n- **Network:** Bridge mode (isolated from host services)\n- **Security:** gVisor runtime, capability dropping, PID limits\n\n## Limitations\n\n- No persistent storage between sandbox sessions (ephemeral by design)\n- No GPU access (CPU-only execution)\n- No outbound network access by default (egress blocked)\n- Max 512 PIDs per sandbox (fork bomb protection)\n- Memory capped per sandbox (default 512MB)\n`,\n\n\t\"mem0-memory\": `---\nname: mem0-memory\ndescription: \"Store and retrieve long-term memories for AI agents using Mem0\"\nmetadata:\n  openclaw:\n    emoji: \"🧠\"\n---\n\n# Mem0 AI Memory\n\nUse Mem0 as a long-term memory layer for AI agents. Mem0 automatically extracts, stores, and retrieves memories across conversations using pgvector embeddings and Neo4j knowledge graphs.\n\n## Connection Details\n\n- **Host:** \\`{{MEM0_HOST}}\\`\n- **Port:** \\`{{MEM0_PORT}}\\`\n\n## Example API Calls\n\n### Add a memory\n\\`\\`\\`bash\ncurl -X POST \"http://{{MEM0_HOST}}:{{MEM0_PORT}}/v1/memories/\" \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"messages\": [{\"role\": \"user\", \"content\": \"I prefer dark mode in all applications\"}], \"user_id\": \"agent-1\"}'\n\\`\\`\\`\n\n### Search memories\n\\`\\`\\`bash\ncurl -X POST \"http://{{MEM0_HOST}}:{{MEM0_PORT}}/v1/memories/search/\" \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"query\": \"What are the user preferences?\", \"user_id\": \"agent-1\"}'\n\\`\\`\\`\n\n### Get all memories for a user\n\\`\\`\\`bash\ncurl \"http://{{MEM0_HOST}}:{{MEM0_PORT}}/v1/memories/?user_id=agent-1\"\n\\`\\`\\`\n\n### Delete a memory\n\\`\\`\\`bash\ncurl -X DELETE \"http://{{MEM0_HOST}}:{{MEM0_PORT}}/v1/memories/<memory_id>/\"\n\\`\\`\\`\n\n## Usage Notes\n\n- Mem0 automatically extracts facts and preferences from conversation messages.\n- Memories are stored as vector embeddings in pgvector and as entity relationships in Neo4j.\n- Use \\`user_id\\` to isolate memories per agent or per conversation context.\n- Mem0 handles deduplication and conflict resolution automatically.\n`,\n\n\t\"memu-memory\": `---\nname: memu-memory\ndescription: \"Persistent memory framework for proactive AI agents using MemU\"\nmetadata:\n  openclaw:\n    emoji: \"🧠\"\n---\n\n# MemU Persistent Memory\n\nUse MemU as a persistent memory framework for 24/7 proactive AI agents. MemU extracts structured memory from multimodal inputs and organizes it into a hierarchical knowledge graph.\n\n## Connection Details\n\n- **Host:** \\`{{MEMU_HOST}}\\`\n- **Port:** \\`{{MEMU_PORT}}\\`\n\n## Example API Calls\n\n### Store a memory\n\\`\\`\\`bash\ncurl -X POST \"http://{{MEMU_HOST}}:{{MEMU_PORT}}/api/v1/memories\" \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"content\": \"User prefers TypeScript over JavaScript\", \"agent_id\": \"agent-1\", \"type\": \"preference\"}'\n\\`\\`\\`\n\n### Recall memories\n\\`\\`\\`bash\ncurl -X POST \"http://{{MEMU_HOST}}:{{MEMU_PORT}}/api/v1/recall\" \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"query\": \"What programming languages does the user prefer?\", \"agent_id\": \"agent-1\"}'\n\\`\\`\\`\n\n### Get memory graph\n\\`\\`\\`bash\ncurl \"http://{{MEMU_HOST}}:{{MEMU_PORT}}/api/v1/graph?agent_id=agent-1\"\n\\`\\`\\`\n\n## Usage Notes\n\n- MemU organizes memories into a hierarchical knowledge graph backed by pgvector.\n- Supports multimodal inputs (text, images, structured data).\n- Use \\`agent_id\\` to partition memories across different agents.\n`,\n\n\t\"hindsight-memory\": `---\nname: hindsight-memory\ndescription: \"Agent memory with Retain/Recall/Reflect operations using Hindsight\"\nmetadata:\n  openclaw:\n    emoji: \"🧠\"\n---\n\n# Hindsight Agent Memory\n\nUse Hindsight for agent memory with three core operations: Retain (store), Recall (retrieve), and Reflect (synthesize). Supports multi-strategy retrieval including semantic, keyword, graph, and temporal search.\n\n## Connection Details\n\n- **Host:** \\`{{HINDSIGHT_HOST}}\\`\n- **Port:** \\`{{HINDSIGHT_API_PORT}}\\`\n\n## Example API Calls\n\n### Retain (store a memory)\n\\`\\`\\`bash\ncurl -X POST \"http://{{HINDSIGHT_HOST}}:{{HINDSIGHT_API_PORT}}/api/v1/retain\" \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"namespace\": \"agent-1\", \"content\": \"The deployment uses Kubernetes on AWS EKS\", \"metadata\": {\"source\": \"conversation\"}}'\n\\`\\`\\`\n\n### Recall (retrieve memories)\n\\`\\`\\`bash\ncurl -X POST \"http://{{HINDSIGHT_HOST}}:{{HINDSIGHT_API_PORT}}/api/v1/recall\" \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"namespace\": \"agent-1\", \"query\": \"What infrastructure is used?\", \"strategies\": [\"semantic\", \"keyword\"], \"limit\": 5}'\n\\`\\`\\`\n\n### Reflect (synthesize memories)\n\\`\\`\\`bash\ncurl -X POST \"http://{{HINDSIGHT_HOST}}:{{HINDSIGHT_API_PORT}}/api/v1/reflect\" \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"namespace\": \"agent-1\", \"query\": \"Summarize all infrastructure decisions\"}'\n\\`\\`\\`\n\n## MCP Integration\n\nHindsight also exposes an MCP server. Configure your agent to connect via:\n\\`\\`\\`\nhttp://{{HINDSIGHT_HOST}}:{{HINDSIGHT_API_PORT}}/mcp\n\\`\\`\\`\n\n## Usage Notes\n\n- Use namespaces to isolate memories per agent, project, or session.\n- Retrieval strategies: semantic (embedding similarity), keyword (BM25), graph (entity relationships), temporal (time-based).\n- The Reflect operation uses LLM-powered synthesis to generate insights from stored memories.\n`,\n\n\t\"chromadb-memory\": `---\nname: chromadb-memory\ndescription: \"Store and retrieve vector embeddings using ChromaDB\"\nmetadata:\n  openclaw:\n    emoji: \"🎨\"\n---\n\n# ChromaDB Vector Memory\n\nUse ChromaDB as a vector database for storing embeddings, enabling semantic search and retrieval-augmented generation (RAG).\n\n## Connection Details\n\n- **Host:** \\`{{CHROMADB_HOST}}\\`\n- **Port:** \\`{{CHROMADB_PORT}}\\`\n\n## Example API Calls\n\n### Create a collection\n\\`\\`\\`bash\ncurl -X POST \"http://{{CHROMADB_HOST}}:{{CHROMADB_PORT}}/api/v1/collections\" \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"name\": \"my_collection\", \"metadata\": {\"hnsw:space\": \"cosine\"}}'\n\\`\\`\\`\n\n### Add documents\n\\`\\`\\`bash\ncurl -X POST \"http://{{CHROMADB_HOST}}:{{CHROMADB_PORT}}/api/v1/collections/<collection_id>/add\" \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"ids\": [\"doc1\"], \"documents\": [\"Hello world\"], \"metadatas\": [{\"source\": \"test\"}]}'\n\\`\\`\\`\n\n### Query similar documents\n\\`\\`\\`bash\ncurl -X POST \"http://{{CHROMADB_HOST}}:{{CHROMADB_PORT}}/api/v1/collections/<collection_id>/query\" \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"query_texts\": [\"greeting\"], \"n_results\": 5}'\n\\`\\`\\`\n\n## Usage Notes\n\n- ChromaDB can auto-generate embeddings from documents if configured with an embedding function.\n- Supports metadata filtering on queries for precise retrieval.\n- Collections are isolated namespaces for different data domains.\n`,\n\n\t\"weaviate-memory\": `---\nname: weaviate-memory\ndescription: \"Store and search vectors with hybrid search using Weaviate\"\nmetadata:\n  openclaw:\n    emoji: \"🔷\"\n---\n\n# Weaviate Vector Memory\n\nUse Weaviate for vector storage with built-in hybrid search (combining vector similarity and keyword/BM25 search) and a GraphQL API.\n\n## Connection Details\n\n- **Host:** \\`{{WEAVIATE_HOST}}\\`\n- **Port:** \\`{{WEAVIATE_PORT}}\\`\n\n## Example API Calls\n\n### Create a class (schema)\n\\`\\`\\`bash\ncurl -X POST \"http://{{WEAVIATE_HOST}}:{{WEAVIATE_PORT}}/v1/schema\" \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"class\": \"Document\", \"vectorizer\": \"none\", \"properties\": [{\"name\": \"content\", \"dataType\": [\"text\"]}]}'\n\\`\\`\\`\n\n### Add an object with vector\n\\`\\`\\`bash\ncurl -X POST \"http://{{WEAVIATE_HOST}}:{{WEAVIATE_PORT}}/v1/objects\" \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"class\": \"Document\", \"properties\": {\"content\": \"Hello world\"}, \"vector\": [0.1, 0.2, 0.3]}'\n\\`\\`\\`\n\n### Hybrid search (vector + keyword)\n\\`\\`\\`bash\ncurl -X POST \"http://{{WEAVIATE_HOST}}:{{WEAVIATE_PORT}}/v1/graphql\" \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"query\": \"{ Get { Document(hybrid: { query: \\\\\"hello\\\\\" alpha: 0.5 }) { content _additional { score } } } }\"}'\n\\`\\`\\`\n\n## Usage Notes\n\n- Weaviate supports hybrid search combining BM25 keyword search with vector similarity.\n- Use the alpha parameter to balance between keyword (0.0) and vector (1.0) search.\n- GraphQL API provides flexible querying with filters, aggregations, and cross-references.\n`,\n};\n\n/**\n * Generates SKILL.md files for each service that has skills defined.\n *\n * Returns a map of file paths (relative to project root) to file contents.\n * Handlebars is used to replace `{{VAR}}` placeholders with actual values\n * from each service's `openclawEnvVars`.\n */\nexport function generateSkillFiles(resolved: ResolverOutput): Record<string, string> {\n\tconst files: Record<string, string> = {};\n\n\tfor (const { definition } of resolved.services) {\n\t\tif (definition.skills.length === 0) continue;\n\n\t\t// Build a variable map from openclawEnvVars for Handlebars\n\t\tconst vars: Record<string, string> = {};\n\t\tfor (const envVar of definition.openclawEnvVars) {\n\t\t\t// Resolve ${REFERENCES} to the default value (just strip the ${} wrapper)\n\t\t\tconst val = envVar.defaultValue.startsWith(\"${\")\n\t\t\t\t? envVar.defaultValue.slice(2, -1)\n\t\t\t\t: envVar.defaultValue;\n\t\t\tvars[envVar.key] = val;\n\t\t}\n\n\t\tfor (const skill of definition.skills) {\n\t\t\tconst template = skillTemplates[skill.skillId];\n\t\t\tif (!template) {\n\t\t\t\t// Generate a generic skill file if no template exists\n\t\t\t\tconst generic = generateGenericSkill(\n\t\t\t\t\tskill.skillId,\n\t\t\t\t\tdefinition.name,\n\t\t\t\t\tdefinition.icon,\n\t\t\t\t\tdefinition.description,\n\t\t\t\t\tvars,\n\t\t\t\t);\n\t\t\t\tfiles[`openclaw/workspace/skills/${skill.skillId}/SKILL.md`] = generic;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst compiled = Handlebars.compile(template, { noEscape: true });\n\t\t\tconst rendered = compiled(vars);\n\t\t\tfiles[`openclaw/workspace/skills/${skill.skillId}/SKILL.md`] = rendered;\n\t\t}\n\t}\n\n\treturn files;\n}\n\n/**\n * Generate a generic SKILL.md for skills that don't have a dedicated template.\n */\nfunction generateGenericSkill(\n\tskillId: string,\n\tserviceName: string,\n\ticon: string,\n\tdescription: string,\n\tvars: Record<string, string>,\n): string {\n\tconst title = skillId\n\t\t.split(\"-\")\n\t\t.map((w) => w.charAt(0).toUpperCase() + w.slice(1))\n\t\t.join(\" \");\n\n\tconst envSection = Object.entries(vars)\n\t\t.map(([key, value]) => `- **${key}:** \\`${value}\\``)\n\t\t.join(\"\\n\");\n\n\treturn `---\nname: ${skillId}\ndescription: \"${description}\"\nmetadata:\n  openclaw:\n    emoji: \"${icon}\"\n---\n\n# ${title}\n\nInteract with ${serviceName} through this skill.\n\n## Connection Details\n\n${envSection || \"No specific connection variables configured.\"}\n\n## Usage Notes\n\n- This skill provides OpenClaw access to ${serviceName}.\n- Refer to the service documentation for available API endpoints.\n`;\n}\n"],"mappings":"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"}

package/dist/{test.CTcmp4Su-ClCHJ3FA.mjs → test.CTcmp4Su-BRa7-bTj.mjs}

@@ -13182,6 +13182,6 @@ function getImporter(name) {
 	}) + 1])?.file || "";
 }
 //#endregion
-export { describe as n, it as r, globalExpect as t };
+export { describe as a, beforeEach as i, vi as n, it as o, afterEach as r, globalExpect as t };
 
-//# sourceMappingURL=test.CTcmp4Su-ClCHJ3FA.mjs.map
+//# sourceMappingURL=test.CTcmp4Su-BRa7-bTj.mjs.map