@better-openclaw/core 1.0.26 → 1.0.30

package/src/frameworks/claude-code-fw.ts

@@ -0,0 +1,118 @@
+import type { ResolverOutput } from "../types.js";
+import type {
+	AgentFrameworkDefinition,
+	EnvLine,
+	FrameworkComposeOptions,
+	FrameworkConfigOptions,
+	FrameworkConfigResult,
+	FrameworkEnvOptions,
+	GatewayBuildResult,
+} from "./types.js";
+
+const IMAGE_VARIANTS: Record<string, string> = {
+	official: "ghcr.io/zeeno-atl/claude-code",
+};
+
+function getClaudeCodeImage(_variant: string, version: string): string {
+	const base = IMAGE_VARIANTS.official;
+	const tag = version !== "latest" ? version : "1.0";
+	return `${base}:${tag}`;
+}
+
+const PROVIDER_ENV_KEYS = ["ANTHROPIC_API_KEY"];
+
+export const claudeCodeFramework: AgentFrameworkDefinition = {
+	id: "claude-code",
+	name: "Claude Code",
+	icon: "🟣",
+	description: "Anthropic's agentic coding assistant with full codebase understanding",
+	runtime: "node",
+	canBePrimary: true,
+	canBeCompanion: true,
+	networkName: "claude-code-network",
+	imageVariants: IMAGE_VARIANTS,
+	defaultImageVariant: "official",
+
+	buildGatewayService(
+		_resolved: ResolverOutput,
+		options: FrameworkComposeOptions,
+		dependsOn?: Record<string, { condition: string }>,
+	): GatewayBuildResult {
+		const allVolumes = new Set<string>();
+		const defaultImage = getClaudeCodeImage(
+			options.frameworkImageVariant ?? "official",
+			options.frameworkVersion,
+		);
+
+		const gatewayEnv: Record<string, string> = {
+			ANTHROPIC_API_KEY: "${ANTHROPIC_API_KEY}",
+		};
+
+		const gateway: Record<string, unknown> = {
+			image: `\${CLAUDE_CODE_IMAGE:-${defaultImage}}`,
+			environment: gatewayEnv,
+			volumes: [
+				"${CLAUDE_CODE_CONFIG_DIR:-./claude-code/config}:/home/coder/.claude",
+				"${CLAUDE_CODE_WORKSPACE_DIR:-./claude-code/workspace}:/workspace",
+			],
+			networks: [this.networkName],
+			restart: "unless-stopped",
+			stdin_open: true,
+			tty: true,
+			command: "tail -f /dev/null",
+		};
+
+		if (dependsOn && Object.keys(dependsOn).length > 0) {
+			gateway.depends_on = dependsOn;
+		}
+
+		return { gatewayService: gateway, cliService: null, allVolumes };
+	},
+
+	generateConfig(
+		_resolved: ResolverOutput,
+		_options: FrameworkConfigOptions,
+	): FrameworkConfigResult | null {
+		// Claude Code uses env-based config
+		return null;
+	},
+
+	getBaseEnvVars(_options: FrameworkEnvOptions): EnvLine[] {
+		return [
+			{
+				comment: "Claude Code Docker image override",
+				key: "CLAUDE_CODE_IMAGE",
+				exampleValue: "",
+				actualValue: "",
+			},
+			{
+				comment: "Host path to Claude Code config directory",
+				key: "CLAUDE_CODE_CONFIG_DIR",
+				exampleValue: "./claude-code/config",
+				actualValue: "./claude-code/config",
+			},
+			{
+				comment: "Host path to Claude Code workspace directory",
+				key: "CLAUDE_CODE_WORKSPACE_DIR",
+				exampleValue: "./claude-code/workspace",
+				actualValue: "./claude-code/workspace",
+			},
+		];
+	},
+
+	getMandatoryServices(): string[] {
+		return [];
+	},
+
+	getRecommendedServices(): string[] {
+		return [];
+	},
+
+	getProviderEnvKeys(): string[] {
+		return [...PROVIDER_ENV_KEYS];
+	},
+
+	getEnvSectionName(): string {
+		return "Claude Code Core";
+	},
+};

