@better-openclaw/core 1.0.0

package/src/services/definitions/n8n.ts

@@ -0,0 +1,153 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const n8nDefinition: ServiceDefinition = {
+	id: "n8n",
+	name: "n8n",
+	description:
+		"Workflow automation platform for connecting services, building integrations, and automating tasks with a visual node-based editor.",
+	category: "automation",
+	icon: "🔄",
+
+	image: "docker.n8n.io/n8nio/n8n",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 5678,
+			container: 5678,
+			description: "n8n web interface and API",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "n8n-data",
+			containerPath: "/home/node/.n8n",
+			description: "Persistent n8n data and workflows",
+		},
+	],
+	environment: [
+		{
+			key: "N8N_BASIC_AUTH_ACTIVE",
+			defaultValue: "true",
+			secret: false,
+			description: "Enable basic authentication for n8n",
+			required: true,
+		},
+		{
+			key: "N8N_BASIC_AUTH_USER",
+			defaultValue: "admin",
+			secret: false,
+			description: "Basic auth username for n8n",
+			required: true,
+		},
+		{
+			key: "N8N_BASIC_AUTH_PASSWORD",
+			defaultValue: "",
+			secret: true,
+			description: "Basic auth password for n8n",
+			required: true,
+		},
+		{
+			key: "DB_TYPE",
+			defaultValue: "postgresdb",
+			secret: false,
+			description: "Database type for n8n persistence",
+			required: true,
+		},
+		{
+			key: "DB_POSTGRESDB_HOST",
+			defaultValue: "postgresql",
+			secret: false,
+			description: "PostgreSQL hostname",
+			required: true,
+		},
+		{
+			key: "DB_POSTGRESDB_PORT",
+			defaultValue: "5432",
+			secret: false,
+			description: "PostgreSQL port",
+			required: true,
+		},
+		{
+			key: "DB_POSTGRESDB_DATABASE",
+			defaultValue: "n8n",
+			secret: false,
+			description: "PostgreSQL database name for n8n",
+			required: true,
+		},
+		{
+			key: "DB_POSTGRESDB_USER",
+			defaultValue: "n8n",
+			secret: false,
+			description: "PostgreSQL user for n8n",
+			required: true,
+		},
+		{
+			key: "DB_POSTGRESDB_PASSWORD",
+			defaultValue: "${N8N_DB_PASSWORD}",
+			secret: true,
+			description: "PostgreSQL password for n8n (references Postgres password)",
+			required: true,
+		},
+		{
+			key: "N8N_PORT",
+			defaultValue: "5678",
+			secret: false,
+			description: "Port n8n listens on",
+			required: true,
+		},
+		{
+			key: "WEBHOOK_URL",
+			defaultValue: "http://n8n:5678/",
+			secret: false,
+			description: "Base URL for n8n webhooks",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "wget -q --spider http://localhost:5678/healthz || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "30s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [{ skillId: "n8n-trigger", autoInstall: true }],
+	openclawEnvVars: [
+		{
+			key: "N8N_HOST",
+			defaultValue: "n8n",
+			secret: false,
+			description: "n8n hostname for OpenClaw",
+			required: true,
+		},
+		{
+			key: "N8N_PORT",
+			defaultValue: "5678",
+			secret: false,
+			description: "n8n port for OpenClaw",
+			required: true,
+		},
+		{
+			key: "N8N_WEBHOOK_URL",
+			defaultValue: "http://n8n:5678/",
+			secret: false,
+			description: "n8n webhook URL for OpenClaw",
+			required: true,
+		},
+	],
+
+	docsUrl: "https://docs.n8n.io/",
+	tags: ["workflow", "automation", "webhook", "integration"],
+	maturity: "stable",
+
+	requires: ["postgresql"],
+	recommends: ["redis"],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};

package/src/services/definitions/nocodb.ts

@@ -0,0 +1,46 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const nocodbDefinition: ServiceDefinition = {
+	id: "nocodb",
+	name: "NocoDB",
+	description:
+		"Open-source Airtable alternative. Turn any database into a smart spreadsheet with views, forms, and automation.",
+	category: "knowledge",
+	icon: "📊",
+
+	image: "nocodb/nocodb",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 8086,
+			container: 8080,
+			description: "NocoDB Web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "nocodb-data",
+			containerPath: "/usr/app/data",
+			description: "NocoDB persistent data and SQLite database",
+		},
+	],
+	environment: [],
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://docs.nocodb.com/",
+	tags: ["database", "spreadsheet", "airtable-alternative", "no-code", "forms"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/ntfy.ts

@@ -0,0 +1,68 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const ntfyDefinition: ServiceDefinition = {
+	id: "ntfy",
+	name: "ntfy",
+	description:
+		"Simple HTTP-based pub-sub notification service that lets you send push notifications to phones and desktops via PUT/POST requests.",
+	category: "communication",
+	icon: "📣",
+
+	image: "binwiederhier/ntfy",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 8084,
+			container: 80,
+			description: "ntfy web interface and API",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "ntfy-cache",
+			containerPath: "/var/cache/ntfy",
+			description: "ntfy message cache and attachment storage",
+		},
+	],
+	environment: [],
+	command: "serve",
+	healthcheck: {
+		test: "wget -q --spider http://localhost:80/v1/health || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [
+		{
+			key: "NTFY_HOST",
+			defaultValue: "ntfy",
+			secret: false,
+			description: "ntfy hostname for OpenClaw",
+			required: true,
+		},
+		{
+			key: "NTFY_PORT",
+			defaultValue: "8080",
+			secret: false,
+			description: "ntfy port for OpenClaw",
+			required: true,
+		},
+	],
+
+	docsUrl: "https://docs.ntfy.sh/",
+	tags: ["notifications", "pub-sub", "push", "http"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: ["gotify"],
+
+	minMemoryMB: 64,
+	gpuRequired: false,
+};

