@better-openclaw/core 1.0.7 → 1.0.9

package/src/services/definitions/cal-com.ts

@@ -0,0 +1,91 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const calComDefinition: ServiceDefinition = {
+	id: "cal-com",
+	name: "Cal.com",
+	description:
+		"Open-source scheduling platform for appointments, meetings, and booking management with calendar integrations and customizable workflows.",
+	category: "automation",
+	icon: "📅",
+
+	image: "calcom/cal.com",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 3005,
+			container: 3000,
+			description: "Cal.com web UI",
+			exposed: true,
+		},
+	],
+	volumes: [],
+	environment: [
+		{
+			key: "DATABASE_URL",
+			defaultValue: "postgresql://calcom:${CALCOM_DB_PASSWORD}@postgresql:5432/calcom",
+			secret: true,
+			description: "PostgreSQL connection URL for Cal.com",
+			required: true,
+		},
+		{
+			key: "NEXTAUTH_SECRET",
+			defaultValue: "",
+			secret: true,
+			description: "NextAuth.js session encryption secret",
+			required: true,
+		},
+		{
+			key: "CALENDSO_ENCRYPTION_KEY",
+			defaultValue: "",
+			secret: true,
+			description: "Encryption key for calendar data at rest",
+			required: true,
+		},
+		{
+			key: "NEXT_PUBLIC_WEBAPP_URL",
+			defaultValue: "http://localhost:3005",
+			secret: false,
+			description: "Public URL of the Cal.com instance",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "wget -q --spider http://localhost:3000 || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "60s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [
+		{
+			key: "CALCOM_HOST",
+			defaultValue: "cal-com",
+			secret: false,
+			description: "Cal.com hostname for OpenClaw",
+			required: true,
+		},
+		{
+			key: "CALCOM_PORT",
+			defaultValue: "3000",
+			secret: false,
+			description: "Cal.com port for OpenClaw",
+			required: true,
+		},
+	],
+
+	docsUrl: "https://cal.com/docs",
+	tags: ["calendar", "scheduling", "booking", "appointments"],
+	maturity: "beta",
+
+	requires: ["postgresql"],
+	recommends: ["redis"],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};

package/src/services/definitions/comfyui.ts

@@ -0,0 +1,90 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const comfyuiDefinition: ServiceDefinition = {
+	id: "comfyui",
+	name: "ComfyUI",
+	description:
+		"Node-based visual workflow editor for Stable Diffusion and other generative AI models. Design complex image/video generation pipelines with a drag-and-drop graph UI and a powerful REST API.",
+	category: "ai",
+	icon: "🎨",
+
+	image: "ghcr.io/ai-dock/comfyui",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 8188,
+			container: 8188,
+			description: "ComfyUI Web UI & API",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "comfyui-models",
+			containerPath: "/opt/ComfyUI/models",
+			description: "Model checkpoint, LoRA, VAE, and ControlNet files",
+		},
+		{
+			name: "comfyui-output",
+			containerPath: "/opt/ComfyUI/output",
+			description: "Generated images and output files",
+		},
+		{
+			name: "comfyui-custom-nodes",
+			containerPath: "/opt/ComfyUI/custom_nodes",
+			description: "Community custom node extensions",
+		},
+	],
+	environment: [],
+	healthcheck: {
+		test: "curl -f http://localhost:8188/system_stats || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "60s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [{ skillId: "comfyui-generate", autoInstall: true }],
+	openclawEnvVars: [
+		{
+			key: "COMFYUI_HOST",
+			defaultValue: "comfyui",
+			secret: false,
+			description: "ComfyUI hostname for OpenClaw",
+			required: true,
+		},
+		{
+			key: "COMFYUI_PORT",
+			defaultValue: "8188",
+			secret: false,
+			description: "ComfyUI API port for OpenClaw",
+			required: true,
+		},
+	],
+
+	docsUrl: "https://github.com/comfyanonymous/ComfyUI",
+	selfHostedDocsUrl: "https://github.com/comfyanonymous/ComfyUI",
+	tags: [
+		"image-generation",
+		"ai-art",
+		"stable-diffusion",
+		"workflow",
+		"node-editor",
+		"text-to-image",
+		"comfyui",
+	],
+	maturity: "experimental",
+
+	requires: [],
+	recommends: ["ollama"],
+	conflictsWith: [],
+
+	removalWarning:
+		"⚠️ GPU INFRASTRUCTURE REQUIRED: ComfyUI requires an NVIDIA GPU with CUDA support and the NVIDIA Container Toolkit (nvidia-docker2) installed on the host. Without GPU acceleration, image generation will be extremely slow (minutes per image). Ensure your deployment target has adequate GPU resources (minimum 4 GB VRAM, 8 GB+ recommended) before adding this service.",
+
+	minMemoryMB: 4096,
+	gpuRequired: true,
+};

