@better-openclaw/core 1.0.16 → 1.0.18

package/dist/generators/skills.cjs

@@ -0,0 +1,590 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_chunk = require('../chunk-C0xms8kb.cjs');
+let handlebars = require("handlebars");
+handlebars = require_chunk.__toESM(handlebars);
+
+//#region src/generators/skills.ts
+/**
+* Basic skill templates keyed by skillId.
+*
+* Templates use Handlebars `{{VAR}}` syntax. Variables are resolved from the
+* service's `openclawEnvVars` array at generation time.
+*/
+const skillTemplates = {
+	"redis-cache": `---
+name: redis-cache
+description: "Cache data and manage key-value state using Redis"
+metadata:
+  openclaw:
+    emoji: "🔴"
+---
+
+# Redis Cache
+
+Use Redis as a high-performance in-memory cache and key-value store.
+
+## Connection Details
+
+- **Host:** \`{{REDIS_HOST}}\`
+- **Port:** \`{{REDIS_PORT}}\`
+
+## Example Commands
+
+### Set a value
+\`\`\`bash
+redis-cli -h {{REDIS_HOST}} -p {{REDIS_PORT}} -a $REDIS_PASSWORD SET mykey "myvalue"
+\`\`\`
+
+### Get a value
+\`\`\`bash
+redis-cli -h {{REDIS_HOST}} -p {{REDIS_PORT}} -a $REDIS_PASSWORD GET mykey
+\`\`\`
+
+### List all keys
+\`\`\`bash
+redis-cli -h {{REDIS_HOST}} -p {{REDIS_PORT}} -a $REDIS_PASSWORD KEYS "*"
+\`\`\`
+
+## Usage Notes
+
+- Use Redis for caching frequently accessed data, session storage, and pub/sub messaging.
+- Data is persisted to disk via RDB snapshots in the mounted volume.
+- Password authentication is required.
+`,
+	"qdrant-memory": `---
+name: qdrant-memory
+description: "Store and retrieve vector embeddings for semantic search and RAG"
+metadata:
+  openclaw:
+    emoji: "🧠"
+---
+
+# Qdrant Memory
+
+Use Qdrant as a vector database for storing embeddings, enabling semantic search and retrieval-augmented generation (RAG).
+
+## Connection Details
+
+- **Host:** \`{{QDRANT_HOST}}\`
+- **Port:** \`{{QDRANT_PORT}}\` (REST API)
+
+## Example API Calls
+
+### Create a collection
+\`\`\`bash
+curl -X PUT "http://{{QDRANT_HOST}}:{{QDRANT_PORT}}/collections/my_collection" \\
+  -H "Content-Type: application/json" \\
+  -d '{"vectors": {"size": 384, "distance": "Cosine"}}'
+\`\`\`
+
+### Upsert points
+\`\`\`bash
+curl -X PUT "http://{{QDRANT_HOST}}:{{QDRANT_PORT}}/collections/my_collection/points" \\
+  -H "Content-Type: application/json" \\
+  -d '{"points": [{"id": 1, "vector": [0.1, 0.2, ...], "payload": {"text": "hello"}}]}'
+\`\`\`
+
+### Search similar vectors
+\`\`\`bash
+curl -X POST "http://{{QDRANT_HOST}}:{{QDRANT_PORT}}/collections/my_collection/points/search" \\
+  -H "Content-Type: application/json" \\
+  -d '{"vector": [0.1, 0.2, ...], "limit": 5}'
+\`\`\`
+
+## Usage Notes
+
+- Use 384-dimensional vectors for MiniLM-based embeddings or 1536 for OpenAI ada-002.
+- Qdrant supports filtering, batch operations, and named vectors.
+`,
+	"n8n-trigger": `---
+name: n8n-trigger
+description: "Trigger and manage automation workflows using n8n"
+metadata:
+  openclaw:
+    emoji: "🔄"
+---
+
+# n8n Workflow Trigger
+
+Use n8n to create, trigger, and manage automation workflows via its REST API.
+
+## Connection Details
+
+- **Host:** \`{{N8N_HOST}}\`
+- **Port:** \`{{N8N_PORT}}\`
+- **Webhook URL:** \`{{N8N_WEBHOOK_URL}}\`
+
+## Example API Calls
+
+### Trigger a webhook workflow
+\`\`\`bash
+curl -X POST "{{N8N_WEBHOOK_URL}}webhook/<your-webhook-id>" \\
+  -H "Content-Type: application/json" \\
+  -d '{"message": "Hello from OpenClaw"}'
+\`\`\`
+
+### List workflows
+\`\`\`bash
+curl -X GET "http://{{N8N_HOST}}:{{N8N_PORT}}/api/v1/workflows" \\
+  -H "Content-Type: application/json"
+\`\`\`
+
+### Activate a workflow
+\`\`\`bash
+curl -X PATCH "http://{{N8N_HOST}}:{{N8N_PORT}}/api/v1/workflows/<id>" \\
+  -H "Content-Type: application/json" \\
+  -d '{"active": true}'
+\`\`\`
+
+## Usage Notes
+
+- Create workflows in the n8n UI at http://{{N8N_HOST}}:{{N8N_PORT}}.
+- Webhook nodes allow external triggers from OpenClaw.
+- n8n stores workflow state in PostgreSQL.
+`,
+	"ffmpeg-process": `---
+name: ffmpeg-process
+description: "Process media files using FFmpeg for transcoding, conversion, and manipulation"
+metadata:
+  openclaw:
+    emoji: "🎬"
+---
+
+# FFmpeg Media Processing
+
+Use FFmpeg for video/audio transcoding, format conversion, and media manipulation.
+
+## Shared Directory
+
+- **Media directory:** \`{{FFMPEG_SHARED_DIR}}\`
+
+## Example Commands
+
+### Convert video to MP4
+\`\`\`bash
+docker exec ffmpeg ffmpeg -i /data/input.avi -c:v libx264 -c:a aac /data/output.mp4
+\`\`\`
+
+### Extract audio from video
+\`\`\`bash
+docker exec ffmpeg ffmpeg -i /data/video.mp4 -vn -acodec libmp3lame /data/audio.mp3
+\`\`\`
+
+### Create thumbnail from video
+\`\`\`bash
+docker exec ffmpeg ffmpeg -i /data/video.mp4 -ss 00:00:05 -vframes 1 /data/thumb.jpg
+\`\`\`
+
+### Resize video
+\`\`\`bash
+docker exec ffmpeg ffmpeg -i /data/input.mp4 -vf scale=1280:720 /data/output_720p.mp4
+\`\`\`
+
+## Usage Notes
+
+- Place input files in the shared media directory.
+- FFmpeg runs as a sidecar container sharing a volume with OpenClaw.
+- Output files appear in the same shared directory.
+`,
+	"minio-storage": `---
+name: minio-storage
+description: "Store and retrieve files using S3-compatible object storage"
+metadata:
+  openclaw:
+    emoji: "💾"
+---
+
+# MinIO Object Storage
+
+Use MinIO as S3-compatible object storage for files, assets, and backups.
+
+## Connection Details
+
+- **Host:** \`{{MINIO_HOST}}\`
+- **API Port:** \`{{MINIO_PORT}}\`
+- **Access Key:** Uses \`MINIO_ACCESS_KEY\` env var
+- **Secret Key:** Uses \`MINIO_SECRET_KEY\` env var
+
+## Example API Calls
+
+### Create a bucket
+\`\`\`bash
+mc alias set local http://{{MINIO_HOST}}:{{MINIO_PORT}} $MINIO_ACCESS_KEY $MINIO_SECRET_KEY
+mc mb local/my-bucket
+\`\`\`
+
+### Upload a file
+\`\`\`bash
+mc cp /path/to/file.txt local/my-bucket/file.txt
+\`\`\`
+
+### Download a file
+\`\`\`bash
+mc cp local/my-bucket/file.txt /path/to/local/file.txt
+\`\`\`
+
+### List bucket contents
+\`\`\`bash
+mc ls local/my-bucket/
+\`\`\`
+
+## Usage Notes
+
+- MinIO is fully S3-compatible—use any S3 SDK or CLI.
+- Access the web console at http://{{MINIO_HOST}}:9001 for a visual file browser.
+- Create separate buckets for different data types (assets, backups, uploads).
+`,
+	"browserless-browse": `---
+name: browserless-browse
+description: "Automate browser interactions, scrape web pages, and generate PDFs"
+metadata:
+  openclaw:
+    emoji: "🌐"
+---
+
+# Browserless Browser Automation
+
+Use Browserless for headless Chrome browser automation, web scraping, screenshots, and PDF generation.
+
+## Connection Details
+
+- **Host:** \`{{BROWSERLESS_HOST}}\`
+- **Port:** \`{{BROWSERLESS_PORT}}\`
+- **Token:** Uses \`BROWSERLESS_TOKEN\` env var
+
+## Example API Calls
+
+### Take a screenshot
+\`\`\`bash
+curl -X POST "http://{{BROWSERLESS_HOST}}:{{BROWSERLESS_PORT}}/screenshot?token=$BROWSERLESS_TOKEN" \\
+  -H "Content-Type: application/json" \\
+  -d '{"url": "https://example.com", "options": {"fullPage": true}}' \\
+  --output screenshot.png
+\`\`\`
+
+### Generate a PDF
+\`\`\`bash
+curl -X POST "http://{{BROWSERLESS_HOST}}:{{BROWSERLESS_PORT}}/pdf?token=$BROWSERLESS_TOKEN" \\
+  -H "Content-Type: application/json" \\
+  -d '{"url": "https://example.com"}' \\
+  --output page.pdf
+\`\`\`
+
+### Scrape page content
+\`\`\`bash
+curl -X POST "http://{{BROWSERLESS_HOST}}:{{BROWSERLESS_PORT}}/content?token=$BROWSERLESS_TOKEN" \\
+  -H "Content-Type: application/json" \\
+  -d '{"url": "https://example.com"}'
+\`\`\`
+
+## Usage Notes
+
+- Browserless manages a pool of Chrome instances (max concurrent sessions configured via env).
+- Token authentication is required for all API calls.
+- Supports Puppeteer and Playwright WebSocket connections.
+`,
+	"searxng-search": `---
+name: searxng-search
+description: "Search the web using a privacy-respecting metasearch engine"
+metadata:
+  openclaw:
+    emoji: "🔍"
+---
+
+# SearXNG Web Search
+
+Use SearXNG as a privacy-respecting metasearch engine to query the web.
+
+## Connection Details
+
+- **Host:** \`{{SEARXNG_HOST}}\`
+- **Port:** \`{{SEARXNG_PORT}}\`
+
+## Example API Calls
+
+### Search the web
+\`\`\`bash
+curl "http://{{SEARXNG_HOST}}:{{SEARXNG_PORT}}/search?q=your+search+query&format=json"
+\`\`\`
+
+### Search with category filter
+\`\`\`bash
+curl "http://{{SEARXNG_HOST}}:{{SEARXNG_PORT}}/search?q=openai&categories=it&format=json"
+\`\`\`
+
+### Search with language filter
+\`\`\`bash
+curl "http://{{SEARXNG_HOST}}:{{SEARXNG_PORT}}/search?q=hello&language=en&format=json"
+\`\`\`
+
+## Usage Notes
+
+- Always use \`format=json\` for machine-readable results.
+- Available categories: general, images, videos, news, map, music, it, science, files.
+- SearXNG aggregates results from many search engines without tracking.
+`,
+	"whisper-transcribe": `---
+name: whisper-transcribe
+description: "Transcribe audio files to text using Faster Whisper"
+metadata:
+  openclaw:
+    emoji: "🎙️"
+---
+
+# Whisper Transcription
+
+Use the Faster Whisper server for speech-to-text transcription.
+
+## Connection Details
+
+- **Host:** \`{{WHISPER_HOST}}\`
+- **Port:** \`{{WHISPER_PORT}}\`
+
+## Example API Calls
+
+### Transcribe an audio file
+\`\`\`bash
+curl -X POST "http://{{WHISPER_HOST}}:{{WHISPER_PORT}}/v1/audio/transcriptions" \\
+  -F "file=@/path/to/audio.mp3" \\
+  -F "model=base"
+\`\`\`
+
+### Transcribe with language hint
+\`\`\`bash
+curl -X POST "http://{{WHISPER_HOST}}:{{WHISPER_PORT}}/v1/audio/transcriptions" \\
+  -F "file=@/path/to/audio.wav" \\
+  -F "model=base" \\
+  -F "language=en"
+\`\`\`
+
+### Get available models
+\`\`\`bash
+curl "http://{{WHISPER_HOST}}:{{WHISPER_PORT}}/v1/models"
+\`\`\`
+
+## Usage Notes
+
+- Supports MP3, WAV, FLAC, and other common audio formats.
+- Model sizes: tiny, base, small, medium, large (larger = more accurate but slower).
+- GPU acceleration significantly improves transcription speed.
+`,
+	"ollama-local-llm": `---
+name: ollama-local-llm
+description: "Run local language models for text generation, chat, and embeddings"
+metadata:
+  openclaw:
+    emoji: "🦙"
+---
+
+# Ollama Local LLM
+
+Use Ollama to run large language models locally for text generation, chat, and embeddings.
+
+## Connection Details
+
+- **Host:** \`{{OLLAMA_HOST}}\`
+- **Port:** \`{{OLLAMA_PORT}}\`
+
+## Example API Calls
+
+### Generate text
+\`\`\`bash
+curl -X POST "http://{{OLLAMA_HOST}}:{{OLLAMA_PORT}}/api/generate" \\
+  -H "Content-Type: application/json" \\
+  -d '{"model": "llama3.2", "prompt": "Explain quantum computing in simple terms"}'
+\`\`\`
+
+### Chat completion
+\`\`\`bash
+curl -X POST "http://{{OLLAMA_HOST}}:{{OLLAMA_PORT}}/api/chat" \\
+  -H "Content-Type: application/json" \\
+  -d '{"model": "llama3.2", "messages": [{"role": "user", "content": "Hello!"}]}'
+\`\`\`
+
+### Pull a model
+\`\`\`bash
+curl -X POST "http://{{OLLAMA_HOST}}:{{OLLAMA_PORT}}/api/pull" \\
+  -H "Content-Type: application/json" \\
+  -d '{"name": "llama3.2"}'
+\`\`\`
+
+### Generate embeddings
+\`\`\`bash
+curl -X POST "http://{{OLLAMA_HOST}}:{{OLLAMA_PORT}}/api/embeddings" \\
+  -H "Content-Type: application/json" \\
+  -d '{"model": "nomic-embed-text", "prompt": "Hello world"}'
+\`\`\`
+
+## Usage Notes
+
+- Pull models before first use (they are cached in the persistent volume).
+- Recommended models: llama3.2 (general), codellama (code), nomic-embed-text (embeddings).
+- GPU passthrough dramatically improves inference speed.
+- The Ollama API is OpenAI-compatible at /v1/ endpoints.
+`,
+	"remotion-render": `---
+name: remotion-render
+description: "Create and render videos programmatically using React"
+metadata:
+  openclaw:
+    emoji: "🎥"
+---
+
+# Remotion Video Rendering
+
+Use Remotion Studio to create and render videos programmatically with React.
+
+## Connection Details
+
+- **Host:** \`{{REMOTION_HOST}}\`
+- **Port:** \`{{REMOTION_PORT}}\`
+
+## Example Usage
+
+### Access the Studio UI
+Open \`http://{{REMOTION_HOST}}:{{REMOTION_PORT}}\` in your browser to use the Remotion Studio visual editor.
+
+### Render a video via CLI
+\`\`\`bash
+docker exec remotion npx remotion render src/index.tsx MyComposition out/video.mp4
+\`\`\`
+
+### Render with custom props
+\`\`\`bash
+docker exec remotion npx remotion render src/index.tsx MyComposition out/video.mp4 \\
+  --props='{"title": "Hello World"}'
+\`\`\`
+
+## Usage Notes
+
+- Define video compositions in React components.
+- Remotion supports MP4, WebM, and GIF output formats.
+- Use the Studio UI for previewing before rendering.
+- Combine with FFmpeg for post-processing.
+`,
+	"lightpanda-browse": `---
+name: lightpanda-browse
+description: "Browse the web using the ultra-fast LightPanda headless browser via CDP"
+metadata:
+  openclaw:
+    emoji: "🐼"
+---
+
+# LightPanda Browse
+
+LightPanda is an ultra-fast headless browser available via CDP WebSocket at \`ws://{{LIGHTPANDA_HOST}}:{{LIGHTPANDA_PORT}}\`.
+
+## Connect via Puppeteer
+
+\`\`\`javascript
+const browser = await puppeteer.connect({
+  browserWSEndpoint: "ws://{{LIGHTPANDA_HOST}}:{{LIGHTPANDA_PORT}}"
+});
+const page = await browser.newPage();
+await page.goto('https://example.com');
+const content = await page.evaluate(() => document.body.innerText);
+\`\`\`
+
+## Key Advantages
+
+- 9x less memory than Chrome (ideal for parallel scraping)
+- 11x faster page loading
+- Instant startup
+- Full CDP compatibility with Puppeteer and Playwright
+`,
+	"steel-browse": `---
+name: steel-browse
+description: "Browse the web using Steel Browser API with session management and anti-detection"
+metadata:
+  openclaw:
+    emoji: "🔥"
+---
+
+# Steel Browser
+
+Steel provides a REST API at \`http://{{STEEL_HOST}}:{{STEEL_PORT}}\` for AI agent web automation.
+
+## Create a Session
+
+\`\`\`bash
+curl -X POST http://{{STEEL_HOST}}:{{STEEL_PORT}}/v1/sessions \\
+  -H "Content-Type: application/json" \\
+  -d '{"blockAds": true}'
+\`\`\`
+
+## Scrape a Page
+
+\`\`\`bash
+curl -X POST http://{{STEEL_HOST}}:{{STEEL_PORT}}/v1/scrape \\
+  -H "Content-Type: application/json" \\
+  -d '{"url": "https://example.com", "format": "markdown"}'
+\`\`\`
+
+## Features
+
+- Session management with persistent cookies
+- Anti-detection and stealth plugins
+- Proxy support and IP rotation
+- Auto CAPTCHA solving
+- Puppeteer/Playwright/Selenium compatible
+`
+};
+/**
+* Generates SKILL.md files for each service that has skills defined.
+*
+* Returns a map of file paths (relative to project root) to file contents.
+* Handlebars is used to replace `{{VAR}}` placeholders with actual values
+* from each service's `openclawEnvVars`.
+*/
+function generateSkillFiles(resolved) {
+	const files = {};
+	for (const { definition } of resolved.services) {
+		if (definition.skills.length === 0) continue;
+		const vars = {};
+		for (const envVar of definition.openclawEnvVars) {
+			const val = envVar.defaultValue.startsWith("${") ? envVar.defaultValue.slice(2, -1) : envVar.defaultValue;
+			vars[envVar.key] = val;
+		}
+		for (const skill of definition.skills) {
+			const template = skillTemplates[skill.skillId];
+			if (!template) {
+				const generic = generateGenericSkill(skill.skillId, definition.name, definition.icon, definition.description, vars);
+				files[`openclaw/workspace/skills/${skill.skillId}/SKILL.md`] = generic;
+				continue;
+			}
+			const rendered = handlebars.default.compile(template, { noEscape: true })(vars);
+			files[`openclaw/workspace/skills/${skill.skillId}/SKILL.md`] = rendered;
+		}
+	}
+	return files;
+}
+/**
+* Generate a generic SKILL.md for skills that don't have a dedicated template.
+*/
+function generateGenericSkill(skillId, serviceName, icon, description, vars) {
+	return `---
+name: ${skillId}
+description: "${description}"
+metadata:
+  openclaw:
+    emoji: "${icon}"
+---
+
+# ${skillId.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ")}
+
+Interact with ${serviceName} through this skill.
+
+## Connection Details
+
+${Object.entries(vars).map(([key, value]) => `- **${key}:** \`${value}\``).join("\n") || "No specific connection variables configured."}
+
+## Usage Notes
+
+- This skill provides OpenClaw access to ${serviceName}.
+- Refer to the service documentation for available API endpoints.
+`;
+}
+
+//#endregion
+exports.generateSkillFiles = generateSkillFiles;
+//# sourceMappingURL=skills.cjs.map

package/dist/generators/skills.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.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\"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\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":";;;;;;;;;;;;AASA,MAAM,iBAAyC;CAC9C,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCf,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8CjB,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+Cf,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6ClB,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiDjB,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkDtB,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyClB,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8CtB,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuDpB,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCnB,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BrB,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoChB;;;;;;;;AASD,SAAgB,mBAAmB,UAAkD;CACpF,MAAM,QAAgC,EAAE;AAExC,MAAK,MAAM,EAAE,gBAAgB,SAAS,UAAU;AAC/C,MAAI,WAAW,OAAO,WAAW,EAAG;EAGpC,MAAM,OAA+B,EAAE;AACvC,OAAK,MAAM,UAAU,WAAW,iBAAiB;GAEhD,MAAM,MAAM,OAAO,aAAa,WAAW,KAAK,GAC7C,OAAO,aAAa,MAAM,GAAG,GAAG,GAChC,OAAO;AACV,QAAK,OAAO,OAAO;;AAGpB,OAAK,MAAM,SAAS,WAAW,QAAQ;GACtC,MAAM,WAAW,eAAe,MAAM;AACtC,OAAI,CAAC,UAAU;IAEd,MAAM,UAAU,qBACf,MAAM,SACN,WAAW,MACX,WAAW,MACX,WAAW,aACX,KACA;AACD,UAAM,6BAA6B,MAAM,QAAQ,cAAc;AAC/D;;GAID,MAAM,WADWA,mBAAW,QAAQ,UAAU,EAAE,UAAU,MAAM,CAAC,CACvC,KAAK;AAC/B,SAAM,6BAA6B,MAAM,QAAQ,cAAc;;;AAIjE,QAAO;;;;;AAMR,SAAS,qBACR,SACA,aACA,MACA,aACA,MACS;AAUT,QAAO;QACA,QAAQ;gBACA,YAAY;;;cAGd,KAAK;;;IAdJ,QACZ,MAAM,IAAI,CACV,KAAK,MAAM,EAAE,OAAO,EAAE,CAAC,aAAa,GAAG,EAAE,MAAM,EAAE,CAAC,CAClD,KAAK,IAAI,CAcF;;gBAEM,YAAY;;;;EAdR,OAAO,QAAQ,KAAK,CACrC,KAAK,CAAC,KAAK,WAAW,OAAO,IAAI,QAAQ,MAAM,IAAI,CACnD,KAAK,KAAK,IAgBG,+CAA+C;;;;2CAIpB,YAAY"}

package/dist/generators/skills.d.cts

@@ -0,0 +1,14 @@
+import { ResolverOutput } from "../types.cjs";
+
+//#region src/generators/skills.d.ts
+/**
+ * Generates SKILL.md files for each service that has skills defined.
+ *
+ * Returns a map of file paths (relative to project root) to file contents.
+ * Handlebars is used to replace `{{VAR}}` placeholders with actual values
+ * from each service's `openclawEnvVars`.
+ */
+declare function generateSkillFiles(resolved: ResolverOutput): Record<string, string>;
+//#endregion
+export { generateSkillFiles };
+//# sourceMappingURL=skills.d.cts.map

package/dist/generators/skills.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.cts","names":[],"sources":["../../src/generators/skills.ts"],"mappings":";;;;;AAmiBA;;;;;iBAAgB,kBAAA,CAAmB,QAAA,EAAU,cAAA,GAAiB,MAAA"}