@better-openclaw/core 1.0.22 → 1.0.24

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

package/src/services/definitions/zulip.ts

@@ -0,0 +1,117 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const zulipDefinition: ServiceDefinition = {
+	id: "zulip",
+	name: "Zulip",
+	description:
+		"Threaded team chat combining the immediacy of real-time chat with email's topic-based threading for async collaboration.",
+	category: "communication",
+	icon: "💬",
+
+	image: "zulip/docker-zulip",
+	imageTag: "9.4-0",
+	ports: [
+		{
+			host: 8380,
+			container: 443,
+			description: "Zulip HTTPS",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "zulip-data",
+			containerPath: "/data",
+			description: "Zulip persistent data and uploads",
+		},
+	],
+	environment: [
+		{
+			key: "SETTING_EXTERNAL_HOST",
+			defaultValue: "localhost",
+			secret: false,
+			description: "External hostname for Zulip",
+			required: true,
+		},
+		{
+			key: "SETTING_ZULIP_ADMINISTRATOR",
+			defaultValue: "admin@example.com",
+			secret: false,
+			description: "Email address of the Zulip administrator",
+			required: true,
+		},
+		{
+			key: "SECRETS_secret_key",
+			defaultValue: "${ZULIP_SECRET_KEY}",
+			secret: true,
+			description: "Secret key for Zulip session signing and encryption",
+			required: true,
+		},
+		{
+			key: "SECRETS_email_password",
+			defaultValue: "",
+			secret: true,
+			description: "Email password for Zulip outbound email",
+			required: false,
+		},
+		{
+			key: "DISABLE_HTTPS",
+			defaultValue: "true",
+			secret: false,
+			description: "Disable HTTPS when running behind a reverse proxy",
+			required: false,
+		},
+		{
+			key: "DB_HOST",
+			defaultValue: "postgresql",
+			secret: false,
+			description: "PostgreSQL hostname for Zulip",
+			required: true,
+		},
+		{
+			key: "DB_USER",
+			defaultValue: "zulip",
+			secret: false,
+			description: "PostgreSQL user for Zulip",
+			required: true,
+		},
+		{
+			key: "DB_NAME",
+			defaultValue: "zulip",
+			secret: false,
+			description: "PostgreSQL database name for Zulip",
+			required: true,
+		},
+		{
+			key: "SETTING_MEMCACHED_LOCATION",
+			defaultValue: "redis:11211",
+			secret: false,
+			description: "Memcached-compatible cache location (Redis)",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost:80 || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 5,
+		startPeriod: "120s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://zulip.readthedocs.io/en/latest/production/install.html",
+	tags: ["team-chat", "threaded", "async", "slack-alternative"],
+	maturity: "stable",
+
+	requires: ["postgresql", "redis"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 1024,
+	gpuRequired: false,
+};

package/src/services/registry.test.ts

@@ -31,6 +31,14 @@ describe("service registry", () => {
 		expect(tailscale!.mandatory).toBe(true);
 	});
 
+	it("finds mission-control and it is mandatory with gitSource", () => {
+		const mc = getServiceById("mission-control");
+		expect(mc).toBeDefined();
+		expect(mc!.mandatory).toBe(true);
+		expect(mc!.gitSource).toBeDefined();
+		expect(mc!.gitSource!.repoUrl).toContain("better-openclaw-mission-control");
+	});
+
 	it("finds coolify, dokploy, livekit, and La Suite Meet services by ID", () => {
 		expect(getServiceById("coolify")).toBeDefined();
 		expect(getServiceById("dokploy")).toBeDefined();

package/src/services/registry.ts

@@ -10,6 +10,13 @@ for (const def of allServiceDefinitions) {
 			`Duplicate service definition ID: "${def.id}". Each service must have a unique ID.`,
 		);
 	}
+	const hasImage = def.image && def.imageTag;
+	const hasGitSource = def.gitSource && def.buildContext;
+	if (!hasImage && !hasGitSource) {
+		throw new Error(
+			`Service "${def.id}" must specify either image+imageTag or gitSource+buildContext.`,
+		);
+	}
 	registryMap.set(def.id, def);
 }
 

package/src/skills/manifest.json

@@ -1445,6 +1445,70 @@
       "services": [
         "headscale"
       ]
+    },
+    {
+      "id": "langfuse-trace",
+      "path": "langfuse-trace/SKILL.md",
+      "emoji": "📊",
+      "services": [
+        "langfuse"
+      ]
+    },
+    {
+      "id": "twenty-crm",
+      "path": "twenty-crm/SKILL.md",
+      "emoji": "📇",
+      "services": [
+        "twenty"
+      ]
+    },
+    {
+      "id": "mautic-campaign",
+      "path": "mautic-campaign/SKILL.md",
+      "emoji": "📬",
+      "services": [
+        "mautic"
+      ]
+    },
+    {
+      "id": "airflow-dag",
+      "path": "airflow-dag/SKILL.md",
+      "emoji": "🌪️",
+      "services": [
+        "airflow"
+      ]
+    },
+    {
+      "id": "airbyte-sync",
+      "path": "airbyte-sync/SKILL.md",
+      "emoji": "🔗",
+      "services": [
+        "airbyte"
+      ]
+    },
+    {
+      "id": "fonoster-voice",
+      "path": "fonoster-voice/SKILL.md",
+      "emoji": "📞",
+      "services": [
+        "fonoster"
+      ]
+    },
+    {
+      "id": "medusa-commerce",
+      "path": "medusa-commerce/SKILL.md",
+      "emoji": "🛒",
+      "services": [
+        "medusa"
+      ]
+    },
+    {
+      "id": "axolotl-finetune",
+      "path": "axolotl-finetune/SKILL.md",
+      "emoji": "🦎",
+      "services": [
+        "axolotl"
+      ]
     }
   ]
 }