package/src/frameworks/codex-fw.ts

@@ -0,0 +1,102 @@
+import type { ResolverOutput } from "../types.js";
+import type {
+	AgentFrameworkDefinition,
+	EnvLine,
+	FrameworkComposeOptions,
+	FrameworkConfigOptions,
+	FrameworkConfigResult,
+	FrameworkEnvOptions,
+	GatewayBuildResult,
+} from "./types.js";
+
+const IMAGE_VARIANTS: Record<string, string> = {
+	official: "node",
+};
+
+const PROVIDER_ENV_KEYS = ["OPENAI_API_KEY"];
+
+export const codexFramework: AgentFrameworkDefinition = {
+	id: "codex",
+	name: "OpenAI Codex CLI",
+	icon: "🟢",
+	description: "OpenAI's lightweight coding agent with sandboxed execution",
+	runtime: "node",
+	canBePrimary: true,
+	canBeCompanion: true,
+	networkName: "codex-network",
+	imageVariants: IMAGE_VARIANTS,
+	defaultImageVariant: "official",
+
+	buildGatewayService(
+		_resolved: ResolverOutput,
+		_options: FrameworkComposeOptions,
+		dependsOn?: Record<string, { condition: string }>,
+	): GatewayBuildResult {
+		const allVolumes = new Set<string>();
+
+		const gatewayEnv: Record<string, string> = {
+			OPENAI_API_KEY: "${OPENAI_API_KEY}",
+		};
+
+		const gateway: Record<string, unknown> = {
+			image: "node:24-alpine",
+			environment: gatewayEnv,
+			volumes: [
+				"${CODEX_CONFIG_DIR:-./codex/config}:/home/node/.codex",
+				"${CODEX_WORKSPACE_DIR:-./codex/workspace}:/workspace",
+			],
+			networks: [this.networkName],
+			restart: "unless-stopped",
+			stdin_open: true,
+			tty: true,
+			command: "npx @openai/codex@latest --headless",
+		};
+
+		if (dependsOn && Object.keys(dependsOn).length > 0) {
+			gateway.depends_on = dependsOn;
+		}
+
+		return { gatewayService: gateway, cliService: null, allVolumes };
+	},
+
+	generateConfig(
+		_resolved: ResolverOutput,
+		_options: FrameworkConfigOptions,
+	): FrameworkConfigResult | null {
+		// Codex uses env-based config
+		return null;
+	},
+
+	getBaseEnvVars(_options: FrameworkEnvOptions): EnvLine[] {
+		return [
+			{
+				comment: "Host path to Codex config directory",
+				key: "CODEX_CONFIG_DIR",
+				exampleValue: "./codex/config",
+				actualValue: "./codex/config",
+			},
+			{
+				comment: "Host path to Codex workspace directory",
+				key: "CODEX_WORKSPACE_DIR",
+				exampleValue: "./codex/workspace",
+				actualValue: "./codex/workspace",
+			},
+		];
+	},
+
+	getMandatoryServices(): string[] {
+		return [];
+	},
+
+	getRecommendedServices(): string[] {
+		return [];
+	},
+
+	getProviderEnvKeys(): string[] {
+		return [...PROVIDER_ENV_KEYS];
+	},
+
+	getEnvSectionName(): string {
+		return "Codex Core";
+	},
+};

package/src/frameworks/copaw.ts

