@better-openclaw/core 1.0.0

package/src/services/definitions/steel-browser.ts

@@ -0,0 +1,70 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const steelBrowserDefinition: ServiceDefinition = {
+	id: "steel-browser",
+	name: "Steel Browser",
+	description:
+		"Open-source browser API for AI agents. Full session management, anti-detection, proxy support, CAPTCHA solving, and compatibility with Puppeteer, Playwright, and Selenium.",
+	category: "browser",
+	icon: "🔥",
+	image: "ghcr.io/steel-dev/steel-browser",
+	imageTag: "latest",
+	ports: [
+		{ host: 3070, container: 3000, description: "Steel Browser REST API", exposed: true },
+		{ host: 9223, container: 9223, description: "CDP debugger", exposed: true },
+	],
+	volumes: [],
+	environment: [
+		{
+			key: "STEEL_LOG_LEVEL",
+			defaultValue: "info",
+			secret: false,
+			description: "Steel Browser log level",
+			required: false,
+		},
+	],
+	healthcheck: {
+		test: "wget -q --spider http://localhost:3000/health || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "15s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+	skills: [{ skillId: "steel-browse", autoInstall: true }],
+	openclawEnvVars: [
+		{
+			key: "STEEL_HOST",
+			defaultValue: "steel-browser",
+			secret: false,
+			description: "Steel Browser hostname for OpenClaw",
+			required: true,
+		},
+		{
+			key: "STEEL_PORT",
+			defaultValue: "3070",
+			secret: false,
+			description: "Steel Browser API port for OpenClaw",
+			required: true,
+		},
+	],
+	docsUrl: "https://docs.steel.dev/",
+	tags: [
+		"browser-api",
+		"ai-agents",
+		"anti-detection",
+		"sessions",
+		"puppeteer",
+		"playwright",
+		"selenium",
+		"captcha",
+	],
+	maturity: "stable",
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+	minMemoryMB: 512,
+	gpuRequired: false,
+};

package/src/services/definitions/tailscale.ts

@@ -0,0 +1,69 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const tailscaleDefinition: ServiceDefinition = {
+	id: "tailscale",
+	name: "Tailscale",
+	description:
+		"Zero-config VPN and secure mesh network for private access to your stack. Uses WireGuard; connect devices and users without opening ports.",
+	category: "dev-tools",
+	icon: "🔒",
+
+	image: "tailscale/tailscale",
+	imageTag: "latest",
+	ports: [],
+	volumes: [
+		{
+			name: "tailscale-state",
+			containerPath: "/var/lib",
+			description: "Tailscale state and identity",
+		},
+	],
+	environment: [
+		{
+			key: "TS_AUTHKEY",
+			defaultValue: "",
+			secret: true,
+			description: "Auth key for headless login (create at admin.tailscale.com)",
+			required: true,
+		},
+		{
+			key: "TS_HOSTNAME",
+			defaultValue: "openclaw-tailscale",
+			secret: false,
+			description: "Hostname for this node in the Tailscale network",
+			required: false,
+		},
+		{
+			key: "TS_ACCEPT_DNS",
+			defaultValue: "true",
+			secret: false,
+			description: "Accept DNS configuration from Tailscale",
+			required: false,
+		},
+		{
+			key: "TS_AUTH_ONCE",
+			defaultValue: "true",
+			secret: false,
+			description: "Exit after initial auth (for ephemeral nodes)",
+			required: false,
+		},
+	],
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://tailscale.com/kb/1282/docker",
+	tags: ["vpn", "wireguard", "networking", "secure-access"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+	mandatory: true,
+
+	minMemoryMB: 64,
+	gpuRequired: false,
+};

package/src/services/definitions/temporal.ts

@@ -0,0 +1,104 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const temporalDefinition: ServiceDefinition = {
+	id: "temporal",
+	name: "Temporal",
+	description:
+		"Durable workflow execution platform for long-running, reliable tasks. OpenClaw can trigger and monitor Temporal workflows for complex multi-step operations.",
+	category: "automation",
+	icon: "⏱️",
+
+	image: "temporalio/auto-setup",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 7233,
+			container: 7233,
+			description: "Temporal gRPC frontend",
+			exposed: true,
+		},
+		{
+			host: 8233,
+			container: 8233,
+			description: "Temporal Web UI",
+			exposed: true,
+		},
+	],
+	volumes: [],
+	environment: [
+		{
+			key: "DB",
+			defaultValue: "postgresql",
+			secret: false,
+			description: "Database type for Temporal persistence",
+			required: true,
+		},
+		{
+			key: "DB_PORT",
+			defaultValue: "5432",
+			secret: false,
+			description: "Database port",
+			required: true,
+		},
+		{
+			key: "POSTGRES_USER",
+			defaultValue: "temporal",
+			secret: false,
+			description: "PostgreSQL user for Temporal",
+			required: true,
+		},
+		{
+			key: "POSTGRES_PWD",
+			defaultValue: "${TEMPORAL_DB_PASSWORD}",
+			secret: true,
+			description: "PostgreSQL password for Temporal",
+			required: true,
+		},
+		{
+			key: "POSTGRES_SEEDS",
+			defaultValue: "postgresql",
+			secret: false,
+			description: "PostgreSQL host(s) for Temporal",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "temporal operator cluster health || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 5,
+		startPeriod: "60s",
+	},
+	dependsOn: ["postgresql"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [
+		{
+			key: "TEMPORAL_HOST",
+			defaultValue: "temporal",
+			secret: false,
+			description: "Temporal server hostname for OpenClaw",
+			required: true,
+		},
+		{
+			key: "TEMPORAL_PORT",
+			defaultValue: "7233",
+			secret: false,
+			description: "Temporal gRPC port for OpenClaw",
+			required: true,
+		},
+	],
+
+	docsUrl: "https://docs.temporal.io/",
+	tags: ["workflow", "durable-execution", "orchestration", "long-running-tasks"],
+	maturity: "beta",
+
+	requires: ["postgresql"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};

package/src/services/definitions/traefik.ts

@@ -0,0 +1,60 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const traefikDefinition: ServiceDefinition = {
+	id: "traefik",
+	name: "Traefik",
+	description:
+		"Cloud-native reverse proxy and load balancer with automatic service discovery, Let's Encrypt integration, and a built-in dashboard.",
+	category: "proxy",
+	icon: "🔀",
+
+	image: "traefik",
+	imageTag: "v3.3",
+	ports: [
+		{
+			host: 80,
+			container: 80,
+			description: "HTTP entrypoint",
+			exposed: true,
+		},
+		{
+			host: 443,
+			container: 443,
+			description: "HTTPS entrypoint",
+			exposed: true,
+		},
+		{
+			host: 8085,
+			container: 8080,
+			description: "Traefik dashboard",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "traefik-certs",
+			containerPath: "/letsencrypt",
+			description: "Let's Encrypt certificate storage",
+		},
+	],
+	environment: [],
+	command:
+		"--api.dashboard=true --providers.docker=true --entrypoints.web.address=:80 --entrypoints.websecure.address=:443",
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://doc.traefik.io/traefik/",
+	tags: ["reverse-proxy", "load-balancer", "service-discovery"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: ["caddy"],
+
+	minMemoryMB: 64,
+	gpuRequired: false,
+};

package/src/services/definitions/umami.ts

@@ -0,0 +1,48 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const umamiDefinition: ServiceDefinition = {
+	id: "umami",
+	name: "Umami",
+	description:
+		"Simple, fast, privacy-focused alternative to Google Analytics. Lightweight and easy to deploy with a clean, modern dashboard.",
+	category: "analytics",
+	icon: "📈",
+
+	image: "ghcr.io/umami-software/umami",
+	imageTag: "postgresql-latest",
+	ports: [
+		{
+			host: 3050,
+			container: 3000,
+			description: "Umami Web UI",
+			exposed: true,
+		},
+	],
+	volumes: [],
+	environment: [
+		{
+			key: "DATABASE_URL",
+			defaultValue: "postgresql://umami:${UMAMI_DB_PASSWORD}@postgresql:5432/umami",
+			secret: false,
+			description: "PostgreSQL connection string for Umami",
+			required: true,
+		},
+	],
+	dependsOn: ["postgresql"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://umami.is/docs",
+	tags: ["analytics", "privacy", "web-analytics", "lightweight"],
+	maturity: "stable",
+
+	requires: ["postgresql"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 128,
+	gpuRequired: false,
+};

package/src/services/definitions/uptime-kuma.ts

@@ -0,0 +1,53 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const uptimeKumaDefinition: ServiceDefinition = {
+	id: "uptime-kuma",
+	name: "Uptime Kuma",
+	description:
+		"Self-hosted monitoring tool for tracking uptime of websites, APIs, and services with a sleek dashboard and multi-notification support.",
+	category: "monitoring",
+	icon: "📡",
+
+	image: "louislam/uptime-kuma",
+	imageTag: "1",
+	ports: [
+		{
+			host: 3001,
+			container: 3001,
+			description: "Uptime Kuma web interface",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "uptime-kuma-data",
+			containerPath: "/app/data",
+			description: "Persistent Uptime Kuma data and configuration",
+		},
+	],
+	environment: [],
+	healthcheck: {
+		test: "wget -q --spider http://localhost:3001 || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "15s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://github.com/louislam/uptime-kuma/wiki",
+	tags: ["uptime", "monitoring", "status-page", "alerts"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/valkey.ts

@@ -0,0 +1,67 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const valkeyDefinition: ServiceDefinition = {
+	id: "valkey",
+	name: "Valkey",
+	description:
+		"Open-source, high-performance key-value store and Redis-compatible fork maintained by the Linux Foundation for caching and data structures.",
+	category: "database",
+	icon: "🔑",
+
+	image: "valkey/valkey",
+	imageTag: "8-alpine",
+	ports: [
+		{
+			host: 6379,
+			container: 6379,
+			description: "Valkey server port",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "valkey-data",
+			containerPath: "/data",
+			description: "Persistent Valkey data",
+		},
+	],
+	environment: [],
+	healthcheck: {
+		test: "valkey-cli ping",
+		interval: "10s",
+		timeout: "5s",
+		retries: 3,
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [
+		{
+			key: "REDIS_HOST",
+			defaultValue: "valkey",
+			secret: false,
+			description: "Redis-compatible hostname for OpenClaw (points to Valkey)",
+			required: true,
+		},
+		{
+			key: "REDIS_PORT",
+			defaultValue: "6379",
+			secret: false,
+			description: "Redis-compatible port for OpenClaw",
+			required: true,
+		},
+	],
+
+	docsUrl: "https://valkey.io/docs/",
+	tags: ["cache", "key-value", "redis-compatible"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: ["redis"],
+
+	minMemoryMB: 128,
+	gpuRequired: false,
+};

package/src/services/definitions/watchtower.ts

@@ -0,0 +1,47 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const watchtowerDefinition: ServiceDefinition = {
+	id: "watchtower",
+	name: "Watchtower",
+	description: "Automatically update Docker container images when new versions are released.",
+	category: "dev-tools",
+	icon: "🗼",
+
+	image: "containrrr/watchtower",
+	imageTag: "latest",
+	ports: [],
+	volumes: [],
+	environment: [
+		{
+			key: "WATCHTOWER_CLEANUP",
+			defaultValue: "true",
+			secret: false,
+			description: "Remove old images after update",
+			required: false,
+		},
+		{
+			key: "WATCHTOWER_POLL_INTERVAL",
+			defaultValue: "86400",
+			secret: false,
+			description: "Check interval in seconds (default 24h)",
+			required: false,
+		},
+	],
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://containrrr.dev/watchtower/",
+	tags: ["auto-update", "docker", "maintenance", "devops"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 32,
+	gpuRequired: false,
+};

package/src/services/definitions/weaviate.ts

@@ -0,0 +1,96 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const weaviateDefinition: ServiceDefinition = {
+	id: "weaviate",
+	name: "Weaviate",
+	description:
+		"Cloud-native vector database for scalable AI applications with built-in vectorization modules, hybrid search, and GraphQL API.",
+	category: "vector-db",
+	icon: "🔷",
+
+	image: "semitechnologies/weaviate",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 8082,
+			container: 8080,
+			description: "Weaviate REST and GraphQL API",
+			exposed: true,
+		},
+		{
+			host: 50051,
+			container: 50051,
+			description: "Weaviate gRPC API",
+			exposed: false,
+		},
+	],
+	volumes: [
+		{
+			name: "weaviate-data",
+			containerPath: "/var/lib/weaviate",
+			description: "Persistent Weaviate vector and object storage",
+		},
+	],
+	environment: [
+		{
+			key: "QUERY_DEFAULTS__LIMIT",
+			defaultValue: "25",
+			secret: false,
+			description: "Default query result limit",
+			required: true,
+		},
+		{
+			key: "AUTHENTICATION_ANONYMOUS_ACCESS_ENABLED",
+			defaultValue: "true",
+			secret: false,
+			description: "Enable anonymous access (disable in production)",
+			required: true,
+		},
+		{
+			key: "PERSISTENCE_DATA_PATH",
+			defaultValue: "/var/lib/weaviate",
+			secret: false,
+			description: "Path for persistent data storage",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "wget -q --spider http://localhost:8080/v1/.well-known/ready || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "15s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [
+		{
+			key: "WEAVIATE_HOST",
+			defaultValue: "weaviate",
+			secret: false,
+			description: "Weaviate hostname for OpenClaw",
+			required: true,
+		},
+		{
+			key: "WEAVIATE_PORT",
+			defaultValue: "8080",
+			secret: false,
+			description: "Weaviate port for OpenClaw",
+			required: true,
+		},
+	],
+
+	docsUrl: "https://weaviate.io/developers/weaviate",
+	tags: ["vector", "graphql", "hybrid-search", "ai-native"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 1024,
+	gpuRequired: false,
+};

package/src/services/definitions/whisper.ts

@@ -0,0 +1,62 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const whisperDefinition: ServiceDefinition = {
+	id: "whisper",
+	name: "Faster Whisper Server",
+	description:
+		"Self-hosted speech-to-text transcription service using the Faster Whisper engine for high-performance audio transcription.",
+	category: "ai",
+	icon: "🎙️",
+
+	image: "fedirz/faster-whisper-server",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 8001,
+			container: 8000,
+			description: "Whisper transcription API",
+			exposed: true,
+		},
+	],
+	volumes: [],
+	environment: [],
+	healthcheck: {
+		test: "wget -q --spider http://localhost:8000/health || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "30s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [{ skillId: "whisper-transcribe", autoInstall: true }],
+	openclawEnvVars: [
+		{
+			key: "WHISPER_HOST",
+			defaultValue: "whisper",
+			secret: false,
+			description: "Whisper hostname for OpenClaw",
+			required: true,
+		},
+		{
+			key: "WHISPER_PORT",
+			defaultValue: "8000",
+			secret: false,
+			description: "Whisper port for OpenClaw",
+			required: true,
+		},
+	],
+
+	docsUrl: "https://github.com/fedirz/faster-whisper-server",
+	tags: ["speech-to-text", "transcription", "audio", "whisper"],
+	maturity: "beta",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 1024,
+	gpuRequired: false,
+};