@better-openclaw/core 1.0.0

package/src/services/definitions/litellm.ts

@@ -0,0 +1,48 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const litellmDefinition: ServiceDefinition = {
+	id: "litellm",
+	name: "LiteLLM Proxy",
+	description:
+		"Unified gateway for 100+ LLM providers with load balancing, fallbacks, spend tracking, and caching.",
+	category: "ai-platform",
+	icon: "🔀",
+
+	image: "ghcr.io/berriai/litellm",
+	imageTag: "main-latest",
+	ports: [
+		{
+			host: 4000,
+			container: 4000,
+			description: "LiteLLM Proxy API",
+			exposed: true,
+		},
+	],
+	volumes: [],
+	environment: [
+		{
+			key: "LITELLM_MASTER_KEY",
+			defaultValue: "",
+			secret: true,
+			description: "LiteLLM admin API key",
+			required: true,
+		},
+	],
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://docs.litellm.ai/",
+	tags: ["llm-proxy", "gateway", "load-balancing", "multi-model", "caching"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/livekit.ts

@@ -0,0 +1,38 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const livekitDefinition: ServiceDefinition = {
+	id: "livekit",
+	name: "LiveKit",
+	description:
+		"Real-time video and audio server for WebRTC. Powers video conferencing and live streaming; used by La Suite Meet. Bind-mount your livekit-server.yaml to /config.yaml.",
+	category: "communication",
+	icon: "📹",
+
+	image: "livekit/livekit-server",
+	imageTag: "latest",
+	ports: [
+		{ host: 7880, container: 7880, description: "LiveKit HTTP/API", exposed: true },
+		{ host: 7881, container: 7881, description: "LiveKit TCP", exposed: true },
+		{ host: 7882, container: 7882, description: "LiveKit UDP (RTP)", exposed: true },
+	],
+	volumes: [],
+	environment: [],
+	command: "--config /config.yaml",
+	dependsOn: ["redis"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://docs.livekit.io/",
+	tags: ["webrtc", "video", "conferencing", "streaming", "lasuite"],
+	maturity: "stable",
+
+	requires: ["redis"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/matomo.ts

@@ -0,0 +1,82 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const matomoDefinition: ServiceDefinition = {
+	id: "matomo",
+	name: "Matomo",
+	description:
+		"Privacy-focused open-source web analytics platform. Self-hosted alternative to Google Analytics with full data ownership and GDPR compliance.",
+	category: "analytics",
+	icon: "📊",
+
+	image: "matomo",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 8090,
+			container: 80,
+			description: "Matomo Web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "matomo-data",
+			containerPath: "/var/www/html",
+			description: "Matomo installation data and plugins",
+		},
+	],
+	environment: [
+		{
+			key: "MATOMO_DATABASE_HOST",
+			defaultValue: "postgresql",
+			secret: false,
+			description: "Database host for Matomo",
+			required: true,
+		},
+		{
+			key: "MATOMO_DATABASE_PORT",
+			defaultValue: "5432",
+			secret: false,
+			description: "Database port for Matomo",
+			required: true,
+		},
+		{
+			key: "MATOMO_DATABASE_DBNAME",
+			defaultValue: "matomo",
+			secret: false,
+			description: "Database name for Matomo",
+			required: true,
+		},
+		{
+			key: "MATOMO_DATABASE_USERNAME",
+			defaultValue: "matomo",
+			secret: false,
+			description: "Database username for Matomo",
+			required: true,
+		},
+		{
+			key: "MATOMO_DATABASE_PASSWORD",
+			defaultValue: "${MATOMO_DB_PASSWORD}",
+			secret: true,
+			description: "Database password for Matomo",
+			required: true,
+		},
+	],
+	dependsOn: ["postgresql"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://matomo.org/docs/",
+	tags: ["analytics", "privacy", "web-analytics", "tracking"],
+	maturity: "stable",
+
+	requires: ["postgresql"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/matrix-synapse.ts

@@ -0,0 +1,89 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const matrixSynapseDefinition: ServiceDefinition = {
+	id: "matrix-synapse",
+	name: "Matrix Synapse",
+	description:
+		"Decentralized messaging server. OpenClaw has a native Matrix plugin for channel integration.",
+	category: "communication",
+	icon: "🔗",
+
+	image: "matrixdotorg/synapse",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 8008,
+			container: 8008,
+			description: "Matrix Synapse API",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "synapse-data",
+			containerPath: "/data",
+			description: "Synapse persistent data including signing keys and media",
+		},
+	],
+	environment: [
+		{
+			key: "SYNAPSE_SERVER_NAME",
+			defaultValue: "localhost",
+			secret: false,
+			description: "Matrix server name/domain used in user IDs and room aliases",
+			required: true,
+		},
+		{
+			key: "SYNAPSE_REPORT_STATS",
+			defaultValue: "no",
+			secret: false,
+			description: "Report anonymous usage statistics to Matrix.org",
+			required: false,
+		},
+		{
+			key: "SYNAPSE_DATABASE_HOST",
+			defaultValue: "postgresql",
+			secret: false,
+			description: "PostgreSQL host for Synapse",
+			required: true,
+		},
+		{
+			key: "SYNAPSE_DATABASE_NAME",
+			defaultValue: "synapse",
+			secret: false,
+			description: "PostgreSQL database for Synapse",
+			required: true,
+		},
+		{
+			key: "SYNAPSE_DATABASE_USER",
+			defaultValue: "synapse",
+			secret: false,
+			description: "PostgreSQL user for Synapse",
+			required: true,
+		},
+		{
+			key: "SYNAPSE_DATABASE_PASSWORD",
+			defaultValue: "${SYNAPSE_DB_PASSWORD}",
+			secret: true,
+			description: "PostgreSQL password for Synapse",
+			required: true,
+		},
+	],
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://element-hq.github.io/synapse/",
+	tags: ["messaging", "decentralized", "federation", "chat", "matrix"],
+	maturity: "stable",
+
+	requires: ["postgresql"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/mattermost.ts

@@ -0,0 +1,67 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const mattermostDefinition: ServiceDefinition = {
+	id: "mattermost",
+	name: "Mattermost",
+	description:
+		"Open-source Slack alternative for team messaging, channels, integrations, and workflows.",
+	category: "communication",
+	icon: "💬",
+
+	image: "mattermost/mattermost-team-edition",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 8065,
+			container: 8065,
+			description: "Mattermost Web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "mattermost-data",
+			containerPath: "/mattermost/data",
+			description: "Mattermost persistent data and file uploads",
+		},
+		{
+			name: "mattermost-config",
+			containerPath: "/mattermost/config",
+			description: "Mattermost server configuration files",
+		},
+	],
+	environment: [
+		{
+			key: "MM_SQLSETTINGS_DRIVERNAME",
+			defaultValue: "postgres",
+			secret: false,
+			description: "Database driver for Mattermost persistence",
+			required: true,
+		},
+		{
+			key: "MM_SQLSETTINGS_DATASOURCE",
+			defaultValue:
+				"postgres://mattermost:${MATTERMOST_DB_PASSWORD}@postgresql:5432/mattermost?sslmode=disable",
+			secret: false,
+			description: "PostgreSQL connection string for Mattermost",
+			required: true,
+		},
+	],
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://docs.mattermost.com/",
+	tags: ["team-chat", "messaging", "slack-alternative", "channels", "integrations"],
+	maturity: "stable",
+
+	requires: ["postgresql"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/meilisearch.ts

@@ -0,0 +1,83 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const meilisearchDefinition: ServiceDefinition = {
+	id: "meilisearch",
+	name: "Meilisearch",
+	description:
+		"Lightning-fast, typo-tolerant full-text search engine with an intuitive API, perfect for building instant search experiences.",
+	category: "search",
+	icon: "🔎",
+
+	image: "getmeili/meilisearch",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 7700,
+			container: 7700,
+			description: "Meilisearch HTTP API",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "meilisearch-data",
+			containerPath: "/meili_data",
+			description: "Persistent Meilisearch index and data storage",
+		},
+	],
+	environment: [
+		{
+			key: "MEILI_MASTER_KEY",
+			defaultValue: "",
+			secret: true,
+			description: "Master key for Meilisearch API authentication",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "wget -q --spider http://localhost:7700/health || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "10s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [
+		{
+			key: "MEILISEARCH_HOST",
+			defaultValue: "meilisearch",
+			secret: false,
+			description: "Meilisearch hostname for OpenClaw",
+			required: true,
+		},
+		{
+			key: "MEILISEARCH_PORT",
+			defaultValue: "7700",
+			secret: false,
+			description: "Meilisearch port for OpenClaw",
+			required: true,
+		},
+		{
+			key: "MEILISEARCH_MASTER_KEY",
+			defaultValue: "${MEILI_MASTER_KEY}",
+			secret: true,
+			description: "Meilisearch master key for OpenClaw (references service key)",
+			required: true,
+		},
+	],
+
+	docsUrl: "https://www.meilisearch.com/docs",
+	tags: ["full-text-search", "instant-search", "typo-tolerant"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/minio.ts

@@ -0,0 +1,105 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const minioDefinition: ServiceDefinition = {
+	id: "minio",
+	name: "MinIO",
+	description:
+		"S3-compatible high-performance object storage for storing assets, backups, and large files with a built-in web console.",
+	category: "storage",
+	icon: "💾",
+
+	image: "minio/minio",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 9000,
+			container: 9000,
+			description: "MinIO S3-compatible API",
+			exposed: true,
+		},
+		{
+			host: 9001,
+			container: 9001,
+			description: "MinIO web console",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "minio-data",
+			containerPath: "/data",
+			description: "Persistent MinIO object storage data",
+		},
+	],
+	environment: [
+		{
+			key: "MINIO_ROOT_USER",
+			defaultValue: "minioadmin",
+			secret: false,
+			description: "MinIO root user (access key)",
+			required: true,
+		},
+		{
+			key: "MINIO_ROOT_PASSWORD",
+			defaultValue: "",
+			secret: true,
+			description: "MinIO root password (secret key, minimum 8 characters)",
+			required: true,
+			validation: "^.{8,}$",
+		},
+	],
+	command: "server /data --console-address ':9001'",
+	healthcheck: {
+		test: "mc ready local || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "10s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [{ skillId: "minio-storage", autoInstall: true }],
+	openclawEnvVars: [
+		{
+			key: "MINIO_HOST",
+			defaultValue: "minio",
+			secret: false,
+			description: "MinIO hostname for OpenClaw",
+			required: true,
+		},
+		{
+			key: "MINIO_PORT",
+			defaultValue: "9000",
+			secret: false,
+			description: "MinIO API port for OpenClaw",
+			required: true,
+		},
+		{
+			key: "MINIO_ACCESS_KEY",
+			defaultValue: "${MINIO_ROOT_USER}",
+			secret: false,
+			description: "MinIO access key for OpenClaw (references root user)",
+			required: true,
+		},
+		{
+			key: "MINIO_SECRET_KEY",
+			defaultValue: "${MINIO_ROOT_PASSWORD}",
+			secret: true,
+			description: "MinIO secret key for OpenClaw (references root password)",
+			required: true,
+		},
+	],
+
+	docsUrl: "https://min.io/docs/minio/container/index.html",
+	tags: ["s3", "object-storage", "assets", "backup"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/mixpost.ts

@@ -0,0 +1,89 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const mixpostDefinition: ServiceDefinition = {
+	id: "mixpost",
+	name: "Mixpost",
+	description:
+		"Self-hosted social media management tool for scheduling, publishing, and analytics. Supports multiple social platforms from a single dashboard.",
+	category: "social-media",
+	icon: "📮",
+
+	image: "inovector/mixpost",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 9191,
+			container: 80,
+			description: "Mixpost Web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "mixpost-storage",
+			containerPath: "/var/www/html/storage/app",
+			description: "Mixpost storage for uploads and generated content",
+		},
+	],
+	environment: [
+		{
+			key: "APP_KEY",
+			defaultValue: "",
+			secret: true,
+			description: "Laravel app key for encryption",
+			required: true,
+		},
+		{
+			key: "DB_HOST",
+			defaultValue: "postgresql",
+			secret: false,
+			description: "Database host",
+			required: true,
+		},
+		{
+			key: "DB_PORT",
+			defaultValue: "5432",
+			secret: false,
+			description: "Database port",
+			required: true,
+		},
+		{
+			key: "DB_DATABASE",
+			defaultValue: "mixpost",
+			secret: false,
+			description: "Database name for Mixpost",
+			required: true,
+		},
+		{
+			key: "DB_USERNAME",
+			defaultValue: "mixpost",
+			secret: false,
+			description: "Database username for Mixpost",
+			required: true,
+		},
+		{
+			key: "DB_PASSWORD",
+			defaultValue: "${MIXPOST_DB_PASSWORD}",
+			secret: true,
+			description: "Database password for Mixpost",
+			required: true,
+		},
+	],
+	dependsOn: ["postgresql"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://mixpost.app/docs/",
+	tags: ["social-media", "scheduling", "publishing", "analytics"],
+	maturity: "stable",
+
+	requires: ["postgresql"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/motion-canvas.ts

@@ -0,0 +1,55 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const motionCanvasDefinition: ServiceDefinition = {
+	id: "motion-canvas",
+	name: "Motion Canvas",
+	description:
+		"TypeScript library for creating animated videos using code, featuring a visual editor for real-time preview and timeline scrubbing.",
+	category: "media",
+	icon: "✨",
+
+	image: "motion-canvas/studio",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 9010,
+			container: 9000,
+			description: "Motion Canvas Studio web interface",
+			exposed: true,
+		},
+	],
+	volumes: [],
+	environment: [],
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [
+		{
+			key: "MOTION_CANVAS_HOST",
+			defaultValue: "motion-canvas",
+			secret: false,
+			description: "Motion Canvas hostname for OpenClaw",
+			required: true,
+		},
+		{
+			key: "MOTION_CANVAS_PORT",
+			defaultValue: "9000",
+			secret: false,
+			description: "Motion Canvas port for OpenClaw",
+			required: true,
+		},
+	],
+
+	docsUrl: "https://motioncanvas.io/docs/",
+	tags: ["animation", "typescript", "video", "motion-graphics"],
+	maturity: "experimental",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};