@@ -0,0 +1,154 @@
+import type { ResolverOutput } from "../types.js";
+import type {
+	AgentFrameworkDefinition,
+	EnvLine,
+	FrameworkComposeOptions,
+	FrameworkConfigOptions,
+	FrameworkConfigResult,
+	FrameworkEnvOptions,
+	GatewayBuildResult,
+} from "./types.js";
+
+const IMAGE_VARIANTS: Record<string, string> = {
+	official: "agentscope/copaw",
+	pre: "agentscope/copaw",
+};
+
+function getCopawImage(variant: string, _version: string): string {
+	const base = IMAGE_VARIANTS[variant] ?? IMAGE_VARIANTS.official;
+	const tag = variant === "pre" ? "pre" : "latest";
+	return `${base}:${tag}`;
+}
+
+const PROVIDER_ENV_KEYS = [
+	"DASHSCOPE_API_KEY",
+	"OPENAI_API_KEY",
+	"ANTHROPIC_API_KEY",
+	"GOOGLE_API_KEY",
+	"DEEPSEEK_API_KEY",
+	"GROQ_API_KEY",
+	"OPENROUTER_API_KEY",
+	"MISTRAL_API_KEY",
+	"TAVILY_API_KEY",
+];
+
+export const copawFramework: AgentFrameworkDefinition = {
+	id: "copaw",
+	name: "CoPaw",
+	icon: "🐾",
+	description: "Alibaba's personal agent workstation with ReMe memory and cron autonomy",
+	runtime: "python",
+	canBePrimary: true,
+	canBeCompanion: true,
+	networkName: "copaw-network",
+	imageVariants: IMAGE_VARIANTS,
+	defaultImageVariant: "official",
+
+	buildGatewayService(
+		resolved: ResolverOutput,
+		options: FrameworkComposeOptions,
+		dependsOn?: Record<string, { condition: string }>,
+	): GatewayBuildResult {
+		const allVolumes = new Set<string>();
+		const defaultImage = getCopawImage(
+			options.frameworkImageVariant ?? "official",
+			options.frameworkVersion,
+		);
+
+		const gatewayEnv: Record<string, string> = {};
+		for (const key of PROVIDER_ENV_KEYS) {
+			gatewayEnv[key] = `\${${key}}`;
+		}
+
+		// Collect env vars from companion services
+		for (const { definition: def } of resolved.services) {
+			for (const env of def.openclawEnvVars) {
+				gatewayEnv[env.key] = env.secret ? `\${${env.key}}` : env.defaultValue;
+			}
+		}
+
+		const gateway: Record<string, unknown> = {
+			image: `\${COPAW_IMAGE:-${defaultImage}}`,
+			environment: gatewayEnv,
+			volumes: [
+				"${COPAW_DATA_DIR:-./copaw/data}:/app/working",
+				"${COPAW_SECRETS_DIR:-./copaw/secrets}:/app/working.secret",
+			],
+			ports: ["${COPAW_PORT:-8088}:8088"],
+			networks: [this.networkName],
+			restart: "unless-stopped",
+			healthcheck: {
+				test: ["CMD", "curl", "-sf", "http://localhost:8088/", "||", "exit", "1"],
+				interval: "30s",
+				timeout: "5s",
+				retries: 5,
+				start_period: "30s",
+			},
+		};
+
+		if (dependsOn && Object.keys(dependsOn).length > 0) {
+			gateway.depends_on = dependsOn;
+		}
+
+		return { gatewayService: gateway, cliService: null, allVolumes };
+	},
+
+	generateConfig(
+		_resolved: ResolverOutput,
+		_options: FrameworkConfigOptions,
+	): FrameworkConfigResult | null {
+		// CoPaw uses config.json in the working directory, generated on first run
+		return null;
+	},
+
+	getBaseEnvVars(options: FrameworkEnvOptions): EnvLine[] {
+		const imageVariantMap: Record<string, string> = {
+			official: "",
+			pre: "agentscope/copaw:pre",
+		};
+		const imageValue = imageVariantMap[options.frameworkImageVariant ?? "official"] ?? "";
+
+		return [
+			{
+				comment: "CoPaw Docker image override",
+				key: "COPAW_IMAGE",
+				exampleValue: "",
+				actualValue: imageValue,
+			},
+			{
+				comment: "CoPaw web console port",
+				key: "COPAW_PORT",
+				exampleValue: "8088",
+				actualValue: "8088",
+			},
+			{
+				comment: "Host path to CoPaw data directory",
+				key: "COPAW_DATA_DIR",
+				exampleValue: "./copaw/data",
+				actualValue: "./copaw/data",
+			},
+			{
+				comment: "Host path to CoPaw secrets directory",
+				key: "COPAW_SECRETS_DIR",
+				exampleValue: "./copaw/secrets",
+				actualValue: "./copaw/secrets",
+			},
+		];
+	},
+
+	getMandatoryServices(): string[] {
+		return [];
+	},
+
+	getRecommendedServices(): string[] {
+		return ["clawrouter"];
+	},
+
+	getProviderEnvKeys(): string[] {
+		return [...PROVIDER_ENV_KEYS];
+	},
+
+	getEnvSectionName(): string {
+		return "CoPaw Core";
+	},
+};