package/src/services/definitions/ollama.ts

@@ -0,0 +1,68 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const ollamaDefinition: ServiceDefinition = {
+	id: "ollama",
+	name: "Ollama",
+	description:
+		"Run large language models locally with an easy-to-use API. Supports a wide range of open-source models like Llama, Mistral, and more.",
+	category: "ai",
+	icon: "🦙",
+
+	image: "ollama/ollama",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 11434,
+			container: 11434,
+			description: "Ollama REST API",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "ollama-data",
+			containerPath: "/root/.ollama",
+			description: "Persistent Ollama model storage and configuration",
+		},
+	],
+	environment: [],
+	healthcheck: {
+		test: "curl -f http://localhost:11434/ || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "30s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [{ skillId: "ollama-local-llm", autoInstall: true }],
+	openclawEnvVars: [
+		{
+			key: "OLLAMA_HOST",
+			defaultValue: "ollama",
+			secret: false,
+			description: "Ollama hostname for OpenClaw",
+			required: true,
+		},
+		{
+			key: "OLLAMA_PORT",
+			defaultValue: "11434",
+			secret: false,
+			description: "Ollama API port for OpenClaw",
+			required: true,
+		},
+	],
+
+	docsUrl: "https://github.com/ollama/ollama",
+	tags: ["llm", "local-ai", "inference", "language-model"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 2048,
+	gpuRequired: false,
+};

package/src/services/definitions/open-webui.ts

@@ -0,0 +1,54 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const openWebuiDefinition: ServiceDefinition = {
+	id: "open-webui",
+	name: "Open WebUI",
+	description:
+		"Beautiful ChatGPT-like web interface for Ollama and other LLM providers. Features RAG, web search, and multi-user support.",
+	category: "ai-platform",
+	icon: "💬",
+
+	image: "ghcr.io/open-webui/open-webui",
+	imageTag: "main",
+	ports: [
+		{
+			host: 3080,
+			container: 8080,
+			description: "Open WebUI interface",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "open-webui-data",
+			containerPath: "/app/backend/data",
+			description: "Open WebUI data",
+		},
+	],
+	environment: [
+		{
+			key: "OLLAMA_BASE_URL",
+			defaultValue: "http://ollama:11434",
+			secret: false,
+			description: "Ollama API URL",
+			required: false,
+		},
+	],
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://docs.openwebui.com/",
+	tags: ["chat-ui", "ollama", "multi-model", "rag"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: ["ollama"],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/opencode.ts

@@ -0,0 +1,54 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const opencodeDefinition: ServiceDefinition = {
+	id: "opencode",
+	name: "OpenCode",
+	description:
+		"Open-source AI coding agent supporting 75+ LLM providers with a terminal-based UI and web interface for collaborative AI-assisted development.",
+	category: "coding-agent",
+	icon: "🐙",
+
+	image: "ghcr.io/opencode-ai/opencode",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 3030,
+			container: 3000,
+			description: "OpenCode Web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "opencode-config",
+			containerPath: "/home/coder/.opencode",
+			description: "OpenCode configuration and session data",
+		},
+	],
+	environment: [
+		{
+			key: "OPENCODE_SERVER_PASSWORD",
+			defaultValue: "",
+			secret: true,
+			description: "OpenCode server password",
+			required: false,
+		},
+	],
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://opencode.ai/docs",
+	tags: ["ai-coding", "open-source", "multi-model", "agent"],
+	maturity: "beta",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/openpanel.ts

@@ -0,0 +1,48 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const openpanelDefinition: ServiceDefinition = {
+	id: "openpanel",
+	name: "OpenPanel",
+	description:
+		"Open-source analytics platform with real-time dashboards and event tracking. Modern alternative for tracking user behavior and application metrics.",
+	category: "analytics",
+	icon: "📉",
+
+	image: "ghcr.io/openpanel-dev/openpanel",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 3060,
+			container: 3000,
+			description: "OpenPanel Web UI",
+			exposed: true,
+		},
+	],
+	volumes: [],
+	environment: [
+		{
+			key: "DATABASE_URL",
+			defaultValue: "postgresql://openpanel:${OPENPANEL_DB_PASSWORD}@postgresql:5432/openpanel",
+			secret: false,
+			description: "PostgreSQL connection string for OpenPanel",
+			required: true,
+		},
+	],
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://openpanel.dev/docs",
+	tags: ["analytics", "events", "real-time", "dashboards"],
+	maturity: "beta",
+
+	requires: [],
+	recommends: ["postgresql"],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/outline.ts

@@ -0,0 +1,75 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const outlineDefinition: ServiceDefinition = {
+	id: "outline",
+	name: "Outline",
+	description:
+		"Modern team wiki and knowledge base. Beautiful, fast, and collaborative. Self-hosted Notion alternative.",
+	category: "knowledge",
+	icon: "📝",
+
+	image: "outlinewiki/outline",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 3140,
+			container: 3000,
+			description: "Outline Web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "outline-data",
+			containerPath: "/var/lib/outline/data",
+			description: "Outline file storage",
+		},
+	],
+	environment: [
+		{
+			key: "SECRET_KEY",
+			defaultValue: "",
+			secret: true,
+			description: "Outline secret key for encrypting sessions and tokens",
+			required: true,
+		},
+		{
+			key: "UTILS_SECRET",
+			defaultValue: "",
+			secret: true,
+			description: "Outline utils secret for internal cryptographic operations",
+			required: true,
+		},
+		{
+			key: "DATABASE_URL",
+			defaultValue: "postgresql://outline:${OUTLINE_DB_PASSWORD}@postgresql:5432/outline",
+			secret: false,
+			description: "PostgreSQL connection string for Outline",
+			required: true,
+		},
+		{
+			key: "REDIS_URL",
+			defaultValue: "redis://:${REDIS_PASSWORD}@redis:6379",
+			secret: false,
+			description: "Redis connection string for caching and background jobs",
+			required: true,
+		},
+	],
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://www.getoutline.com/developers",
+	tags: ["wiki", "knowledge-base", "documentation", "team", "notion-alternative"],
+	maturity: "stable",
+
+	requires: ["postgresql", "redis"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/paperless-ngx.ts

@@ -0,0 +1,92 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const paperlessNgxDefinition: ServiceDefinition = {
+	id: "paperless-ngx",
+	name: "Paperless-ngx",
+	description:
+		"Document management system with OCR, AI-powered classification, and full-text search.",
+	category: "knowledge",
+	icon: "🗃️",
+
+	image: "ghcr.io/paperless-ngx/paperless-ngx",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 8010,
+			container: 8000,
+			description: "Paperless-ngx Web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "paperless-data",
+			containerPath: "/usr/src/paperless/data",
+			description: "Paperless application data and database",
+		},
+		{
+			name: "paperless-media",
+			containerPath: "/usr/src/paperless/media",
+			description: "Paperless stored and processed documents",
+		},
+		{
+			name: "paperless-consume",
+			containerPath: "/usr/src/paperless/consume",
+			description: "Paperless intake folder for automatic document ingestion",
+		},
+	],
+	environment: [
+		{
+			key: "PAPERLESS_SECRET_KEY",
+			defaultValue: "",
+			secret: true,
+			description: "Django secret key for cryptographic signing",
+			required: true,
+		},
+		{
+			key: "PAPERLESS_DBHOST",
+			defaultValue: "postgresql",
+			secret: false,
+			description: "PostgreSQL host for Paperless-ngx",
+			required: true,
+		},
+		{
+			key: "PAPERLESS_DBUSER",
+			defaultValue: "paperless",
+			secret: false,
+			description: "PostgreSQL user for Paperless-ngx",
+			required: true,
+		},
+		{
+			key: "PAPERLESS_DBPASS",
+			defaultValue: "${PAPERLESS_DB_PASSWORD}",
+			secret: true,
+			description: "PostgreSQL password for Paperless-ngx",
+			required: true,
+		},
+		{
+			key: "PAPERLESS_DBNAME",
+			defaultValue: "paperless",
+			secret: false,
+			description: "PostgreSQL database name for Paperless-ngx",
+			required: true,
+		},
+	],
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://docs.paperless-ngx.com/",
+	tags: ["documents", "ocr", "classification", "archive", "search"],
+	maturity: "stable",
+
+	requires: ["postgresql"],
+	recommends: ["redis"],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};

package/src/services/definitions/playwright-server.ts

@@ -0,0 +1,41 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const playwrightServerDefinition: ServiceDefinition = {
+	id: "playwright-server",
+	name: "Playwright Server",
+	description:
+		"Microsoft Playwright browser automation server for headless testing and web scraping.",
+	category: "browser",
+	icon: "🎭",
+
+	image: "mcr.microsoft.com/playwright",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 3040,
+			container: 3000,
+			description: "Playwright Server",
+			exposed: true,
+		},
+	],
+	volumes: [],
+	environment: [],
+	command: "npx playwright run-server --port 3000",
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://playwright.dev/docs/intro",
+	tags: ["browser", "testing", "automation", "scraping", "headless"],
+	maturity: "beta",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};