package/src/services/definitions/desktop-environment.ts

@@ -0,0 +1,163 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const desktopEnvironmentDefinition: ServiceDefinition = {
+	id: "desktop-environment",
+	name: "Desktop Environment",
+	description:
+		"Isolated KasmVNC-based Linux desktop that gives AI agents full computer-use capabilities — screen vision, mouse/keyboard control, file management, and application launching (VS Code, Chrome, Firefox). OBS Studio is pre-installed for optional recording or live-streaming.",
+	category: "desktop",
+	icon: "🖥️",
+
+	image: "kasmweb/core-ubuntu-jammy",
+	imageTag: "1.16.0",
+	ports: [
+		{
+			host: 6901,
+			container: 6901,
+			description: "KasmVNC web interface (browser-based desktop access)",
+			exposed: true,
+		},
+		{
+			host: 5900,
+			container: 5900,
+			description: "VNC protocol port (native VNC clients)",
+			exposed: false,
+		},
+		{
+			host: 4455,
+			container: 4455,
+			description: "OBS WebSocket control port (when OBS is running)",
+			exposed: false,
+		},
+	],
+	volumes: [
+		{
+			name: "desktop-config",
+			containerPath: "/home/kasm-user",
+			description: "Desktop user home with config persistence",
+		},
+		{
+			name: "desktop-workspace",
+			containerPath: "/home/kasm-user/workspace",
+			description: "Shared workspace directory for files and projects",
+		},
+	],
+	environment: [
+		{
+			key: "VNC_PW",
+			defaultValue: "changeme",
+			secret: true,
+			description: "Password for VNC / KasmVNC web access",
+			required: true,
+		},
+		{
+			key: "VNC_RESOLUTION",
+			defaultValue: "1920x1080",
+			secret: false,
+			description: "Desktop screen resolution (WidthxHeight)",
+			required: false,
+		},
+		{
+			key: "SSL_VNC_ONLY",
+			defaultValue: "false",
+			secret: false,
+			description:
+				"When false, allows HTTP/WS connections without SSL (useful for local/Docker networking)",
+			required: false,
+		},
+		{
+			key: "OBS_WS_PORT",
+			defaultValue: "4455",
+			secret: false,
+			description: "OBS WebSocket port (used when OBS is launched manually)",
+			required: false,
+		},
+		{
+			key: "OBS_PASSWORD",
+			defaultValue: "changeme",
+			secret: true,
+			description: "OBS WebSocket password (used when OBS is launched manually)",
+			required: false,
+		},
+	],
+	healthcheck: {
+		test: "curl -sfk https://localhost:6901/ > /dev/null || curl -sf http://localhost:6901/ > /dev/null || exit 1",
+		interval: "10s",
+		timeout: "10s",
+		retries: 6,
+		startPeriod: "60s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	deploy: {
+		resources: {
+			limits: { cpus: "4.0", memory: "8G" },
+			reservations: { cpus: "2.0", memory: "4G" },
+		},
+	},
+
+	skills: [{ skillId: "desktop-use", autoInstall: true }],
+	openclawEnvVars: [
+		{
+			key: "DESKTOP_HOST",
+			defaultValue: "desktop-environment",
+			secret: false,
+			description: "Hostname of the desktop-environment container",
+			required: true,
+		},
+		{
+			key: "DESKTOP_VNC_PORT",
+			defaultValue: "6901",
+			secret: false,
+			description: "KasmVNC web port",
+			required: true,
+		},
+		{
+			key: "DESKTOP_VNC_PASSWORD",
+			defaultValue: "${VNC_PW}",
+			secret: true,
+			description: "VNC password (references service password)",
+			required: true,
+		},
+	],
+
+	docsUrl: "https://www.kasmweb.com/docs/latest/index.html",
+	tags: [
+		"computer-use",
+		"vnc",
+		"desktop",
+		"screen-capture",
+		"automation",
+		"obs",
+		"kasm",
+	],
+	maturity: "experimental",
+
+	requires: [],
+	recommends: ["stream-gateway"],
+	conflictsWith: [],
+
+	removalWarning:
+		"⚠️ HEAVY RESOURCE USAGE: The desktop environment requires at least 4 GB RAM (8 GB recommended) and 2+ CPU cores. It runs a full Linux desktop with XFCE inside KasmVNC. OBS Studio is pre-installed but NOT auto-started — launch it manually or via agent tools when needed. Ensure your deployment target can handle these resources alongside other services.",
+	minMemoryMB: 4096,
+	gpuRequired: false,
+
+	nativeSupported: true,
+	nativeRecipes: [
+		{
+			platform: "linux",
+			installSteps: [
+				"command -v Xvfb >/dev/null 2>&1 || (command -v apt-get >/dev/null 2>&1 && sudo apt-get update -qq && sudo apt-get install -y -qq xvfb xfce4 xfce4-terminal tigervnc-standalone-server scrot xdotool xclip)",
+				"command -v obs >/dev/null 2>&1 || (sudo add-apt-repository -y ppa:obsproject/obs-studio && sudo apt-get update -qq && sudo apt-get install -y -qq obs-studio)",
+			],
+			startCommand:
+				"vncserver :1 -geometry 1920x1080 -depth 24 -localhost no 2>/dev/null || Xvfb :1 -screen 0 1920x1080x24 &",
+			stopCommand: "vncserver -kill :1 2>/dev/null; killall Xvfb 2>/dev/null",
+			configPath: "/etc/vnc/xstartup",
+			configTemplate:
+				"#!/bin/sh\n# Generated for OpenClaw bare-metal desktop\nexport DISPLAY=:1\nstartxfce4 &\n",
+		},
+	],
+};