package/src/skills/registry.ts

@@ -473,7 +473,7 @@ const skillPacks: SkillPack[] = [
 		description:
 			"AI-powered helpdesk with live chat, LLM observability, and ticket management across channels",
 		requiredServices: ["chatwoot", "langfuse", "postgresql", "redis"],
-		skills: ["chatwoot-inbox", "langfuse-trace", "postgresql-query", "redis-cache"],
+		skills: ["chatwoot-support", "langfuse-trace", "postgresql-query", "redis-cache"],
 		icon: "💬",
 		tags: ["support", "chat", "helpdesk", "tickets", "customer-service"],
 	},
@@ -483,7 +483,7 @@ const skillPacks: SkillPack[] = [
 		description:
 			"CRM-driven sales pipeline with email marketing, newsletter management, and lead nurturing",
 		requiredServices: ["twenty", "mautic", "listmonk", "postgresql"],
-		skills: ["twenty-crm", "mautic-campaign", "listmonk-newsletter", "postgresql-query"],
+		skills: ["twenty-crm", "mautic-campaign", "listmonk-email", "postgresql-query"],
 		icon: "📈",
 		tags: ["sales", "crm", "email", "leads", "marketing"],
 	},
@@ -543,7 +543,7 @@ const skillPacks: SkillPack[] = [
 		description:
 			"Full marketing stack with blogging, email automation, newsletter management, and web analytics",
 		requiredServices: ["ghost", "mautic", "listmonk", "umami"],
-		skills: ["ghost-publish", "mautic-campaign", "listmonk-newsletter", "umami-analytics"],
+		skills: ["ghost-publish", "mautic-campaign", "listmonk-email", "umami-analytics"],
 		icon: "📣",
 		tags: ["marketing", "blog", "email", "analytics", "content"],
 	},

package/src/track-analytics.test.ts

