@better-openclaw/core 1.0.22 → 1.0.24

package/src/services/definitions/pihole.ts

@@ -0,0 +1,79 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const piholeDefinition: ServiceDefinition = {
+	id: "pihole",
+	name: "Pi-hole",
+	description:
+		"Network-level ad blocker acting as a DNS sinkhole to block ads and trackers for all devices on the network.",
+	category: "dns-networking",
+	icon: "🕳️",
+
+	image: "pihole/pihole",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 8053,
+			container: 80,
+			description: "Pi-hole web admin",
+			exposed: true,
+		},
+		{
+			host: 53,
+			container: 53,
+			description: "DNS server",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "pihole-etc",
+			containerPath: "/etc/pihole",
+			description: "Pi-hole configuration",
+		},
+		{
+			name: "pihole-dnsmasq",
+			containerPath: "/etc/dnsmasq.d",
+			description: "DNS configuration",
+		},
+	],
+	environment: [
+		{
+			key: "WEBPASSWORD",
+			defaultValue: "",
+			secret: true,
+			description: "Pi-hole web admin password",
+			required: true,
+		},
+		{
+			key: "TZ",
+			defaultValue: "UTC",
+			secret: false,
+			description: "Timezone",
+			required: false,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost:80/admin/ || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "30s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://docs.pi-hole.net/",
+	tags: ["dns", "ad-blocking", "privacy", "sinkhole"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: ["adguard-home"],
+
+	minMemoryMB: 128,
+	gpuRequired: false,
+};

package/src/services/definitions/piper-tts.ts

@@ -0,0 +1,76 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const piperTtsDefinition: ServiceDefinition = {
+	id: "piper-tts",
+	name: "Piper TTS",
+	description:
+		"Fast local neural text-to-speech engine supporting 30+ languages with low-latency voice synthesis.",
+	category: "voice",
+	icon: "🗣️",
+
+	image: "rhasspy/wyoming-piper",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 10200,
+			container: 10200,
+			description: "Wyoming protocol",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "piper-data",
+			containerPath: "/data",
+			description: "Piper TTS voice model data",
+		},
+	],
+	environment: [
+		{
+			key: "PIPER_VOICE",
+			defaultValue: "en_US-lessac-medium",
+			secret: false,
+			description: "Default TTS voice model",
+			required: false,
+		},
+	],
+	healthcheck: {
+		test: "echo > /dev/tcp/localhost/10200 || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "30s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [
+		{
+			key: "PIPER_TTS_HOST",
+			defaultValue: "piper-tts",
+			secret: false,
+			description: "Piper TTS hostname for OpenClaw",
+			required: true,
+		},
+		{
+			key: "PIPER_TTS_PORT",
+			defaultValue: "10200",
+			secret: false,
+			description: "Piper TTS port for OpenClaw",
+			required: true,
+		},
+	],
+
+	docsUrl: "https://github.com/rhasspy/piper",
+	tags: ["tts", "text-to-speech", "voice-synthesis", "speech"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};

package/src/services/definitions/plane.ts

@@ -0,0 +1,75 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const planeDefinition: ServiceDefinition = {
+	id: "plane",
+	name: "Plane",
+	description:
+		"Open-source project management tool for tracking issues, sprints, and cycles. Self-hosted Jira alternative with Kanban boards and roadmaps.",
+	category: "project-management",
+	icon: "✈️",
+
+	image: "makeplane/plane-app",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 3340,
+			container: 3000,
+			description: "Plane Web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "plane-data",
+			containerPath: "/app/data",
+			description: "Plane persistent data",
+		},
+	],
+	environment: [
+		{
+			key: "DATABASE_URL",
+			defaultValue: "postgresql://plane:${PLANE_DB_PASSWORD}@postgresql:5432/plane",
+			secret: false,
+			description: "PostgreSQL connection string for Plane",
+			required: true,
+		},
+		{
+			key: "REDIS_URL",
+			defaultValue: "redis://redis:6379/0",
+			secret: false,
+			description: "Redis connection string for caching and background jobs",
+			required: true,
+		},
+		{
+			key: "SECRET_KEY",
+			defaultValue: "${PLANE_SECRET_KEY}",
+			secret: true,
+			description: "Secret key for Plane session encryption and security",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost:3000/ || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 5,
+		startPeriod: "60s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://docs.plane.so/",
+	tags: ["project-management", "issues", "sprints", "kanban", "jira-alternative"],
+	maturity: "stable",
+
+	requires: ["postgresql", "redis"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};

package/src/services/definitions/plausible.ts

@@ -0,0 +1,97 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const plausibleDefinition: ServiceDefinition = {
+	id: "plausible",
+	name: "Plausible Analytics",
+	description:
+		"Lightweight, privacy-friendly web analytics alternative to Google Analytics with no cookies and GDPR compliance out of the box.",
+	category: "analytics",
+	icon: "📉",
+
+	image: "ghcr.io/plausible/community-edition",
+	imageTag: "v2.1",
+	ports: [
+		{
+			host: 8350,
+			container: 8000,
+			description: "Plausible web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "plausible-data",
+			containerPath: "/var/lib/plausible",
+			description: "Plausible event data",
+		},
+	],
+	environment: [
+		{
+			key: "BASE_URL",
+			defaultValue: "http://localhost:8350",
+			secret: false,
+			description: "Public URL for Plausible",
+			required: true,
+		},
+		{
+			key: "SECRET_KEY_BASE",
+			defaultValue: "",
+			secret: true,
+			description: "Secret key for encryption (min 64 chars)",
+			required: true,
+		},
+		{
+			key: "DATABASE_URL",
+			defaultValue: "postgres://plausible:${PLAUSIBLE_DB_PASSWORD}@postgresql:5432/plausible",
+			secret: false,
+			description: "PostgreSQL connection string",
+			required: true,
+		},
+		{
+			key: "CLICKHOUSE_DATABASE_URL",
+			defaultValue: "http://clickhouse:8123/plausible_events",
+			secret: false,
+			description: "ClickHouse connection URL",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost:8000/api/health || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "30s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [
+		{
+			key: "PLAUSIBLE_HOST",
+			defaultValue: "plausible",
+			secret: false,
+			description: "Plausible hostname",
+			required: false,
+		},
+		{
+			key: "PLAUSIBLE_PORT",
+			defaultValue: "8000",
+			secret: false,
+			description: "Plausible port",
+			required: false,
+		},
+	],
+
+	docsUrl: "https://plausible.io/docs/self-hosting",
+	tags: ["web-analytics", "privacy", "gdpr", "cookie-free", "google-analytics-alternative"],
+	maturity: "stable",
+
+	requires: ["postgresql", "clickhouse"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/pocket-id.ts

@@ -0,0 +1,98 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const pocketIdDefinition: ServiceDefinition = {
+	id: "pocket-id",
+	name: "Pocket ID",
+	description:
+		"Simple, clean OIDC provider with passkey-first authentication. Self-hosted alternative to Auth0/Okta for adding SSO to your services.",
+	category: "security",
+	icon: "🪪",
+
+	image: "ghcr.io/pocket-id/pocket-id",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 3055,
+			container: 1411,
+			description: "Pocket ID web interface and OIDC endpoints",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "pocket-id-data",
+			containerPath: "/app/data",
+			description: "Pocket ID persistent data (SQLite DB, config, keys)",
+		},
+	],
+	environment: [
+		{
+			key: "APP_URL",
+			defaultValue: "${POCKET_ID_APP_URL}",
+			secret: false,
+			description: "Public URL where Pocket ID is accessible (must be HTTPS in production)",
+			required: true,
+		},
+		{
+			key: "ENCRYPTION_KEY",
+			defaultValue: "${POCKET_ID_ENCRYPTION_KEY}",
+			secret: true,
+			description: "32-character encryption key for securing tokens and sessions",
+			required: true,
+		},
+		{
+			key: "TRUST_PROXY",
+			defaultValue: "true",
+			secret: false,
+			description: "Trust reverse proxy headers (required when behind Caddy/Traefik)",
+			required: true,
+		},
+		{
+			key: "PUID",
+			defaultValue: "1000",
+			secret: false,
+			description: "User ID for file permissions",
+			required: false,
+		},
+		{
+			key: "PGID",
+			defaultValue: "1000",
+			secret: false,
+			description: "Group ID for file permissions",
+			required: false,
+		},
+	],
+	healthcheck: {
+		test: "wget -qO- http://localhost:1411/health || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "15s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [{ skillId: "pocket-id-auth", autoInstall: true }],
+	openclawEnvVars: [
+		{
+			key: "POCKET_ID_URL",
+			defaultValue: "http://pocket-id:1411",
+			secret: false,
+			description: "Internal URL for Pocket ID OIDC provider",
+			required: false,
+		},
+	],
+
+	docsUrl: "https://pocket-id.org",
+	selfHostedDocsUrl: "https://pocket-id.org/docs/setup/installation",
+	tags: ["auth", "oidc", "passkey", "sso", "webauthn", "identity-provider", "openid-connect"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: ["caddy", "postgresql"],
+	conflictsWith: [],
+
+	minMemoryMB: 128,
+	gpuRequired: false,
+};

package/src/services/definitions/posthog.ts

@@ -0,0 +1,97 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const posthogDefinition: ServiceDefinition = {
+	id: "posthog",
+	name: "PostHog",
+	description:
+		"All-in-one product analytics platform with event tracking, session recording, feature flags, A/B testing, and user surveys.",
+	category: "analytics",
+	icon: "🦔",
+
+	image: "posthog/posthog",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 8290,
+			container: 8000,
+			description: "PostHog web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "posthog-data",
+			containerPath: "/var/lib/posthog/data",
+			description: "PostHog persistent data",
+		},
+	],
+	environment: [
+		{
+			key: "SECRET_KEY",
+			defaultValue: "",
+			secret: true,
+			description: "PostHog secret key for encryption",
+			required: true,
+		},
+		{
+			key: "DATABASE_URL",
+			defaultValue: "postgres://posthog:${POSTHOG_DB_PASSWORD}@postgresql:5432/posthog",
+			secret: false,
+			description: "PostgreSQL connection string",
+			required: true,
+		},
+		{
+			key: "REDIS_URL",
+			defaultValue: "redis://redis:6379/",
+			secret: false,
+			description: "Redis connection URL",
+			required: true,
+		},
+		{
+			key: "SITE_URL",
+			defaultValue: "http://localhost:8290",
+			secret: false,
+			description: "Public site URL",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost:8000/_health || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 5,
+		startPeriod: "120s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [
+		{
+			key: "POSTHOG_HOST",
+			defaultValue: "posthog",
+			secret: false,
+			description: "PostHog hostname",
+			required: false,
+		},
+		{
+			key: "POSTHOG_PORT",
+			defaultValue: "8000",
+			secret: false,
+			description: "PostHog port",
+			required: false,
+		},
+	],
+
+	docsUrl: "https://posthog.com/docs/self-host",
+	tags: ["product-analytics", "event-tracking", "feature-flags", "session-recording", "ab-testing"],
+	maturity: "stable",
+
+	requires: ["postgresql", "redis"],
+	recommends: ["clickhouse"],
+	conflictsWith: [],
+
+	minMemoryMB: 1024,
+	gpuRequired: false,
+};

package/src/services/definitions/redis.ts

@@ -75,7 +75,7 @@ export const redisDefinition: ServiceDefinition = {
 
 	requires: [],
 	recommends: [],
-	conflictsWith: ["valkey"],
+	conflictsWith: ["valkey", "dragonfly"],
 
 	minMemoryMB: 128,
 	gpuRequired: false,

package/src/services/definitions/revolt.ts

@@ -0,0 +1,68 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const revoltDefinition: ServiceDefinition = {
+	id: "revolt",
+	name: "Revolt",
+	description:
+		"Open-source Discord alternative with voice channels, bots, custom emojis, and modern UI for community building.",
+	category: "communication",
+	icon: "🔴",
+
+	image: "revoltchat/server",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 14000,
+			container: 14000,
+			description: "Revolt API",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "revolt-data",
+			containerPath: "/data",
+			description: "Revolt persistent data storage",
+		},
+	],
+	environment: [
+		{
+			key: "REVOLT_MONGO_URI",
+			defaultValue: "mongodb://mongodb:27017/revolt",
+			secret: false,
+			description: "MongoDB connection string for Revolt",
+			required: true,
+		},
+		{
+			key: "REVOLT_REDIS_URI",
+			defaultValue: "redis://redis:6379",
+			secret: false,
+			description: "Redis connection string for Revolt",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost:14000/ || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "30s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://developers.revolt.chat/",
+	tags: ["discord-alternative", "communities", "voice", "bots"],
+	maturity: "beta",
+
+	requires: ["redis"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};

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,
+};