@better-openclaw/core 1.0.21 → 1.0.23

package/src/services/definitions/calibre-web.ts

@@ -0,0 +1,95 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const calibreWebDefinition: ServiceDefinition = {
+	id: "calibre-web",
+	name: "Calibre-Web",
+	description:
+		"Web-based ebook management interface for browsing, reading, and downloading books from a Calibre library.",
+	category: "media",
+	icon: "📖",
+
+	image: "lscr.io/linuxserver/calibre-web",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 8083,
+			container: 8083,
+			description: "Calibre-Web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "calibreweb-config",
+			containerPath: "/config",
+			description: "Calibre-Web configuration",
+		},
+		{
+			name: "calibreweb-books",
+			containerPath: "/books",
+			description: "Book library",
+		},
+	],
+	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,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost:8083 || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "30s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [
+		{
+			key: "CALIBREWEB_HOST",
+			defaultValue: "calibre-web",
+			secret: false,
+			description: "Calibre-Web hostname",
+			required: false,
+		},
+		{
+			key: "CALIBREWEB_PORT",
+			defaultValue: "8083",
+			secret: false,
+			description: "Calibre-Web port",
+			required: false,
+		},
+	],
+
+	docsUrl: "https://github.com/janeczku/calibre-web/wiki",
+	tags: ["ebooks", "reading", "library", "calibre", "kindle"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 128,
+	gpuRequired: false,
+};

package/src/services/definitions/chatwoot-worker.ts