package/src/frameworks/index.ts

@@ -0,0 +1,46 @@
+export { claudeCodeFramework } from "./claude-code-fw.js";
+export { codexFramework } from "./codex-fw.js";
+export { copawFramework } from "./copaw.js";
+export { memuFramework } from "./memu.js";
+export { nanobotFramework } from "./nanobot.js";
+export { nanoclawFramework } from "./nanoclaw.js";
+export { openclawFramework } from "./openclaw.js";
+export {
+	getAllFrameworks,
+	getCompanionFrameworks,
+	getFrameworkById,
+	getPrimaryFrameworks,
+	registerFramework,
+} from "./registry.js";
+export type {
+	AgentFrameworkDefinition,
+	AgentFrameworkId,
+	EnvLine,
+	FrameworkComposeOptions,
+	FrameworkConfigOptions,
+	FrameworkConfigResult,
+	FrameworkEnvOptions,
+	GatewayBuildResult,
+} from "./types.js";
+export { zeroclawFramework } from "./zeroclaw.js";
+
+// ── Auto-register built-in frameworks ───────────────────────────────────────
+
+import { claudeCodeFramework } from "./claude-code-fw.js";
+import { codexFramework } from "./codex-fw.js";
+import { copawFramework } from "./copaw.js";
+import { memuFramework } from "./memu.js";
+import { nanobotFramework } from "./nanobot.js";
+import { nanoclawFramework } from "./nanoclaw.js";
+import { openclawFramework } from "./openclaw.js";
+import { registerFramework } from "./registry.js";
+import { zeroclawFramework } from "./zeroclaw.js";
+
+registerFramework(openclawFramework);
+registerFramework(copawFramework);
+registerFramework(nanoclawFramework);
+registerFramework(nanobotFramework);
+registerFramework(zeroclawFramework);
+registerFramework(memuFramework);
+registerFramework(claudeCodeFramework);
+registerFramework(codexFramework);

package/src/frameworks/memu.ts

