@better-openclaw/core 1.0.0

package/src/services/definitions/gotify.ts

@@ -0,0 +1,67 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const gotifyDefinition: ServiceDefinition = {
+	id: "gotify",
+	name: "Gotify",
+	description:
+		"Simple, self-hosted push notification server with a REST API and real-time WebSocket delivery for sending and receiving messages.",
+	category: "communication",
+	icon: "🔔",
+
+	image: "gotify/server",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 8083,
+			container: 80,
+			description: "Gotify web interface and API",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "gotify-data",
+			containerPath: "/app/data",
+			description: "Persistent Gotify data and message storage",
+		},
+	],
+	environment: [],
+	healthcheck: {
+		test: "wget -q --spider http://localhost:80/health || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [
+		{
+			key: "GOTIFY_HOST",
+			defaultValue: "gotify",
+			secret: false,
+			description: "Gotify hostname for OpenClaw",
+			required: true,
+		},
+		{
+			key: "GOTIFY_PORT",
+			defaultValue: "8080",
+			secret: false,
+			description: "Gotify port for OpenClaw",
+			required: true,
+		},
+	],
+
+	docsUrl: "https://gotify.net/docs/",
+	tags: ["notifications", "push", "websocket", "messaging"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 64,
+	gpuRequired: false,
+};

package/src/services/definitions/grafana.ts

