mlclaw 0.1.0 → 0.2.1

package/entrypoint.sh

@@ -83,5 +83,9 @@ if [ -n "${TELEGRAM_BOT_TOKEN:-}" ] && [ "${OPENCLAW_TELEGRAM_CONNECTIVITY_PROBE
   fi
 fi
 
+echo "[hf-tooling] seeding baseline Hugging Face tooling"
+node /app/hf-tooling-seed.js
+echo "[hf-tooling] baseline Hugging Face tooling ready"
+
 chown -R node:node "$LIVE_DIR"
 exec gosu node node /app/hf-state-sync.js supervise -- node /app/mlclaw-space-runtime.js

package/mlclaw.ps1

@@ -71,16 +71,18 @@ function Install-CachedNode {
 function Invoke-MLClaw($NodeBin, [string[]]$CliArgs) {
   $nodeDir = Split-Path $NodeBin -Parent
   $env:PATH = "$nodeDir;$env:PATH"
+  $execPrefix = Join-Path $CacheRoot "npm-exec"
+  New-Item -ItemType Directory -Force -Path $execPrefix | Out-Null
   $npmCli = Join-Path $nodeDir "node_modules\npm\bin\npm-cli.js"
   if (-not (Test-Path $npmCli)) {
     $npmCommand = Get-Command npm -ErrorAction SilentlyContinue
     if (-not $npmCommand) {
       throw "npm was not found for Node runtime $NodeBin"
     }
-    & $npmCommand.Source exec --yes --package $PackageSpec -- mlclaw @CliArgs
+    & $npmCommand.Source exec --yes --prefix $execPrefix --package $PackageSpec -- mlclaw @CliArgs
     exit $LASTEXITCODE
   }
-  & $NodeBin $npmCli exec --yes --package $PackageSpec -- mlclaw @CliArgs
+  & $NodeBin $npmCli exec --yes --prefix $execPrefix --package $PackageSpec -- mlclaw @CliArgs
   exit $LASTEXITCODE
 }
 

package/mlclaw.sh

@@ -84,14 +84,16 @@ install_node() {
 run_with_node() {
   local node_bin="$1"
   shift
-  local npm_cli node_path
+  local npm_cli node_path exec_prefix
   node_path="$(dirname "$node_bin")"
   npm_cli="$(dirname "$node_bin")/../lib/node_modules/npm/bin/npm-cli.js"
+  exec_prefix="$CACHE_ROOT/npm-exec"
+  mkdir -p "$exec_prefix"
   if [ -f "$npm_cli" ]; then
-    PATH="$node_path:$PATH" exec "$node_bin" "$npm_cli" exec --yes --package "$PACKAGE_SPEC" -- mlclaw "$@"
+    PATH="$node_path:$PATH" exec "$node_bin" "$npm_cli" exec --yes --prefix "$exec_prefix" --package "$PACKAGE_SPEC" -- mlclaw "$@"
   fi
   if command -v npm >/dev/null 2>&1; then
-    PATH="$node_path:$PATH" exec npm exec --yes --package "$PACKAGE_SPEC" -- mlclaw "$@"
+    PATH="$node_path:$PATH" exec npm exec --yes --prefix "$exec_prefix" --package "$PACKAGE_SPEC" -- mlclaw "$@"
   fi
   die "npm was not found for Node runtime $node_bin"
 }

package/openclaw.default.json

@@ -1,6 +1,7 @@
 {
   "agents": {
     "defaults": {
+      "workspace": "${OPENCLAW_WORKSPACE_DIR}",
       "model": {
         "primary": "${OPENCLAW_MODEL}"
       }

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "mlclaw",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "license": "MIT",
+  "config": {
+    "openclawVersion": "2026.6.11",
+    "runtimeImageRepository": "ghcr.io/osolmaz/mlclaw"
+  },
   "repository": {
     "type": "git",
     "url": "https://github.com/osolmaz/mlclaw"
@@ -19,6 +23,7 @@
     ".gitattributes",
     "assets/",
     "dist/hf-state-sync.js",
+    "dist/hf-tooling-seed.js",
     "dist/mlclaw.mjs",
     "dist/mlclaw-space-runtime.js",
     "Dockerfile",
@@ -38,8 +43,10 @@
     "tsconfig.json"
   ],
   "scripts": {
-    "build": "npm run build:state-sync && npm run build:space-runtime && npm run build:mlclaw",
+    "build": "npm run build:control-ui && npm run build:state-sync && npm run build:hf-tooling && npm run build:space-runtime && npm run build:mlclaw",
+    "build:control-ui": "vite build --config vite.control-ui.config.ts",
     "build:state-sync": "esbuild src/hf-state-sync/cli.ts --bundle --platform=node --target=node22 --format=esm --outfile=dist/hf-state-sync.js --banner:js=\"import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);\"",
+    "build:hf-tooling": "esbuild src/hf-tooling/cli.ts --bundle --platform=node --target=node22 --format=esm --outfile=dist/hf-tooling-seed.js --banner:js=\"import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);\"",
     "build:space-runtime": "esbuild src/mlclaw-space-runtime/cli.ts --bundle --platform=node --target=node22 --format=esm --outfile=dist/mlclaw-space-runtime.js --banner:js=\"import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);\"",
     "build:mlclaw": "esbuild src/mlclaw/cli.ts --bundle --platform=node --target=node22 --format=esm --outfile=dist/mlclaw.mjs --banner:js=\"import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);\"",
     "build:probe": "esbuild scripts/parity-probe.ts --bundle --platform=node --target=node22 --format=esm --outfile=dist/parity-probe.mjs --banner:js=\"import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);\"",
@@ -54,13 +61,20 @@
     "@huggingface/splitmix64-wasm": "^0.0.1",
     "@huggingface/xetchunk-wasm": "^0.0.6",
     "commander": "^14.0.3",
+    "hono": "^4.12.28",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
     "skillflag": "^0.2.0",
     "zod": "^3.24.0"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",
+    "@types/react": "^19.2.17",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^5.2.0",
     "esbuild": "^0.25.0",
     "typescript": "^5.7.0",
+    "vite": "^7.3.6",
     "vitest": "^3.0.0"
   }
 }

package/space/README.md

@@ -21,8 +21,38 @@ secrets:
 </p>
 
 ML Claw runs OpenClaw in a Hugging Face Space with a browser gateway protected
-by Hugging Face OAuth. Duplicate this Space or use `mlclaw bootstrap` to create
-your own deployment.
+by Hugging Face OAuth.
+
+Do not set up ML Claw by only clicking Duplicate. Run the local bootstrapper
+instead. It creates the private Space, private Storage Bucket, OAuth settings,
+secrets, model configuration, and local manifest for you.
+
+With Node.js:
+
+```bash
+npx mlclaw bootstrap --name mlclaw
+```
+
+On macOS or Linux without Node.js:
+
+```bash
+bash <(curl -fsSL https://raw.githubusercontent.com/osolmaz/mlclaw/main/mlclaw.sh) --name mlclaw
+```
+
+On Windows PowerShell:
+
+```powershell
+irm https://raw.githubusercontent.com/osolmaz/mlclaw/main/mlclaw.ps1 | iex
+```
+
+After the command finishes, open the Space it created and sign in with your
+Hugging Face account.
+
+After sign-in, use `/mlclaw` for settings, status, credentials, and sign out.
+The OpenClaw gateway also shows a small ML Claw control link.
+
+Duplicating this Space manually is only useful for development or for people
+who already know how to configure the required secrets and variables.
 
 The public Space process is an ML Claw proxy. It authenticates the signed-in
 Hugging Face user, then forwards browser traffic to OpenClaw on loopback using

package/tsconfig.json

@@ -3,8 +3,9 @@
     "target": "ES2023",
     "module": "NodeNext",
     "moduleResolution": "NodeNext",
-    "lib": ["ES2023"],
+    "lib": ["ES2023", "DOM"],
     "types": ["node"],
+    "jsx": "react-jsx",
     "strict": true,
     "noUncheckedIndexedAccess": true,
     "exactOptionalPropertyTypes": true,
@@ -12,5 +13,5 @@
     "noEmit": true,
     "skipLibCheck": true
   },
-  "include": ["src/**/*.ts", "test/**/*.ts"]
+  "include": ["src/**/*.ts", "src/**/*.tsx", "test/**/*.ts", "vite.control-ui.config.ts"]
 }