@better-openclaw/core 1.0.0

package/src/services/definitions/portainer.ts

@@ -0,0 +1,50 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const portainerDefinition: ServiceDefinition = {
+	id: "portainer",
+	name: "Portainer",
+	description: "Docker management UI for monitoring and managing your entire stack visually.",
+	category: "dev-tools",
+	icon: "🐳",
+
+	image: "portainer/portainer-ce",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 9443,
+			container: 9443,
+			description: "Portainer HTTPS UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "portainer-data",
+			containerPath: "/data",
+			description: "Portainer data",
+		},
+		{
+			name: "portainer-docker-sock",
+			containerPath: "/var/run/docker.sock",
+			description: "Docker socket (must be bind-mounted to /var/run/docker.sock on host)",
+		},
+	],
+	environment: [],
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://docs.portainer.io/",
+	tags: ["docker", "management", "monitoring", "ui", "containers"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 64,
+	gpuRequired: false,
+};

package/src/services/definitions/postgresql.ts

@@ -0,0 +1,90 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const postgresqlDefinition: ServiceDefinition = {
+	id: "postgresql",
+	name: "PostgreSQL",
+	description:
+		"Powerful open-source relational database for structured data, supporting advanced SQL features, JSONB, and full-text search.",
+	category: "database",
+	icon: "🐘",
+
+	image: "postgres",
+	imageTag: "16-alpine",
+	ports: [
+		{
+			host: 5432,
+			container: 5432,
+			description: "PostgreSQL server port",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "postgres-data",
+			containerPath: "/var/lib/postgresql/data",
+			description: "Persistent PostgreSQL data",
+		},
+	],
+	environment: [
+		{
+			key: "POSTGRES_USER",
+			defaultValue: "openclaw",
+			secret: false,
+			description: "PostgreSQL superuser name",
+			required: true,
+		},
+		{
+			key: "POSTGRES_PASSWORD",
+			defaultValue: "",
+			secret: true,
+			description: "PostgreSQL superuser password",
+			required: true,
+		},
+		{
+			key: "POSTGRES_DB",
+			defaultValue: "openclaw",
+			secret: false,
+			description: "Default database to create on first run",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "pg_isready -U openclaw",
+		interval: "10s",
+		timeout: "5s",
+		retries: 3,
+		startPeriod: "30s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [
+		{
+			key: "POSTGRES_HOST",
+			defaultValue: "postgresql",
+			secret: false,
+			description: "PostgreSQL hostname for OpenClaw",
+			required: true,
+		},
+		{
+			key: "POSTGRES_PORT",
+			defaultValue: "5432",
+			secret: false,
+			description: "PostgreSQL port for OpenClaw",
+			required: true,
+		},
+	],
+
+	docsUrl: "https://www.postgresql.org/docs/",
+	tags: ["relational", "sql", "structured-data"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/postiz.ts

@@ -0,0 +1,86 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const postizDefinition: ServiceDefinition = {
+	id: "postiz",
+	name: "Postiz",
+	description:
+		"Open-source social media scheduling and management tool with AI features. Schedule posts for X, Bluesky, Instagram, TikTok, and more.",
+	category: "social-media",
+	icon: "📨",
+
+	image: "ghcr.io/gitroomhq/postiz-app",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 5200,
+			container: 5000,
+			description: "Postiz Web UI",
+			exposed: true,
+		},
+		{
+			host: 3333,
+			container: 3000,
+			description: "Postiz Frontend",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "postiz-config",
+			containerPath: "/config",
+			description: "Postiz configuration",
+		},
+		{
+			name: "postiz-uploads",
+			containerPath: "/uploads",
+			description: "Postiz uploaded media",
+		},
+	],
+	environment: [
+		{
+			key: "MAIN_URL",
+			defaultValue: "http://localhost:5200",
+			secret: false,
+			description: "Main Postiz URL",
+			required: true,
+		},
+		{
+			key: "FRONTEND_URL",
+			defaultValue: "http://localhost:3333",
+			secret: false,
+			description: "Frontend URL",
+			required: true,
+		},
+		{
+			key: "JWT_SECRET",
+			defaultValue: "",
+			secret: true,
+			description: "JWT secret for Postiz auth",
+			required: true,
+		},
+		{
+			key: "DATABASE_URL",
+			defaultValue: "postgresql://postiz:${POSTIZ_DB_PASSWORD}@postgresql:5432/postiz",
+			secret: false,
+			description: "PostgreSQL connection string",
+			required: true,
+		},
+	],
+	dependsOn: ["postgresql", "redis"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://docs.postiz.com/",
+	tags: ["social-media", "scheduling", "ai", "content", "automation"],
+	maturity: "stable",
+
+	requires: ["postgresql", "redis"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};

package/src/services/definitions/prometheus.ts

@@ -0,0 +1,54 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const prometheusDefinition: ServiceDefinition = {
+	id: "prometheus",
+	name: "Prometheus",
+	description:
+		"Open-source systems monitoring and alerting toolkit for collecting and querying time-series metrics with a powerful query language (PromQL).",
+	category: "monitoring",
+	icon: "🔥",
+
+	image: "prom/prometheus",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 9090,
+			container: 9090,
+			description: "Prometheus web UI and API",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "prometheus-data",
+			containerPath: "/prometheus",
+			description: "Persistent Prometheus time-series data",
+		},
+	],
+	environment: [],
+	command: "--config.file=/etc/prometheus/prometheus.yml --storage.tsdb.path=/prometheus",
+	healthcheck: {
+		test: "wget -q --spider http://localhost:9090/-/healthy || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "10s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://prometheus.io/docs/",
+	tags: ["metrics", "time-series", "alerting", "monitoring"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: ["grafana"],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/qdrant.ts

@@ -0,0 +1,82 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const qdrantDefinition: ServiceDefinition = {
+	id: "qdrant",
+	name: "Qdrant Vector DB",
+	description:
+		"High-performance vector similarity search engine for building RAG pipelines, semantic search, and AI-powered recommendation systems.",
+	category: "vector-db",
+	icon: "🧠",
+
+	image: "qdrant/qdrant",
+	imageTag: "v1.12.1",
+	ports: [
+		{
+			host: 6333,
+			container: 6333,
+			description: "Qdrant REST API",
+			exposed: true,
+		},
+		{
+			host: 6334,
+			container: 6334,
+			description: "Qdrant gRPC API",
+			exposed: false,
+		},
+	],
+	volumes: [
+		{
+			name: "qdrant-data",
+			containerPath: "/qdrant/storage",
+			description: "Persistent Qdrant vector storage",
+		},
+	],
+	environment: [
+		{
+			key: "QDRANT__SERVICE__GRPC_PORT",
+			defaultValue: "6334",
+			secret: false,
+			description: "gRPC port for Qdrant service",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "wget -q --spider http://localhost:6333/healthz || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "10s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [{ skillId: "qdrant-memory", autoInstall: true }],
+	openclawEnvVars: [
+		{
+			key: "QDRANT_HOST",
+			defaultValue: "qdrant",
+			secret: false,
+			description: "Qdrant hostname for OpenClaw",
+			required: true,
+		},
+		{
+			key: "QDRANT_PORT",
+			defaultValue: "6333",
+			secret: false,
+			description: "Qdrant REST API port for OpenClaw",
+			required: true,
+		},
+	],
+
+	docsUrl: "https://qdrant.tech/documentation/",
+	tags: ["vector", "rag", "embeddings", "semantic-search"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: ["redis"],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};

package/src/services/definitions/redis.ts

@@ -0,0 +1,99 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const redisDefinition: ServiceDefinition = {
+	id: "redis",
+	name: "Redis",
+	description:
+		"In-memory data store used for caching, session management, pub/sub messaging, and as a high-performance key-value database.",
+	category: "database",
+	icon: "🔴",
+
+	image: "redis",
+	imageTag: "7-alpine",
+	ports: [
+		{
+			host: 6379,
+			container: 6379,
+			description: "Redis server port",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "redis-data",
+			containerPath: "/data",
+			description: "Persistent Redis data",
+		},
+	],
+	environment: [
+		{
+			key: "REDIS_PASSWORD",
+			defaultValue: "changeme",
+			secret: true,
+			description: "Password for Redis authentication",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "redis-cli ping",
+		interval: "10s",
+		timeout: "5s",
+		retries: 3,
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [{ skillId: "redis-cache", autoInstall: true }],
+	openclawEnvVars: [
+		{
+			key: "REDIS_HOST",
+			defaultValue: "redis",
+			secret: false,
+			description: "Redis hostname for OpenClaw",
+			required: true,
+		},
+		{
+			key: "REDIS_PORT",
+			defaultValue: "6379",
+			secret: false,
+			description: "Redis port for OpenClaw",
+			required: true,
+		},
+		{
+			key: "REDIS_PASSWORD",
+			defaultValue: "${REDIS_PASSWORD}",
+			secret: true,
+			description: "Redis password for OpenClaw (references service password)",
+			required: true,
+		},
+	],
+
+	docsUrl: "https://redis.io/docs",
+	tags: ["cache", "pubsub", "message-bus", "session-store"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: ["valkey"],
+
+	minMemoryMB: 128,
+	gpuRequired: false,
+
+	nativeSupported: true,
+	nativeRecipes: [
+		{
+			platform: "linux",
+			installSteps: [
+				"command -v redis-server >/dev/null 2>&1 || (command -v apt-get >/dev/null 2>&1 && sudo apt-get update -qq && sudo apt-get install -y -qq redis-server)",
+				"command -v redis-server >/dev/null 2>&1 || (command -v dnf >/dev/null 2>&1 && sudo dnf install -y redis)",
+			],
+			startCommand: "sudo systemctl start redis-server 2>/dev/null || sudo systemctl start redis",
+			stopCommand: "sudo systemctl stop redis-server 2>/dev/null || sudo systemctl stop redis",
+			configPath: "/etc/redis/redis.conf",
+			configTemplate:
+				"# Generated for OpenClaw bare-metal\nport 6379\nrequirepass ${REDIS_PASSWORD}\nbind 127.0.0.1 ::1\n",
+			systemdUnit: "redis-server",
+		},
+	],
+};

package/src/services/definitions/remotion.ts

@@ -0,0 +1,55 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const remotionDefinition: ServiceDefinition = {
+	id: "remotion",
+	name: "Remotion Studio",
+	description:
+		"Programmatic video creation framework for React that lets you create motion graphics and render videos using code.",
+	category: "media",
+	icon: "🎥",
+
+	image: "remotion-dev/studio",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 3020,
+			container: 3000,
+			description: "Remotion Studio web interface",
+			exposed: true,
+		},
+	],
+	volumes: [],
+	environment: [],
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [{ skillId: "remotion-render", autoInstall: true }],
+	openclawEnvVars: [
+		{
+			key: "REMOTION_HOST",
+			defaultValue: "remotion",
+			secret: false,
+			description: "Remotion hostname for OpenClaw",
+			required: true,
+		},
+		{
+			key: "REMOTION_PORT",
+			defaultValue: "3000",
+			secret: false,
+			description: "Remotion port for OpenClaw",
+			required: true,
+		},
+	],
+
+	docsUrl: "https://www.remotion.dev/docs/",
+	tags: ["video", "react", "motion-graphics", "rendering"],
+	maturity: "beta",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};

package/src/services/definitions/rocketchat.ts

@@ -0,0 +1,61 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const rocketchatDefinition: ServiceDefinition = {
+	id: "rocketchat",
+	name: "Rocket.Chat",
+	description:
+		"Open-source team chat platform with AI features, channels, DMs, video calls, and integrations.",
+	category: "communication",
+	icon: "🚀",
+
+	image: "rocket.chat",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 3200,
+			container: 3000,
+			description: "Rocket.Chat Web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "rocketchat-uploads",
+			containerPath: "/app/uploads",
+			description: "Rocket.Chat file uploads and attachments",
+		},
+	],
+	environment: [
+		{
+			key: "ROOT_URL",
+			defaultValue: "http://localhost:3200",
+			secret: false,
+			description: "Public root URL for Rocket.Chat",
+			required: true,
+		},
+		{
+			key: "MONGO_URL",
+			defaultValue: "mongodb://mongodb:27017/rocketchat",
+			secret: false,
+			description: "MongoDB connection string for Rocket.Chat",
+			required: true,
+		},
+	],
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://docs.rocket.chat/",
+	tags: ["team-chat", "messaging", "video-calls", "ai", "slack-alternative"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};

package/src/services/definitions/searxng.ts

@@ -0,0 +1,68 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const searxngDefinition: ServiceDefinition = {
+	id: "searxng",
+	name: "SearXNG",
+	description:
+		"Privacy-respecting, self-hosted metasearch engine that aggregates results from multiple search engines without tracking.",
+	category: "search",
+	icon: "🔍",
+
+	image: "searxng/searxng",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 8080,
+			container: 8080,
+			description: "SearXNG web interface and API",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "searxng-data",
+			containerPath: "/etc/searxng",
+			description: "SearXNG configuration and settings",
+		},
+	],
+	environment: [],
+	healthcheck: {
+		test: "wget -q --spider http://localhost:8080/ || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "15s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [{ skillId: "searxng-search", autoInstall: true }],
+	openclawEnvVars: [
+		{
+			key: "SEARXNG_HOST",
+			defaultValue: "searxng",
+			secret: false,
+			description: "SearXNG hostname for OpenClaw",
+			required: true,
+		},
+		{
+			key: "SEARXNG_PORT",
+			defaultValue: "8080",
+			secret: false,
+			description: "SearXNG port for OpenClaw",
+			required: true,
+		},
+	],
+
+	docsUrl: "https://docs.searxng.org/",
+	tags: ["search", "meta-search", "privacy"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: ["redis"],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/stable-diffusion.ts

@@ -0,0 +1,50 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const stableDiffusionDefinition: ServiceDefinition = {
+	id: "stable-diffusion",
+	name: "Stable Diffusion WebUI",
+	description: "Local AI image generation with a web interface. Generate images from text prompts.",
+	category: "ai",
+	icon: "🎨",
+
+	image: "ghcr.io/stable-diffusion-webui/stable-diffusion-webui",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 7860,
+			container: 7860,
+			description: "Stable Diffusion WebUI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "sd-models",
+			containerPath: "/models",
+			description: "Stable Diffusion model checkpoint files",
+		},
+		{
+			name: "sd-outputs",
+			containerPath: "/outputs",
+			description: "Generated images and output files",
+		},
+	],
+	environment: [],
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://github.com/AUTOMATIC1111/stable-diffusion-webui",
+	tags: ["image-generation", "ai-art", "stable-diffusion", "text-to-image"],
+	maturity: "experimental",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 4096,
+	gpuRequired: true,
+};