@@ -0,0 +1,149 @@
+import type { ResolverOutput } from "../types.js";
+import type {
+	AgentFrameworkDefinition,
+	EnvLine,
+	FrameworkComposeOptions,
+	FrameworkConfigOptions,
+	FrameworkConfigResult,
+	FrameworkEnvOptions,
+	GatewayBuildResult,
+} from "./types.js";
+
+const IMAGE_VARIANTS: Record<string, string> = {
+	official: "nevamindai/memu-server",
+};
+
+function getMemuImage(_variant: string, version: string): string {
+	const base = IMAGE_VARIANTS.official;
+	const tag = version !== "latest" ? version : "latest";
+	return `${base}:${tag}`;
+}
+
+const PROVIDER_ENV_KEYS = ["OPENAI_API_KEY", "OPENROUTER_API_KEY"];
+
+export const memuFramework: AgentFrameworkDefinition = {
+	id: "memu",
+	name: "MemU",
+	icon: "🧠",
+	description: "Persistent knowledge graph memory agent backed by pgvector",
+	runtime: "python",
+	canBePrimary: true,
+	canBeCompanion: true,
+	networkName: "memu-network",
+	imageVariants: IMAGE_VARIANTS,
+	defaultImageVariant: "official",
+
+	buildGatewayService(
+		resolved: ResolverOutput,
+		options: FrameworkComposeOptions,
+		dependsOn?: Record<string, { condition: string }>,
+	): GatewayBuildResult {
+		const allVolumes = new Set<string>();
+		const defaultImage = getMemuImage(
+			options.frameworkImageVariant ?? "official",
+			options.frameworkVersion,
+		);
+
+		const gatewayEnv: Record<string, string> = {
+			OPENAI_API_KEY: "${OPENAI_API_KEY}",
+			OPENROUTER_API_KEY: "${OPENROUTER_API_KEY:-}",
+			DATABASE_URL:
+				"postgresql://${MEMU_DB_USER:-memu}:${MEMU_DB_PASSWORD}@postgresql:5432/${MEMU_DB_NAME:-memu}",
+		};
+
+		// Collect env vars from companion services
+		for (const { definition: def } of resolved.services) {
+			for (const env of def.openclawEnvVars) {
+				gatewayEnv[env.key] = env.secret ? `\${${env.key}}` : env.defaultValue;
+			}
+		}
+
+		// Ensure postgresql dependency
+		const deps = { ...dependsOn };
+		deps.postgresql = { condition: "service_healthy" };
+
+		const gateway: Record<string, unknown> = {
+			image: `\${MEMU_IMAGE:-${defaultImage}}`,
+			environment: gatewayEnv,
+			volumes: ["${MEMU_DATA_DIR:-./memu/data}:/app/data"],
+			ports: ["${MEMU_PORT:-8020}:8000"],
+			networks: [this.networkName],
+			restart: "unless-stopped",
+			depends_on: deps,
+			healthcheck: {
+				test: ["CMD", "curl", "-sf", "http://localhost:8000/health", "||", "exit", "1"],
+				interval: "30s",
+				timeout: "5s",
+				retries: 5,
+				start_period: "30s",
+			},
+		};
+
+		return { gatewayService: gateway, cliService: null, allVolumes };
+	},
+
+	generateConfig(
+		_resolved: ResolverOutput,
+		_options: FrameworkConfigOptions,
+	): FrameworkConfigResult | null {
+		// MemU uses environment-based config
+		return null;
+	},
+
+	getBaseEnvVars(_options: FrameworkEnvOptions): EnvLine[] {
+		return [
+			{
+				comment: "MemU Docker image override",
+				key: "MEMU_IMAGE",
+				exampleValue: "",
+				actualValue: "",
+			},
+			{
+				comment: "MemU REST API port",
+				key: "MEMU_PORT",
+				exampleValue: "8020",
+				actualValue: "8020",
+			},
+			{
+				comment: "MemU PostgreSQL database name",
+				key: "MEMU_DB_NAME",
+				exampleValue: "memu",
+				actualValue: "memu",
+			},
+			{
+				comment: "MemU PostgreSQL user",
+				key: "MEMU_DB_USER",
+				exampleValue: "memu",
+				actualValue: "memu",
+			},
+			{
+				comment: "MemU PostgreSQL password",
+				key: "MEMU_DB_PASSWORD",
+				exampleValue: "changeme",
+				actualValue: "",
+			},
+			{
+				comment: "Host path to MemU data directory",
+				key: "MEMU_DATA_DIR",
+				exampleValue: "./memu/data",
+				actualValue: "./memu/data",
+			},
+		];
+	},
+
+	getMandatoryServices(): string[] {
+		return ["postgresql"];
+	},
+
+	getRecommendedServices(): string[] {
+		return [];
+	},
+
+	getProviderEnvKeys(): string[] {
+		return [...PROVIDER_ENV_KEYS];
+	},
+
+	getEnvSectionName(): string {
+		return "MemU Core";
+	},
+};