@better-openclaw/core 1.0.21 → 1.0.22

package/src/services/definitions/kong.ts

@@ -0,0 +1,116 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const kongDefinition: ServiceDefinition = {
+	id: "kong",
+	name: "Kong",
+	description:
+		"High-performance API gateway with plugins for rate limiting, authentication, load balancing, and request transformation.",
+	category: "api-gateway",
+	icon: "🔌",
+
+	image: "kong/kong-gateway",
+	imageTag: "3.9",
+	ports: [
+		{
+			host: 8001,
+			container: 8001,
+			description: "Kong Admin API",
+			exposed: true,
+		},
+		{
+			host: 8443,
+			container: 8443,
+			description: "Kong proxy HTTPS",
+			exposed: true,
+		},
+		{
+			host: 8002,
+			container: 8000,
+			description: "Kong proxy HTTP",
+			exposed: true,
+		},
+	],
+	volumes: [],
+	environment: [
+		{
+			key: "KONG_DATABASE",
+			defaultValue: "postgres",
+			secret: false,
+			description: "Database backend",
+			required: true,
+		},
+		{
+			key: "KONG_PG_HOST",
+			defaultValue: "postgresql",
+			secret: false,
+			description: "PostgreSQL host",
+			required: true,
+		},
+		{
+			key: "KONG_PG_DATABASE",
+			defaultValue: "kong",
+			secret: false,
+			description: "PostgreSQL database name",
+			required: true,
+		},
+		{
+			key: "KONG_PG_USER",
+			defaultValue: "kong",
+			secret: false,
+			description: "PostgreSQL username",
+			required: true,
+		},
+		{
+			key: "KONG_PG_PASSWORD",
+			defaultValue: "${KONG_DB_PASSWORD}",
+			secret: true,
+			description: "PostgreSQL password",
+			required: true,
+		},
+		{
+			key: "KONG_PROXY_ACCESS_LOG",
+			defaultValue: "/dev/stdout",
+			secret: false,
+			description: "Proxy access log output",
+			required: false,
+		},
+		{
+			key: "KONG_ADMIN_ACCESS_LOG",
+			defaultValue: "/dev/stdout",
+			secret: false,
+			description: "Admin access log output",
+			required: false,
+		},
+		{
+			key: "KONG_ADMIN_LISTEN",
+			defaultValue: "0.0.0.0:8001",
+			secret: false,
+			description: "Admin API listen address",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "kong health || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "30s",
+	},
+	dependsOn: ["postgresql"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://docs.konghq.com/gateway/latest/install/docker/",
+	tags: ["api", "gateway", "rate-limiting", "auth", "load-balancing", "proxy"],
+	maturity: "stable",
+
+	requires: ["postgresql"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/lago.ts

@@ -0,0 +1,95 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const lagoDefinition: ServiceDefinition = {
+	id: "lago",
+	name: "Lago",
+	description:
+		"Open-source usage-based billing engine for metered pricing, subscriptions, invoicing, and payment processing with Stripe integration.",
+	category: "billing",
+	icon: "💳",
+
+	image: "getlago/api",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 3036,
+			container: 3000,
+			description: "Lago API",
+			exposed: true,
+		},
+		{
+			host: 8081,
+			container: 80,
+			description: "Lago web UI (frontend)",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "lago-storage",
+			containerPath: "/app/storage",
+			description: "Lago uploaded files and invoices",
+		},
+	],
+	environment: [
+		{
+			key: "DATABASE_URL",
+			defaultValue: "postgresql://lago:${LAGO_DB_PASSWORD}@postgresql:5432/lago",
+			secret: true,
+			description: "PostgreSQL connection URL",
+			required: true,
+		},
+		{
+			key: "REDIS_URL",
+			defaultValue: "redis://:${REDIS_PASSWORD}@redis:6379",
+			secret: true,
+			description: "Redis connection URL",
+			required: true,
+		},
+		{
+			key: "SECRET_KEY_BASE",
+			defaultValue: "${LAGO_SECRET_KEY}",
+			secret: true,
+			description: "Rails secret key base",
+			required: true,
+		},
+		{
+			key: "LAGO_API_URL",
+			defaultValue: "http://localhost:3036",
+			secret: false,
+			description: "Public API URL",
+			required: true,
+		},
+		{
+			key: "LAGO_FRONT_URL",
+			defaultValue: "http://localhost:8081",
+			secret: false,
+			description: "Public frontend URL",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost:3000/health || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 5,
+		startPeriod: "45s",
+	},
+	dependsOn: ["postgresql", "redis"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://docs.getlago.com/guide/introduction/welcome-to-lago",
+	tags: ["billing", "payments", "metering", "subscriptions", "invoicing", "stripe"],
+	maturity: "stable",
+
+	requires: ["postgresql", "redis"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};

package/src/services/definitions/langflow.ts

@@ -0,0 +1,82 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const langflowDefinition: ServiceDefinition = {
+	id: "langflow",
+	name: "Langflow",
+	description:
+		"Visual low-code builder for LLM workflows, agents, retrieval pipelines, and tool orchestration using LangChain-compatible components.",
+	category: "ai-platform",
+	icon: "🧩",
+
+	image: "langflowai/langflow",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 7865,
+			container: 7860,
+			description: "Langflow web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "langflow-data",
+			containerPath: "/app/langflow",
+			description: "Langflow configuration, sqlite database, and uploads",
+		},
+	],
+	environment: [
+		{
+			key: "LANGFLOW_HOST",
+			defaultValue: "0.0.0.0",
+			secret: false,
+			description: "Host interface for Langflow",
+			required: true,
+		},
+		{
+			key: "LANGFLOW_PORT",
+			defaultValue: "7860",
+			secret: false,
+			description: "Langflow application port",
+			required: true,
+		},
+		{
+			key: "LANGFLOW_CONFIG_DIR",
+			defaultValue: "/app/langflow",
+			secret: false,
+			description: "Directory for Langflow state and configuration",
+			required: true,
+		},
+		{
+			key: "DO_NOT_TRACK",
+			defaultValue: "true",
+			secret: false,
+			description: "Disable telemetry",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost:7860/ || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 5,
+		startPeriod: "30s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://docs.langflow.org/",
+	tags: ["llm", "workflow-builder", "langchain", "agents", "rag", "visual-builder"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: ["qdrant", "postgresql", "ollama", "open-webui"],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};

package/src/services/definitions/langfuse.ts

@@ -0,0 +1,76 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const langfuseDefinition: ServiceDefinition = {
+	id: "langfuse",
+	name: "Langfuse",
+	description:
+		"Open-source LLM observability platform for tracing, evaluating, and debugging AI agent interactions with cost and latency tracking.",
+	category: "ai-observability",
+	icon: "🔭",
+
+	image: "langfuse/langfuse",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 3033,
+			container: 3000,
+			description: "Langfuse web UI",
+			exposed: true,
+		},
+	],
+	volumes: [],
+	environment: [
+		{
+			key: "DATABASE_URL",
+			defaultValue: "postgresql://langfuse:${LANGFUSE_DB_PASSWORD}@postgresql:5432/langfuse",
+			secret: true,
+			description: "PostgreSQL connection URL",
+			required: true,
+		},
+		{
+			key: "NEXTAUTH_SECRET",
+			defaultValue: "${LANGFUSE_NEXTAUTH_SECRET}",
+			secret: true,
+			description: "NextAuth.js secret for session signing",
+			required: true,
+		},
+		{
+			key: "NEXTAUTH_URL",
+			defaultValue: "http://localhost:3033",
+			secret: false,
+			description: "Public URL for NextAuth callbacks",
+			required: true,
+		},
+		{
+			key: "SALT",
+			defaultValue: "${LANGFUSE_SALT}",
+			secret: true,
+			description: "Salt for hashing API keys",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost:3000/api/public/health || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 5,
+		startPeriod: "30s",
+	},
+	dependsOn: ["postgresql"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://langfuse.com/docs/deployment/self-host",
+	tags: ["llm", "observability", "tracing", "ai", "debugging", "cost-tracking"],
+	maturity: "stable",
+
+	requires: ["postgresql"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};

package/src/services/definitions/listmonk.ts

@@ -0,0 +1,118 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const listmonkDefinition: ServiceDefinition = {
+	id: "listmonk",
+	name: "Listmonk",
+	description:
+		"Self-hosted newsletter and mailing list manager for product updates, lifecycle email, broadcasts, and audience segmentation.",
+	category: "communication",
+	icon: "📬",
+
+	image: "listmonk/listmonk",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 9018,
+			container: 9000,
+			description: "Listmonk admin UI and API",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "listmonk-uploads",
+			containerPath: "/listmonk/uploads",
+			description: "Uploaded assets and media for Listmonk campaigns",
+		},
+	],
+	environment: [
+		{
+			key: "LISTMONK_db__host",
+			defaultValue: "postgresql",
+			secret: false,
+			description: "PostgreSQL host",
+			required: true,
+		},
+		{
+			key: "LISTMONK_db__port",
+			defaultValue: "5432",
+			secret: false,
+			description: "PostgreSQL port",
+			required: true,
+		},
+		{
+			key: "LISTMONK_db__user",
+			defaultValue: "listmonk",
+			secret: false,
+			description: "PostgreSQL user",
+			required: true,
+		},
+		{
+			key: "LISTMONK_db__password",
+			defaultValue: "${LISTMONK_DB_PASSWORD}",
+			secret: true,
+			description: "PostgreSQL password",
+			required: true,
+		},
+		{
+			key: "LISTMONK_db__database",
+			defaultValue: "listmonk",
+			secret: false,
+			description: "PostgreSQL database name",
+			required: true,
+		},
+		{
+			key: "LISTMONK_db__ssl_mode",
+			defaultValue: "disable",
+			secret: false,
+			description: "PostgreSQL SSL mode",
+			required: true,
+		},
+		{
+			key: "LISTMONK_app__address",
+			defaultValue: "0.0.0.0:9000",
+			secret: false,
+			description: "Listmonk bind address",
+			required: true,
+		},
+		{
+			key: "LISTMONK_ADMIN_USER",
+			defaultValue: "admin",
+			secret: false,
+			description: "Initial Listmonk admin username",
+			required: false,
+		},
+		{
+			key: "LISTMONK_ADMIN_PASSWORD",
+			defaultValue: "${LISTMONK_ADMIN_PASSWORD}",
+			secret: true,
+			description: "Initial Listmonk admin password",
+			required: false,
+		},
+	],
+	command: `sh -c "./listmonk --install --idempotent --yes --config '' && ./listmonk --upgrade --yes --config '' && ./listmonk --config ''"`,
+	healthcheck: {
+		test: "curl -sf http://localhost:9000/ || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 5,
+		startPeriod: "45s",
+	},
+	dependsOn: ["postgresql"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://listmonk.app/docs/",
+	tags: ["newsletter", "email", "campaigns", "mailing-list", "marketing"],
+	maturity: "stable",
+
+	requires: ["postgresql"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/mariadb.ts

@@ -0,0 +1,82 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const mariadbDefinition: ServiceDefinition = {
+	id: "mariadb",
+	name: "MariaDB",
+	description:
+		"Community-developed relational database compatible with MySQL. Common backing store for self-hosted apps and control-plane services.",
+	category: "database",
+	icon: "🦭",
+
+	image: "mariadb",
+	imageTag: "11.8",
+	ports: [
+		{
+			host: 3307,
+			container: 3306,
+			description: "MariaDB server port",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "mariadb-data",
+			containerPath: "/var/lib/mysql",
+			description: "Persistent MariaDB data",
+		},
+	],
+	environment: [
+		{
+			key: "MARIADB_ROOT_PASSWORD",
+			defaultValue: "",
+			secret: true,
+			description: "MariaDB root password",
+			required: true,
+		},
+		{
+			key: "MARIADB_DATABASE",
+			defaultValue: "openclaw",
+			secret: false,
+			description: "Default database created on first run",
+			required: true,
+		},
+		{
+			key: "MARIADB_USER",
+			defaultValue: "openclaw",
+			secret: false,
+			description: "Default MariaDB user created on first run",
+			required: true,
+		},
+		{
+			key: "MARIADB_PASSWORD",
+			defaultValue: "",
+			secret: true,
+			description: "Password for the default MariaDB user",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "mariadb-admin ping -h 127.0.0.1 -u root -p$MARIADB_ROOT_PASSWORD || exit 1",
+		interval: "15s",
+		timeout: "5s",
+		retries: 5,
+		startPeriod: "30s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://mariadb.com/kb/en/docker-official-image-frequently-asked-questions/",
+	tags: ["sql", "mysql-compatible", "relational", "database"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: ["mysql"],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/mautic.ts

@@ -0,0 +1,82 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const mauticDefinition: ServiceDefinition = {
+	id: "mautic",
+	name: "Mautic",
+	description:
+		"Open-source marketing automation platform for email campaigns, drip sequences, lead scoring, contact management, and landing pages.",
+	category: "email-marketing",
+	icon: "📧",
+
+	image: "mautic/mautic",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 8082,
+			container: 80,
+			description: "Mautic web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "mautic-data",
+			containerPath: "/var/www/html",
+			description: "Mautic application data and assets",
+		},
+	],
+	environment: [
+		{
+			key: "MAUTIC_DB_HOST",
+			defaultValue: "mysql",
+			secret: false,
+			description: "MySQL host",
+			required: true,
+		},
+		{
+			key: "MAUTIC_DB_NAME",
+			defaultValue: "mautic",
+			secret: false,
+			description: "MySQL database name",
+			required: true,
+		},
+		{
+			key: "MAUTIC_DB_USER",
+			defaultValue: "mautic",
+			secret: false,
+			description: "MySQL username",
+			required: true,
+		},
+		{
+			key: "MAUTIC_DB_PASSWORD",
+			defaultValue: "${MAUTIC_DB_PASSWORD}",
+			secret: true,
+			description: "MySQL password",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost:80/ || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 5,
+		startPeriod: "60s",
+	},
+	dependsOn: ["mysql"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://docs.mautic.org/en/5.x/getting_started/how_to_install_mautic.html",
+	tags: ["marketing", "email", "automation", "campaigns", "leads", "crm"],
+	maturity: "stable",
+
+	requires: ["mysql"],
+	recommends: ["redis"],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};