mlclaw 0.2.1 → 0.2.3

package/.agents/skills/mlclaw/SKILL.md

@@ -64,7 +64,7 @@ Space names from that.
 With Node.js:
 
 ```bash
-npx mlclaw bootstrap --name mlclaw
+npx mlclaw@latest bootstrap --name mlclaw
 ```
 
 Without Node.js on macOS/Linux:
@@ -92,13 +92,13 @@ node dist/mlclaw.mjs --help
 Interactive:
 
 ```bash
-npx mlclaw bootstrap --name mlclaw
+npx mlclaw@latest bootstrap --name mlclaw
 ```
 
 Automation:
 
 ```bash
-npx mlclaw bootstrap \
+npx mlclaw@latest bootstrap \
   --name mlclaw \
   --model huggingface/google/gemma-4-26B-A4B-it:deepinfra \
   --yes
@@ -118,7 +118,7 @@ Create a public Space only when the user explicitly asks for a public demo or
 template-style deployment:
 
 ```bash
-npx mlclaw bootstrap --name mlclaw --public-space
+npx mlclaw@latest bootstrap --name mlclaw --public-space
 ```
 
 ## Optional Telegram
@@ -126,7 +126,7 @@ npx mlclaw bootstrap --name mlclaw --public-space
 Telegram is optional and should not be required for the default setup.
 
 ```bash
-npx mlclaw bootstrap \
+npx mlclaw@latest bootstrap \
   --telegram-token-file ~/secrets/mlclaw_bot.env \
   --telegram-user-id 1234567890 \
   --hardware cpu-upgrade \
@@ -143,13 +143,13 @@ restriction because messaging traffic originates from the user's machine.
 Use local gateway mode when the user wants the gateway on their machine:
 
 ```bash
-npx mlclaw bootstrap --gateway local --name mlclaw
+npx mlclaw@latest bootstrap --gateway local --name mlclaw
 ```
 
 If the user has multiple Docker engines, pin the intended context:
 
 ```bash
-npx mlclaw bootstrap \
+npx mlclaw@latest bootstrap \
   --gateway local \
   --name mlclaw \
   --docker-context desktop-linux
@@ -167,7 +167,7 @@ models, use the `huggingface/` prefix.
 Default/recommended:
 
 ```bash
-npx mlclaw bootstrap \
+npx mlclaw@latest bootstrap \
   --name mlclaw \
   --model huggingface/google/gemma-4-26B-A4B-it:deepinfra
 ```
@@ -175,8 +175,15 @@ npx mlclaw bootstrap \
 Known useful router-compatible choices:
 
 - `huggingface/google/gemma-4-26B-A4B-it:deepinfra`: default quality target.
+- `huggingface/Qwen/Qwen3.6-35B-A3B:deepinfra`: strong Qwen 3.6 option with tool and structured-output support.
 - `huggingface/Qwen/Qwen3.6-27B:deepinfra`: live Qwen 3.6 option with tool and structured-output support.
-- `huggingface/Qwen/Qwen3-8B:nscale`: cheaper small-model option.
+- `huggingface/zai-org/GLM-5.2:deepinfra`: long-context GLM option with tool and structured-output support.
+- `huggingface/moonshotai/Kimi-K2.7-Code:deepinfra`: coding-focused Kimi option with tool and structured-output support.
+- `huggingface/openai/gpt-oss-120b:deepinfra`: larger GPT-OSS option with tool and structured-output support.
+- `huggingface/openai/gpt-oss-20b:deepinfra`: lower-cost GPT-OSS option with tool and structured-output support.
+- `huggingface/deepseek-ai/DeepSeek-V4-Flash:deepinfra`: low-cost long-context DeepSeek V4 option.
+- `huggingface/deepseek-ai/DeepSeek-V4-Pro:deepinfra`: higher-quality long-context DeepSeek V4 option.
+- `huggingface/MiniMaxAI/MiniMax-M3:together`: long-context MiniMax option with tool and structured-output support.
 
 Do not assume every Hub model is a Router chat model. If exact current model
 availability matters, check the Hugging Face Router catalog or run a direct
@@ -229,10 +236,11 @@ to the browser.
 ## Branding
 
 ML Claw white-labels the browser gateway at the proxy layer. App Spaces default
-the browser title, PWA manifest, assistant fallback avatar, login heading, and
-ML Claw control link to the agent name. The ML Claw logo is reserved for the
-control UI brand mark. The gateway shortcut, login logo, and default browser
-icons use the Hugging Face logo.
+the browser title, PWA manifest, login heading, and ML Claw control link to the
+agent name. The ML Claw logo is reserved for the control UI brand mark. The
+gateway shortcut, login logo, and default browser icons use the Hugging Face
+logo. The OpenClaw assistant fallback avatar defaults to a neutral assistant
+icon.
 
 Use Space variables for explicit branding:
 
@@ -244,7 +252,8 @@ MLCLAW_BRAND_LOGO="mlclaw.svg"
 MLCLAW_BRAND_FAVICON="hf-logo.svg"
 MLCLAW_BRAND_FAVICON_32="hf-logo.svg"
 MLCLAW_BRAND_FAVICON_ICO="hf-logo.svg"
-MLCLAW_BRAND_APPLE_TOUCH_ICON="hf-logo.svg"
+MLCLAW_BRAND_APPLE_TOUCH_ICON="assistant-avatar.svg"
+MLCLAW_BRAND_ASSISTANT_AVATAR="assistant-avatar.svg"
 ```
 
 Brand asset paths are relative to the Space `assets/` directory. ML Claw serves

