@better-openclaw/core 1.0.0

package/src/services/definitions/claude-code.ts

@@ -0,0 +1,56 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const claudeCodeDefinition: ServiceDefinition = {
+	id: "claude-code",
+	name: "Claude Code",
+	description:
+		"Anthropic's agentic coding assistant that runs in the terminal. Claude Code understands your entire codebase, executes commands, and helps with complex multi-file edits.",
+	category: "coding-agent",
+	icon: "🟣",
+
+	image: "ghcr.io/zeeno-atl/claude-code",
+	imageTag: "latest",
+	ports: [],
+	volumes: [
+		{
+			name: "claude-code-config",
+			containerPath: "/home/coder/.claude",
+			description: "Claude Code config and auth",
+		},
+	],
+	environment: [
+		{
+			key: "ANTHROPIC_API_KEY",
+			defaultValue: "",
+			secret: true,
+			description: "Anthropic API key for Claude Code",
+			required: true,
+		},
+	],
+	command: "tail -f /dev/null",
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [
+		{
+			key: "CLAUDE_CODE_WORKSPACE",
+			defaultValue: "/home/node/.openclaw/workspace",
+			secret: false,
+			description: "Shared workspace path with Claude Code",
+			required: false,
+		},
+	],
+
+	docsUrl: "https://docs.anthropic.com/en/docs/claude-code",
+	tags: ["ai-coding", "claude", "anthropic", "agent"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};

package/src/services/definitions/code-server.ts

@@ -0,0 +1,67 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const codeServerDefinition: ServiceDefinition = {
+	id: "code-server",
+	name: "code-server",
+	description: "Run VS Code in the browser. Full IDE experience accessible from anywhere.",
+	category: "dev-tools",
+	icon: "🖥️",
+
+	image: "lscr.io/linuxserver/code-server",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 8443,
+			container: 8443,
+			description: "code-server Web IDE",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "code-server-config",
+			containerPath: "/config",
+			description: "code-server config and extensions",
+		},
+	],
+	environment: [
+		{
+			key: "PASSWORD",
+			defaultValue: "",
+			secret: true,
+			description: "code-server login password",
+			required: true,
+		},
+		{
+			key: "PUID",
+			defaultValue: "1000",
+			secret: false,
+			description: "User ID",
+			required: false,
+		},
+		{
+			key: "PGID",
+			defaultValue: "1000",
+			secret: false,
+			description: "Group ID",
+			required: false,
+		},
+	],
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://coder.com/docs/code-server/latest",
+	tags: ["ide", "vscode", "browser", "remote-development"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};

package/src/services/definitions/codex.ts

@@ -0,0 +1,48 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const codexDefinition: ServiceDefinition = {
+	id: "codex",
+	name: "OpenAI Codex CLI",
+	description:
+		"OpenAI's lightweight coding agent that runs in the terminal. Uses OpenAI models to understand context, suggest edits, and execute commands in a sandboxed environment.",
+	category: "coding-agent",
+	icon: "🟢",
+
+	image: "node",
+	imageTag: "22-alpine",
+	ports: [],
+	volumes: [
+		{
+			name: "codex-config",
+			containerPath: "/home/node/.codex",
+			description: "Codex CLI configuration and cache",
+		},
+	],
+	environment: [
+		{
+			key: "OPENAI_API_KEY",
+			defaultValue: "",
+			secret: true,
+			description: "OpenAI API key for Codex",
+			required: true,
+		},
+	],
+	command: "npx @openai/codex@latest --headless",
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://github.com/openai/codex",
+	tags: ["ai-coding", "openai", "agent"],
+	maturity: "beta",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/coolify.ts

@@ -0,0 +1,51 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const coolifyDefinition: ServiceDefinition = {
+	id: "coolify",
+	name: "Coolify",
+	description:
+		"Self-hosted PaaS to deploy and manage applications, databases, and services. Heroku/Netlify alternative with Git integration and one-click apps.",
+	category: "dev-tools",
+	icon: "☁️",
+
+	image: "coollabsio/coolify",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 8000,
+			container: 8000,
+			description: "Coolify web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "coolify-docker-sock",
+			containerPath: "/var/run/docker.sock",
+			description: "Docker socket for managing containers",
+		},
+		{
+			name: "coolify-data",
+			containerPath: "/data",
+			description: "Coolify data and configuration",
+		},
+	],
+	environment: [],
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://coolify.io/docs",
+	tags: ["paas", "deployment", "docker", "git", "self-hosted"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 2048,
+	gpuRequired: false,
+};

package/src/services/definitions/dify.ts