@@ -0,0 +1,93 @@
+import type { ServiceDefinition } from "../../types.js";
+
+const chatwootSharedEnv = [
+	{
+		key: "RAILS_ENV",
+		defaultValue: "production",
+		secret: false,
+		description: "Rails runtime environment",
+		required: true,
+	},
+	{
+		key: "NODE_ENV",
+		defaultValue: "production",
+		secret: false,
+		description: "Node runtime environment",
+		required: true,
+	},
+	{
+		key: "INSTALLATION_ENV",
+		defaultValue: "docker",
+		secret: false,
+		description: "Deployment mode indicator",
+		required: true,
+	},
+	{
+		key: "SECRET_KEY_BASE",
+		defaultValue: "${CHATWOOT_SECRET_KEY_BASE}",
+		secret: true,
+		description: "Rails secret key base",
+		required: true,
+	},
+	{
+		key: "FRONTEND_URL",
+		defaultValue: "http://localhost:3011",
+		secret: false,
+		description: "Public Chatwoot URL",
+		required: true,
+	},
+	{
+		key: "DATABASE_URL",
+		defaultValue: "postgresql://chatwoot:${CHATWOOT_DB_PASSWORD}@postgresql:5432/chatwoot",
+		secret: true,
+		description: "PostgreSQL connection URL",
+		required: true,
+	},
+	{
+		key: "REDIS_URL",
+		defaultValue: "redis://:${REDIS_PASSWORD}@redis:6379",
+		secret: true,
+		description: "Redis connection URL",
+		required: true,
+	},
+] as const;
+
+export const chatwootWorkerDefinition: ServiceDefinition = {
+	id: "chatwoot-worker",
+	name: "Chatwoot (Worker)",
+	description:
+		"Background worker for Chatwoot. Processes jobs such as webhooks, emails, inbox automation, and asynchronous conversation tasks.",
+	category: "communication",
+	icon: "⚙️",
+
+	image: "chatwoot/chatwoot",
+	imageTag: "latest",
+	ports: [],
+	volumes: [],
+	environment: [...chatwootSharedEnv],
+	command: "bundle exec sidekiq -C config/sidekiq.yml",
+	healthcheck: {
+		test: "ps aux | grep sidekiq | grep -v grep || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 5,
+		startPeriod: "45s",
+	},
+	dependsOn: ["postgresql", "redis"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://developers.chatwoot.com/self-hosted/deployment/docker",
+	tags: ["support", "chat", "crm", "inbox", "customer-success", "worker"],
+	maturity: "stable",
+
+	requires: ["postgresql", "redis"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};

package/src/services/definitions/chatwoot.ts

@@ -0,0 +1,106 @@
+import type { ServiceDefinition } from "../../types.js";
+
+const chatwootSharedEnv = [
+	{
+		key: "RAILS_ENV",
+		defaultValue: "production",
+		secret: false,
+		description: "Rails runtime environment",
+		required: true,
+	},
+	{
+		key: "NODE_ENV",
+		defaultValue: "production",
+		secret: false,
+		description: "Node runtime environment",
+		required: true,
+	},
+	{
+		key: "INSTALLATION_ENV",
+		defaultValue: "docker",
+		secret: false,
+		description: "Deployment mode indicator",
+		required: true,
+	},
+	{
+		key: "SECRET_KEY_BASE",
+		defaultValue: "${CHATWOOT_SECRET_KEY_BASE}",
+		secret: true,
+		description: "Rails secret key base",
+		required: true,
+	},
+	{
+		key: "FRONTEND_URL",
+		defaultValue: "http://localhost:3011",
+		secret: false,
+		description: "Public Chatwoot URL",
+		required: true,
+	},
+	{
+		key: "DATABASE_URL",
+		defaultValue: "postgresql://chatwoot:${CHATWOOT_DB_PASSWORD}@postgresql:5432/chatwoot",
+		secret: true,
+		description: "PostgreSQL connection URL",
+		required: true,
+	},
+	{
+		key: "REDIS_URL",
+		defaultValue: "redis://:${REDIS_PASSWORD}@redis:6379",
+		secret: true,
+		description: "Redis connection URL",
+		required: true,
+	},
+] as const;
+
+export const chatwootDefinition: ServiceDefinition = {
+	id: "chatwoot",
+	name: "Chatwoot",
+	description:
+		"Customer support inbox and live chat platform for managing conversations, support workflows, agents, and product feedback across channels.",
+	category: "communication",
+	icon: "💬",
+
+	image: "chatwoot/chatwoot",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 3011,
+			container: 3000,
+			description: "Chatwoot web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "chatwoot-storage",
+			containerPath: "/app/storage",
+			description: "Chatwoot uploaded assets and attachments",
+		},
+	],
+	environment: [...chatwootSharedEnv],
+	command: "bundle exec rails s -p 3000 -b 0.0.0.0",
+	healthcheck: {
+		test: "curl -sf http://localhost:3000/ || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 5,
+		startPeriod: "45s",
+	},
+	dependsOn: ["postgresql", "redis", "chatwoot-worker"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://developers.chatwoot.com/self-hosted/deployment/docker",
+	tags: ["support", "chat", "crm", "inbox", "customer-success", "live-chat"],
+	maturity: "stable",
+
+	requires: ["postgresql", "redis", "chatwoot-worker"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};

package/src/services/definitions/clickhouse.ts

@@ -0,0 +1,115 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const clickhouseDefinition: ServiceDefinition = {
+	id: "clickhouse",
+	name: "ClickHouse",
+	description:
+		"High-performance columnar database for online analytical processing (OLAP). Optimized for real-time analytics on large datasets with SQL support.",
+	category: "database",
+	icon: "🏠",
+
+	image: "clickhouse/clickhouse-server",
+	imageTag: "24.12",
+	ports: [
+		{
+			host: 8123,
+			container: 8123,
+			description: "ClickHouse HTTP API",
+			exposed: true,
+		},
+		{
+			host: 9000,
+			container: 9000,
+			description: "ClickHouse Native TCP protocol",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "clickhouse-data",
+			containerPath: "/var/lib/clickhouse",
+			description: "Persistent ClickHouse data storage",
+		},
+		{
+			name: "clickhouse-logs",
+			containerPath: "/var/log/clickhouse-server",
+			description: "ClickHouse server logs",
+		},
+	],
+	environment: [
+		{
+			key: "CLICKHOUSE_DB",
+			defaultValue: "default",
+			secret: false,
+			description: "Default database name",
+			required: true,
+		},
+		{
+			key: "CLICKHOUSE_USER",
+			defaultValue: "openclaw",
+			secret: false,
+			description: "ClickHouse admin user",
+			required: true,
+		},
+		{
+			key: "CLICKHOUSE_PASSWORD",
+			defaultValue: "${CLICKHOUSE_PASSWORD}",
+			secret: true,
+			description: "ClickHouse admin password",
+			required: true,
+		},
+		{
+			key: "CLICKHOUSE_DEFAULT_ACCESS_MANAGEMENT",
+			defaultValue: "1",
+			secret: false,
+			description: "Enable SQL-driven access management and account creation",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "wget -qO- http://localhost:8123/ping || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "30s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [
+		{
+			key: "CLICKHOUSE_HOST",
+			defaultValue: "clickhouse",
+			secret: false,
+			description: "ClickHouse hostname",
+			required: false,
+		},
+		{
+			key: "CLICKHOUSE_HTTP_PORT",
+			defaultValue: "8123",
+			secret: false,
+			description: "ClickHouse HTTP API port",
+			required: false,
+		},
+		{
+			key: "CLICKHOUSE_TCP_PORT",
+			defaultValue: "9000",
+			secret: false,
+			description: "ClickHouse Native TCP port",
+			required: false,
+		},
+	],
+
+	docsUrl: "https://clickhouse.com/docs",
+	tags: ["columnar", "analytics", "olap", "time-series", "sql"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 1024,
+	gpuRequired: false,
+};

package/src/services/definitions/cloudflared.ts

@@ -0,0 +1,55 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const cloudflaredDefinition: ServiceDefinition = {
+	id: "cloudflared",
+	name: "Cloudflare Tunnel",
+	description:
+		"Secure tunnel to expose local services to the internet without port forwarding using Cloudflare's network.",
+	category: "dns-networking",
+	icon: "☁️",
+
+	image: "cloudflare/cloudflared",
+	imageTag: "latest",
+	command: "tunnel run",
+	ports: [],
+	volumes: [
+		{
+			name: "cloudflared-config",
+			containerPath: "/etc/cloudflared",
+			description: "Tunnel configuration and credentials",
+		},
+	],
+	environment: [
+		{
+			key: "TUNNEL_TOKEN",
+			defaultValue: "",
+			secret: true,
+			description: "Cloudflare Tunnel token from dashboard",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "cloudflared tunnel info || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "15s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/",
+	tags: ["tunnel", "cloudflare", "zero-trust", "ingress", "no-port-forward"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 64,
+	gpuRequired: false,
+};

package/src/services/definitions/cockroachdb.ts

@@ -0,0 +1,75 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const cockroachdbDefinition: ServiceDefinition = {
+	id: "cockroachdb",
+	name: "CockroachDB",
+	description:
+		"Distributed SQL database with horizontal scaling, strong consistency, and PostgreSQL wire protocol compatibility.",
+	category: "database",
+	icon: "🪳",
+
+	image: "cockroachdb/cockroach",
+	imageTag: "latest-v24.3",
+	command: "start-single-node --insecure",
+	ports: [
+		{
+			host: 26257,
+			container: 26257,
+			description: "CockroachDB SQL port",
+			exposed: true,
+		},
+		{
+			host: 8090,
+			container: 8080,
+			description: "CockroachDB admin UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "cockroachdb-data",
+			containerPath: "/cockroach/cockroach-data",
+			description: "Persistent CockroachDB data",
+		},
+	],
+	environment: [],
+	healthcheck: {
+		test: "curl -sf http://localhost:8080/health || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "60s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [
+		{
+			key: "COCKROACHDB_HOST",
+			defaultValue: "cockroachdb",
+			secret: false,
+			description: "CockroachDB hostname",
+			required: false,
+		},
+		{
+			key: "COCKROACHDB_PORT",
+			defaultValue: "26257",
+			secret: false,
+			description: "CockroachDB port",
+			required: false,
+		},
+	],
+
+	docsUrl: "https://www.cockroachlabs.com/docs/",
+	tags: ["distributed-sql", "postgresql-compatible", "horizontal-scaling", "acid"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 1024,
+	gpuRequired: false,
+};

package/src/services/definitions/coder.ts

@@ -0,0 +1,68 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const coderDefinition: ServiceDefinition = {
+	id: "coder",
+	name: "Coder",
+	description:
+		"Cloud development environment platform providing consistent, reproducible workspaces with IDE support and infrastructure templates.",
+	category: "dev-tools",
+	icon: "💻",
+
+	image: "ghcr.io/coder/coder",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 7080,
+			container: 7080,
+			description: "Coder web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "coder-data",
+			containerPath: "/home/coder/.config/coderv2",
+			description: "Coder server data",
+		},
+	],
+	environment: [
+		{
+			key: "CODER_ACCESS_URL",
+			defaultValue: "http://localhost:7080",
+			secret: false,
+			description: "External access URL",
+			required: true,
+		},
+		{
+			key: "CODER_PG_CONNECTION_URL",
+			defaultValue: "postgresql://coder:${CODER_DB_PASSWORD}@postgresql:5432/coder?sslmode=disable",
+			secret: false,
+			description: "PostgreSQL connection string",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost:7080/api/v2/buildinfo || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "30s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://coder.com/docs",
+	tags: ["cloud-ide", "workspaces", "remote-development", "devcontainers"],
+	maturity: "stable",
+
+	requires: ["postgresql"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};

package/src/services/definitions/dagster.ts

@@ -0,0 +1,82 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const dagsterDefinition: ServiceDefinition = {
+	id: "dagster",
+	name: "Dagster",
+	description:
+		"Asset-focused data orchestration platform with observability, testing, and scheduling for modern data pipelines.",
+	category: "automation",
+	icon: "📊",
+
+	image: "dagster/dagster-webserver",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 3035,
+			container: 3000,
+			description: "Dagster web UI (Dagit)",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "dagster-storage",
+			containerPath: "/opt/dagster/dagster_home",
+			description: "Dagster instance storage and run logs",
+		},
+	],
+	environment: [
+		{
+			key: "DAGSTER_PG_HOST",
+			defaultValue: "postgresql",
+			secret: false,
+			description: "PostgreSQL host",
+			required: true,
+		},
+		{
+			key: "DAGSTER_PG_DB",
+			defaultValue: "dagster",
+			secret: false,
+			description: "PostgreSQL database name",
+			required: true,
+		},
+		{
+			key: "DAGSTER_PG_USERNAME",
+			defaultValue: "dagster",
+			secret: false,
+			description: "PostgreSQL username",
+			required: true,
+		},
+		{
+			key: "DAGSTER_PG_PASSWORD",
+			defaultValue: "${DAGSTER_DB_PASSWORD}",
+			secret: true,
+			description: "PostgreSQL password",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost:3000/server_info || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 3,
+		startPeriod: "30s",
+	},
+	dependsOn: ["postgresql"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://docs.dagster.io/deployment/guides/docker",
+	tags: ["data", "pipeline", "orchestration", "etl", "assets", "observability"],
+	maturity: "stable",
+
+	requires: ["postgresql"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};