package/Dockerfile

@@ -1,6 +1,6 @@
-ARG OPENCLAW_VERSION=2026.6.11
+ARG OPENCLAW_VERSION=2026.7.1-beta.2
 ARG OPENCLAW_BASE_IMAGE=ghcr.io/openclaw/openclaw:${OPENCLAW_VERSION}
-ARG MLCLAW_RUNTIME_IMAGE=ghcr.io/osolmaz/mlclaw:0.2.1-openclaw-2026.6.11
+ARG MLCLAW_RUNTIME_IMAGE=ghcr.io/osolmaz/mlclaw:0.2.3-openclaw-2026.7.1-beta.2
 
 # Stage 1: build the state-sync bundle so the runtime image needs no dev deps.
 FROM node:24-bookworm-slim AS sync-build

package/README.md

@@ -17,7 +17,7 @@ OpenClaw on loopback using OpenClaw trusted-proxy auth.
 With Node.js:
 
 ```bash
-npx mlclaw bootstrap
+npx mlclaw@latest bootstrap
 ```
 
 Without Node.js, the launcher fetches a pinned Node runtime into your user
@@ -40,7 +40,7 @@ token into someone else's app; the bootstrapper runs locally.
 ## Default Flow
 
 ```bash
-npx mlclaw bootstrap --name mlclaw
+npx mlclaw@latest bootstrap --name mlclaw
 ```
 
 This creates:
@@ -59,13 +59,13 @@ for settings, status, credentials, and sign out.
 Create a public Space only when you explicitly want a public demo or template:
 
 ```bash
-npx mlclaw bootstrap --name mlclaw --public-space
+npx mlclaw@latest bootstrap --name mlclaw --public-space
 ```
 
 Choose a Hugging Face Router model with `--model`:
 
 ```bash
-npx mlclaw bootstrap \
+npx mlclaw@latest bootstrap \
   --name mlclaw \
   --model huggingface/google/gemma-4-26B-A4B-it:deepinfra
 ```
@@ -73,8 +73,15 @@ npx mlclaw bootstrap \
 Recommended router-compatible options:
 
 - `huggingface/google/gemma-4-26B-A4B-it:deepinfra`: default quality target.
+- `huggingface/Qwen/Qwen3.6-35B-A3B:deepinfra`: strong Qwen 3.6 option with tool and structured-output support.
 - `huggingface/Qwen/Qwen3.6-27B:deepinfra`: live Qwen 3.6 option with tool and structured-output support.
