@alfe.ai/openclaw 0.0.45 → 0.2.0

package/README.md

@@ -73,3 +73,8 @@ Register tools **before** this guard so they're available for CLI introspection.
 Integration management (install, remove, configure, health) is handled by
 the gateway service directly — this plugin does not process integration
 commands.
+
+## Links
+
+- 🌐 Website: <https://alfe.ai>
+- 📚 Docs: <https://docs.alfe.ai>

package/dist/plugin2.cjs

@@ -3089,6 +3089,13 @@ async function registerWithDaemon(client, log, pluginName = "@alfe.ai/openclaw")
 const pkg = (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href)("../package.json");
 const DEFAULT_SOCKET_PATH = (0, node_path.join)((0, node_os.homedir)(), ".alfe", "gateway.sock");
 let ipcClient = null;
+/**
+* The local AI proxy (packages/ai-proxy-local) runs alongside the daemon on a
+* fixed loopback port in every runtime mode (managed VM / docker / self-hosted),
+* injects the agent's Alfe key, and forwards arbitrary paths to the cloud AI
+* proxy. openclaw-chat hardcodes the same host for /__alfe/set-identity.
+*/
+const LOCAL_AI_PROXY_URL = process.env.ALFE_AI_PROXY_URL ?? "http://127.0.0.1:18193";
 function ok(result) {
 	return { content: [{
 		type: "text",
@@ -3181,6 +3188,95 @@ function buildIntegrationTools(client) {
 		})
 	];
 }
+function buildVoiceTools(client) {
+	return [
+		defineTool({
+			name: "list_voices",
+			description: "List the available voices this agent can speak with (the ElevenLabs catalogue). Use this to pick or confirm a voice before calling set_voice with the chosen id.",
+			parameters: Type.Object({}),
+			handler: async () => {
+				const { voices } = await client.listVoices();
+				return { voices: voices.map((v) => ({
+					id: v.id,
+					name: v.name,
+					description: v.description,
+					labels: v.labels,
+					category: v.category,
+					previewUrl: v.previewUrl
+				})) };
+			}
+		}),
+		defineTool({
+			name: "set_voice",
+			description: "Change this agent's OWN voice. Pass a `voiceId` from list_voices. Optionally set `enabled` to turn voice on/off. Returns the updated voice config.",
+			parameters: Type.Object({
+				voiceId: Type.String({ description: "The ElevenLabs voice id to use, from list_voices (e.g. the `id` field)." }),
+				enabled: Type.Optional(Type.Boolean({ description: "Enable or disable voice. Omit to leave the current on/off state unchanged." }))
+			}),
+			handler: async (params) => {
+				const voiceId = params.voiceId;
+				const enabled = params.enabled;
+				return {
+					updated: true,
+					voiceConfig: (await client.updateSelf({ voiceConfig: {
+						voiceId,
+						...enabled === void 0 ? {} : { enabled }
+					} })).voiceConfig
+				};
+			}
+		}),
+		defineTool({
+			name: "generate_image",
+			description: "Generate an image from a text prompt. Returns a URL to the generated PNG. To show the image to the user, embed it in your reply as markdown: ![description](imageUrl). Optional `model` picks the image model (default gpt-image-1).",
+			parameters: Type.Object({
+				prompt: Type.String({ description: "Text description of the image to generate." }),
+				model: Type.Optional(Type.String({ description: "Image model id (default \"gpt-image-1\"). Others may be available, e.g. dall-e-3." })),
+				size: Type.Optional(Type.String({ description: "Image size, e.g. \"1024x1024\" (provider-dependent)." })),
+				quality: Type.Optional(Type.String({ description: "Image quality hint (provider-dependent)." }))
+			}),
+			handler: async (params) => {
+				const prompt = params.prompt;
+				const model = params.model ?? "gpt-image-1";
+				const size = params.size;
+				const quality = params.quality;
+				const genRes = await fetch(`${LOCAL_AI_PROXY_URL}/v1/images/generations`, {
+					method: "POST",
+					headers: { "Content-Type": "application/json" },
+					body: JSON.stringify({
+						model,
+						prompt,
+						...size ? { size } : {},
+						...quality ? { quality } : {}
+					})
+				});
+				const genJson = await genRes.json().catch(() => ({}));
+				if (!genRes.ok) throw new Error(`image generation failed (${String(genRes.status)}): ${genJson.message ?? genJson.error ?? "unknown error"}`);
+				const b64 = genJson.data?.[0]?.b64_json;
+				if (!b64) throw new Error("image generation returned no image data");
+				const buffer = Buffer.from(b64, "base64");
+				const filename = `generated-image-${String(Date.now())}.png`;
+				const { attachments } = await client.presignAttachments([{
+					filename,
+					mimeType: "image/png",
+					size: buffer.length
+				}]);
+				if (attachments.length === 0) throw new Error("failed to presign upload for the generated image");
+				const att = attachments[0];
+				const putRes = await fetch(att.uploadUrl, {
+					method: "PUT",
+					headers: { "Content-Type": "image/png" },
+					body: buffer
+				});
+				if (!putRes.ok) throw new Error(`failed to upload the generated image (${String(putRes.status)})`);
+				return {
+					imageUrl: att.downloadUrl,
+					model,
+					instruction: "Show this image to the user by including it in your reply as markdown: ![image](imageUrl)."
+				};
+			}
+		})
+	];
+}
 const plugin = {
 	id: "@alfe.ai/openclaw",
 	name: "Alfe OpenClaw Plugin",
@@ -3195,12 +3291,13 @@ const plugin = {
 			log.warn(`Integration tools not registered — config not available: ${err.message}`);
 		}
 		if (cfg) {
-			const tools = buildIntegrationTools(new _alfe_ai_agent_api_client.AgentApiClient({
+			const client = new _alfe_ai_agent_api_client.AgentApiClient({
 				apiKey: cfg.apiKey,
 				apiUrl: cfg.apiUrl
-			}));
+			});
+			const tools = [...buildIntegrationTools(client), ...buildVoiceTools(client)];
 			for (const tool of tools) api.registerTool(tool);
-			log.info(`Registered ${String(tools.length)} integration tools: ${tools.map((t) => t.name).join(", ")}`);
+			log.info(`Registered ${String(tools.length)} agent tools: ${tools.map((t) => t.name).join(", ")}`);
 		}
 		const startDaemonIpc = () => {
 			if (globalThis.__alfeOpenclawPluginActivated === true) {

package/dist/plugin2.js

@@ -3090,6 +3090,13 @@ async function registerWithDaemon(client, log, pluginName = "@alfe.ai/openclaw")
 const pkg = createRequire(import.meta.url)("../package.json");
 const DEFAULT_SOCKET_PATH = join(homedir(), ".alfe", "gateway.sock");
 let ipcClient = null;
+/**
+* The local AI proxy (packages/ai-proxy-local) runs alongside the daemon on a
+* fixed loopback port in every runtime mode (managed VM / docker / self-hosted),
+* injects the agent's Alfe key, and forwards arbitrary paths to the cloud AI
+* proxy. openclaw-chat hardcodes the same host for /__alfe/set-identity.
+*/
+const LOCAL_AI_PROXY_URL = process.env.ALFE_AI_PROXY_URL ?? "http://127.0.0.1:18193";
 function ok(result) {
 	return { content: [{
 		type: "text",
@@ -3182,6 +3189,95 @@ function buildIntegrationTools(client) {
 		})
 	];
 }
+function buildVoiceTools(client) {
+	return [
+		defineTool({
+			name: "list_voices",
+			description: "List the available voices this agent can speak with (the ElevenLabs catalogue). Use this to pick or confirm a voice before calling set_voice with the chosen id.",
+			parameters: Type.Object({}),
+			handler: async () => {
+				const { voices } = await client.listVoices();
+				return { voices: voices.map((v) => ({
+					id: v.id,
+					name: v.name,
+					description: v.description,
+					labels: v.labels,
+					category: v.category,
+					previewUrl: v.previewUrl
+				})) };
+			}
+		}),
+		defineTool({
+			name: "set_voice",
+			description: "Change this agent's OWN voice. Pass a `voiceId` from list_voices. Optionally set `enabled` to turn voice on/off. Returns the updated voice config.",
+			parameters: Type.Object({
+				voiceId: Type.String({ description: "The ElevenLabs voice id to use, from list_voices (e.g. the `id` field)." }),
+				enabled: Type.Optional(Type.Boolean({ description: "Enable or disable voice. Omit to leave the current on/off state unchanged." }))
+			}),
+			handler: async (params) => {
+				const voiceId = params.voiceId;
+				const enabled = params.enabled;
+				return {
+					updated: true,
+					voiceConfig: (await client.updateSelf({ voiceConfig: {
+						voiceId,
+						...enabled === void 0 ? {} : { enabled }
+					} })).voiceConfig
+				};
+			}
+		}),
+		defineTool({
+			name: "generate_image",
+			description: "Generate an image from a text prompt. Returns a URL to the generated PNG. To show the image to the user, embed it in your reply as markdown: ![description](imageUrl). Optional `model` picks the image model (default gpt-image-1).",
+			parameters: Type.Object({
+				prompt: Type.String({ description: "Text description of the image to generate." }),
+				model: Type.Optional(Type.String({ description: "Image model id (default \"gpt-image-1\"). Others may be available, e.g. dall-e-3." })),
+				size: Type.Optional(Type.String({ description: "Image size, e.g. \"1024x1024\" (provider-dependent)." })),
+				quality: Type.Optional(Type.String({ description: "Image quality hint (provider-dependent)." }))
+			}),
+			handler: async (params) => {
+				const prompt = params.prompt;
+				const model = params.model ?? "gpt-image-1";
+				const size = params.size;
+				const quality = params.quality;
+				const genRes = await fetch(`${LOCAL_AI_PROXY_URL}/v1/images/generations`, {
+					method: "POST",
+					headers: { "Content-Type": "application/json" },
+					body: JSON.stringify({
+						model,
+						prompt,
+						...size ? { size } : {},
+						...quality ? { quality } : {}
+					})
+				});
+				const genJson = await genRes.json().catch(() => ({}));
+				if (!genRes.ok) throw new Error(`image generation failed (${String(genRes.status)}): ${genJson.message ?? genJson.error ?? "unknown error"}`);
+				const b64 = genJson.data?.[0]?.b64_json;
+				if (!b64) throw new Error("image generation returned no image data");
+				const buffer = Buffer.from(b64, "base64");
+				const filename = `generated-image-${String(Date.now())}.png`;
+				const { attachments } = await client.presignAttachments([{
+					filename,
+					mimeType: "image/png",
+					size: buffer.length
+				}]);
+				if (attachments.length === 0) throw new Error("failed to presign upload for the generated image");
+				const att = attachments[0];
+				const putRes = await fetch(att.uploadUrl, {
+					method: "PUT",
+					headers: { "Content-Type": "image/png" },
+					body: buffer
+				});
+				if (!putRes.ok) throw new Error(`failed to upload the generated image (${String(putRes.status)})`);
+				return {
+					imageUrl: att.downloadUrl,
+					model,
+					instruction: "Show this image to the user by including it in your reply as markdown: ![image](imageUrl)."
+				};
+			}
+		})
+	];
+}
 const plugin = {
 	id: "@alfe.ai/openclaw",
 	name: "Alfe OpenClaw Plugin",
@@ -3196,12 +3292,13 @@ const plugin = {
 			log.warn(`Integration tools not registered — config not available: ${err.message}`);
 		}
 		if (cfg) {
-			const tools = buildIntegrationTools(new AgentApiClient({
+			const client = new AgentApiClient({
 				apiKey: cfg.apiKey,
 				apiUrl: cfg.apiUrl
-			}));
+			});
+			const tools = [...buildIntegrationTools(client), ...buildVoiceTools(client)];
 			for (const tool of tools) api.registerTool(tool);
-			log.info(`Registered ${String(tools.length)} integration tools: ${tools.map((t) => t.name).join(", ")}`);
+			log.info(`Registered ${String(tools.length)} agent tools: ${tools.map((t) => t.name).join(", ")}`);
 		}
 		const startDaemonIpc = () => {
 			if (globalThis.__alfeOpenclawPluginActivated === true) {

package/openclaw.plugin.json

@@ -11,7 +11,8 @@
       "update_integration_config",
       "install_integration",
       "remove_integration",
-      "browse_integration_registry"
+      "browse_integration_registry",
+      "generate_image"
     ]
   },
   "configSchema": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/openclaw",
-  "version": "0.0.45",
+  "version": "0.2.0",
   "description": "OpenClaw plugin for Alfe — connects to local gateway daemon via IPC for integration management",
   "type": "module",
   "main": "./dist/index.js",
@@ -26,8 +26,8 @@
     "@auriclabs/logger": "^0.1.1",
     "@sinclair/typebox": "^0.34.48",
     "zod": "^4.1.5",
-    "@alfe.ai/agent-api-client": "^0.3.0",
-    "@alfe.ai/config": "^0.1.0"
+    "@alfe.ai/agent-api-client": "^0.4.0",
+    "@alfe.ai/config": "^0.2.0"
   },
   "peerDependencies": {
     "openclaw": ">=2026.3.0"
@@ -42,6 +42,16 @@
     "openclaw.plugin.json"
   ],
   "license": "UNLICENSED",
+  "homepage": "https://alfe.ai",
+  "author": "Alfe (https://alfe.ai)",
+  "keywords": [
+    "alfe",
+    "ai-agents",
+    "agent",
+    "llm",
+    "openclaw",
+    "plugin"
+  ],
   "scripts": {
     "build": "tsdown",
     "dev": "tsdown --watch",