package/src/services/definitions/grafana.ts

@@ -53,7 +53,22 @@ export const grafanaDefinition: ServiceDefinition = {
 	networks: ["openclaw-network"],
 
 	skills: [],
-	openclawEnvVars: [],
+	openclawEnvVars: [
+		{
+			key: "GRAFANA_HOST",
+			defaultValue: "grafana",
+			secret: false,
+			description: "Grafana hostname",
+			required: false,
+		},
+		{
+			key: "GRAFANA_PORT",
+			defaultValue: "3000",
+			secret: false,
+			description: "Grafana internal port",
+			required: false,
+		},
+	],
 
 	docsUrl: "https://grafana.com/docs/grafana/latest/",
 	tags: ["dashboards", "visualization", "metrics", "monitoring"],

package/src/services/definitions/index.ts

@@ -3,13 +3,16 @@ export { appflowyDefinition } from "./appflowy.js";
 export { beszelDefinition } from "./beszel.js";
 export { browserlessDefinition } from "./browserless.js";
 export { caddyDefinition } from "./caddy.js";
+export { calComDefinition } from "./cal-com.js";
 export { chromadbDefinition } from "./chromadb.js";
 export { claudeCodeDefinition } from "./claude-code.js";
 export { codeServerDefinition } from "./code-server.js";
+export { comfyuiDefinition } from "./comfyui.js";
 export { convexDefinition } from "./convex.js";
 export { convexDashboardDefinition } from "./convex-dashboard.js";
 export { codexDefinition } from "./codex.js";
 export { coolifyDefinition } from "./coolify.js";
+export { desktopEnvironmentDefinition } from "./desktop-environment.js";
 export { difyDefinition } from "./dify.js";
 export { docsgptDefinition } from "./docsgpt.js";
 export { dokployDefinition } from "./dokploy.js";
@@ -37,6 +40,7 @@ export { minioDefinition } from "./minio.js";
 export { mixpostDefinition } from "./mixpost.js";
 export { motionCanvasDefinition } from "./motion-canvas.js";
 export { n8nDefinition } from "./n8n.js";
+export { neo4jDefinition } from "./neo4j.js";
 export { nocodbDefinition } from "./nocodb.js";
 export { ntfyDefinition } from "./ntfy.js";
 export { ollamaDefinition } from "./ollama.js";
@@ -57,6 +61,7 @@ export { rocketchatDefinition } from "./rocketchat.js";
 export { searxngDefinition } from "./searxng.js";
 export { stableDiffusionDefinition } from "./stable-diffusion.js";
 export { steelBrowserDefinition } from "./steel-browser.js";
+export { streamGatewayDefinition } from "./stream-gateway.js";
 export { tailscaleDefinition } from "./tailscale.js";
 export { temporalDefinition } from "./temporal.js";
 export { traefikDefinition } from "./traefik.js";
@@ -67,6 +72,7 @@ export { valkeyDefinition } from "./valkey.js";
 export { watchtowerDefinition } from "./watchtower.js";
 export { weaviateDefinition } from "./weaviate.js";
 export { whisperDefinition } from "./whisper.js";
+export { xyopsDefinition } from "./xyops.js";
 
 import type { ServiceDefinition } from "../../types.js";
 import { anythingLlmDefinition } from "./anything-llm.js";
@@ -74,13 +80,16 @@ import { appflowyDefinition } from "./appflowy.js";
 import { beszelDefinition } from "./beszel.js";
 import { browserlessDefinition } from "./browserless.js";
 import { caddyDefinition } from "./caddy.js";
+import { calComDefinition } from "./cal-com.js";
 import { chromadbDefinition } from "./chromadb.js";
 import { claudeCodeDefinition } from "./claude-code.js";
 import { codeServerDefinition } from "./code-server.js";
+import { comfyuiDefinition } from "./comfyui.js";
 import { convexDefinition } from "./convex.js";
 import { convexDashboardDefinition } from "./convex-dashboard.js";
 import { codexDefinition } from "./codex.js";
 import { coolifyDefinition } from "./coolify.js";
+import { desktopEnvironmentDefinition } from "./desktop-environment.js";
 import { difyDefinition } from "./dify.js";
 import { docsgptDefinition } from "./docsgpt.js";
 import { dokployDefinition } from "./dokploy.js";
@@ -108,6 +117,7 @@ import { minioDefinition } from "./minio.js";
 import { mixpostDefinition } from "./mixpost.js";
 import { motionCanvasDefinition } from "./motion-canvas.js";
 import { n8nDefinition } from "./n8n.js";
+import { neo4jDefinition } from "./neo4j.js";
 import { nocodbDefinition } from "./nocodb.js";
 import { ntfyDefinition } from "./ntfy.js";
 import { ollamaDefinition } from "./ollama.js";
@@ -128,6 +138,7 @@ import { rocketchatDefinition } from "./rocketchat.js";
 import { searxngDefinition } from "./searxng.js";
 import { stableDiffusionDefinition } from "./stable-diffusion.js";
 import { steelBrowserDefinition } from "./steel-browser.js";
+import { streamGatewayDefinition } from "./stream-gateway.js";
 import { tailscaleDefinition } from "./tailscale.js";
 import { temporalDefinition } from "./temporal.js";
 import { traefikDefinition } from "./traefik.js";
@@ -138,6 +149,7 @@ import { valkeyDefinition } from "./valkey.js";
 import { watchtowerDefinition } from "./watchtower.js";
 import { weaviateDefinition } from "./weaviate.js";
 import { whisperDefinition } from "./whisper.js";
+import { xyopsDefinition } from "./xyops.js";
 
 export const allServiceDefinitions: ServiceDefinition[] = [
 	redisDefinition,
@@ -173,6 +185,7 @@ export const allServiceDefinitions: ServiceDefinition[] = [
 	rocketchatDefinition,
 	mattermostDefinition,
 	stableDiffusionDefinition,
+	comfyuiDefinition,
 	playwrightServerDefinition,
 	openWebuiDefinition,
 	librechatDefinition,
@@ -209,4 +222,9 @@ export const allServiceDefinitions: ServiceDefinition[] = [
 	lasuiteMeetBackendDefinition,
 	lasuiteMeetFrontendDefinition,
 	lasuiteMeetAgentsDefinition,
+	desktopEnvironmentDefinition,
+	streamGatewayDefinition,
+	neo4jDefinition,
+	calComDefinition,
+	xyopsDefinition,
 ];

package/src/services/definitions/neo4j.ts

@@ -0,0 +1,96 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const neo4jDefinition: ServiceDefinition = {
+	id: "neo4j",
+	name: "Neo4j",
+	description:
+		"Graph database platform for connected data, enabling knowledge graphs, fraud detection, and relationship-driven queries with the Cypher query language.",
+	category: "database",
+	icon: "🔵",
+
+	image: "neo4j",
+	imageTag: "5-community",
+	ports: [
+		{
+			host: 7474,
+			container: 7474,
+			description: "Neo4j Browser (HTTP)",
+			exposed: true,
+		},
+		{
+			host: 7687,
+			container: 7687,
+			description: "Bolt protocol",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "neo4j-data",
+			containerPath: "/data",
+			description: "Persistent Neo4j data",
+		},
+	],
+	environment: [
+		{
+			key: "NEO4J_AUTH",
+			defaultValue: "neo4j/${NEO4J_PASSWORD}",
+			secret: true,
+			description: "Neo4j authentication credentials (user/password)",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "wget -q --spider http://localhost:7474 || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "30s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [
+		{
+			key: "NEO4J_HOST",
+			defaultValue: "neo4j",
+			secret: false,
+			description: "Neo4j hostname for OpenClaw",
+			required: true,
+		},
+		{
+			key: "NEO4J_BOLT_PORT",
+			defaultValue: "7687",
+			secret: false,
+			description: "Neo4j Bolt protocol port for OpenClaw",
+			required: true,
+		},
+		{
+			key: "NEO4J_HTTP_PORT",
+			defaultValue: "7474",
+			secret: false,
+			description: "Neo4j HTTP port for OpenClaw",
+			required: true,
+		},
+		{
+			key: "NEO4J_PASSWORD",
+			defaultValue: "",
+			secret: true,
+			description: "Neo4j password for OpenClaw",
+			required: true,
+		},
+	],
+
+	docsUrl: "https://neo4j.com/docs/",
+	tags: ["graph", "database", "knowledge-graph", "cypher"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};