@better-openclaw/core 1.0.26 → 1.0.30

package/src/services/definitions/nanobot.ts

@@ -0,0 +1,89 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const nanobotDefinition: ServiceDefinition = {
+	id: "nanobot",
+	name: "NanoBot",
+	description:
+		"Ultra-lightweight ~4,000-line Python AI assistant (99% smaller than OpenClaw). Supports 11 LLM providers and 11 messaging channels including Telegram, Discord, and WhatsApp.",
+	category: "agent-framework",
+	icon: "🤏",
+
+	image: "smanx/nanobot",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 18790,
+			container: 18790,
+			description: "NanoBot gateway port",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "nanobot-config",
+			containerPath: "/root/.nanobot",
+			description: "NanoBot config, workspace, and channel data",
+		},
+	],
+	environment: [
+		{
+			key: "ANTHROPIC_API_KEY",
+			defaultValue: "",
+			secret: true,
+			description: "Anthropic API key",
+			required: false,
+		},
+		{
+			key: "OPENAI_API_KEY",
+			defaultValue: "",
+			secret: true,
+			description: "OpenAI API key",
+			required: false,
+		},
+		{
+			key: "OPENROUTER_API_KEY",
+			defaultValue: "",
+			secret: true,
+			description: "OpenRouter API key (supports many models)",
+			required: false,
+		},
+	],
+	healthcheck: {
+		test: "curl -sf http://localhost:18790/health || exit 1",
+		interval: "30s",
+		timeout: "5s",
+		retries: 3,
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [
+		{
+			key: "NANOBOT_HOST",
+			defaultValue: "nanobot",
+			secret: false,
+			description: "NanoBot hostname for gateway integration",
+			required: false,
+		},
+		{
+			key: "NANOBOT_PORT",
+			defaultValue: "18790",
+			secret: false,
+			description: "NanoBot gateway port",
+			required: false,
+		},
+	],
+
+	docsUrl: "https://github.com/HKUDS/nanobot",
+	tags: ["agent", "lightweight", "python", "multi-channel", "multi-provider"],
+	maturity: "beta",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/nanoclaw.ts

@@ -0,0 +1,78 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const nanoclawDefinition: ServiceDefinition = {
+	id: "nanoclaw",
+	name: "NanoClaw",
+	description:
+		"Security-first containerized AI agent (~3,900 lines). Each task runs in an isolated Docker container. Native WhatsApp, Telegram, Discord, Slack, and Gmail support.",
+	category: "agent-framework",
+	icon: "🔒",
+
+	image: "node",
+	imageTag: "22-slim",
+	buildContext: {
+		context: "https://github.com/qwibitai/nanoclaw.git",
+		dockerfile: "container/Dockerfile",
+	},
+	ports: [],
+	volumes: [
+		{
+			name: "nanoclaw-store",
+			containerPath: "/app/store",
+			description: "NanoClaw SQLite database and session data",
+		},
+		{
+			name: "nanoclaw-groups",
+			containerPath: "/app/groups",
+			description: "NanoClaw group workspaces",
+		},
+	],
+	environment: [
+		{
+			key: "ANTHROPIC_API_KEY",
+			defaultValue: "",
+			secret: true,
+			description: "Anthropic API key for Claude (required)",
+			required: true,
+		},
+		{
+			key: "ASSISTANT_NAME",
+			defaultValue: "Andy",
+			secret: false,
+			description: "Bot display name",
+			required: false,
+		},
+		{
+			key: "CONTAINER_IMAGE",
+			defaultValue: "nanoclaw-agent:latest",
+			secret: false,
+			description: "Agent container image for ephemeral task containers",
+			required: false,
+		},
+		{
+			key: "MAX_CONCURRENT_CONTAINERS",
+			defaultValue: "5",
+			secret: false,
+			description: "Maximum parallel agent containers",
+			required: false,
+		},
+	],
+	command: "node dist/index.js",
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://nanoclaw.dev/",
+	tags: ["agent", "security", "whatsapp", "containerized", "claude"],
+	maturity: "beta",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/opensandbox.ts

@@ -16,14 +16,14 @@ export const opensandboxDefinition: ServiceDefinition = {
 			container: 8080,
 			description: "OpenSandbox Lifecycle API (FastAPI)",
 			exposed: true,
+			websocket: true,
 		},
 	],
 	volumes: [
 		{
 			name: "/var/run/docker.sock",
 			containerPath: "/var/run/docker.sock",
-			description:
-				"Docker socket (required for managing sandbox containers)",
+			description: "Docker socket (required for managing sandbox containers)",
 		},
 		{
 			name: "./sandbox.toml",
@@ -36,8 +36,7 @@ export const opensandboxDefinition: ServiceDefinition = {
 			key: "OPEN_SANDBOX_API_KEY",
 			defaultValue: "",
 			secret: true,
-			description:
-				"API key for OpenSandbox lifecycle API authentication (min 32 chars)",
+			description: "API key for OpenSandbox lifecycle API authentication (min 32 chars)",
 			required: true,
 		},
 		{
@@ -58,16 +57,14 @@ export const opensandboxDefinition: ServiceDefinition = {
 			key: "OPENSANDBOX_EXECD_IMAGE",
 			defaultValue: "opensandbox/execd:v1.0.6",
 			secret: false,
-			description:
-				"Execution daemon image injected into sandbox containers",
+			description: "Execution daemon image injected into sandbox containers",
 			required: false,
 		},
 		{
 			key: "OPENSANDBOX_NETWORK_MODE",
 			defaultValue: "bridge",
 			secret: false,
-			description:
-				"Container networking mode (always bridge for isolation)",
+			description: "Container networking mode (always bridge for isolation)",
 			required: false,
 		},
 		{
@@ -129,13 +126,7 @@ export const opensandboxDefinition: ServiceDefinition = {
 	],
 
 	docsUrl: "https://github.com/anthropics/OpenSandbox",
-	tags: [
-		"sandbox",
-		"code-execution",
-		"security",
-		"ai-agent",
-		"isolation",
-	],
+	tags: ["sandbox", "code-execution", "security", "ai-agent", "isolation"],
 	maturity: "stable",
 
 	requires: [],

package/src/services/definitions/relaticle-horizon.ts

@@ -0,0 +1,48 @@
+import type { ServiceDefinition } from "../../types.js";
+import { relaticleSharedEnv } from "./relaticle.js";
+
+export const relaticleHorizonDefinition: ServiceDefinition = {
+	id: "relaticle-horizon",
+	name: "Relaticle (Horizon)",
+	description:
+		"Laravel Horizon queue worker for Relaticle CRM. Processes background jobs such as webhooks, email notifications, and asynchronous data operations.",
+	category: "crm",
+	icon: "⚙️",
+
+	image: "ghcr.io/relaticle/relaticle",
+	imageTag: "latest",
+	ports: [],
+	volumes: [
+		{
+			name: "relaticle-storage",
+			containerPath: "/var/www/html/storage/app",
+			description: "Shared file storage with main Relaticle service",
+		},
+	],
+	environment: [...relaticleSharedEnv],
+	command: "php /var/www/html/artisan horizon",
+	healthcheck: {
+		test: "php /var/www/html/artisan horizon:status | grep running || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 5,
+		startPeriod: "30s",
+	},
+	dependsOn: ["postgresql", "redis"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://github.com/Relaticle/relaticle",
+	tags: ["crm", "worker", "queue", "horizon"],
+	maturity: "stable",
+
+	requires: ["postgresql", "redis"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/relaticle-scheduler.ts

@@ -0,0 +1,42 @@
+import type { ServiceDefinition } from "../../types.js";
+import { relaticleSharedEnv } from "./relaticle.js";
+
+export const relaticleSchedulerDefinition: ServiceDefinition = {
+	id: "relaticle-scheduler",
+	name: "Relaticle (Scheduler)",
+	description:
+		"Laravel task scheduler for Relaticle CRM. Runs periodic background tasks such as data cleanup, report generation, and scheduled notifications.",
+	category: "crm",
+	icon: "🕐",
+
+	image: "ghcr.io/relaticle/relaticle",
+	imageTag: "latest",
+	ports: [],
+	volumes: [],
+	environment: [...relaticleSharedEnv],
+	command: "php /var/www/html/artisan schedule:work",
+	healthcheck: {
+		test: "ps aux | grep 'schedule:work' | grep -v grep || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 5,
+		startPeriod: "30s",
+	},
+	dependsOn: ["postgresql", "redis"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://github.com/Relaticle/relaticle",
+	tags: ["crm", "worker", "scheduler", "cron"],
+	maturity: "stable",
+
+	requires: ["postgresql", "redis"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 128,
+	gpuRequired: false,
+};

package/src/services/definitions/relaticle.ts

@@ -0,0 +1,142 @@
+import type { ServiceDefinition } from "../../types.js";
+
+const relaticleSharedEnv = [
+	{
+		key: "APP_KEY",
+		defaultValue: "${RELATICLE_APP_KEY}",
+		secret: true,
+		description: "Laravel application encryption key",
+		required: true,
+	},
+	{
+		key: "APP_URL",
+		defaultValue: "http://localhost:8080",
+		secret: false,
+		description: "Public URL of the Relaticle instance",
+		required: true,
+	},
+	{
+		key: "APP_ENV",
+		defaultValue: "production",
+		secret: false,
+		description: "Application environment",
+		required: true,
+	},
+	{
+		key: "DB_CONNECTION",
+		defaultValue: "pgsql",
+		secret: false,
+		description: "Database driver",
+		required: true,
+	},
+	{
+		key: "DB_HOST",
+		defaultValue: "postgresql",
+		secret: false,
+		description: "PostgreSQL hostname",
+		required: true,
+	},
+	{
+		key: "DB_PORT",
+		defaultValue: "5432",
+		secret: false,
+		description: "PostgreSQL port",
+		required: true,
+	},
+	{
+		key: "DB_DATABASE",
+		defaultValue: "relaticle",
+		secret: false,
+		description: "Database name",
+		required: true,
+	},
+	{
+		key: "DB_USERNAME",
+		defaultValue: "relaticle",
+		secret: false,
+		description: "Database username",
+		required: true,
+	},
+	{
+		key: "DB_PASSWORD",
+		defaultValue: "${RELATICLE_DB_PASSWORD}",
+		secret: true,
+		description: "Database password",
+		required: true,
+	},
+	{
+		key: "REDIS_HOST",
+		defaultValue: "redis",
+		secret: false,
+		description: "Redis hostname",
+		required: true,
+	},
+	{
+		key: "REDIS_PORT",
+		defaultValue: "6379",
+		secret: false,
+		description: "Redis port",
+		required: true,
+	},
+	{
+		key: "REDIS_PASSWORD",
+		defaultValue: "${REDIS_PASSWORD}",
+		secret: true,
+		description: "Redis password",
+		required: false,
+	},
+] as const;
+
+export const relaticleDefinition: ServiceDefinition = {
+	id: "relaticle",
+	name: "Relaticle",
+	description:
+		"Next-generation open-source CRM platform built with Laravel and Filament, featuring customizable pipelines, contacts, companies, and task management.",
+	category: "crm",
+	icon: "📇",
+
+	image: "ghcr.io/relaticle/relaticle",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 8080,
+			container: 8080,
+			description: "Relaticle web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "relaticle-storage",
+			containerPath: "/var/www/html/storage/app",
+			description: "Persistent file storage for uploads and attachments",
+		},
+	],
+	environment: [...relaticleSharedEnv],
+	healthcheck: {
+		test: "curl -sf http://localhost:8080/up || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 5,
+		startPeriod: "45s",
+	},
+	dependsOn: ["postgresql", "redis", "relaticle-horizon", "relaticle-scheduler"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://github.com/Relaticle/relaticle",
+	tags: ["crm", "sales", "contacts", "pipeline", "customer", "laravel"],
+	maturity: "stable",
+
+	requires: ["postgresql", "redis", "relaticle-horizon", "relaticle-scheduler"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};
+
+export { relaticleSharedEnv };

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

@@ -0,0 +1,70 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const twentyWorkerDefinition: ServiceDefinition = {
+	id: "twenty-worker",
+	name: "Twenty (Worker)",
+	description:
+		"Background job processor for Twenty CRM. Handles asynchronous tasks such as email sync, webhook delivery, and data pipeline operations.",
+	category: "crm",
+	icon: "⚙️",
+
+	image: "twentycrm/twenty",
+	imageTag: "latest",
+	ports: [],
+	volumes: [],
+	environment: [
+		{
+			key: "PG_DATABASE_URL",
+			defaultValue: "postgresql://twenty:${TWENTY_DB_PASSWORD}@postgresql:5432/twenty",
+			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,
+		},
+		{
+			key: "APP_SECRET",
+			defaultValue: "${TWENTY_APP_SECRET}",
+			secret: true,
+			description: "Application secret for signing tokens",
+			required: true,
+		},
+		{
+			key: "ENABLE_DB_MIGRATIONS",
+			defaultValue: "false",
+			secret: false,
+			description: "Disable migrations (handled by main server)",
+			required: false,
+		},
+	],
+	command: "yarn worker:prod",
+	healthcheck: {
+		test: "ps aux | grep worker | grep -v grep || exit 1",
+		interval: "30s",
+		timeout: "10s",
+		retries: 5,
+		startPeriod: "30s",
+	},
+	dependsOn: ["postgresql", "redis"],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://twenty.com/developers/section/self-hosting",
+	tags: ["crm", "sales", "customer", "worker"],
+	maturity: "stable",
+
+	requires: ["postgresql", "redis"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};

package/src/services/definitions/twenty.ts

@@ -47,6 +47,13 @@ export const twentyDefinition: ServiceDefinition = {
 			description: "Application secret for signing tokens",
 			required: true,
 		},
+		{
+			key: "SERVER_URL",
+			defaultValue: "http://localhost:3037",
+			secret: false,
+			description: "Server URL for API and webhooks",
+			required: true,
+		},
 		{
 			key: "FRONT_BASE_URL",
 			defaultValue: "http://localhost:3037",
@@ -54,6 +61,13 @@ export const twentyDefinition: ServiceDefinition = {
 			description: "Public frontend URL",
 			required: true,
 		},
+		{
+			key: "ENABLE_DB_MIGRATIONS",
+			defaultValue: "true",
+			secret: false,
+			description: "Run database migrations on startup",
+			required: false,
+		},
 	],
 	healthcheck: {
 		test: "curl -sf http://localhost:3000/healthz || exit 1",
@@ -62,7 +76,7 @@ export const twentyDefinition: ServiceDefinition = {
 		retries: 3,
 		startPeriod: "30s",
 	},
-	dependsOn: ["postgresql", "redis"],
+	dependsOn: ["postgresql", "redis", "twenty-worker"],
 	restartPolicy: "unless-stopped",
 	networks: ["openclaw-network"],
 
@@ -73,7 +87,7 @@ export const twentyDefinition: ServiceDefinition = {
 	tags: ["crm", "sales", "customer", "contacts", "pipeline", "graphql"],
 	maturity: "stable",
 
-	requires: ["postgresql", "redis"],
+	requires: ["postgresql", "redis", "twenty-worker"],
 	recommends: [],
 	conflictsWith: [],
 

package/src/services/definitions/weaviate.ts

@@ -65,7 +65,7 @@ export const weaviateDefinition: ServiceDefinition = {
 	restartPolicy: "unless-stopped",
 	networks: ["openclaw-network"],
 
-	skills: [],
+	skills: [{ skillId: "weaviate-memory", autoInstall: true }],
 	openclawEnvVars: [
 		{
 			key: "WEAVIATE_HOST",

package/src/services/definitions/zeroclaw.ts

@@ -0,0 +1,102 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const zeroclawDefinition: ServiceDefinition = {
+	id: "zeroclaw",
+	name: "ZeroClaw",
+	description:
+		"Rust-based autonomous AI agent. 3.4MB binary, cold start under 10ms. 400x faster startup and 99% lower memory footprint than alternatives. Security-first design.",
+	category: "agent-framework",
+	icon: "⚡",
+
+	image: "ghcr.io/zeroclaw-labs/zeroclaw",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 3000,
+			container: 42617,
+			description: "ZeroClaw gateway (internal 42617 mapped to host 3000)",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "zeroclaw-data",
+			containerPath: "/zeroclaw-data",
+			description: "ZeroClaw persistent data and config",
+		},
+	],
+	environment: [
+		{
+			key: "API_KEY",
+			defaultValue: "",
+			secret: true,
+			description: "LLM provider API key",
+			required: true,
+		},
+		{
+			key: "PROVIDER",
+			defaultValue: "openrouter",
+			secret: false,
+			description: "LLM provider name (openrouter, anthropic, openai, etc.)",
+			required: false,
+		},
+		{
+			key: "ZEROCLAW_GATEWAY_PORT",
+			defaultValue: "42617",
+			secret: false,
+			description: "Internal gateway port",
+			required: false,
+		},
+		{
+			key: "ZEROCLAW_ALLOW_PUBLIC_BIND",
+			defaultValue: "true",
+			secret: false,
+			description: "Bind to all interfaces (required for Docker)",
+			required: false,
+		},
+	],
+	healthcheck: {
+		test: "zeroclaw status",
+		interval: "60s",
+		timeout: "10s",
+		retries: 3,
+	},
+	deploy: {
+		resources: {
+			limits: { cpus: "2", memory: "2G" },
+			reservations: { cpus: "0.5", memory: "512M" },
+		},
+	},
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [
+		{
+			key: "ZEROCLAW_HOST",
+			defaultValue: "zeroclaw",
+			secret: false,
+			description: "ZeroClaw hostname for gateway integration",
+			required: false,
+		},
+		{
+			key: "ZEROCLAW_PORT",
+			defaultValue: "42617",
+			secret: false,
+			description: "ZeroClaw internal gateway port",
+			required: false,
+		},
+	],
+
+	docsUrl: "https://github.com/zeroclaw-labs/zeroclaw",
+	tags: ["agent", "rust", "fast", "lightweight", "security"],
+	maturity: "beta",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 64,
+	gpuRequired: false,
+};