@@ -0,0 +1,82 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const difyDefinition: ServiceDefinition = {
+	id: "dify",
+	name: "Dify",
+	description:
+		"Open-source LLM app development platform with visual AI workflow builder, RAG pipeline, agent capabilities, and model management.",
+	category: "ai-platform",
+	icon: "🔮",
+
+	image: "langgenius/dify-api",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 3110,
+			container: 5001,
+			description: "Dify API",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "dify-data",
+			containerPath: "/app/api/storage",
+			description: "Dify storage",
+		},
+	],
+	environment: [
+		{
+			key: "DB_HOST",
+			defaultValue: "postgresql",
+			secret: false,
+			description: "PostgreSQL host for Dify",
+			required: true,
+		},
+		{
+			key: "DB_PORT",
+			defaultValue: "5432",
+			secret: false,
+			description: "PostgreSQL port for Dify",
+			required: true,
+		},
+		{
+			key: "DB_DATABASE",
+			defaultValue: "dify",
+			secret: false,
+			description: "PostgreSQL database for Dify",
+			required: true,
+		},
+		{
+			key: "DB_USERNAME",
+			defaultValue: "dify",
+			secret: false,
+			description: "PostgreSQL user for Dify",
+			required: true,
+		},
+		{
+			key: "DB_PASSWORD",
+			defaultValue: "${DIFY_DB_PASSWORD}",
+			secret: true,
+			description: "PostgreSQL password for Dify",
+			required: true,
+		},
+	],
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://docs.dify.ai/",
+	tags: ["ai-platform", "workflow", "rag", "agents", "visual-builder"],
+	maturity: "stable",
+
+	requires: ["postgresql", "redis"],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 1024,
+	gpuRequired: false,
+};

package/src/services/definitions/docsgpt.ts

@@ -0,0 +1,45 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const docsgptDefinition: ServiceDefinition = {
+	id: "docsgpt",
+	name: "DocsGPT",
+	description: "AI-powered documentation assistant. Upload documents and chat with them using RAG.",
+	category: "knowledge",
+	icon: "📄",
+
+	image: "arc53/docsgpt",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 7071,
+			container: 7091,
+			description: "DocsGPT Web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "docsgpt-data",
+			containerPath: "/app/data",
+			description: "DocsGPT uploaded documents and vector store data",
+		},
+	],
+	environment: [],
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://docs.docsgpt.cloud/",
+	tags: ["documents", "rag", "qa", "ai-assistant", "knowledge"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: ["ollama"],
+	conflictsWith: [],
+
+	minMemoryMB: 512,
+	gpuRequired: false,
+};

package/src/services/definitions/dokploy.ts

@@ -0,0 +1,51 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const dokployDefinition: ServiceDefinition = {
+	id: "dokploy",
+	name: "Dokploy",
+	description:
+		"All-in-one platform for deploying containerized apps and databases. Supports Docker Compose, Dockerfiles, Nixpacks, and multi-server deployment.",
+	category: "dev-tools",
+	icon: "🚀",
+
+	image: "dokploy/dokploy",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 3000,
+			container: 3000,
+			description: "Dokploy web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "dokploy-docker-sock",
+			containerPath: "/var/run/docker.sock",
+			description: "Docker socket for managing containers",
+		},
+		{
+			name: "dokploy-data",
+			containerPath: "/data",
+			description: "Dokploy data and configuration",
+		},
+	],
+	environment: [],
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://docs.dokploy.com",
+	tags: ["paas", "deployment", "docker", "docker-compose", "self-hosted"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 1024,
+	gpuRequired: false,
+};

package/src/services/definitions/dozzle.ts

@@ -0,0 +1,40 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const dozzleDefinition: ServiceDefinition = {
+	id: "dozzle",
+	name: "Dozzle",
+	description:
+		"Real-time Docker container log viewer in the browser. Lightweight and requires no database.",
+	category: "dev-tools",
+	icon: "📜",
+
+	image: "amir20/dozzle",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 9999,
+			container: 8080,
+			description: "Dozzle Web UI",
+			exposed: true,
+		},
+	],
+	volumes: [],
+	environment: [],
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://dozzle.dev/",
+	tags: ["logs", "docker", "monitoring", "real-time", "viewer"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 32,
+	gpuRequired: false,
+};

package/src/services/definitions/ffmpeg.ts

