@better-openclaw/core 1.0.20 → 1.0.22

package/src/services/definitions/appwrite.ts

@@ -0,0 +1,181 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const appwriteDefinition: ServiceDefinition = {
+	id: "appwrite",
+	name: "Appwrite",
+	description:
+		"Self-hosted backend platform for auth, databases, storage, functions, and realtime APIs for web and mobile apps.",
+	category: "dev-tools",
+	icon: "🧱",
+
+	image: "appwrite/appwrite",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 8114,
+			container: 80,
+			description: "Appwrite API and console",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "appwrite-storage",
+			containerPath: "/storage",
+			description: "Appwrite file storage and persistent assets",
+		},
+	],
+	environment: [
+		{
+			key: "_APP_ENV",
+			defaultValue: "production",
+			secret: false,
+			description: "Appwrite runtime environment",
+			required: true,
+		},
+		{
+			key: "_APP_OPENSSL_KEY_V1",
+			defaultValue: "${APPWRITE_OPENSSL_KEY_V1}",
+			secret: true,
+			description: "Primary encryption key for Appwrite secrets and storage",
+			required: true,
+		},
+		{
+			key: "_APP_DOMAIN",
+			defaultValue: "localhost",
+			secret: false,
+			description: "Primary Appwrite domain",
+			required: true,
+		},
+		{
+			key: "_APP_DOMAIN_TARGET",
+			defaultValue: "localhost",
+			secret: false,
+			description: "Target domain for Appwrite endpoints",
+			required: true,
+		},
+		{
+			key: "_APP_DOMAIN_FUNCTIONS",
+			defaultValue: "localhost",
+			secret: false,
+			description: "Domain for Appwrite functions",
+			required: true,
+		},
+		{
+			key: "_APP_DB_HOST",
+			defaultValue: "mariadb",
+			secret: false,
+			description: "MariaDB host",
+			required: true,
+		},
+		{
+			key: "_APP_DB_PORT",
+			defaultValue: "3306",
+			secret: false,
+			description: "MariaDB port",
+			required: true,
+		},
+		{
+			key: "_APP_DB_SCHEMA",
+			defaultValue: "appwrite",
+			secret: false,
+			description: "MariaDB schema name",
+			required: true,
+		},
+		{
+			key: "_APP_DB_USER",
+			defaultValue: "appwrite",
+			secret: false,
+			description: "MariaDB user",
+			required: true,
+		},
+		{
+			key: "_APP_DB_PASS",
+			defaultValue: "${APPWRITE_DB_PASSWORD}",
+			secret: true,
+			description: "MariaDB password",
+			required: true,
+		},
+		{
+			key: "_APP_REDIS_HOST",
+			defaultValue: "redis",
+			secret: false,
+			description: "Redis host",
+			required: true,
+		},
+		{
+			key: "_APP_REDIS_PORT",
+			defaultValue: "6379",
+			secret: false,
+			description: "Redis port",
+			required: true,
+		},
+		{
+			key: "_APP_REDIS_PASS",
+			defaultValue: "${REDIS_PASSWORD}",
+			secret: true,
+			description: "Redis password",
+			required: true,
+		},
+		{
+			key: "_APP_RABBITMQ",
+			defaultValue: "amqp://openclaw:${RABBITMQ_PASSWORD}@rabbitmq:5672/",
+			secret: true,
+			description: "RabbitMQ connection URL",
+			required: true,
+		},
+		{
+			key: "_APP_SYSTEM_EMAIL_NAME",
+			defaultValue: "Appwrite",
+			secret: false,
+			description: "System email sender name",
+			required: true,
+		},
+		{
+			key: "_APP_SYSTEM_EMAIL_ADDRESS",
+			defaultValue: "noreply@appwrite.local",
+			secret: false,
+			description: "System email sender address",
+			required: true,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost/v1/health || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 5,
+		startPeriod: "60s",
+	},
+	dependsOn: ["mariadb", "redis", "rabbitmq"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [{ skillId: "appwrite-backend", autoInstall: true }],
+	openclawEnvVars: [
+		{
+			key: "APPWRITE_HOST",
+			defaultValue: "appwrite",
+			description: "Appwrite service host for API calls",
+			secret: false,
+			required: false,
+		},
+		{
+			key: "APPWRITE_PORT",
+			defaultValue: "80",
+			description: "Appwrite HTTP port",
+			secret: false,
+			required: false,
+		},
+	],
+
+	docsUrl: "https://appwrite.io/docs/advanced/self-hosting/installation",
+	tags: ["backend", "baas", "auth", "storage", "functions", "realtime"],
+	maturity: "beta",
+
+	requires: ["mariadb", "redis", "rabbitmq"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 1024,
+	gpuRequired: false,
+};

package/src/services/definitions/authelia.ts

@@ -0,0 +1,145 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const autheliaDefinition: ServiceDefinition = {
+	id: "authelia",
+	name: "Authelia",
+	description:
+		"Authentication and authorization server for protecting self-hosted apps with SSO, MFA, and access policies behind your reverse proxy.",
+	category: "security",
+	icon: "🔒",
+
+	image: "authelia/authelia",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 9091,
+			container: 9091,
+			description: "Authelia web portal and API",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "authelia-config",
+			containerPath: "/config",
+			description: "Authelia configuration, sqlite storage, and notifier output",
+		},
+	],
+	environment: [
+		{
+			key: "TZ",
+			defaultValue: "UTC",
+			secret: false,
+			description: "Container timezone",
+			required: true,
+		},
+		{
+			key: "AUTHELIA_DOMAIN",
+			defaultValue: "localhost",
+			secret: false,
+			description: "Default protected domain for Authelia session cookies",
+			required: true,
+		},
+		{
+			key: "AUTHELIA_JWT_SECRET",
+			defaultValue: "${AUTHELIA_JWT_SECRET}",
+			secret: true,
+			description: "JWT secret used for identity validation flows",
+			required: true,
+		},
+		{
+			key: "AUTHELIA_SESSION_SECRET",
+			defaultValue: "${AUTHELIA_SESSION_SECRET}",
+			secret: true,
+			description: "Session secret for cookie encryption",
+			required: true,
+		},
+		{
+			key: "AUTHELIA_STORAGE_ENCRYPTION_KEY",
+			defaultValue: "${AUTHELIA_STORAGE_ENCRYPTION_KEY}",
+			secret: true,
+			description: "Encryption key for the local Authelia sqlite storage",
+			required: true,
+		},
+		{
+			key: "AUTHELIA_DEFAULT_USER_PASSWORD_HASH",
+			defaultValue:
+				"$6$rounds=50000$BpLnfgDsc2WD8F2q$Zis.ixdg9s/UOJYrs56b5QEZFiZECu0qZVNsIYxBaNJ7ucIL.nlxVCT5tqh8KHG8X4tlwCFm5r6NTOZZ5qRFN/",
+			secret: false,
+			description:
+				"Password hash for the generated default admin user. Replace with a value from `authelia crypto hash generate argon2` before production use.",
+			required: true,
+		},
+	],
+	command: `/bin/sh -c "mkdir -p /config && cat >/config/users_database.yml <<EOF
+users:
+  admin:
+    disabled: false
+    displayname: 'Admin'
+    password: '\${AUTHELIA_DEFAULT_USER_PASSWORD_HASH}'
+    email: 'admin@localhost'
+    groups:
+      - admins
+EOF
+cat >/config/configuration.yml <<EOF
+server:
+  address: 'tcp://0.0.0.0:9091'
+log:
+  level: 'info'
+theme: 'dark'
+jwt_secret: '\${AUTHELIA_JWT_SECRET}'
+default_redirection_url: 'http://localhost'
+totp:
+  issuer: 'better-openclaw'
+authentication_backend:
+  file:
+    path: '/config/users_database.yml'
+access_control:
+  default_policy: 'deny'
+session:
+  secret: '\${AUTHELIA_SESSION_SECRET}'
+  cookies:
+    - domain: '\${AUTHELIA_DOMAIN}'
+      authelia_url: 'http://localhost:9091'
+storage:
+  encryption_key: '\${AUTHELIA_STORAGE_ENCRYPTION_KEY}'
+  local:
+    path: '/config/db.sqlite3'
+notifier:
+  filesystem:
+    filename: '/config/notification.txt'
+EOF
+authelia --config /config/configuration.yml"`,
+	healthcheck: {
+		test: "curl -sf http://localhost:9091/api/health || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 5,
+		startPeriod: "30s",
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [{ skillId: "authelia-auth", autoInstall: true }],
+	openclawEnvVars: [
+		{
+			key: "AUTHELIA_PORTAL_URL",
+			defaultValue: "http://authelia:9091",
+			description: "Authelia portal URL for reverse proxy",
+			secret: false,
+			required: false,
+		},
+	],
+
+	docsUrl: "https://www.authelia.com/",
+	tags: ["auth", "sso", "mfa", "access-control", "reverse-proxy", "security"],
+	maturity: "beta",
+
+	requires: [],
+	recommends: ["caddy", "traefik"],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/axolotl.ts

@@ -0,0 +1,65 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const axolotlDefinition: ServiceDefinition = {
+	id: "axolotl",
+	name: "Axolotl",
+	description:
+		"Streamlined LLM fine-tuning framework supporting LoRA, QLoRA, and full fine-tuning with YAML-based configuration.",
+	category: "fine-tuning",
+	icon: "🎯",
+
+	image: "winglian/axolotl",
+	imageTag: "main-latest",
+	ports: [],
+	volumes: [
+		{
+			name: "axolotl-models",
+			containerPath: "/workspace/models",
+			description: "Base models and fine-tuned outputs",
+		},
+		{
+			name: "axolotl-data",
+			containerPath: "/workspace/data",
+			description: "Training datasets",
+		},
+		{
+			name: "axolotl-configs",
+			containerPath: "/workspace/configs",
+			description: "Training configuration YAML files",
+		},
+	],
+	environment: [
+		{
+			key: "WANDB_DISABLED",
+			defaultValue: "true",
+			secret: false,
+			description: "Disable Weights & Biases logging by default",
+			required: false,
+		},
+		{
+			key: "HF_TOKEN",
+			defaultValue: "${HF_TOKEN}",
+			secret: true,
+			description: "HuggingFace token for gated model access",
+			required: false,
+		},
+	],
+	command: "sleep infinity",
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://github.com/axolotl-ai-cloud/axolotl",
+	tags: ["fine-tuning", "llm", "lora", "qlora", "training", "ai"],
+	maturity: "beta",
+
+	requires: [],
+	recommends: ["ollama", "minio"],
+	conflictsWith: [],
+
+	minMemoryMB: 4096,
+	gpuRequired: true,
+};

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