-- `huggingface/Qwen/Qwen3-8B:nscale`: cheaper small-model option.
+- `huggingface/zai-org/GLM-5.2:deepinfra`: long-context GLM option with tool and structured-output support.
+- `huggingface/moonshotai/Kimi-K2.7-Code:deepinfra`: coding-focused Kimi option with tool and structured-output support.
+- `huggingface/openai/gpt-oss-120b:deepinfra`: larger GPT-OSS option with tool and structured-output support.
+- `huggingface/openai/gpt-oss-20b:deepinfra`: lower-cost GPT-OSS option with tool and structured-output support.
+- `huggingface/deepseek-ai/DeepSeek-V4-Flash:deepinfra`: low-cost long-context DeepSeek V4 option.
+- `huggingface/deepseek-ai/DeepSeek-V4-Pro:deepinfra`: higher-quality long-context DeepSeek V4 option.
+- `huggingface/MiniMaxAI/MiniMax-M3:together`: long-context MiniMax option with tool and structured-output support.
 
 ## Optional Telegram
 
@@ -83,7 +90,7 @@ Telegram `getMe`, removes a trailing `_bot` from the username, and can derive
 the Space and bucket names from the bot username.
 
 ```bash
-npx mlclaw bootstrap \
+npx mlclaw@latest bootstrap \
   --telegram-token-file ~/secrets/mlclaw_bot.env \
   --telegram-user-id 1234567890 \
   --hardware cpu-upgrade \
@@ -100,7 +107,7 @@ only for automation.
 You can run the gateway locally instead of inside a Space:
 
 ```bash
-npx mlclaw bootstrap --gateway local --name mlclaw
+npx mlclaw@latest bootstrap --gateway local --name mlclaw
 ```
 
 Local mode uses Docker on your machine and the same private Storage Bucket.
@@ -175,10 +182,11 @@ mutate only the current Space, inferred from `SPACE_ID`.
 ## Branding
 
 ML Claw white-labels the browser-facing gateway by default. App Spaces use the
-agent name as the browser title, PWA name, login heading, assistant fallback
-avatar, and ML Claw control link label. The ML Claw logo is reserved for the
-control UI brand mark. The gateway shortcut, login logo, and default browser
-icons use the Hugging Face logo.
+agent name as the browser title, PWA name, login heading, and ML Claw control
+link label. The ML Claw logo is reserved for the control UI brand mark. The
+gateway shortcut, login logo, and default browser icons use the Hugging Face
+logo. The OpenClaw assistant fallback avatar defaults to a neutral assistant
+icon.
 
 Override branding with Space variables:
 
@@ -190,7 +198,8 @@ MLCLAW_BRAND_LOGO=mlclaw.svg
 MLCLAW_BRAND_FAVICON=hf-logo.svg
 MLCLAW_BRAND_FAVICON_32=hf-logo.svg
 MLCLAW_BRAND_FAVICON_ICO=hf-logo.svg
-MLCLAW_BRAND_APPLE_TOUCH_ICON=hf-logo.svg
+MLCLAW_BRAND_APPLE_TOUCH_ICON=assistant-avatar.svg
+MLCLAW_BRAND_ASSISTANT_AVATAR=assistant-avatar.svg
 ```
 
 Brand asset paths are relative to the Space `assets/` directory. ML Claw serves

package/assets/assistant-avatar.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" role="img" aria-label="Assistant">
+  <rect width="256" height="256" rx="64" fill="#111827"/>
+  <path fill="#f9fafb" d="M128 52 146 107h58l-47 34 18 55-47-34-47 34 18-55-47-34h58z"/>
+  <circle cx="128" cy="128" r="92" fill="none" stroke="#f9fafb" stroke-width="10" opacity=".22"/>
+</svg>

package/dist/mlclaw-space-runtime.js

@@ -17,6 +17,7 @@ var DEFAULT_BRAND_NAME = "ML Claw";
 var DEFAULT_THEME_COLOR = "#111827";
 var DEFAULT_LOGO_ASSET = "mlclaw.svg";
 var DEFAULT_HUGGING_FACE_ASSET = "hf-logo.svg";
+var DEFAULT_ASSISTANT_AVATAR_ASSET = "assistant-avatar.svg";
 function resolveBranding(env, agentName) {
   const defaultName = defaultBrandName(agentName);
   const name = cleanText(env.MLCLAW_BRAND_NAME) ?? defaultName;
@@ -38,8 +39,8 @@ function resolveBranding(env, agentName) {
       DEFAULT_HUGGING_FACE_ASSET
     ),
     appleTouchIconAsset: normalizeAssetRef(
-      env.MLCLAW_BRAND_APPLE_TOUCH_ICON ?? env.MLCLAW_BRAND_FAVICON_PNG ?? env.MLCLAW_BRAND_FAVICON,
-      DEFAULT_HUGGING_FACE_ASSET
+      env.MLCLAW_BRAND_APPLE_TOUCH_ICON ?? env.MLCLAW_BRAND_ASSISTANT_AVATAR,
+      DEFAULT_ASSISTANT_AVATAR_ASSET
     )
   };
 }
