@better-openclaw/core 1.0.20 → 1.0.22

package/src/deployers/types.ts

@@ -7,7 +7,7 @@
  * registering it in `deployers/index.ts`.
  *
  * Architecture:
- *   Web UI / CLI  -->  API relay (/v1/deploy)  -->  PaaS instance (Dokploy/Coolify)
+ *   Web UI / CLI  -->  API relay (/api/v1/deploy)  -->  PaaS instance (Dokploy/Coolify)
  *
  * The API server acts as a relay to avoid CORS issues when deploying from the
  * browser. The CLI calls the deployer directly (no relay needed).
@@ -33,6 +33,8 @@ export interface DeployInput {
 	envContent: string;
 	/** Optional description */
 	description?: string;
+	/** Optional server ID to deploy to (for PaaS platforms managing multiple servers) */
+	serverId?: string;
 }
 
 /** Step-level status for deploy progress. */
@@ -57,6 +59,16 @@ export interface DeployResult {
 	error?: string;
 }
 
+/** Server available on a PaaS platform. */
+export interface PaasServer {
+	/** Server ID (used as identifier when deploying) */
+	id: string;
+	/** Human-readable server name */
+	name: string;
+	/** Server IP address or hostname */
+	ip?: string;
+}
+
 /** Interface that all PaaS deployers implement. */
 export interface PaasDeployer {
 	/** Human-readable name */
@@ -67,4 +79,176 @@ export interface PaasDeployer {
 	testConnection(target: DeployTarget): Promise<{ ok: boolean; error?: string }>;
 	/** Deploy a compose stack */
 	deploy(input: DeployInput): Promise<DeployResult>;
+	/** List available servers on the PaaS instance (optional — not all providers manage multiple servers) */
+	listServers?(target: DeployTarget): Promise<PaasServer[]>;
+}
+
+export interface ProviderCapabilities {
+	compose: boolean;
+	dockerImage: boolean;
+	volumes: boolean;
+	domains: boolean;
+	secrets: boolean;
+}
+
+export interface DeploymentResult {
+	success: boolean;
+	url?: string;
+	message?: string;
+}
+
+export interface DeploymentProvider {
+	id: string;
+	name: string;
+
+	capabilities: ProviderCapabilities;
+
+	deploy(config: NormalizedApp): Promise<DeploymentResult>;
+
+	createSecret?(key: string, value: string): Promise<void>;
+
+	createDomain?(service: string, domain: string): Promise<void>;
+}
+
+export interface NormalizedApp {
+	name: string;
+	services: NormalizedService[];
+	env: Record<string, string>;
+}
+
+export interface NormalizedService {
+	name: string;
+	image?: string;
+	build?: string;
+	ports?: number[];
+	volumes?: string[];
+	env?: Record<string, string>;
+}
+
+export interface DokployEnvironment {
+	environmentId: string;
+	name: string;
+	description: string;
+	createdAt: string;
+	env: string;
+	projectId: string;
+	isDefault: boolean;
+	applications: DokployApplication[];
+	mariadb: any[];
+	mongo: any[];
+	mysql: any[];
+	postgres: any[];
+	redis: any[];
+	compose: any[];
+	project: Project;
+}
+
+export interface DokployApplication {
+	applicationId: string;
+	name: string;
+	appName: string;
+	description: string;
+	env: string;
+	previewEnv: any;
+	watchPaths: any[];
+	previewBuildArgs: any;
+	previewBuildSecrets: any;
+	previewLabels: any;
+	previewWildcard: any;
+	previewPort: number;
+	previewHttps: boolean;
+	previewPath: string;
+	previewCertificateType: string;
+	previewCustomCertResolver: any;
+	previewLimit: number;
+	isPreviewDeploymentsActive: boolean;
+	previewRequireCollaboratorPermissions: boolean;
+	rollbackActive: boolean;
+	buildArgs: string;
+	buildSecrets: string;
+	memoryReservation: any;
+	memoryLimit: any;
+	cpuReservation: any;
+	cpuLimit: any;
+	title: any;
+	enabled: any;
+	subtitle: any;
+	command: any;
+	args: any;
+	refreshToken: string;
+	sourceType: string;
+	cleanCache: boolean;
+	repository: string;
+	owner: string;
+	branch: string;
+	buildPath: string;
+	triggerType: string;
+	autoDeploy: boolean;
+	gitlabProjectId: any;
+	gitlabRepository: any;
+	gitlabOwner: any;
+	gitlabBranch: any;
+	gitlabBuildPath: string;
+	gitlabPathNamespace: any;
+	giteaRepository: any;
+	giteaOwner: any;
+	giteaBranch: any;
+	giteaBuildPath: string;
+	bitbucketRepository: any;
+	bitbucketRepositorySlug: any;
+	bitbucketOwner: any;
+	bitbucketBranch: any;
+	bitbucketBuildPath: string;
+	username: any;
+	password: any;
+	dockerImage: any;
+	registryUrl: any;
+	customGitUrl: any;
+	customGitBranch: any;
+	customGitBuildPath: any;
+	customGitSSHKeyId: any;
+	enableSubmodules: boolean;
+	dockerfile: any;
+	dockerContextPath: any;
+	dockerBuildStage: any;
+	dropBuildPath: any;
+	healthCheckSwarm: any;
+	restartPolicySwarm: any;
+	placementSwarm: any;
+	updateConfigSwarm: any;
+	rollbackConfigSwarm: any;
+	modeSwarm: any;
+	labelsSwarm: any;
+	networkSwarm: any;
+	stopGracePeriodSwarm: any;
+	endpointSpecSwarm: any;
+	ulimitsSwarm: any;
+	replicas: number;
+	applicationStatus: string;
+	buildType: string;
+	railpackVersion: string;
+	herokuVersion: any;
+	publishDirectory: any;
+	isStaticSpa: any;
+	createEnvFile: boolean;
+	createdAt: string;
+	registryId: any;
+	rollbackRegistryId: any;
+	environmentId: string;
+	githubId: string;
+	gitlabId: any;
+	giteaId: any;
+	bitbucketId: any;
+	serverId: string;
+	buildServerId: any;
+	buildRegistryId: any;
+}
+
+export interface Project {
+	projectId: string;
+	name: string;
+	description: string;
+	createdAt: string;
+	organizationId: string;
+	env: string;
 }

package/src/generators/postgres-init.ts

@@ -38,6 +38,12 @@ const DB_REQUIREMENTS: Record<string, Omit<DbRequirement, "serviceId" | "service
 	"cal-com": { dbName: "calcom", dbUser: "calcom", passwordEnvVar: "CALCOM_DB_PASSWORD" },
 	immich: { dbName: "immich", dbUser: "immich", passwordEnvVar: "IMMICH_DB_PASSWORD" },
 	authentik: { dbName: "authentik", dbUser: "authentik", passwordEnvVar: "AUTHENTIK_DB_PASSWORD" },
+	chatwoot: { dbName: "chatwoot", dbUser: "chatwoot", passwordEnvVar: "CHATWOOT_DB_PASSWORD" },
+	firecrawl: { dbName: "firecrawl", dbUser: "firecrawl", passwordEnvVar: "FIRECRAWL_DB_PASSWORD" },
+	flagsmith: { dbName: "flagsmith", dbUser: "flagsmith", passwordEnvVar: "FLAGSMITH_DB_PASSWORD" },
+	infisical: { dbName: "infisical", dbUser: "infisical", passwordEnvVar: "INFISICAL_DB_PASSWORD" },
+	keycloak: { dbName: "keycloak", dbUser: "keycloak", passwordEnvVar: "KEYCLOAK_DB_PASSWORD" },
+	listmonk: { dbName: "listmonk", dbUser: "listmonk", passwordEnvVar: "LISTMONK_DB_PASSWORD" },
 	"lasuite-meet-backend": {
 		dbName: "meet",
 		dbUser: "meet",

package/src/index.ts

@@ -15,6 +15,7 @@ export type {
 	DeployStep as PaasDeployStep,
 	DeployTarget as PaasDeployTarget,
 	PaasDeployer,
+	PaasServer,
 } from "./deployers/index.js";
 export {
 	CoolifyDeployer,
@@ -29,10 +30,16 @@ export { generate, generateServicesDoc } from "./generate.js";
 export { generateCaddyfile } from "./generators/caddy.js";
 export type { EnvVarGroup } from "./generators/env.js";
 export { generateEnvFiles, getStructuredEnvVars } from "./generators/env.js";
-export { generateGrafanaConfig, generateGrafanaDashboard } from "./generators/grafana.js";
+export {
+	generateGrafanaConfig,
+	generateGrafanaDashboard,
+} from "./generators/grafana.js";
 export { generateHealthCheck } from "./generators/health-check.js";
 export { generateN8nWorkflows } from "./generators/n8n-workflows.js";
-export { generatePostgresInit, getDbRequirements } from "./generators/postgres-init.js";
+export {
+	generatePostgresInit,
+	getDbRequirements,
+} from "./generators/postgres-init.js";
 export { generatePrometheusConfig } from "./generators/prometheus.js";
 export { generateReadme } from "./generators/readme.js";
 export { generateScripts } from "./generators/scripts.js";
@@ -44,12 +51,20 @@ export type {
 } from "./generators/stack-manifest.js";
 export { generateStackManifest } from "./generators/stack-manifest.js";
 // ─── Config Migrations ──────────────────────────────────────────────────────
-export { CURRENT_CONFIG_VERSION, migrateConfig, needsMigration } from "./migrations.js";
+export {
+	CURRENT_CONFIG_VERSION,
+	migrateConfig,
+	needsMigration,
+} from "./migrations.js";
 // ─── Port Scanner ───────────────────────────────────────────────────────────
 export type { PortConflict } from "./port-scanner.js";
 export { formatPortConflicts, scanPortConflicts } from "./port-scanner.js";
 // ─── Presets ────────────────────────────────────────────────────────────────
-export { getAllPresets, getPresetById, presetRegistry } from "./presets/registry.js";
+export {
+	getAllPresets,
+	getPresetById,
+	presetRegistry,
+} from "./presets/registry.js";
 export { resolve } from "./resolver.js";
 export {
 	AddedDependencySchema,

package/src/presets/presets.test.ts

@@ -43,6 +43,10 @@ describe("preset smoke tests", () => {
 				generateSecrets: false,
 				openclawVersion: "latest",
 				monitoring: false,
+				openclawImage: "official",
+				openclawInstallMethod: "docker",
+				deployTarget: "local",
+				hardened: false,
 			});
 
 			expect(result.files["docker-compose.yml"]).toBeDefined();

package/src/presets/registry.ts

@@ -128,6 +128,94 @@ const presets: Preset[] = [
 		skillPacks: [],
 		estimatedMemoryMB: 2048,
 	},
+	// ── New service presets ─────────────────────────────────────────────────
+	{
+		id: "backend-platform",
+		name: "Backend Platform",
+		description:
+			"BaaS stack with Appwrite, MariaDB, Redis, RabbitMQ for auth, storage, and async workflows",
+		services: ["appwrite", "mariadb", "redis", "rabbitmq", "caddy"],
+		skillPacks: ["appwrite-platform"],
+		estimatedMemoryMB: 3072,
+	},
+	{
+		id: "rag-platform",
+		name: "RAG Platform",
+		description:
+			"RAGFlow with MySQL, Redis, MinIO, OpenSearch for knowledge ingestion and grounded AI assistants",
+		services: ["ragflow", "mysql", "redis", "minio", "opensearch", "caddy"],
+		skillPacks: ["ragflow-platform"],
+		estimatedMemoryMB: 6144,
+	},
+	{
+		id: "zero-trust",
+		name: "Zero-Trust Security",
+		description:
+			"SSO, secrets management, and access control with Authelia, Keycloak, and Infisical",
+		services: ["authelia", "keycloak", "infisical", "postgresql", "redis", "caddy"],
+		skillPacks: ["authelia-security"],
+		estimatedMemoryMB: 3584,
+	},
+	{
+		id: "content-platform",
+		name: "Content Platform",
+		description: "CMS and newsletter stack with Directus, Strapi, Listmonk, and Stirling PDF",
+		services: ["directus", "strapi", "listmonk", "postgresql", "redis", "stirling-pdf", "caddy"],
+		skillPacks: ["cms-stack"],
+		estimatedMemoryMB: 3584,
+	},
+	{
+		id: "ai-orchestrator",
+		name: "AI Orchestrator",
+		description: "Langflow and Firecrawl for building and deploying AI workflows",
+		services: ["langflow", "firecrawl", "postgresql", "redis", "caddy"],
+		skillPacks: ["ai-agent-orchestra"],
+		estimatedMemoryMB: 3072,
+	},
+	// ── New Presets (from feature analysis) ───────────────────────────────────
+	{
+		id: "support-desk",
+		name: "Support Desk",
+		description:
+			"AI-powered customer support with live chat, LLM observability, and ticket management",
+		services: ["chatwoot", "chatwoot-worker", "langfuse", "redis", "postgresql", "caddy"],
+		skillPacks: ["customer-support"],
+		estimatedMemoryMB: 3072,
+	},
+	{
+		id: "sales-machine",
+		name: "Sales Machine",
+		description:
+			"CRM-driven sales pipeline with email marketing, newsletters, and workflow automation",
+		services: ["twenty", "mautic", "listmonk", "n8n", "postgresql", "mysql", "redis", "caddy"],
+		skillPacks: ["sales-pipeline"],
+		estimatedMemoryMB: 4096,
+	},
+	{
+		id: "data-warehouse",
+		name: "Data Warehouse",
+		description: "End-to-end data pipeline with DAG orchestration, 300+ connectors, and monitoring",
+		services: ["airflow", "airbyte", "postgresql", "grafana", "prometheus", "redis", "caddy"],
+		skillPacks: ["data-pipeline"],
+		estimatedMemoryMB: 4096,
+	},
+	{
+		id: "voice-center",
+		name: "Voice Center",
+		description:
+			"AI voice agent stack with programmable telephony, transcription, and real-time comms",
+		services: ["fonoster", "livekit", "whisper", "redis", "caddy"],
+		skillPacks: ["voice-agent"],
+		estimatedMemoryMB: 3072,
+	},
+	{
+		id: "shopfront",
+		name: "Shopfront",
+		description: "AI-managed headless e-commerce with product management and object storage",
+		services: ["medusa", "minio", "postgresql", "redis", "caddy"],
+		skillPacks: ["ecommerce-ops"],
+		estimatedMemoryMB: 2560,
+	},
 ];
 
 const presetMap = new Map<string, Preset>();

package/src/schema.ts

@@ -23,6 +23,17 @@ export const ServiceCategorySchema = z.enum([
 	"desktop",
 	"streaming",
 	"security",
+	"billing",
+	"crm",
+	"email-marketing",
+	"forms",
+	"api-gateway",
+	"backup",
+	"voice",
+	"ecommerce",
+	"collaboration",
+	"ai-observability",
+	"fine-tuning",
 ]);
 
 export const MaturitySchema = z.enum(["stable", "beta", "experimental"]);

package/src/services/definitions/airbyte.ts

@@ -0,0 +1,75 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const airbyteDefinition: ServiceDefinition = {
+	id: "airbyte",
+	name: "Airbyte",
+	description:
+		"Open-source data integration platform with 300+ connectors for syncing data between databases, APIs, SaaS tools, and warehouses.",
+	category: "automation",
+	icon: "🔄",
+
+	image: "airbyte/airbyte-bootloader",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 8000,
+			container: 8000,
+			description: "Airbyte web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "airbyte-data",
+			containerPath: "/data",
+			description: "Airbyte workspace and connection data",
+		},
+	],
+	environment: [
+		{
+			key: "DATABASE_URL",
+			defaultValue: "jdbc:postgresql://postgresql:5432/airbyte",
+			secret: false,
+			description: "PostgreSQL connection URL",
+			required: true,
+		},
+		{
+			key: "DATABASE_USER",
+			defaultValue: "airbyte",
+			secret: false,
+			description: "Database username",
+			required: true,
+		},
+		{
+			key: "DATABASE_PASSWORD",
+			defaultValue: "${AIRBYTE_DB_PASSWORD}",
+			secret: true,
+			description: "Database password",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost:8000/api/v1/health || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 5,
+		startPeriod: "60s",
+	},
+	dependsOn: ["postgresql"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://docs.airbyte.com/deploying-airbyte/docker-compose",
+	tags: ["data", "integration", "etl", "connectors", "sync", "pipeline"],
+	maturity: "stable",
+
+	requires: ["postgresql"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 1024,
+	gpuRequired: false,
+};

package/src/services/definitions/airflow.ts

@@ -0,0 +1,109 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const airflowDefinition: ServiceDefinition = {
+	id: "airflow",
+	name: "Apache Airflow",
+	description:
+		"Industry-standard DAG-based workflow orchestration platform for scheduling, monitoring, and managing data pipelines and ETL jobs.",
+	category: "automation",
+	icon: "🌬️",
+
+	image: "apache/airflow",
+	imageTag: "2.10.4",
+	ports: [
+		{
+			host: 8080,
+			container: 8080,
+			description: "Airflow web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "airflow-dags",
+			containerPath: "/opt/airflow/dags",
+			description: "Airflow DAG definitions",
+		},
+		{
+			name: "airflow-logs",
+			containerPath: "/opt/airflow/logs",
+			description: "Airflow task logs",
+		},
+	],
+	environment: [
+		{
+			key: "AIRFLOW__CORE__EXECUTOR",
+			defaultValue: "LocalExecutor",
+			secret: false,
+			description: "Airflow executor type",
+			required: true,
+		},
+		{
+			key: "AIRFLOW__DATABASE__SQL_ALCHEMY_CONN",
+			defaultValue: "postgresql+psycopg2://airflow:${AIRFLOW_DB_PASSWORD}@postgresql:5432/airflow",
+			secret: true,
+			description: "Database connection string",
+			required: true,
+		},
+		{
+			key: "AIRFLOW__CORE__FERNET_KEY",
+			defaultValue: "${AIRFLOW_FERNET_KEY}",
+			secret: true,
+			description: "Fernet encryption key for connections",
+			required: true,
+		},
+		{
+			key: "AIRFLOW__WEBSERVER__SECRET_KEY",
+			defaultValue: "${AIRFLOW_SECRET_KEY}",
+			secret: true,
+			description: "Secret key for webserver sessions",
+			required: true,
+		},
+		{
+			key: "_AIRFLOW_WWW_USER_CREATE",
+			defaultValue: "true",
+			secret: false,
+			description: "Create default admin user on startup",
+			required: false,
+		},
+		{
+			key: "_AIRFLOW_WWW_USER_USERNAME",
+			defaultValue: "admin",
+			secret: false,
+			description: "Default admin username",
+			required: false,
+		},
+		{
+			key: "_AIRFLOW_WWW_USER_PASSWORD",
+			defaultValue: "${AIRFLOW_ADMIN_PASSWORD}",
+			secret: true,
+			description: "Default admin password",
+			required: false,
+		},
+	],
+	command: "standalone",
+	healthcheck: {
+		test: "curl -sf http://localhost:8080/health || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 5,
+		startPeriod: "60s",
+	},
+	dependsOn: ["postgresql"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://airflow.apache.org/docs/",
+	tags: ["etl", "dag", "pipeline", "orchestration", "scheduling", "data"],
+	maturity: "stable",
+
+	requires: ["postgresql"],
+	recommends: ["redis"],
+	conflictsWith: [],
+
+	minMemoryMB: 1024,
+	gpuRequired: false,
+};