@@ -0,0 +1,70 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const ffmpegDefinition: ServiceDefinition = {
+	id: "ffmpeg",
+	name: "FFmpeg Sidecar",
+	description:
+		"FFmpeg sidecar container for media processing, transcoding, and format conversion. Runs as a long-lived sidecar sharing a volume with OpenClaw.",
+	category: "media",
+	icon: "🎬",
+
+	image: "linuxserver/ffmpeg",
+	imageTag: "latest",
+	ports: [],
+	volumes: [
+		{
+			name: "ffmpeg-shared",
+			containerPath: "/data",
+			description: "Shared volume with OpenClaw for media files",
+		},
+	],
+	environment: [
+		{
+			key: "PUID",
+			defaultValue: "1000",
+			secret: false,
+			description: "User ID for file permissions",
+			required: true,
+		},
+		{
+			key: "PGID",
+			defaultValue: "1000",
+			secret: false,
+			description: "Group ID for file permissions",
+			required: true,
+		},
+	],
+	command: "tail -f /dev/null",
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [{ skillId: "ffmpeg-process", autoInstall: true }],
+	openclawEnvVars: [
+		{
+			key: "FFMPEG_SHARED_DIR",
+			defaultValue: "/home/node/.openclaw/workspace/media",
+			secret: false,
+			description: "Shared media directory path inside the OpenClaw container",
+			required: true,
+		},
+	],
+	openclawVolumeMounts: [
+		{
+			name: "ffmpeg-shared",
+			containerPath: "/home/node/.openclaw/workspace/media",
+			description: "Shared media volume with FFmpeg",
+		},
+	],
+
+	docsUrl: "https://ffmpeg.org/documentation.html",
+	tags: ["video", "audio", "transcoding", "media-processing"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/flowise.ts

@@ -0,0 +1,45 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const flowiseDefinition: ServiceDefinition = {
+	id: "flowise",
+	name: "Flowise",
+	description: "Drag & drop UI to build customized LLM flows, chatbots, and AI agents.",
+	category: "ai-platform",
+	icon: "🌊",
+
+	image: "flowiseai/flowise",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 3120,
+			container: 3000,
+			description: "Flowise Web UI",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "flowise-data",
+			containerPath: "/root/.flowise",
+			description: "Flowise data",
+		},
+	],
+	environment: [],
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://docs.flowiseai.com/",
+	tags: ["flow-builder", "chatbot", "llm", "visual", "drag-drop"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/gemini-cli.ts

@@ -0,0 +1,48 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const geminiCliDefinition: ServiceDefinition = {
+	id: "gemini-cli",
+	name: "Gemini CLI",
+	description:
+		"Google's AI-powered command-line coding agent. Leverages Gemini models for code understanding, generation, and multi-file editing directly in the terminal.",
+	category: "coding-agent",
+	icon: "💎",
+
+	image: "node",
+	imageTag: "22-alpine",
+	ports: [],
+	volumes: [
+		{
+			name: "gemini-cli-config",
+			containerPath: "/home/node/.gemini",
+			description: "Gemini CLI configuration and cache",
+		},
+	],
+	environment: [
+		{
+			key: "GOOGLE_API_KEY",
+			defaultValue: "",
+			secret: true,
+			description: "Google API key for Gemini CLI",
+			required: true,
+		},
+	],
+	command: "npx @anthropic-ai/gemini-cli@latest",
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://github.com/google-gemini/gemini-cli",
+	tags: ["ai-coding", "google", "gemini", "agent"],
+	maturity: "beta",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 256,
+	gpuRequired: false,
+};

package/src/services/definitions/gitea.ts

@@ -0,0 +1,52 @@
+import type { ServiceDefinition } from "../../types.js";
+
+export const giteaDefinition: ServiceDefinition = {
+	id: "gitea",
+	name: "Gitea",
+	description:
+		"Lightweight self-hosted Git service. Host private repos alongside your OpenClaw stack.",
+	category: "dev-tools",
+	icon: "🍵",
+
+	image: "gitea/gitea",
+	imageTag: "latest",
+	ports: [
+		{
+			host: 3130,
+			container: 3000,
+			description: "Gitea Web UI",
+			exposed: true,
+		},
+		{
+			host: 2222,
+			container: 22,
+			description: "Gitea SSH",
+			exposed: true,
+		},
+	],
+	volumes: [
+		{
+			name: "gitea-data",
+			containerPath: "/data",
+			description: "Gitea data and repos",
+		},
+	],
+	environment: [],
+	dependsOn: [],
+	restartPolicy: "unless-stopped",
+	networks: ["openclaw-network"],
+
+	skills: [],
+	openclawEnvVars: [],
+
+	docsUrl: "https://docs.gitea.com/",
+	tags: ["git", "version-control", "repos", "code-hosting"],
+	maturity: "stable",
+
+	requires: [],
+	recommends: [],
+	conflictsWith: [],
+
+	minMemoryMB: 128,
+	gpuRequired: false,
+};