@@ -0,0 +1,68 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const grafanaDefinition: ServiceDefinition = {
+	id: "grafana",
+	name: "Grafana",
+	description:
+		"Open-source analytics and interactive visualization platform for metrics, logs, and traces with rich dashboards and alerting.",
+	category: "monitoring",
+	icon: "📊",
+
+	image: "grafana/grafana",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 3150,
+			container: 3000,
+			description: "Grafana web interface",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "grafana-data",
+			containerPath: "/var/lib/grafana",
+			description: "Persistent Grafana dashboards, plugins, and data",
+		},
+	],
+	environment: [
+		{
+			key: "GF_SECURITY_ADMIN_USER",
+			defaultValue: "admin",
+			secret: false,
+			description: "Grafana admin username",
+			required: true,
+		},
+		{
+			key: "GF_SECURITY_ADMIN_PASSWORD",
+			defaultValue: "",
+			secret: true,
+			description: "Grafana admin password",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "wget -q --spider http://localhost:3000/api/health || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "15s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://grafana.com/docs/grafana/latest/",
+	tags: ["dashboards", "visualization", "metrics", "monitoring"],
+	maturity: "stable",
+
+	requires: ["prometheus"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/index.ts

@@ -0,0 +1,200 @@
+export { anythingLlmDefinition } from "./anything-llm.js";
+export { appflowyDefinition } from "./appflowy.js";
+export { beszelDefinition } from "./beszel.js";
+export { browserlessDefinition } from "./browserless.js";
+export { caddyDefinition } from "./caddy.js";
+export { chromadbDefinition } from "./chromadb.js";
+export { claudeCodeDefinition } from "./claude-code.js";
+export { codeServerDefinition } from "./code-server.js";
+export { codexDefinition } from "./codex.js";
+export { coolifyDefinition } from "./coolify.js";
+export { difyDefinition } from "./dify.js";
+export { docsgptDefinition } from "./docsgpt.js";
+export { dokployDefinition } from "./dokploy.js";
+export { dozzleDefinition } from "./dozzle.js";
+export { ffmpegDefinition } from "./ffmpeg.js";
+export { flowiseDefinition } from "./flowise.js";
+export { geminiCliDefinition } from "./gemini-cli.js";
+export { giteaDefinition } from "./gitea.js";
+export { gotifyDefinition } from "./gotify.js";
+export { grafanaDefinition } from "./grafana.js";
+export { kimiDefinition } from "./kimi.js";
+export { lasuiteMeetAgentsDefinition } from "./lasuite-meet-agents.js";
+export { lasuiteMeetBackendDefinition } from "./lasuite-meet-backend.js";
+export { lasuiteMeetFrontendDefinition } from "./lasuite-meet-frontend.js";
+export { librechatDefinition } from "./librechat.js";
+export { lightpandaDefinition } from "./lightpanda.js";
+export { litellmDefinition } from "./litellm.js";
+export { livekitDefinition } from "./livekit.js";
+export { matomoDefinition } from "./matomo.js";
+export { matrixSynapseDefinition } from "./matrix-synapse.js";
+export { mattermostDefinition } from "./mattermost.js";
+export { meilisearchDefinition } from "./meilisearch.js";
+export { minioDefinition } from "./minio.js";
+export { mixpostDefinition } from "./mixpost.js";
+export { motionCanvasDefinition } from "./motion-canvas.js";
+export { n8nDefinition } from "./n8n.js";
+export { nocodbDefinition } from "./nocodb.js";
+export { ntfyDefinition } from "./ntfy.js";
+export { ollamaDefinition } from "./ollama.js";
+export { openWebuiDefinition } from "./open-webui.js";
+export { opencodeDefinition } from "./opencode.js";
+export { openpanelDefinition } from "./openpanel.js";
+export { outlineDefinition } from "./outline.js";
+export { paperlessNgxDefinition } from "./paperless-ngx.js";
+export { playwrightServerDefinition } from "./playwright-server.js";
+export { portainerDefinition } from "./portainer.js";
+export { postgresqlDefinition } from "./postgresql.js";
+export { postizDefinition } from "./postiz.js";
+export { prometheusDefinition } from "./prometheus.js";
+export { qdrantDefinition } from "./qdrant.js";
+export { redisDefinition } from "./redis.js";
+export { remotionDefinition } from "./remotion.js";
+export { rocketchatDefinition } from "./rocketchat.js";
+export { searxngDefinition } from "./searxng.js";
+export { stableDiffusionDefinition } from "./stable-diffusion.js";
+export { steelBrowserDefinition } from "./steel-browser.js";
+export { tailscaleDefinition } from "./tailscale.js";
+export { temporalDefinition } from "./temporal.js";
+export { traefikDefinition } from "./traefik.js";
+export { umamiDefinition } from "./umami.js";
+export { uptimeKumaDefinition } from "./uptime-kuma.js";
+export { valkeyDefinition } from "./valkey.js";
+export { watchtowerDefinition } from "./watchtower.js";
+export { weaviateDefinition } from "./weaviate.js";
+export { whisperDefinition } from "./whisper.js";
+
+import type { ServiceDefinition } from "../../types.js";
+import { anythingLlmDefinition } from "./anything-llm.js";
+import { appflowyDefinition } from "./appflowy.js";
+import { beszelDefinition } from "./beszel.js";
+import { browserlessDefinition } from "./browserless.js";
+import { caddyDefinition } from "./caddy.js";
+import { chromadbDefinition } from "./chromadb.js";
+import { claudeCodeDefinition } from "./claude-code.js";
+import { codeServerDefinition } from "./code-server.js";
+import { codexDefinition } from "./codex.js";
+import { coolifyDefinition } from "./coolify.js";
+import { difyDefinition } from "./dify.js";
+import { docsgptDefinition } from "./docsgpt.js";
+import { dokployDefinition } from "./dokploy.js";
+import { dozzleDefinition } from "./dozzle.js";
+import { ffmpegDefinition } from "./ffmpeg.js";
+import { flowiseDefinition } from "./flowise.js";
+import { geminiCliDefinition } from "./gemini-cli.js";
+import { giteaDefinition } from "./gitea.js";
+import { gotifyDefinition } from "./gotify.js";
+import { grafanaDefinition } from "./grafana.js";
+import { kimiDefinition } from "./kimi.js";
+import { lasuiteMeetAgentsDefinition } from "./lasuite-meet-agents.js";
+import { lasuiteMeetBackendDefinition } from "./lasuite-meet-backend.js";
+import { lasuiteMeetFrontendDefinition } from "./lasuite-meet-frontend.js";
+import { librechatDefinition } from "./librechat.js";
+import { lightpandaDefinition } from "./lightpanda.js";
+import { litellmDefinition } from "./litellm.js";
+import { livekitDefinition } from "./livekit.js";
+import { matomoDefinition } from "./matomo.js";
+import { matrixSynapseDefinition } from "./matrix-synapse.js";
+import { mattermostDefinition } from "./mattermost.js";
+import { meilisearchDefinition } from "./meilisearch.js";
+import { minioDefinition } from "./minio.js";
+import { mixpostDefinition } from "./mixpost.js";
+import { motionCanvasDefinition } from "./motion-canvas.js";
+import { n8nDefinition } from "./n8n.js";
+import { nocodbDefinition } from "./nocodb.js";
+import { ntfyDefinition } from "./ntfy.js";
+import { ollamaDefinition } from "./ollama.js";
+import { openWebuiDefinition } from "./open-webui.js";
+import { opencodeDefinition } from "./opencode.js";
+import { openpanelDefinition } from "./openpanel.js";
+import { outlineDefinition } from "./outline.js";
+import { paperlessNgxDefinition } from "./paperless-ngx.js";
+import { playwrightServerDefinition } from "./playwright-server.js";
+import { portainerDefinition } from "./portainer.js";
+import { postgresqlDefinition } from "./postgresql.js";
+import { postizDefinition } from "./postiz.js";
+import { prometheusDefinition } from "./prometheus.js";
+import { qdrantDefinition } from "./qdrant.js";
+import { redisDefinition } from "./redis.js";
+import { remotionDefinition } from "./remotion.js";
+import { rocketchatDefinition } from "./rocketchat.js";
+import { searxngDefinition } from "./searxng.js";
+import { stableDiffusionDefinition } from "./stable-diffusion.js";
+import { steelBrowserDefinition } from "./steel-browser.js";
+import { tailscaleDefinition } from "./tailscale.js";
+import { temporalDefinition } from "./temporal.js";
+import { traefikDefinition } from "./traefik.js";
+import { umamiDefinition } from "./umami.js";
+import { uptimeKumaDefinition } from "./uptime-kuma.js";
+import { valkeyDefinition } from "./valkey.js";
+import { watchtowerDefinition } from "./watchtower.js";
+import { weaviateDefinition } from "./weaviate.js";
+import { whisperDefinition } from "./whisper.js";
+
+export const allServiceDefinitions: ServiceDefinition[] = [
+	redisDefinition,
+	qdrantDefinition,
+	n8nDefinition,
+	ffmpegDefinition,
+	minioDefinition,
+	postgresqlDefinition,
+	caddyDefinition,
+	traefikDefinition,
+	uptimeKumaDefinition,
+	grafanaDefinition,
+	prometheusDefinition,
+	browserlessDefinition,
+	searxngDefinition,
+	meilisearchDefinition,
+	ollamaDefinition,
+	whisperDefinition,
+	chromadbDefinition,
+	weaviateDefinition,
+	valkeyDefinition,
+	gotifyDefinition,
+	ntfyDefinition,
+	remotionDefinition,
+	motionCanvasDefinition,
+	temporalDefinition,
+	outlineDefinition,
+	docsgptDefinition,
+	paperlessNgxDefinition,
+	nocodbDefinition,
+	appflowyDefinition,
+	matrixSynapseDefinition,
+	rocketchatDefinition,
+	mattermostDefinition,
+	stableDiffusionDefinition,
+	playwrightServerDefinition,
+	openWebuiDefinition,
+	librechatDefinition,
+	anythingLlmDefinition,
+	difyDefinition,
+	flowiseDefinition,
+	litellmDefinition,
+	giteaDefinition,
+	codeServerDefinition,
+	portainerDefinition,
+	watchtowerDefinition,
+	dozzleDefinition,
+	beszelDefinition,
+	claudeCodeDefinition,
+	opencodeDefinition,
+	codexDefinition,
+	geminiCliDefinition,
+	kimiDefinition,
+	postizDefinition,
+	mixpostDefinition,
+	matomoDefinition,
+	umamiDefinition,
+	openpanelDefinition,
+	lightpandaDefinition,
+	steelBrowserDefinition,
+	coolifyDefinition,
+	dokployDefinition,
+	tailscaleDefinition,
+	livekitDefinition,
+	lasuiteMeetBackendDefinition,
+	lasuiteMeetFrontendDefinition,
+	lasuiteMeetAgentsDefinition,
+];

package/src/services/definitions/kimi.ts

@@ -0,0 +1,48 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const kimiDefinition: ServiceDefinition = {
+	id: "kimi",
+	name: "Kimi CLI",
+	description:
+		"Moonshot AI's command-line coding agent powered by the Kimi model. Provides AI-assisted coding with strong multilingual and long-context capabilities.",
+	category: "coding-agent",
+	icon: "🌙",
+
+	image: "node",
+	imageTag: "22-alpine",
+	ports: [],
+	volumes: [
+		{
+			name: "kimi-config",
+			containerPath: "/home/node/.kimi",
+			description: "Kimi CLI configuration and cache",
+		},
+	],
+	environment: [
+		{
+			key: "KIMI_API_KEY",
+			defaultValue: "",
+			secret: true,
+			description: "Kimi/Moonshot API key",
+			required: true,
+		},
+	],
+	command: "npx kimi-cli@latest",
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://github.com/anthropics/kimi-cli",
+	tags: ["ai-coding", "kimi", "moonshot", "agent"],
+	maturity: "experimental",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/lasuite-meet-agents.ts

@@ -0,0 +1,33 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const lasuiteMeetAgentsDefinition: ServiceDefinition = {
+	id: "lasuite-meet-agents",
+	name: "La Suite Meet (Agents)",
+	description:
+		"Background agents for La Suite Meet (e.g. room lifecycle, recording). Shares env with backend; run alongside the Meet stack.",
+	category: "communication",
+	icon: "⚙️",
+
+	image: "lasuite/meet-agents",
+	imageTag: "main",
+	ports: [],
+	volumes: [],
+	environment: [],
+	dependsOn: ["lasuite-meet-backend"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://github.com/suitenumerique/meet",
+	tags: ["lasuite", "meet", "video", "conferencing", "agents"],
+	maturity: "stable",
+
+	requires: ["lasuite-meet-backend"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/lasuite-meet-backend.ts

@@ -0,0 +1,125 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const lasuiteMeetBackendDefinition: ServiceDefinition = {
+	id: "lasuite-meet-backend",
+	name: "La Suite Meet (Backend)",
+	description:
+		"Django backend for La Suite Meet — open-source video conferencing from La Suite numérique. Handles API, auth, and room management.",
+	category: "communication",
+	icon: "📞",
+
+	image: "lasuite/meet-backend",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 8081,
+			container: 8000,
+			description: "Django backend API",
+			exposed: true,
+		},
+	],
+	volumes: [],
+	environment: [
+		{
+			key: "DB_HOST",
+			defaultValue: "postgresql",
+			secret: false,
+			description: "PostgreSQL host",
+			required: true,
+		},
+		{
+			key: "DB_NAME",
+			defaultValue: "meet",
+			secret: false,
+			description: "PostgreSQL database name",
+			required: true,
+		},
+		{
+			key: "DB_USER",
+			defaultValue: "meet",
+			secret: false,
+			description: "PostgreSQL user",
+			required: true,
+		},
+		{
+			key: "DB_PASSWORD",
+			defaultValue: "",
+			secret: true,
+			description: "PostgreSQL password",
+			required: true,
+		},
+		{
+			key: "DB_PORT",
+			defaultValue: "5432",
+			secret: false,
+			description: "PostgreSQL port",
+			required: true,
+		},
+		{
+			key: "DJANGO_SECRET_KEY",
+			defaultValue: "",
+			secret: true,
+			description: "Django secret key",
+			required: true,
+		},
+		{
+			key: "DJANGO_SETTINGS_MODULE",
+			defaultValue: "meet.settings",
+			secret: false,
+			description: "Django settings module",
+			required: true,
+		},
+		{
+			key: "DJANGO_ALLOWED_HOSTS",
+			defaultValue: "localhost,backend",
+			secret: false,
+			description: "Comma-separated allowed hosts",
+			required: true,
+		},
+		{
+			key: "LIVEKIT_API_URL",
+			defaultValue: "http://livekit:7880",
+			secret: false,
+			description: "LiveKit API URL (internal)",
+			required: true,
+		},
+		{
+			key: "LIVEKIT_API_KEY",
+			defaultValue: "meet",
+			secret: false,
+			description: "LiveKit API key",
+			required: true,
+		},
+		{
+			key: "LIVEKIT_API_SECRET",
+			defaultValue: "",
+			secret: true,
+			description: "LiveKit API secret",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "python manage.py check",
+		interval: "15s",
+		timeout: "30s",
+		retries: 20,
+		startPeriod: "10s",
+	},
+	dependsOn: ["postgresql", "redis", "livekit"],
+	restartPolicy: "always",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://github.com/suitenumerique/meet",
+	tags: ["lasuite", "meet", "video", "conferencing", "django"],
+	maturity: "stable",
+
+	requires: ["postgresql", "redis", "livekit"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};

package/src/services/definitions/lasuite-meet-frontend.ts

@@ -0,0 +1,38 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const lasuiteMeetFrontendDefinition: ServiceDefinition = {
+	id: "lasuite-meet-frontend",
+	name: "La Suite Meet (Frontend)",
+	description:
+		"Nginx-served frontend for La Suite Meet. Serves the web client and proxies API/admin/static to the backend.",
+	category: "communication",
+	icon: "🖥️",
+
+	image: "lasuite/meet-frontend",
+	imageTag: "latest",
+	ports: [
+		{ host: 8082, container: 8080, description: "Frontend HTTP", exposed: true },
+		{ host: 8083, container: 8083, description: "Frontend alternate (e.g. nginx)", exposed: true },
+	],
+	volumes: [],
+	environment: [],
+	entrypoint: "/docker-entrypoint.sh",
+	command: "nginx -g daemon off;",
+	dependsOn: ["lasuite-meet-backend"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://github.com/suitenumerique/meet",
+	tags: ["lasuite", "meet", "video", "conferencing", "nginx"],
+	maturity: "stable",
+
+	requires: ["lasuite-meet-backend"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 128,
+	gpuRequired: false,
+};

package/src/services/definitions/librechat.ts

@@ -0,0 +1,54 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const librechatDefinition: ServiceDefinition = {
+	id: "librechat",
+	name: "LibreChat",
+	description:
+		"Enhanced ChatGPT clone supporting multiple AI providers (Claude, GPT, Gemini, local models) with agents, code interpreter, and more.",
+	category: "ai-platform",
+	icon: "🗨️",
+
+	image: "ghcr.io/danny-avila/librechat",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 3090,
+			container: 3080,
+			description: "LibreChat interface",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "librechat-data",
+			containerPath: "/app/data",
+			description: "LibreChat data",
+		},
+	],
+	environment: [
+		{
+			key: "MONGO_URI",
+			defaultValue: "mongodb://mongodb:27017/LibreChat",
+			secret: false,
+			description: "MongoDB connection",
+			required: true,
+		},
+	],
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://www.librechat.ai/docs",
+	tags: ["chat-ui", "multi-model", "agents", "plugins"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};

package/src/services/definitions/lightpanda.ts

@@ -0,0 +1,61 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const lightpandaDefinition: ServiceDefinition = {
+	id: "lightpanda",
+	name: "LightPanda",
+	description:
+		"Ultra-fast open-source headless browser built in Zig. 9x less memory and 11x faster than Chrome. CDP-compatible with Puppeteer and Playwright for web scraping and AI agent automation.",
+	category: "browser",
+	icon: "🐼",
+	image: "lightpanda/browser",
+	imageTag: "nightly",
+	ports: [
+		{
+			host: 9222,
+			container: 9222,
+			description: "CDP WebSocket protocol",
+			exposed: true,
+		},
+	],
+	volumes: [],
+	environment: [],
+	// No command -- the image's default ENTRYPOINT+CMD starts the CDP server
+	// on port 9222 bound to all interfaces automatically
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+	skills: [{ skillId: "lightpanda-browse", autoInstall: true }],
+	openclawEnvVars: [
+		{
+			key: "LIGHTPANDA_HOST",
+			defaultValue: "lightpanda",
+			secret: false,
+			description: "LightPanda hostname for OpenClaw",
+			required: true,
+		},
+		{
+			key: "LIGHTPANDA_PORT",
+			defaultValue: "9222",
+			secret: false,
+			description: "LightPanda CDP port for OpenClaw",
+			required: true,
+		},
+	],
+	docsUrl: "https://github.com/lightpanda-io/browser",
+	tags: [
+		"headless-browser",
+		"cdp",
+		"zig",
+		"fast",
+		"low-memory",
+		"scraping",
+		"puppeteer",
+		"playwright",
+	],
+	maturity: "beta",
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+	minMemoryMB: 64,
+	gpuRequired: false,
+};