@better-openclaw/core 1.0.22 → 1.0.24

package/src/services/definitions/sonarqube.ts

@@ -0,0 +1,85 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const sonarqubeDefinition: ServiceDefinition = {
+	id: "sonarqube",
+	name: "SonarQube",
+	description:
+		"Continuous code quality and security analysis platform detecting bugs, vulnerabilities, and code smells across 30+ languages.",
+	category: "dev-tools",
+	icon: "🔍",
+
+	image: "sonarqube",
+	imageTag: "community",
+	ports: [
+		{
+			host: 9100,
+			container: 9000,
+			description: "SonarQube web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "sonarqube-data",
+			containerPath: "/opt/sonarqube/data",
+			description: "SonarQube data",
+		},
+		{
+			name: "sonarqube-extensions",
+			containerPath: "/opt/sonarqube/extensions",
+			description: "SonarQube plugins",
+		},
+		{
+			name: "sonarqube-logs",
+			containerPath: "/opt/sonarqube/logs",
+			description: "SonarQube logs",
+		},
+	],
+	environment: [
+		{
+			key: "SONAR_JDBC_URL",
+			defaultValue: "jdbc:postgresql://postgresql:5432/sonarqube",
+			secret: false,
+			description: "JDBC connection URL",
+			required: true,
+		},
+		{
+			key: "SONAR_JDBC_USERNAME",
+			defaultValue: "sonarqube",
+			secret: false,
+			description: "Database username",
+			required: true,
+		},
+		{
+			key: "SONAR_JDBC_PASSWORD",
+			defaultValue: "${SONARQUBE_DB_PASSWORD}",
+			secret: true,
+			description: "Database password",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost:9000/api/system/status | grep -q UP || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 5,
+		startPeriod: "120s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://docs.sonarsource.com/sonarqube/",
+	tags: ["code-quality", "static-analysis", "security", "linting"],
+	maturity: "stable",
+
+	requires: ["postgresql"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 2048,
+	gpuRequired: false,
+};

package/src/services/definitions/superset.ts

@@ -0,0 +1,84 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const supersetDefinition: ServiceDefinition = {
+	id: "superset",
+	name: "Apache Superset",
+	description:
+		"Modern data exploration and visualization platform. Create interactive dashboards, run SQL queries, and explore data from any database.",
+	category: "business-intelligence",
+	icon: "📈",
+
+	image: "apache/superset",
+	imageTag: "4.1.1",
+	ports: [
+		{
+			host: 8088,
+			container: 8088,
+			description: "Superset web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "superset-data",
+			containerPath: "/app/superset_home",
+			description: "Persistent Superset application data and configurations",
+		},
+	],
+	environment: [
+		{
+			key: "SUPERSET_SECRET_KEY",
+			defaultValue: "${SUPERSET_SECRET_KEY}",
+			secret: true,
+			description: "Secret key for Superset session encryption and CSRF protection",
+			required: true,
+		},
+		{
+			key: "SQLALCHEMY_DATABASE_URI",
+			defaultValue:
+				"postgresql+psycopg2://superset:${SUPERSET_DB_PASSWORD}@postgresql:5432/superset",
+			secret: true,
+			description: "SQLAlchemy connection URI for the Superset metadata database",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost:8088/health || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "30s",
+	},
+	dependsOn: ["postgresql", "redis"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [
+		{
+			key: "SUPERSET_HOST",
+			defaultValue: "superset",
+			secret: false,
+			description: "Superset hostname",
+			required: false,
+		},
+		{
+			key: "SUPERSET_PORT",
+			defaultValue: "8088",
+			secret: false,
+			description: "Superset internal port",
+			required: false,
+		},
+	],
+
+	docsUrl: "https://superset.apache.org/docs/intro",
+	tags: ["visualization", "dashboards", "sql", "analytics", "charts"],
+	maturity: "stable",
+
+	requires: ["postgresql", "redis"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 1024,
+	gpuRequired: false,
+};

package/src/services/definitions/surrealdb.ts

@@ -0,0 +1,77 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const surrealdbDefinition: ServiceDefinition = {
+	id: "surrealdb",
+	name: "SurrealDB",
+	description:
+		"Multi-model database combining document, graph, and relational capabilities with SQL-like query language and real-time subscriptions.",
+	category: "database",
+	icon: "🌀",
+
+	image: "surrealdb/surrealdb",
+	imageTag: "v2.2",
+	command: "start --user root --pass ${SURREALDB_ROOT_PASSWORD} file:/data/database.db",
+	ports: [
+		{
+			host: 8000,
+			container: 8000,
+			description: "SurrealDB HTTP API",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "surrealdb-data",
+			containerPath: "/data",
+			description: "Persistent SurrealDB data",
+		},
+	],
+	environment: [
+		{
+			key: "SURREALDB_ROOT_PASSWORD",
+			defaultValue: "",
+			secret: true,
+			description: "SurrealDB root password",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost:8000/health || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "15s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [
+		{
+			key: "SURREALDB_HOST",
+			defaultValue: "surrealdb",
+			secret: false,
+			description: "SurrealDB hostname",
+			required: false,
+		},
+		{
+			key: "SURREALDB_PORT",
+			defaultValue: "8000",
+			secret: false,
+			description: "SurrealDB port",
+			required: false,
+		},
+	],
+
+	docsUrl: "https://surrealdb.com/docs",
+	tags: ["multi-model", "document", "graph", "relational", "realtime"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/tabby-ml.ts

@@ -0,0 +1,76 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const tabbyMlDefinition: ServiceDefinition = {
+	id: "tabby-ml",
+	name: "Tabby",
+	description:
+		"Self-hosted AI code completion server providing GitHub Copilot-like suggestions with support for multiple models.",
+	category: "coding-agent",
+	icon: "🐱",
+
+	image: "tabbyml/tabby",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 8180,
+			container: 8080,
+			description: "Tabby API",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "tabby-data",
+			containerPath: "/data",
+			description: "Tabby model storage and configuration data",
+		},
+	],
+	environment: [
+		{
+			key: "TABBY_MODEL",
+			defaultValue: "StarCoder-1B",
+			secret: false,
+			description: "Default code completion model",
+			required: false,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost:8080/v1/health || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "120s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [
+		{
+			key: "TABBY_HOST",
+			defaultValue: "tabby-ml",
+			secret: false,
+			description: "Tabby hostname for OpenClaw",
+			required: true,
+		},
+		{
+			key: "TABBY_PORT",
+			defaultValue: "8080",
+			secret: false,
+			description: "Tabby API port for OpenClaw",
+			required: true,
+		},
+	],
+
+	docsUrl: "https://tabby.tabbyml.com/docs/getting-started/",
+	tags: ["code-completion", "copilot", "ai-coding", "ide"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 2048,
+	gpuRequired: false,
+};

package/src/services/definitions/tempo.ts

@@ -0,0 +1,59 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const tempoDefinition: ServiceDefinition = {
+	id: "tempo",
+	name: "Grafana Tempo",
+	description:
+		"High-scale distributed tracing backend by Grafana Labs with native Grafana integration and S3/GCS storage support.",
+	category: "monitoring",
+	icon: "🎵",
+
+	image: "grafana/tempo",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 3210,
+			container: 3200,
+			description: "Tempo HTTP API",
+			exposed: true,
+		},
+		{
+			host: 4327,
+			container: 4317,
+			description: "OpenTelemetry gRPC receiver",
+			exposed: false,
+		},
+	],
+	volumes: [
+		{
+			name: "tempo-data",
+			containerPath: "/var/tempo",
+			description: "Tempo trace data",
+		},
+	],
+	environment: [],
+	healthcheck: {
+		test: "wget -qO- http://localhost:3200/ready || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "15s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://grafana.com/docs/tempo/latest/",
+	tags: ["distributed-tracing", "opentelemetry", "grafana", "observability"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: ["grafana"],
+	conflictsWith: ["jaeger"],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/text-gen-webui.ts

@@ -0,0 +1,92 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const textGenWebuiDefinition: ServiceDefinition = {
+	id: "text-gen-webui",
+	name: "Text Generation WebUI",
+	description:
+		"Feature-rich web interface for running large language models with support for GPTQ, GGUF, and many backends.",
+	category: "ai-platform",
+	icon: "💬",
+
+	image: "atinoda/text-generation-webui",
+	imageTag: "default-nightly",
+	ports: [
+		{
+			host: 7860,
+			container: 7860,
+			description: "Gradio UI",
+			exposed: true,
+		},
+		{
+			host: 5000,
+			container: 5000,
+			description: "API",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "textgen-models",
+			containerPath: "/app/models",
+			description: "Language model files",
+		},
+		{
+			name: "textgen-loras",
+			containerPath: "/app/loras",
+			description: "LoRA adapter files",
+		},
+		{
+			name: "textgen-characters",
+			containerPath: "/app/characters",
+			description: "Character card files",
+		},
+	],
+	environment: [
+		{
+			key: "EXTRA_LAUNCH_ARGS",
+			defaultValue: "--listen --api",
+			secret: false,
+			description: "Additional launch arguments for the WebUI",
+			required: false,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost:7860/ || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "120s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [
+		{
+			key: "TEXT_GEN_WEBUI_HOST",
+			defaultValue: "text-gen-webui",
+			secret: false,
+			description: "Text Generation WebUI hostname for OpenClaw",
+			required: true,
+		},
+		{
+			key: "TEXT_GEN_WEBUI_PORT",
+			defaultValue: "5000",
+			secret: false,
+			description: "Text Generation WebUI API port for OpenClaw",
+			required: true,
+		},
+	],
+
+	docsUrl: "https://github.com/oobabooga/text-generation-webui",
+	tags: ["llm", "inference", "gptq", "gguf", "text-generation"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 4096,
+	gpuRequired: false,
+};

package/src/services/definitions/timescaledb.ts

@@ -0,0 +1,90 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const timescaledbDefinition: ServiceDefinition = {
+	id: "timescaledb",
+	name: "TimescaleDB",
+	description:
+		"PostgreSQL extension for time-series data with automatic partitioning, continuous aggregates, and compression.",
+	category: "database",
+	icon: "⏱️",
+
+	image: "timescale/timescaledb",
+	imageTag: "latest-pg17",
+	ports: [
+		{
+			host: 5433,
+			container: 5432,
+			description: "TimescaleDB server port",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "timescaledb-data",
+			containerPath: "/var/lib/postgresql/data",
+			description: "Persistent TimescaleDB data",
+		},
+	],
+	environment: [
+		{
+			key: "POSTGRES_USER",
+			defaultValue: "openclaw",
+			secret: false,
+			description: "Database superuser",
+			required: true,
+		},
+		{
+			key: "POSTGRES_PASSWORD",
+			defaultValue: "",
+			secret: true,
+			description: "Database password",
+			required: true,
+		},
+		{
+			key: "POSTGRES_DB",
+			defaultValue: "openclaw_ts",
+			secret: false,
+			description: "Default database",
+			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: "TIMESCALEDB_HOST",
+			defaultValue: "timescaledb",
+			secret: false,
+			description: "TimescaleDB hostname",
+			required: false,
+		},
+		{
+			key: "TIMESCALEDB_PORT",
+			defaultValue: "5432",
+			secret: false,
+			description: "TimescaleDB port",
+			required: false,
+		},
+	],
+
+	docsUrl: "https://docs.timescale.com/",
+	tags: ["time-series", "postgresql", "hypertables", "compression", "analytics"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};

package/src/services/definitions/valkey.ts

@@ -60,7 +60,7 @@ export const valkeyDefinition: ServiceDefinition = {
 
 	requires: [],
 	recommends: [],
-	conflictsWith: ["redis"],
+	conflictsWith: ["redis", "dragonfly"],
 
 	minMemoryMB: 128,
 	gpuRequired: false,

package/src/services/definitions/vector-log.ts

@@ -0,0 +1,61 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const vectorLogDefinition: ServiceDefinition = {
+	id: "vector-log",
+	name: "Vector",
+	description:
+		"High-performance observability data pipeline for collecting, transforming, and routing logs, metrics, and traces.",
+	category: "monitoring",
+	icon: "📊",
+
+	image: "timberio/vector",
+	imageTag: "0.43.1-alpine",
+	ports: [
+		{
+			host: 8686,
+			container: 8686,
+			description: "Vector API",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "vector-data",
+			containerPath: "/var/lib/vector",
+			description: "Vector buffer and state data",
+		},
+	],
+	environment: [
+		{
+			key: "VECTOR_LOG",
+			defaultValue: "info",
+			secret: false,
+			description: "Log level",
+			required: false,
+		},
+	],
+	healthcheck: {
+		test: "wget -qO- http://localhost:8686/health || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "10s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://vector.dev/docs/",
+	tags: ["log-pipeline", "metrics", "observability", "etl", "data-pipeline"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 128,
+	gpuRequired: false,
+};