@better-openclaw/core 1.0.21 → 1.0.23

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/twenty.ts

@@ -0,0 +1,82 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const twentyDefinition: ServiceDefinition = {
+	id: "twenty",
+	name: "Twenty",
+	description:
+		"Modern open-source CRM with a beautiful UI, GraphQL API, customizable data models, and integrations for managing customer relationships.",
+	category: "crm",
+	icon: "🤝",
+
+	image: "twentycrm/twenty",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 3037,
+			container: 3000,
+			description: "Twenty CRM web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "twenty-storage",
+			containerPath: "/app/packages/twenty-server/.local-storage",
+			description: "Twenty server local storage",
+		},
+	],
+	environment: [
+		{
+			key: "PG_DATABASE_URL",
+			defaultValue: "postgresql://twenty:${TWENTY_DB_PASSWORD}@postgresql:5432/twenty",
+			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: "APP_SECRET",
+			defaultValue: "${TWENTY_APP_SECRET}",
+			secret: true,
+			description: "Application secret for signing tokens",
+			required: true,
+		},
+		{
+			key: "FRONT_BASE_URL",
+			defaultValue: "http://localhost:3037",
+			secret: false,
+			description: "Public frontend URL",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost:3000/healthz || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "30s",
+	},
+	dependsOn: ["postgresql", "redis"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://twenty.com/developers/section/self-hosting",
+	tags: ["crm", "sales", "customer", "contacts", "pipeline", "graphql"],
+	maturity: "stable",
+
+	requires: ["postgresql", "redis"],
+	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/vault.ts

@@ -0,0 +1,74 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const vaultDefinition: ServiceDefinition = {
+	id: "vault",
+	name: "HashiCorp Vault",
+	description:
+		"Industry-standard secrets management with dynamic credentials, encryption-as-a-service, audit logging, and access control policies.",
+	category: "security",
+	icon: "🔐",
+
+	image: "hashicorp/vault",
+	imageTag: "1.18",
+	ports: [
+		{
+			host: 8200,
+			container: 8200,
+			description: "Vault API and web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "vault-data",
+			containerPath: "/vault/data",
+			description: "Vault data and audit logs",
+		},
+		{
+			name: "vault-config",
+			containerPath: "/vault/config",
+			description: "Vault server configuration",
+		},
+	],
+	environment: [
+		{
+			key: "VAULT_ADDR",
+			defaultValue: "http://0.0.0.0:8200",
+			secret: false,
+			description: "Vault listener address",
+			required: true,
+		},
+		{
+			key: "VAULT_DEV_ROOT_TOKEN_ID",
+			defaultValue: "${VAULT_ROOT_TOKEN}",
+			secret: true,
+			description: "Root token for dev mode",
+			required: false,
+		},
+	],
+	command: "server -dev",
+	healthcheck: {
+		test: "vault status || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "15s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://developer.hashicorp.com/vault/docs",
+	tags: ["secrets", "vault", "encryption", "credentials", "access-control", "security"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	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,
+};

package/src/services/definitions/vikunja.ts

@@ -0,0 +1,96 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const vikunjaDefinition: ServiceDefinition = {
+	id: "vikunja",
+	name: "Vikunja",
+	description:
+		"Open-source task management and to-do list application with Kanban boards, calendars, and collaboration. Self-hosted Todoist alternative.",
+	category: "project-management",
+	icon: "✅",
+
+	image: "vikunja/vikunja",
+	imageTag: "0.24",
+	ports: [
+		{
+			host: 3460,
+			container: 3456,
+			description: "Vikunja API + frontend",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "vikunja-data",
+			containerPath: "/app/vikunja/files",
+			description: "Vikunja persistent file storage",
+		},
+	],
+	environment: [
+		{
+			key: "VIKUNJA_DATABASE_TYPE",
+			defaultValue: "postgres",
+			secret: false,
+			description: "Database type for Vikunja persistence",
+			required: true,
+		},
+		{
+			key: "VIKUNJA_DATABASE_HOST",
+			defaultValue: "postgresql",
+			secret: false,
+			description: "PostgreSQL hostname for Vikunja",
+			required: true,
+		},
+		{
+			key: "VIKUNJA_DATABASE_USER",
+			defaultValue: "vikunja",
+			secret: false,
+			description: "PostgreSQL user for Vikunja",
+			required: true,
+		},
+		{
+			key: "VIKUNJA_DATABASE_PASSWORD",
+			defaultValue: "${VIKUNJA_DB_PASSWORD}",
+			secret: true,
+			description: "PostgreSQL password for Vikunja",
+			required: true,
+		},
+		{
+			key: "VIKUNJA_DATABASE_DATABASE",
+			defaultValue: "vikunja",
+			secret: false,
+			description: "PostgreSQL database name for Vikunja",
+			required: true,
+		},
+		{
+			key: "VIKUNJA_SERVICE_JWTSECRET",
+			defaultValue: "${VIKUNJA_JWT_SECRET}",
+			secret: true,
+			description: "JWT secret for Vikunja authentication tokens",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "wget -qO- http://localhost:3456/api/v1/info || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "30s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://vikunja.io/docs/",
+	tags: ["tasks", "todo", "kanban", "calendar", "todoist-alternative"],
+	maturity: "stable",
+
+	requires: ["postgresql"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 128,
+	gpuRequired: false,
+};

package/src/services/definitions/wireguard.ts

@@ -0,0 +1,89 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const wireguardDefinition: ServiceDefinition = {
+	id: "wireguard",
+	name: "WireGuard",
+	description:
+		"Modern, high-performance VPN tunnel with simple configuration, strong encryption, and minimal attack surface.",
+	category: "dns-networking",
+	icon: "🔐",
+
+	image: "linuxserver/wireguard",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 51820,
+			container: 51820,
+			description: "WireGuard VPN",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "wireguard-config",
+			containerPath: "/config",
+			description: "WireGuard configuration and keys",
+		},
+	],
+	environment: [
+		{
+			key: "PUID",
+			defaultValue: "1000",
+			secret: false,
+			description: "User ID",
+			required: false,
+		},
+		{
+			key: "PGID",
+			defaultValue: "1000",
+			secret: false,
+			description: "Group ID",
+			required: false,
+		},
+		{
+			key: "TZ",
+			defaultValue: "UTC",
+			secret: false,
+			description: "Timezone",
+			required: false,
+		},
+		{
+			key: "SERVERURL",
+			defaultValue: "auto",
+			secret: false,
+			description: "Server URL or auto-detect",
+			required: true,
+		},
+		{
+			key: "PEERS",
+			defaultValue: "3",
+			secret: false,
+			description: "Number of VPN peers to generate",
+			required: false,
+		},
+	],
+	healthcheck: {
+		test: "wg show || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "15s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://www.wireguard.com/quickstart/",
+	tags: ["vpn", "tunnel", "encryption", "networking"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 64,
+	gpuRequired: false,
+};

package/src/services/definitions/woodpecker-ci.ts

@@ -0,0 +1,97 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const woodpeckerCiDefinition: ServiceDefinition = {
+	id: "woodpecker-ci",
+	name: "Woodpecker CI",
+	description:
+		"Lightweight container-native CI/CD engine with YAML pipelines, multi-platform builds, and Gitea/GitHub/GitLab integration.",
+	category: "dev-tools",
+	icon: "🐦",
+
+	image: "woodpeckerci/woodpecker-server",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 8320,
+			container: 8000,
+			description: "Woodpecker web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "woodpecker-data",
+			containerPath: "/var/lib/woodpecker",
+			description: "Woodpecker server data",
+		},
+	],
+	environment: [
+		{
+			key: "WOODPECKER_HOST",
+			defaultValue: "http://localhost:8320",
+			secret: false,
+			description: "Woodpecker server URL",
+			required: true,
+		},
+		{
+			key: "WOODPECKER_AGENT_SECRET",
+			defaultValue: "",
+			secret: true,
+			description: "Shared secret for agent auth",
+			required: true,
+		},
+		{
+			key: "WOODPECKER_GITEA",
+			defaultValue: "true",
+			secret: false,
+			description: "Enable Gitea integration",
+			required: false,
+		},
+		{
+			key: "WOODPECKER_GITEA_URL",
+			defaultValue: "http://gitea:3000",
+			secret: false,
+			description: "Gitea server URL",
+			required: false,
+		},
+	],
+	healthcheck: {
+		test: "wget -qO- http://localhost:8000/healthz || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "15s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [
+		{
+			key: "WOODPECKER_HOST",
+			defaultValue: "woodpecker-ci",
+			secret: false,
+			description: "Woodpecker hostname",
+			required: false,
+		},
+		{
+			key: "WOODPECKER_PORT",
+			defaultValue: "8000",
+			secret: false,
+			description: "Woodpecker port",
+			required: false,
+		},
+	],
+
+	docsUrl: "https://woodpecker-ci.org/docs/intro",
+	tags: ["ci-cd", "pipelines", "container-native", "drone-compatible"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: ["gitea", "forgejo"],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};