@@ -0,0 +1,82 @@
+import { describe, expect, it } from "vitest";
+import { buildAnalyticsPayload } from "./track-analytics.js";
+import type { GenerationInput, GenerationMetadata } from "./types.js";
+
+const baseInput: GenerationInput = {
+	projectName: "test-stack",
+	services: ["postgresql", "redis", "n8n"],
+	skillPacks: ["research-agent"],
+	aiProviders: ["openai"],
+	gsdRuntimes: [],
+	proxy: "caddy",
+	domain: "example.com",
+	gpu: false,
+	platform: "linux/amd64",
+	deployment: "local",
+	deploymentType: "docker",
+	generateSecrets: true,
+	openclawVersion: "latest",
+	monitoring: true,
+	openclawImage: "official",
+	openclawInstallMethod: "docker",
+	hardened: true,
+	deployTarget: "local",
+};
+
+const baseMetadata: GenerationMetadata = {
+	serviceCount: 5,
+	skillCount: 1,
+	estimatedMemoryMB: 2048,
+	resolvedServices: ["postgresql", "redis", "n8n", "caddy", "searxng"],
+	generatedAt: "2026-03-09T00:00:00.000Z",
+};
+
+describe("buildAnalyticsPayload", () => {
+	it("builds payload for a preset-based CLI generation", () => {
+		const payload = buildAnalyticsPayload(baseInput, baseMetadata, "cli", "researcher");
+
+		expect(payload.source).toBe("cli");
+		expect(payload.buildMethod).toBe("preset");
+		expect(payload.presetId).toBe("researcher");
+		expect(payload.services).toEqual(["postgresql", "redis", "n8n"]);
+		expect(payload.skillPacks).toEqual(["research-agent"]);
+		expect(payload.serviceCount).toBe(5);
+		expect(payload.proxy).toBe("caddy");
+		expect(payload.deployment).toBe("local");
+		expect(payload.deploymentType).toBe("docker");
+		expect(payload.platform).toBe("linux/amd64");
+		expect(payload.gpu).toBe(false);
+		expect(payload.monitoring).toBe(true);
+		expect(payload.hasDomain).toBe(true);
+		expect(payload.openclawImage).toBe("official");
+		expect(payload.estimatedMemoryMB).toBe(2048);
+	});
+
+	it("sets buildMethod to custom when no presetId", () => {
+		const payload = buildAnalyticsPayload(baseInput, baseMetadata, "web");
+
+		expect(payload.buildMethod).toBe("custom");
+		expect(payload.presetId).toBeNull();
+	});
+
+	it("sets buildMethod to custom when presetId is null", () => {
+		const payload = buildAnalyticsPayload(baseInput, baseMetadata, "api", null);
+
+		expect(payload.buildMethod).toBe("custom");
+		expect(payload.presetId).toBeNull();
+	});
+
+	it("sets hasDomain to false when no domain in input", () => {
+		const noDomainInput = { ...baseInput, domain: undefined };
+		const payload = buildAnalyticsPayload(noDomainInput, baseMetadata, "mcp");
+
+		expect(payload.hasDomain).toBe(false);
+	});
+
+	it("preserves all source types", () => {
+		for (const source of ["cli", "web", "api", "mcp"] as const) {
+			const payload = buildAnalyticsPayload(baseInput, baseMetadata, source);
+			expect(payload.source).toBe(source);
+		}
+	});
+});

package/src/track-analytics.ts

@@ -0,0 +1,76 @@
+import type { GenerationInput, GenerationMetadata } from "./types.js";
+
+export interface AnalyticsPayload {
+	source: "cli" | "web" | "api" | "mcp";
+	buildMethod: "preset" | "custom";
+	presetId: string | null;
+	services: string[];
+	skillPacks: string[];
+	serviceCount: number;
+	proxy: string;
+	deployment: string;
+	deploymentType: string;
+	platform: string;
+	gpu: boolean;
+	monitoring: boolean;
+	hasDomain: boolean;
+	openclawImage: string;
+	estimatedMemoryMB: number;
+}
+
+/**
+ * Build an analytics payload from generation input and metadata.
+ * Pure function — does not send anything.
+ */
+export function buildAnalyticsPayload(
+	input: GenerationInput,
+	metadata: GenerationMetadata,
+	source: AnalyticsPayload["source"],
+	presetId?: string | null,
+): AnalyticsPayload {
+	return {
+		source,
+		buildMethod: presetId ? "preset" : "custom",
+		presetId: presetId ?? null,
+		services: input.services,
+		skillPacks: input.skillPacks,
+		serviceCount: metadata.serviceCount,
+		proxy: input.proxy,
+		deployment: input.deployment,
+		deploymentType: input.deploymentType,
+		platform: input.platform,
+		gpu: input.gpu,
+		monitoring: input.monitoring,
+		hasDomain: Boolean(input.domain),
+		openclawImage: input.openclawImage,
+		estimatedMemoryMB: metadata.estimatedMemoryMB,
+	};
+}
+
+const DEFAULT_API_URL = "https://better-openclaw.dev/api/v1/analytics/event";
+
+/**
+ * Fire-and-forget POST to the analytics endpoint.
+ * Respects DISABLE_ANALYTICS=true env var.
+ * Silently catches all errors — tracking must never crash the main flow.
+ */
+export async function trackAnalytics(
+	payload: AnalyticsPayload,
+	apiUrl: string = DEFAULT_API_URL,
+): Promise<void> {
+	if (process.env.DISABLE_ANALYTICS === "true") return;
+
+	try {
+		const controller = new AbortController();
+		const timeout = setTimeout(() => controller.abort(), 5000);
+		await fetch(apiUrl, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify(payload),
+			signal: controller.signal,
+		});
+		clearTimeout(timeout);
+	} catch {
+		// Silent — tracking must never block or crash generation
+	}
+}