@@ -139,6 +140,22 @@ var PRESET_MODEL_CHOICES = [
     outputModalities: ["text"],
     preset: true
   }),
+  freezeChoice({
+    modelId: "Qwen/Qwen3.6-35B-A3B",
+    provider: "deepinfra",
+    label: "Qwen 3.6 35B A3B",
+    note: "Strong Qwen 3.6 preset on DeepInfra",
+    contextLength: 262144,
+    pricing: { input: 0.15, output: 0.95 },
+    supportsTools: true,
+    supportsStructuredOutput: true,
+    firstTokenLatencyMs: 401,
+    throughput: 43.13170843671405,
+    status: "live",
+    inputModalities: ["text"],
+    outputModalities: ["text"],
+    preset: true
+  }),
   freezeChoice({
     modelId: "Qwen/Qwen3.6-27B",
     provider: "deepinfra",
@@ -154,6 +171,118 @@ var PRESET_MODEL_CHOICES = [
     inputModalities: ["text", "image"],
     outputModalities: ["text"],
     preset: true
+  }),
+  freezeChoice({
+    modelId: "zai-org/GLM-5.2",
+    provider: "deepinfra",
+    label: "GLM 5.2",
+    note: "Long-context GLM preset on DeepInfra",
+    contextLength: 1048576,
+    pricing: { input: 0.93, output: 3 },
+    supportsTools: true,
+    supportsStructuredOutput: true,
+    firstTokenLatencyMs: 467.5,
+    throughput: 16.52283992136833,
+    status: "live",
+    inputModalities: ["text"],
+    outputModalities: ["text"],
+    preset: true
+  }),
+  freezeChoice({
+    modelId: "moonshotai/Kimi-K2.7-Code",
+    provider: "deepinfra",
+    label: "Kimi K2.7 Code",
+    note: "Kimi K2.7 coding preset on DeepInfra",
+    contextLength: 262144,
+    pricing: { input: 0.74, output: 3.5 },
+    supportsTools: true,
+    supportsStructuredOutput: true,
+    firstTokenLatencyMs: 692,
+    throughput: 29.26330731892916,
+    status: "live",
+    inputModalities: ["text"],
+    outputModalities: ["text"],
+    preset: true
+  }),
+  freezeChoice({
+    modelId: "openai/gpt-oss-120b",
+    provider: "deepinfra",
+    label: "GPT-OSS 120B",
+    note: "Large GPT-OSS preset on DeepInfra",
+    contextLength: 131072,
+    pricing: { input: 0.037, output: 0.17 },
+    supportsTools: true,
+    supportsStructuredOutput: true,
+    firstTokenLatencyMs: 362.2,
+    throughput: 32.98392643597656,
+    status: "live",
+    inputModalities: ["text"],
+    outputModalities: ["text"],
+    preset: true
+  }),
+  freezeChoice({
+    modelId: "openai/gpt-oss-20b",
+    provider: "deepinfra",
+    label: "GPT-OSS 20B",
+    note: "Lower-cost GPT-OSS preset on DeepInfra",
+    contextLength: 131072,
+    pricing: { input: 0.03, output: 0.14 },
+    supportsTools: true,
+    supportsStructuredOutput: true,
+    firstTokenLatencyMs: 255,
+    throughput: 115.64765388606148,
+    status: "live",
+    inputModalities: ["text"],
+    outputModalities: ["text"],
+    preset: true
+  }),
+  freezeChoice({
+    modelId: "deepseek-ai/DeepSeek-V4-Flash",
+    provider: "deepinfra",
+    label: "DeepSeek V4 Flash",
+    note: "Lower-cost DeepSeek V4 preset on DeepInfra",
+    contextLength: 1048576,
+    pricing: { input: 0.09, output: 0.18 },
+    supportsTools: true,
+    supportsStructuredOutput: true,
+    firstTokenLatencyMs: 719.8,
+    throughput: 24.5757632831937,
+    status: "live",
+    inputModalities: ["text"],
+    outputModalities: ["text"],
+    preset: true
+  }),
+  freezeChoice({
+    modelId: "deepseek-ai/DeepSeek-V4-Pro",
+    provider: "deepinfra",
+    label: "DeepSeek V4 Pro",
+    note: "Higher-quality DeepSeek V4 preset on DeepInfra",
+    contextLength: 1048576,
+    pricing: { input: 1.3, output: 2.6 },
+    supportsTools: true,
+    supportsStructuredOutput: true,
+    firstTokenLatencyMs: 489.2,
+    throughput: 37.30647476533069,
+    status: "live",
+    inputModalities: ["text"],
+    outputModalities: ["text"],
+    preset: true
+  }),
+  freezeChoice({
+    modelId: "MiniMaxAI/MiniMax-M3",
+    provider: "together",
+    label: "MiniMax M3",
+    note: "Long-context MiniMax preset on Together",
+    contextLength: 524288,
+    pricing: { input: 0.3, output: 1.2 },
+    supportsTools: true,
+    supportsStructuredOutput: true,
+    firstTokenLatencyMs: 505.6,
+    throughput: 59.79726580207129,
+    status: "live",
+    inputModalities: ["text"],
+    outputModalities: ["text"],
+    preset: true
   })
 ];
 function parseModelChoicesEnv(value, activeModel) {
@@ -6960,7 +7089,7 @@ function templatePage(config2) {
       <p>Run the local bootstrapper to create a Hugging Face hosted OpenClaw agent for ML workflows.</p>
       <p class="notice">Do not set this up by only clicking Duplicate. The bootstrapper creates the private Space, private Storage Bucket, OAuth settings, secrets, model configuration, and local manifest.</p>
       <h2>With Node.js</h2>
-      <pre><code>npx mlclaw bootstrap --name mlclaw</code></pre>
+      <pre><code>npx mlclaw@latest bootstrap --name mlclaw</code></pre>
       <h2>macOS or Linux without Node.js</h2>
       <pre><code>bash &lt;(curl -fsSL https://raw.githubusercontent.com/osolmaz/mlclaw/main/mlclaw.sh) --name mlclaw</code></pre>
       <h2>Windows PowerShell</h2>
@@ -7516,6 +7645,7 @@ function createSpaceRuntimeApp(config2, controls) {
   app.get("/healthz", (c) => health(c, config2, controls));
   app.get("/assets/mlclaw.svg", async () => serveFile(path3.join(config2.assetsDir, "mlclaw.svg"), "image/svg+xml; charset=utf-8"));
   app.get("/assets/hf-logo.svg", async () => serveFile(path3.join(config2.assetsDir, "hf-logo.svg"), "image/svg+xml; charset=utf-8"));
+  app.get("/assets/assistant-avatar.svg", async () => serveFile(path3.join(config2.assetsDir, "assistant-avatar.svg"), "image/svg+xml; charset=utf-8"));
   app.get("/assets/mlclaw-control-branding.js", () => staticScript(CONTROL_BRANDING_SCRIPT));
   app.get("/assets/brand/logo", async () => serveBrandAsset(config2, config2.branding.logoAsset));
   app.get("/favicon.svg", async () => serveBrandAsset(config2, config2.branding.faviconSvgAsset));
@@ -7853,11 +7983,11 @@ async function serveFile(file, contentTypeHeader, immutable = false) {
   }
 }
 async function serveBrandAsset(config2, asset) {
-  const response = await serveFile(path3.join(config2.assetsDir, asset), contentType(asset), true);
+  const response = await serveFile(path3.join(config2.assetsDir, asset), contentType(asset));
   if (response.status !== 404 || asset === "mlclaw.svg") {
     return response;
   }
-  return serveFile(path3.join(config2.assetsDir, "mlclaw.svg"), "image/svg+xml; charset=utf-8", true);
+  return serveFile(path3.join(config2.assetsDir, "mlclaw.svg"), "image/svg+xml; charset=utf-8");
 }
 function safeRelativePath(value) {
   let decoded;
@@ -8172,7 +8302,7 @@ var SpaceRuntimeServer = class {
     await proxyHttp(req, res, this.config, { username: session.username });
   }
   shouldRouteToMlClaw(pathname) {
-    return pathname === "/health" || pathname === "/healthz" || pathname === "/favicon.svg" || pathname === "/favicon-32.png" || pathname === "/favicon.ico" || pathname === "/apple-touch-icon.png" || pathname === "/manifest.webmanifest" || pathname === "/sw.js" || pathname === "/assets/hf-logo.svg" || pathname === "/assets/mlclaw.svg" || pathname === "/assets/mlclaw-control-branding.js" || pathname === "/assets/brand/logo" || pathname === "/login" || pathname === "/logout" || pathname.startsWith("/oauth/") || pathname === "/mlclaw" || pathname.startsWith("/mlclaw/");
+    return pathname === "/health" || pathname === "/healthz" || pathname === "/favicon.svg" || pathname === "/favicon-32.png" || pathname === "/favicon.ico" || pathname === "/apple-touch-icon.png" || pathname === "/manifest.webmanifest" || pathname === "/sw.js" || pathname === "/assets/hf-logo.svg" || pathname === "/assets/mlclaw.svg" || pathname === "/assets/assistant-avatar.svg" || pathname === "/assets/mlclaw-control-branding.js" || pathname === "/assets/brand/logo" || pathname === "/login" || pathname === "/logout" || pathname.startsWith("/oauth/") || pathname === "/mlclaw" || pathname.startsWith("/mlclaw/");
   }
   async startOpenClaw(extraEnv = {}) {
     if (this.openclawStarting || this.openclaw && !this.openclaw.killed) {
@@ -8299,7 +8429,7 @@ function isApiPath(pathname) {
   return pathname.startsWith("/mlclaw/api/");
 }
 function isTemplateRuntimePath(pathname) {
-  return pathname === "/health" || pathname === "/healthz" || pathname === "/favicon.svg" || pathname === "/favicon-32.png" || pathname === "/favicon.ico" || pathname === "/apple-touch-icon.png" || pathname === "/manifest.webmanifest" || pathname === "/assets/hf-logo.svg" || pathname === "/assets/mlclaw.svg" || pathname === "/assets/brand/logo";
+  return pathname === "/health" || pathname === "/healthz" || pathname === "/favicon.svg" || pathname === "/favicon-32.png" || pathname === "/favicon.ico" || pathname === "/apple-touch-icon.png" || pathname === "/manifest.webmanifest" || pathname === "/assets/hf-logo.svg" || pathname === "/assets/mlclaw.svg" || pathname === "/assets/assistant-avatar.svg" || pathname === "/assets/brand/logo";
 }
 function formatError2(err) {
   return err instanceof Error ? err.stack ?? err.message : String(err);

package/dist/mlclaw.mjs

@@ -14804,7 +14804,7 @@ function sseDataToText(raw) {
 import fs11 from "node:fs";
 import path12 from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
-var DEFAULT_OPENCLAW_VERSION = "2026.6.11";
+var DEFAULT_OPENCLAW_VERSION = "2026.7.1-beta.2";
 var DEFAULT_RUNTIME_IMAGE_REPOSITORY = "ghcr.io/osolmaz/mlclaw";
 var PACKAGE_METADATA = readPackageMetadata();
 var PACKAGE_VERSION = packageString("version", "unknown");
@@ -14903,6 +14903,7 @@ async function currentTemplateRev(sourceDir) {
 async function generateSpaceRepo(sourceDir, outDir, options = {}) {
   const copies = [
     [".gitattributes", ".gitattributes"],
+    ["assets/assistant-avatar.svg", "assets/assistant-avatar.svg"],
     ["assets/hf-logo.svg", "assets/hf-logo.svg"],
     ["assets/mlclaw.svg", "assets/mlclaw.svg"],
     ["assets/mlclaw-control-ui", "assets/mlclaw-control-ui"],

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "mlclaw",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "license": "MIT",
   "config": {
-    "openclawVersion": "2026.6.11",
+    "openclawVersion": "2026.7.1-beta.2",
     "runtimeImageRepository": "ghcr.io/osolmaz/mlclaw"
   },
   "repository": {