@better-openclaw/core 1.0.21 → 1.0.23

package/src/services/definitions/sentry.ts

@@ -0,0 +1,104 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const sentryDefinition: ServiceDefinition = {
+	id: "sentry",
+	name: "Sentry",
+	description:
+		"Application performance monitoring and error tracking platform with real-time alerting, release tracking, and stack trace analysis.",
+	category: "monitoring",
+	icon: "🐛",
+
+	image: "getsentry/self-hosted",
+	imageTag: "24.12.0",
+	ports: [
+		{
+			host: 9500,
+			container: 9000,
+			description: "Sentry web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "sentry-data",
+			containerPath: "/data",
+			description: "Persistent Sentry data",
+		},
+	],
+	environment: [
+		{
+			key: "SENTRY_SECRET_KEY",
+			defaultValue: "",
+			secret: true,
+			description: "Sentry secret key for encryption",
+			required: true,
+		},
+		{
+			key: "SENTRY_POSTGRES_HOST",
+			defaultValue: "postgresql",
+			secret: false,
+			description: "PostgreSQL host",
+			required: true,
+		},
+		{
+			key: "SENTRY_DB_USER",
+			defaultValue: "sentry",
+			secret: false,
+			description: "Database user",
+			required: true,
+		},
+		{
+			key: "SENTRY_DB_PASSWORD",
+			defaultValue: "${SENTRY_DB_PASSWORD}",
+			secret: true,
+			description: "Database password",
+			required: true,
+		},
+		{
+			key: "SENTRY_REDIS_HOST",
+			defaultValue: "redis",
+			secret: false,
+			description: "Redis host",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost:9000/_health/ || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 5,
+		startPeriod: "120s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [
+		{
+			key: "SENTRY_HOST",
+			defaultValue: "sentry",
+			secret: false,
+			description: "Sentry hostname",
+			required: false,
+		},
+		{
+			key: "SENTRY_PORT",
+			defaultValue: "9000",
+			secret: false,
+			description: "Sentry port",
+			required: false,
+		},
+	],
+
+	docsUrl: "https://develop.sentry.dev/self-hosted/",
+	tags: ["error-tracking", "apm", "monitoring", "alerting", "debugging"],
+	maturity: "stable",
+
+	requires: ["postgresql", "redis"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 2048,
+	gpuRequired: false,
+};

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/stirling-pdf.ts

@@ -0,0 +1,73 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const stirlingPdfDefinition: ServiceDefinition = {
+	id: "stirling-pdf",
+	name: "Stirling PDF",
+	description:
+		"Self-hosted PDF toolkit for merging, splitting, OCR, compressing, redacting, and transforming documents before they enter knowledge workflows.",
+	category: "knowledge",
+	icon: "📄",
+
+	image: "stirlingtools/stirling-pdf",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 8113,
+			container: 8080,
+			description: "Stirling PDF web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "stirling-pdf-configs",
+			containerPath: "/configs",
+			description: "Stirling PDF configuration and custom settings",
+		},
+		{
+			name: "stirling-pdf-custom-files",
+			containerPath: "/customFiles",
+			description: "Custom fonts, assets, and extra files",
+		},
+	],
+	environment: [
+		{
+			key: "DOCKER_ENABLE_SECURITY",
+			defaultValue: "false",
+			secret: false,
+			description: "Enable built-in Stirling PDF login and security mode",
+			required: true,
+		},
+		{
+			key: "LANGS",
+			defaultValue: "en_GB",
+			secret: false,
+			description: "Enabled UI languages",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost:8080/ || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 5,
+		startPeriod: "20s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://docs.stirlingpdf.com/",
+	tags: ["pdf", "documents", "ocr", "merge", "split", "transform"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: ["paperless-ngx", "outline", "docsgpt"],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};

package/src/services/definitions/strapi.ts

@@ -0,0 +1,124 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const strapiDefinition: ServiceDefinition = {
+	id: "strapi",
+	name: "Strapi",
+	description:
+		"Headless CMS for content-rich products and editorial workflows, with customizable APIs and admin experiences.",
+	category: "knowledge",
+	icon: "📰",
+
+	image: "naskio/strapi",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 1337,
+			container: 1337,
+			description: "Strapi admin UI and API",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "strapi-data",
+			containerPath: "/srv/app",
+			description: "Strapi application data, sqlite DB, uploads, and generated assets",
+		},
+	],
+	environment: [
+		{
+			key: "NODE_ENV",
+			defaultValue: "production",
+			secret: false,
+			description: "Runtime environment",
+			required: true,
+		},
+		{
+			key: "HOST",
+			defaultValue: "0.0.0.0",
+			secret: false,
+			description: "Strapi host binding",
+			required: true,
+		},
+		{
+			key: "PORT",
+			defaultValue: "1337",
+			secret: false,
+			description: "Strapi port",
+			required: true,
+		},
+		{
+			key: "DATABASE_CLIENT",
+			defaultValue: "sqlite",
+			secret: false,
+			description: "Database client",
+			required: true,
+		},
+		{
+			key: "DATABASE_FILENAME",
+			defaultValue: "/srv/app/data/data.db",
+			secret: false,
+			description: "Path to the Strapi sqlite database file",
+			required: true,
+		},
+		{
+			key: "APP_KEYS",
+			defaultValue: "${STRAPI_APP_KEYS}",
+			secret: true,
+			description: "Comma-separated Strapi app keys",
+			required: true,
+		},
+		{
+			key: "API_TOKEN_SALT",
+			defaultValue: "${STRAPI_API_TOKEN_SALT}",
+			secret: true,
+			description: "Salt for API tokens",
+			required: true,
+		},
+		{
+			key: "ADMIN_JWT_SECRET",
+			defaultValue: "${STRAPI_ADMIN_JWT_SECRET}",
+			secret: true,
+			description: "Admin JWT secret",
+			required: true,
+		},
+		{
+			key: "TRANSFER_TOKEN_SALT",
+			defaultValue: "${STRAPI_TRANSFER_TOKEN_SALT}",
+			secret: true,
+			description: "Salt for transfer tokens",
+			required: true,
+		},
+		{
+			key: "JWT_SECRET",
+			defaultValue: "${STRAPI_JWT_SECRET}",
+			secret: true,
+			description: "JWT secret used by Strapi auth flows",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost:1337/admin || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 5,
+		startPeriod: "40s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://docs.strapi.io/",
+	tags: ["cms", "headless", "content", "api", "editorial"],
+	maturity: "beta",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	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,
+};