@better-openclaw/core 1.0.21 → 1.0.22

package/src/services/definitions/medusa.ts

@@ -0,0 +1,82 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const medusaDefinition: ServiceDefinition = {
+	id: "medusa",
+	name: "Medusa",
+	description:
+		"Modular headless commerce engine for building custom storefronts, managing products, orders, and payments with PostgreSQL and Redis.",
+	category: "ecommerce",
+	icon: "🛒",
+
+	image: "medusajs/medusa",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 9002,
+			container: 9002,
+			description: "Medusa backend API",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "medusa-uploads",
+			containerPath: "/app/uploads",
+			description: "Medusa product images and uploads",
+		},
+	],
+	environment: [
+		{
+			key: "DATABASE_URL",
+			defaultValue: "postgresql://medusa:${MEDUSA_DB_PASSWORD}@postgresql:5432/medusa",
+			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: "JWT_SECRET",
+			defaultValue: "${MEDUSA_JWT_SECRET}",
+			secret: true,
+			description: "JWT signing secret",
+			required: true,
+		},
+		{
+			key: "COOKIE_SECRET",
+			defaultValue: "${MEDUSA_COOKIE_SECRET}",
+			secret: true,
+			description: "Cookie signing secret",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost:9000/health || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "30s",
+	},
+	dependsOn: ["postgresql", "redis"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://docs.medusajs.com/learn",
+	tags: ["ecommerce", "store", "products", "orders", "payments", "headless"],
+	maturity: "stable",
+
+	requires: ["postgresql", "redis"],
+	recommends: ["minio"],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};

package/src/services/definitions/mysql.ts

@@ -0,0 +1,82 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const mysqlDefinition: ServiceDefinition = {
+	id: "mysql",
+	name: "MySQL",
+	description:
+		"Popular open-source relational database engine used by many web applications and self-hosted platforms.",
+	category: "database",
+	icon: "🐬",
+
+	image: "mysql",
+	imageTag: "8.4",
+	ports: [
+		{
+			host: 3306,
+			container: 3306,
+			description: "MySQL server port",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "mysql-data",
+			containerPath: "/var/lib/mysql",
+			description: "Persistent MySQL data",
+		},
+	],
+	environment: [
+		{
+			key: "MYSQL_ROOT_PASSWORD",
+			defaultValue: "",
+			secret: true,
+			description: "MySQL root password",
+			required: true,
+		},
+		{
+			key: "MYSQL_DATABASE",
+			defaultValue: "openclaw",
+			secret: false,
+			description: "Default database created on first run",
+			required: true,
+		},
+		{
+			key: "MYSQL_USER",
+			defaultValue: "openclaw",
+			secret: false,
+			description: "Default MySQL user created on first run",
+			required: true,
+		},
+		{
+			key: "MYSQL_PASSWORD",
+			defaultValue: "",
+			secret: true,
+			description: "Password for the default MySQL user",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "mysqladmin ping -h 127.0.0.1 -u root -p$MYSQL_ROOT_PASSWORD || exit 1",
+		interval: "15s",
+		timeout: "5s",
+		retries: 5,
+		startPeriod: "30s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://dev.mysql.com/doc/refman/8.4/en/docker-mysql-more-topics.html",
+	tags: ["sql", "relational", "database", "web-apps"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: ["mariadb"],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/openhands.ts

@@ -0,0 +1,60 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const openhandsDefinition: ServiceDefinition = {
+	id: "openhands",
+	name: "OpenHands",
+	description:
+		"Autonomous AI coding agent with a web UI that can write, test, and debug code in sandboxed containers.",
+	category: "coding-agent",
+	icon: "🤲",
+
+	image: "ghcr.io/all-hands-ai/openhands",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 3034,
+			container: 3000,
+			description: "OpenHands web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "openhands-workspace",
+			containerPath: "/opt/workspace_base",
+			description: "OpenHands workspace for code projects",
+		},
+	],
+	environment: [
+		{
+			key: "SANDBOX_RUNTIME_CONTAINER_IMAGE",
+			defaultValue: "ghcr.io/all-hands-ai/runtime:latest",
+			secret: false,
+			description: "Runtime sandbox container image",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost:3000/ || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://docs.all-hands.dev",
+	tags: ["ai", "coding", "agent", "autonomous", "development"],
+	maturity: "beta",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 1024,
+	gpuRequired: false,
+};

package/src/services/definitions/opensearch.ts

@@ -0,0 +1,95 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const opensearchDefinition: ServiceDefinition = {
+	id: "opensearch",
+	name: "OpenSearch",
+	description:
+		"Distributed search and analytics engine for full-text search, log indexing, vector retrieval, and large-scale data exploration.",
+	category: "search",
+	icon: "🔍",
+
+	image: "opensearchproject/opensearch",
+	imageTag: "2.19.1",
+	ports: [
+		{
+			host: 9200,
+			container: 9200,
+			description: "OpenSearch HTTP API",
+			exposed: true,
+		},
+		{
+			host: 9600,
+			container: 9600,
+			description: "OpenSearch performance analyzer",
+			exposed: false,
+		},
+	],
+	volumes: [
+		{
+			name: "opensearch-data",
+			containerPath: "/usr/share/opensearch/data",
+			description: "Persistent OpenSearch index data",
+		},
+	],
+	environment: [
+		{
+			key: "discovery.type",
+			defaultValue: "single-node",
+			secret: false,
+			description: "Run OpenSearch in single-node mode",
+			required: true,
+		},
+		{
+			key: "OPENSEARCH_INITIAL_ADMIN_PASSWORD",
+			defaultValue: "",
+			secret: true,
+			description: "Initial admin password for OpenSearch",
+			required: true,
+		},
+		{
+			key: "OPENSEARCH_JAVA_OPTS",
+			defaultValue: "-Xms512m -Xmx512m",
+			secret: false,
+			description: "JVM heap settings for OpenSearch",
+			required: true,
+		},
+		{
+			key: "DISABLE_INSTALL_DEMO_CONFIG",
+			defaultValue: "true",
+			secret: false,
+			description: "Disable demo configuration",
+			required: true,
+		},
+		{
+			key: "DISABLE_SECURITY_PLUGIN",
+			defaultValue: "false",
+			secret: false,
+			description: "Whether to disable the built-in security plugin",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost:9200/_cluster/health || exit 1",
+		interval: "20s",
+		timeout: "10s",
+		retries: 10,
+		startPeriod: "60s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://opensearch.org/docs/latest/install-and-configure/install-opensearch/docker/",
+	tags: ["search", "analytics", "logs", "full-text", "vector-search"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 1024,
+	gpuRequired: false,
+};

package/src/services/definitions/pocketbase.ts

@@ -0,0 +1,62 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const pocketbaseDefinition: ServiceDefinition = {
+	id: "pocketbase",
+	name: "PocketBase",
+	description:
+		"Lightweight backend with auth, realtime APIs, file storage, and an admin UI, designed for solo builders and small products.",
+	category: "database",
+	icon: "👜",
+
+	image: "benallfree/pocketbase",
+	imageTag: "0.29.1",
+	ports: [
+		{
+			host: 8097,
+			container: 8090,
+			description: "PocketBase API and admin UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "pocketbase-data",
+			containerPath: "/data",
+			description: "PocketBase sqlite database and uploaded files",
+		},
+	],
+	environment: [
+		{
+			key: "GOMEMLIMIT",
+			defaultValue: "512MiB",
+			secret: false,
+			description: "Go memory limit hint for PocketBase",
+			required: true,
+		},
+	],
+	command: "pocketbase serve --http=0.0.0.0:8090 --dir=/data/pb_data",
+	healthcheck: {
+		test: "curl -sf http://localhost:8090/api/health || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 5,
+		startPeriod: "20s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://pocketbase.io/docs/going-to-production",
+	tags: ["backend", "auth", "sqlite", "realtime", "files", "solo-builder"],
+	maturity: "beta",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 128,
+	gpuRequired: false,
+};

package/src/services/definitions/rabbitmq.ts

@@ -0,0 +1,81 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const rabbitmqDefinition: ServiceDefinition = {
+	id: "rabbitmq",
+	name: "RabbitMQ",
+	description:
+		"Message broker and event backbone for asynchronous workflows, background jobs, queue-based integrations, and agent task orchestration.",
+	category: "communication",
+	icon: "🐇",
+
+	image: "rabbitmq",
+	imageTag: "4.0-management",
+	ports: [
+		{
+			host: 5672,
+			container: 5672,
+			description: "RabbitMQ AMQP port",
+			exposed: true,
+		},
+		{
+			host: 15672,
+			container: 15672,
+			description: "RabbitMQ management UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "rabbitmq-data",
+			containerPath: "/var/lib/rabbitmq",
+			description: "Persistent RabbitMQ queues and broker state",
+		},
+	],
+	environment: [
+		{
+			key: "RABBITMQ_DEFAULT_USER",
+			defaultValue: "openclaw",
+			secret: false,
+			description: "Default RabbitMQ username",
+			required: true,
+		},
+		{
+			key: "RABBITMQ_DEFAULT_PASS",
+			defaultValue: "${RABBITMQ_PASSWORD}",
+			secret: true,
+			description: "Default RabbitMQ password",
+			required: true,
+		},
+		{
+			key: "RABBITMQ_DEFAULT_VHOST",
+			defaultValue: "/",
+			secret: false,
+			description: "Default RabbitMQ virtual host",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "rabbitmq-diagnostics -q ping || exit 1",
+		interval: "20s",
+		timeout: "10s",
+		retries: 5,
+		startPeriod: "30s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://www.rabbitmq.com/docs/download",
+	tags: ["queue", "message-broker", "pubsub", "events", "async"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/ragflow.ts

@@ -0,0 +1,175 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const ragflowDefinition: ServiceDefinition = {
+	id: "ragflow",
+	name: "RAGFlow",
+	description:
+		"End-to-end retrieval-augmented generation platform for ingesting knowledge, indexing content, and serving grounded AI assistants over your own data.",
+	category: "ai-platform",
+	icon: "🧠",
+
+	image: "infiniflow/ragflow",
+	imageTag: "v0.15.0-slim",
+	ports: [
+		{
+			host: 9380,
+			container: 9380,
+			description: "RAGFlow web UI and API",
+			exposed: true,
+		},
+	],
+	volumes: [],
+	environment: [
+		{
+			key: "SVR_HTTP_PORT",
+			defaultValue: "9380",
+			secret: false,
+			description: "RAGFlow HTTP port",
+			required: true,
+		},
+		{
+			key: "MYSQL_HOST",
+			defaultValue: "mysql",
+			secret: false,
+			description: "MySQL host for RAGFlow metadata",
+			required: true,
+		},
+		{
+			key: "MYSQL_PORT",
+			defaultValue: "3306",
+			secret: false,
+			description: "MySQL port",
+			required: true,
+		},
+		{
+			key: "MYSQL_USER",
+			defaultValue: "ragflow",
+			secret: false,
+			description: "MySQL user for RAGFlow",
+			required: true,
+		},
+		{
+			key: "MYSQL_PASSWORD",
+			defaultValue: "${RAGFLOW_DB_PASSWORD}",
+			secret: true,
+			description: "MySQL password for RAGFlow",
+			required: true,
+		},
+		{
+			key: "MYSQL_DATABASE",
+			defaultValue: "ragflow",
+			secret: false,
+			description: "MySQL database name for RAGFlow",
+			required: true,
+		},
+		{
+			key: "REDIS_HOST",
+			defaultValue: "redis",
+			secret: false,
+			description: "Redis host for queues and caching",
+			required: true,
+		},
+		{
+			key: "REDIS_PORT",
+			defaultValue: "6379",
+			secret: false,
+			description: "Redis port",
+			required: true,
+		},
+		{
+			key: "REDIS_PASSWORD",
+			defaultValue: "${REDIS_PASSWORD}",
+			secret: true,
+			description: "Redis password",
+			required: true,
+		},
+		{
+			key: "MINIO_HOST",
+			defaultValue: "minio",
+			secret: false,
+			description: "MinIO host for object storage",
+			required: true,
+		},
+		{
+			key: "MINIO_PORT",
+			defaultValue: "9000",
+			secret: false,
+			description: "MinIO API port",
+			required: true,
+		},
+		{
+			key: "MINIO_USER",
+			defaultValue: "minioadmin",
+			secret: false,
+			description: "MinIO access key",
+			required: true,
+		},
+		{
+			key: "MINIO_PASSWORD",
+			defaultValue: "${MINIO_ROOT_PASSWORD}",
+			secret: true,
+			description: "MinIO secret key",
+			required: true,
+		},
+		{
+			key: "OPENSEARCH_HOST",
+			defaultValue: "opensearch",
+			secret: false,
+			description: "OpenSearch host for retrieval indexes",
+			required: true,
+		},
+		{
+			key: "OPENSEARCH_PORT",
+			defaultValue: "9200",
+			secret: false,
+			description: "OpenSearch HTTP port",
+			required: true,
+		},
+		{
+			key: "OPENSEARCH_PASSWORD",
+			defaultValue: "${OPENSEARCH_INITIAL_ADMIN_PASSWORD}",
+			secret: true,
+			description: "OpenSearch admin password",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost:9380/ || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 5,
+		startPeriod: "60s",
+	},
+	dependsOn: ["mysql", "redis", "minio", "opensearch"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [{ skillId: "ragflow-pipeline", autoInstall: true }],
+	openclawEnvVars: [
+		{
+			key: "RAGFLOW_HOST",
+			defaultValue: "ragflow",
+			description: "RAGFlow API host",
+			secret: false,
+			required: false,
+		},
+		{
+			key: "RAGFLOW_PORT",
+			defaultValue: "9380",
+			description: "RAGFlow HTTP port",
+			secret: false,
+			required: false,
+		},
+	],
+
+	docsUrl: "https://ragflow.io/docs/configurations",
+	tags: ["rag", "knowledge", "retrieval", "ai-platform", "search", "documents"],
+	maturity: "beta",
+
+	requires: ["mysql", "redis", "minio", "opensearch"],
+	recommends: ["open-webui", "qdrant", "meilisearch"],
+	conflictsWith: [],
+
+	minMemoryMB: 4096,
+	gpuRequired: false,
+};

package/src/services/definitions/restic.ts

@@ -0,0 +1,60 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const resticDefinition: ServiceDefinition = {
+	id: "restic",
+	name: "Restic REST Server",
+	description:
+		"Fast, secure, encrypted backup server with deduplication, supporting S3/MinIO/local storage backends.",
+	category: "backup",
+	icon: "💾",
+
+	image: "restic/rest-server",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 8500,
+			container: 8000,
+			description: "Restic REST API",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "restic-data",
+			containerPath: "/data",
+			description: "Restic backup repository",
+		},
+	],
+	environment: [
+		{
+			key: "OPTIONS",
+			defaultValue: "--no-auth",
+			secret: false,
+			description: "Server options (use --no-auth for dev, configure auth in production)",
+			required: false,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost:8000/ || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://restic.readthedocs.io/en/latest/",
+	tags: ["backup", "restore", "encryption", "deduplication", "s3"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: ["minio"],
+	conflictsWith: [],
+
+	minMemoryMB: 128,
+	gpuRequired: false,
+};