Initial commit

.claude/scheduled_tasks.lock

@@ -0,0 +1 @@
+{"sessionId":"9cf03742-3f47-4a01-bbe9-989dff2c6421","pid":64066,"acquiredAt":1773282355683}

.env.example

@@ -0,0 +1,194 @@
+# ═══════════════════════════════════════════════════════════════════════════
+#  HuggingClaw — Environment Configuration
+#  Deploy OpenClaw on HuggingFace Spaces
+# ═══════════════════════════════════════════════════════════════════════════
+#
+#  Usage:
+#    Local Docker  →  cp .env.example .env  →  fill in values  →  docker run --env-file .env
+#    HF Spaces     →  Set each variable as a "Repository Secret" in Space Settings
+#
+#  Legend:
+#    [REQUIRED]      Must be set, or data persistence will not work
+#    [RECOMMENDED]   Strongly recommended for production use
+#    [OPTIONAL]      Fine-tune behavior; safe to leave empty
+#
+# ═══════════════════════════════════════════════════════════════════════════
+
+
+# ─── SECURITY ─────────────────────────────────────────────────────────────
+#
+# Password for the Control UI dashboard.
+# Visitors can see the UI, but only users with this password can connect
+# and control the OpenClaw instance (manage agents, plugins, settings).
+#
+# [RECOMMENDED]  Default: huggingclaw
+#
+OPENCLAW_PASSWORD=huggingclaw
+
+
+# ─── DATA PERSISTENCE ────────────────────────────────────────────────────
+#
+# HuggingClaw auto-syncs the ~/.openclaw directory to a private HF Dataset
+# repo, so your conversations, settings, and credentials survive restarts.
+# Without these two variables, all data is lost when the Space restarts.
+#
+# HuggingFace Access Token with WRITE permission.
+# Create one at: https://huggingface.co/settings/tokens
+# Scopes needed: read + write access to your repos.
+#
+# [REQUIRED]
+#
+HF_TOKEN=hf_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+
+# Target Dataset repository for data backup.
+# Format: your-username/repo-name
+# Example: your-name/YourSpace-data
+#
+#   Manual mode (default): create the repo yourself, then set this variable.
+#   Auto mode (AUTO_CREATE_DATASET=true): if not set, HuggingClaw derives
+#     it from your HF_TOKEN username → "your-username/HuggingClaw-data".
+#
+# [REQUIRED in manual mode, OPTIONAL in auto mode]
+#
+OPENCLAW_DATASET_REPO=your-username/HuggingClaw-data
+
+# Whether to auto-create the Dataset repo if it doesn't exist.
+# When true: HuggingClaw creates a PRIVATE dataset repo on first startup.
+#   If OPENCLAW_DATASET_REPO is not set, the repo name is auto-derived
+#   from your HF_TOKEN username (e.g. "your-username/HuggingClaw-data").
+# When false (default): you must create the repo manually on HuggingFace
+#   and set OPENCLAW_DATASET_REPO yourself.
+#
+# [OPTIONAL]  Default: false
+#
+# AUTO_CREATE_DATASET=false
+
+# How often (in seconds) to back up data to the Dataset repo.
+# Lower values = safer but more API calls to HuggingFace.
+#
+# [OPTIONAL]  Default: 60
+#
+# SYNC_INTERVAL=60
+
+
+# ─── LLM PROVIDERS ────────────────────────────────────────────────────────
+#
+# HuggingClaw passes ALL environment variables directly to OpenClaw.
+# Any provider that OpenClaw supports works out of the box — just set the
+# API key as a Secret in your HF Space settings.
+#
+# See OpenClaw docs: https://openclawdoc.com/docs/reference/environment-variables
+#
+# [RECOMMENDED] At least one of the following for AI conversations
+#
+OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+# OPENAI_BASE_URL=https://api.openai.com/v1
+# OPENROUTER_API_KEY=sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+# NVIDIA_API_KEY=nvapi-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+# ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+# GOOGLE_API_KEY=AIza...
+# MISTRAL_API_KEY=mis-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+# COHERE_API_KEY=co-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+
+# Default model for new conversations (must exist in your configured provider).
+#
+# [OPTIONAL]  Examples: openai/gpt-5-nano, openrouter/deepseek/deepseek-chat:free
+#
+# OPENCLAW_DEFAULT_MODEL=openai/gpt-5-nano
+
+
+# ─── PERFORMANCE ──────────────────────────────────────────────────────────
+#
+# Node.js heap memory limit in MB.
+# HF free tier provides 16 GB RAM. Default 512 MB is enough for most cases.
+# Increase if you run complex agent workflows or handle large conversations.
+#
+# [OPTIONAL]  Default: 512
+#
+# NODE_MEMORY_LIMIT=512
+
+
+# ─��─ LOCALE ───────────────────────────────────────────────────────────────
+#
+# Timezone for log timestamps and scheduled tasks.
+#
+# [OPTIONAL]  Default: UTC
+#
+# TZ=Asia/Shanghai
+
+
+# ─── OPENCLAW (from official docs) ─────────────────────────────────────────
+#
+# Optional overrides. See https://openclawdoc.com/docs/reference/environment-variables
+#
+# OPENCLAW_HOME=~/.openclaw
+# OPENCLAW_STATE_DIR=~/.openclaw
+# OPENCLAW_CONFIG_PATH=~/.openclaw/openclaw.json
+# OPENCLAW_LOG_LEVEL=info
+# OPENCLAW_API_PORT=8080
+# OPENCLAW_WS_PORT=8081
+# OPENCLAW_HOST=0.0.0.0
+# OLLAMA_HOST=http://localhost:11434
+# OPENCLAW_HTTP_PROXY=
+# OPENCLAW_HTTPS_PROXY=
+# OPENCLAW_NO_PROXY=
+
+
+# ═══════════════════════════════════════════════════════════════════════════
+#  OpenClaw 官方环境变量
+# ═══════════════════════════════════════════════════════════════════════════
+#
+#  HuggingClaw 启动 OpenClaw 时透传整个环境（env=os.environ.copy()），
+#  因此 OpenClaw 官方文档中列出的 **所有** 环境变量在 HF Spaces / Docker 中
+#  设置后均可直接生效。
+#  官方完整列表见：https://openclawdoc.com/docs/reference/environment-variables
+#
+#  常见类别（仅列举部分）：
+#    API Keys: OPENAI_API_KEY, ANTHROPIC_API_KEY, GOOGLE_API_KEY, MISTRAL_API_KEY,
+#              COHERE_API_KEY, OPENROUTER_API_KEY
+#    Server:   OPENCLAW_API_PORT, OPENCLAW_WS_PORT, OPENCLAW_METRICS_PORT,
+#              OPENCLAW_HOST, OPENCLAW_TLS_*
+#    App:      OPENCLAW_CONFIG, OPENCLAW_DATA_DIR, OPENCLAW_LOG_LEVEL,
+#              OPENCLAW_LOG_FORMAT, OPENCLAW_LOG_FILE, OPENCLAW_ENV
+#    Memory:   OPENCLAW_MEMORY_BACKEND, OPENCLAW_REDIS_URL, OPENCLAW_SQLITE_PATH
+#    Network:  OPENCLAW_HTTP_PROXY, OPENCLAW_HTTPS_PROXY, OPENCLAW_NO_PROXY,
+#              OPENCLAW_OUTBOUND_MODE
+#    Secrets:  OPENCLAW_SECRETS_BACKEND, OPENCLAW_SECRETS_KEY, VAULT_ADDR, VAULT_TOKEN
+#    Ollama:   OLLAMA_HOST, OLLAMA_NUM_PARALLEL, OLLAMA_KEEP_ALIVE
+#    Browser:  OPENCLAW_BROWSER_EXECUTABLE, OPENCLAW_BROWSER_HEADLESS
+#
+# ═══════════════════════════════════════════════════════════════════════════
+#
+# ═══════════════════════════════════════════════════════════════════════════
+#  HuggingClaw 新增变量一览（仅本仓库脚本使用）
+# ═══════════════════════════════════════════════════════════════════════════
+#
+# ─── 安全 / 控制台 ───────────────────────────────────────────────────────
+#   OPENCLAW_PASSWORD         [推荐] 控制台密码，未设则默认 huggingclaw
+#
+# ─── 持久化 (HuggingFace Dataset) ───────────────────────────────────────
+#   HF_TOKEN                  [必填] HF 访问令牌，需具备写入权限
+#   OPENCLAW_DATASET_REPO     [必填] 备份用 Dataset 仓库，如 your-name/HuggingClaw-data
+#   AUTO_CREATE_DATASET       [可选] 是否自动创建仓库，默认 false（安全考虑）
+#   SYNC_INTERVAL             [可选] 备份间隔（秒），默认 60
+#   HF_HUB_DOWNLOAD_TIMEOUT   [可选] 下载超时（秒），默认 300
+#   HF_HUB_UPLOAD_TIMEOUT     [可选] 上传超时（秒），默认 600
+#
+# ─── LLM / 对话 API（至少配置其一以启用 AI 对话）────────────────────────
+#   所有 OpenClaw 支持的 API Key 环境变量均可直接使用，无需额外配置。
+#   完整列表见 OpenClaw 官方文档。常见：
+#   OPENAI_API_KEY, OPENROUTER_API_KEY, NVIDIA_API_KEY, ANTHROPIC_API_KEY,
+#   GOOGLE_API_KEY, MISTRAL_API_KEY, COHERE_API_KEY, OPENCLAW_DEFAULT_MODEL
+#
+# ─── 消息渠道 ─────────────────────────────────────────────────────────
+#   Telegram、WhatsApp 等消息渠道均可在 Control UI 中配置，无需环境变量。
+#
+# ─── HuggingFace Spaces 运行时（HF 自动注入，一般无需手动设）─��──────────
+#   SPACE_HOST                当前 Space 域名，如 xxx.hf.space
+#   SPACE_ID                  仓库 ID，如 username/HuggingClaw
+#
+# ─── 性能与运行 ───────────────────────────────────────────────────────
+#   NODE_MEMORY_LIMIT         [可选] Node 堆内存上限(MB)，默认 512
+#   TZ                        [可选] 时区，如 Asia/Shanghai
+#
+# ═══════════════════════════════════════════════════════════════════════════

.gitattributes

@@ -0,0 +1,39 @@
+*.7z filter=lfs diff=lfs merge=lfs -text
+*.arrow filter=lfs diff=lfs merge=lfs -text
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.bz2 filter=lfs diff=lfs merge=lfs -text
+*.ckpt filter=lfs diff=lfs merge=lfs -text
+*.ftz filter=lfs diff=lfs merge=lfs -text
+*.gz filter=lfs diff=lfs merge=lfs -text
+*.h5 filter=lfs diff=lfs merge=lfs -text
+*.joblib filter=lfs diff=lfs merge=lfs -text
+*.lfs.* filter=lfs diff=lfs merge=lfs -text
+*.mlmodel filter=lfs diff=lfs merge=lfs -text
+*.model filter=lfs diff=lfs merge=lfs -text
+*.msgpack filter=lfs diff=lfs merge=lfs -text
+*.npy filter=lfs diff=lfs merge=lfs -text
+*.npz filter=lfs diff=lfs merge=lfs -text
+*.onnx filter=lfs diff=lfs merge=lfs -text
+*.ot filter=lfs diff=lfs merge=lfs -text
+*.parquet filter=lfs diff=lfs merge=lfs -text
+*.pb filter=lfs diff=lfs merge=lfs -text
+*.pickle filter=lfs diff=lfs merge=lfs -text
+*.pkl filter=lfs diff=lfs merge=lfs -text
+*.pt filter=lfs diff=lfs merge=lfs -text
+*.pth filter=lfs diff=lfs merge=lfs -text
+*.rar filter=lfs diff=lfs merge=lfs -text
+*.safetensors filter=lfs diff=lfs merge=lfs -text
+saved_model/**/* filter=lfs diff=lfs merge=lfs -text
+*.tar.* filter=lfs diff=lfs merge=lfs -text
+*.tar filter=lfs diff=lfs merge=lfs -text
+*.tflite filter=lfs diff=lfs merge=lfs -text
+*.tgz filter=lfs diff=lfs merge=lfs -text
+*.wasm filter=lfs diff=lfs merge=lfs -text
+*.xz filter=lfs diff=lfs merge=lfs -text
+*.zip filter=lfs diff=lfs merge=lfs -text
+*.zst filter=lfs diff=lfs merge=lfs -text
+*tfevents* filter=lfs diff=lfs merge=lfs -text
+*.png filter=lfs diff=lfs merge=lfs -text
+*.jpg filter=lfs diff=lfs merge=lfs -text
+*.webp filter=lfs diff=lfs merge=lfs -text
+*.woff2 filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -0,0 +1,18 @@
+# 环境与密钥
+.env
+.env.local
+*.pem
+
+# 依赖与构建
+node_modules/
+
+# 日志与临时
+*.log
+.DS_Store
+frontend/index.html
+scripts/__pycache__/
+.replit
+replit.nix
+.breakpoints
+.config
+upm.toml

Dockerfile

@@ -0,0 +1,73 @@
+# OpenClaw on Hugging Face Spaces — Pre-built image (v4.1)
+# Uses official pre-built image to avoid 30+ minute builds on cpu-basic
+
+# ── Stage 1: Pull pre-built OpenClaw ─────────────────────────────────────────
+FROM ghcr.io/openclaw/openclaw:latest AS openclaw-prebuilt
+
+# ── Stage 2: Runtime ─────────────────────────────────────────────────────────
+FROM node:22-bookworm
+SHELL ["/bin/bash", "-c"]
+
+# ── System dependencies (root) ───────────────────────────────────────────────
+RUN echo "[build] Installing system deps..." && START=$(date +%s) \
+  && apt-get update \
+  && apt-get install -y --no-install-recommends git ca-certificates curl python3 python3-pip \
+  && rm -rf /var/lib/apt/lists/* \
+  && pip3 install --no-cache-dir --break-system-packages huggingface_hub requests \
+  && corepack enable \
+  && mkdir -p /app/openclaw \
+  && chown -R node:node /app \
+  && mkdir -p /home/node/.openclaw/workspace /home/node/.openclaw/credentials \
+  && chown -R node:node /home/node \
+  && echo "[build] System deps: $(($(date +%s) - START))s"
+
+# ── Claude Code CLI + ACP (acpx) ──────────────────────────────────────────────
+# Claude Code is the coding agent; acpx manages it via ACP (Agent Client Protocol)
+RUN echo "[build] Installing Claude Code CLI + acpx..." && START=$(date +%s) \
+  && npm install -g @anthropic-ai/claude-code acpx@latest \
+  && echo "[build] Claude Code + acpx: $(($(date +%s) - START))s"
+
+# ── Copy pre-built OpenClaw (skips clone + install + build entirely) ─────────
+COPY --from=openclaw-prebuilt --chown=node:node /app /app/openclaw
+
+USER node
+ENV HOME=/home/node
+WORKDIR /app
+
+# ── A2A Gateway Extension ───────────────────────────────────────────────────
+RUN echo "[build] Installing A2A gateway..." && START=$(date +%s) \
+  && git clone --depth 1 https://github.com/win4r/openclaw-a2a-gateway.git /app/openclaw/extensions/a2a-gateway \
+  && cd /app/openclaw/extensions/a2a-gateway \
+  && npm install --production \
+  && echo "[build] A2A gateway: $(($(date +%s) - START))s"
+
+# ── Coding Agent Extension (local — no git clone needed) ─────────────────────
+COPY --chown=node:node extensions/coding-agent /app/openclaw/extensions/coding-agent
+
+# ── Pre-configure acpx for non-interactive ACP sessions ───────────────────
+RUN mkdir -p /home/node/.acpx \
+  && echo '{"defaultAgent":"claude","defaultPermissions":"approve-all","format":"text"}' \
+     > /home/node/.acpx/config.json
+
+# ── Prepare runtime dirs ────────────────────────────────────────────────────
+RUN mkdir -p /app/openclaw/empty-bundled-plugins \
+  && node -e "try{console.log(require('/app/openclaw/package.json').version)}catch(e){console.log('unknown')}" > /app/openclaw/.version \
+  && echo "[build] OpenClaw version: $(cat /app/openclaw/.version)"
+
+# ── Scripts + Config + Frontend ──────────────────────────────────────────────
+COPY --chown=node:node scripts /home/node/scripts
+COPY --chown=node:node frontend /home/node/frontend
+COPY --chown=node:node workspace-templates /home/node/workspace-templates
+COPY --chown=node:node openclaw.json /home/node/scripts/openclaw.json.default
+RUN chmod +x /home/node/scripts/entrypoint.sh /home/node/scripts/sync_hf.py \
+  && VERSION_TS=$(date +%s) \
+  && sed "s/{{VERSION_TIMESTAMP}}/${VERSION_TS}/g" /home/node/frontend/electron-standalone.html > /home/node/frontend/index.html \
+  && echo "[build] Frontend index.html generated (timestamp=${VERSION_TS})"
+
+ENV NODE_ENV=production
+ENV OPENCLAW_BUNDLED_PLUGINS_DIR=/app/openclaw/empty-bundled-plugins
+ENV OPENCLAW_PREFER_PNPM=1
+ENV PATH="/home/node/.local/bin:$PATH"
+WORKDIR /home/node
+
+CMD ["/home/node/scripts/entrypoint.sh"]

README.md

@@ -0,0 +1,14 @@
+---
+title: HuggingClaw Home
+emoji: 🏠
+colorFrom: yellow
+colorTo: red
+sdk: docker
+pinned: false
+license: mit
+short_description: Family dashboard and orchestrator
+app_port: 7860
+tags:
+  - huggingface
+  - openclaw
+---

app.py

@@ -0,0 +1,8 @@
+import subprocess
+import sys
+
+if __name__ == "__main__":
+    # In a generic Docker Space, this might not be executed if CMD is set in Dockerfile.
+    # But if the user switches to generic Python SDK or wants to run it manually:
+    print("Starting OpenClaw Sync Wrapper...")
+    subprocess.run([sys.executable, "scripts/sync_hf.py"], check=True)

config_for_dataset.json

@@ -0,0 +1,54 @@
+{
+  "gateway": {
+    "mode": "local",
+    "bind": "lan",
+    "port": 7860,
+    "auth": { "token": "openclaw-space-default" },
+    "controlUi": {
+      "allowInsecureAuth": true,
+      "allowedOrigins": [
+        "https://huggingface.co"
+      ]
+    }
+  },
+  "session": { "scope": "global" },
+  "models": {
+    "mode": "merge",
+    "providers": {
+      "zhipu": {
+        "baseUrl": "https://open.bigmodel.cn/api/anthropic",
+        "apiKey": "<ENV_VAR>",
+        "api": "anthropic-messages",
+        "models": [
+          { "id": "glm-4.5-air", "name": "GLM-4.5 Air" },
+          { "id": "glm-4.5", "name": "GLM-4.5" },
+          { "id": "glm-4.6", "name": "GLM-4.6" }
+        ]
+      },
+      "hf": {
+        "baseUrl": "https://router.huggingface.co/v1",
+        "apiKey": "<ENV_VAR>",
+        "api": "openai-completions",
+        "models": [
+          { "id": "Qwen/Qwen2.5-7B-Instruct", "name": "Qwen2.5 7B (HF Router)" }
+        ]
+      }
+    }
+  },
+  "plugins": {
+    "entries": {
+      "telegram": {
+        "enabled": true
+      },
+      "whatsapp": {
+        "enabled": true
+      }
+    }
+  },
+  "agents": {
+    "defaults": {
+      "workspace": "~/.openclaw/workspace",
+      "model": { "primary": "zhipu/glm-4.5-air" }
+    }
+  }
+}

extensions/coding-agent/index.ts

@@ -0,0 +1,269 @@
+/**
+ * Coding Agent Extension for OpenClaw
+ *
+ * Integrates Claude Code via ACP (Agent Client Protocol) using acpx as the
+ * backend. All Claude Code invocations go through ACP for lifecycle management.
+ *
+ * Tools:
+ *   - claude_code: Spawn Claude Code via ACP to autonomously complete coding tasks
+ *   - hf_space_status: Check Space health/stage
+ *   - hf_restart_space: Restart a Space
+ */
+
+import { execSync } from "node:child_process";
+import { existsSync } from "node:fs";
+
+// ── Types ────────────────────────────────────────────────────────────────────
+
+interface PluginApi {
+  pluginConfig: Record<string, unknown>;
+  logger: { info: (...a: unknown[]) => void; warn: (...a: unknown[]) => void; error: (...a: unknown[]) => void };
+  registerTool?: (def: ToolDef) => void;
+}
+
+interface ToolDef {
+  name: string;
+  description: string;
+  label?: string;
+  parameters: Record<string, unknown>;
+  execute: (toolCallId: string, params: Record<string, unknown>) => Promise<ToolResult>;
+}
+
+interface ToolResult {
+  content: Array<{ type: "text"; text: string }>;
+}
+
+// ── Helpers ──────────────────────────────────────────────────────────────────
+
+const WORK_DIR = "/tmp/claude-workspace";
+const CLAUDE_TIMEOUT = 300_000; // 5 minutes
+
+function text(t: string): ToolResult {
+  return { content: [{ type: "text", text: t }] };
+}
+
+function asStr(v: unknown, fallback = ""): string {
+  return typeof v === "string" ? v : fallback;
+}
+
+// ── Git helpers ──────────────────────────────────────────────────────────────
+
+function ensureRepo(targetSpace: string, hfToken: string): void {
+  const repoUrl = `https://user:${hfToken}@huggingface.co/spaces/${targetSpace}`;
+
+  if (existsSync(`${WORK_DIR}/.git`)) {
+    // Reset to latest remote state (clean slate for each task)
+    try {
+      execSync("git fetch origin && git reset --hard origin/main", {
+        cwd: WORK_DIR,
+        timeout: 30_000,
+        stdio: "pipe",
+      });
+      return;
+    } catch {
+      // If fetch/reset fails, re-clone
+      execSync(`rm -rf ${WORK_DIR}`, { stdio: "pipe" });
+    }
+  }
+
+  // Fresh clone
+  if (existsSync(WORK_DIR)) {
+    execSync(`rm -rf ${WORK_DIR}`, { stdio: "pipe" });
+  }
+  execSync(`git clone --depth 20 ${repoUrl} ${WORK_DIR}`, {
+    timeout: 60_000,
+    stdio: "pipe",
+  });
+  execSync('git config user.name "Claude Code"', { cwd: WORK_DIR, stdio: "pipe" });
+  execSync('git config user.email "claude-code@huggingclaw"', { cwd: WORK_DIR, stdio: "pipe" });
+}
+
+function pushChanges(summary: string): string {
+  const status = execSync("git status --porcelain", {
+    cwd: WORK_DIR,
+    encoding: "utf-8",
+  }).trim();
+
+  if (!status) return "No files changed.";
+
+  execSync("git add -A", { cwd: WORK_DIR, stdio: "pipe" });
+  // Use a safe commit message
+  const msg = summary.slice(0, 72).replace(/"/g, '\\"');
+  execSync(`git commit -m "Claude Code: ${msg}"`, { cwd: WORK_DIR, stdio: "pipe" });
+  execSync("git push", { cwd: WORK_DIR, timeout: 60_000, stdio: "pipe" });
+
+  return `Pushed changes:\n${status}`;
+}
+
+// ── Plugin ───────────────────────────────────────────────────────────────────
+
+const plugin = {
+  id: "coding-agent",
+  name: "Coding Agent",
+  description: "Claude Code via ACP for autonomous coding on HF Spaces",
+
+  register(api: PluginApi) {
+    const cfg = (api.pluginConfig as Record<string, unknown>) || {};
+    const targetSpace = asStr(cfg.targetSpace) || process.env.CODING_AGENT_TARGET_SPACE || "";
+    const hfToken = asStr(cfg.hfToken) || process.env.HF_TOKEN || "";
+    const zaiApiKey = asStr(cfg.zaiApiKey) || process.env.ZAI_API_KEY || process.env.ZHIPU_API_KEY || "";
+
+    api.logger.info(`coding-agent: targetSpace=${targetSpace}, zaiKey=${zaiApiKey ? "set" : "missing"}`);
+
+    if (!api.registerTool) {
+      api.logger.warn("coding-agent: registerTool unavailable — no tools registered");
+      return;
+    }
+
+    // ── Tool: claude_code ───────────────────────────────────────────────────
+    api.registerTool({
+      name: "claude_code",
+      label: "Run Claude Code",
+      description:
+        "Run Claude Code via ACP (acpx) to autonomously complete a coding task on the target HF Space. " +
+        "Claude Code clones the Space repo, analyzes code, makes changes, and pushes them back. " +
+        "Use for: debugging, fixing errors, adding features, refactoring.",
+      parameters: {
+        type: "object",
+        required: ["task"],
+        properties: {
+          task: {
+            type: "string",
+            description: "Detailed coding task description. Be specific about what to fix/change and why.",
+          },
+          auto_push: {
+            type: "boolean",
+            description: "Automatically push changes after Claude Code finishes (default: true)",
+          },
+        },
+      },
+      async execute(_id, params) {
+        const task = asStr(params.task);
+        const autoPush = params.auto_push !== false;
+
+        if (!targetSpace) return text("Error: no targetSpace configured");
+        if (!hfToken) return text("Error: no HF token configured");
+        if (!zaiApiKey) return text("Error: no ZAI_API_KEY or ZHIPU_API_KEY configured for Claude Code backend");
+
+        try {
+          // 1. Clone / reset to latest
+          api.logger.info(`coding-agent: Syncing repo ${targetSpace}...`);
+          ensureRepo(targetSpace, hfToken);
+
+          // 2. Run Claude Code via ACP (acpx)
+          api.logger.info(`coding-agent: Running Claude Code via ACP: ${task.slice(0, 100)}...`);
+          const claudeEnv: Record<string, string> = {
+            ...(process.env as Record<string, string>),
+            ANTHROPIC_BASE_URL: "https://api.z.ai/api/anthropic",
+            ANTHROPIC_AUTH_TOKEN: zaiApiKey,
+            ANTHROPIC_DEFAULT_OPUS_MODEL: "GLM-4.7",
+            ANTHROPIC_DEFAULT_SONNET_MODEL: "GLM-4.7",
+            ANTHROPIC_DEFAULT_HAIKU_MODEL: "GLM-4.5-Air",
+            CI: "true",
+          };
+
+          const output = execSync(
+            `acpx claude ${JSON.stringify(task)}`,
+            {
+              cwd: WORK_DIR,
+              env: claudeEnv,
+              timeout: CLAUDE_TIMEOUT,
+              encoding: "utf-8",
+              maxBuffer: 10 * 1024 * 1024, // 10MB
+            },
+          );
+
+          // 3. Push changes if requested
+          let pushResult = "Auto-push disabled.";
+          if (autoPush) {
+            try {
+              pushResult = pushChanges(task);
+            } catch (e: unknown) {
+              pushResult = `Push failed: ${e instanceof Error ? e.message : e}`;
+            }
+          }
+
+          return text(
+            `=== Claude Code Output ===\n${output}\n\n=== Changes ===\n${pushResult}`,
+          );
+        } catch (e: unknown) {
+          const msg = e instanceof Error ? e.message : String(e);
+          return text(`Claude Code failed:\n${msg.slice(0, 3000)}`);
+        }
+      },
+    });
+
+    // ── Tool: hf_space_status ───────────────────────────────────────────────
+    api.registerTool({
+      name: "hf_space_status",
+      label: "Check Space Health",
+      description:
+        "Check the current status of the target HuggingFace Space. " +
+        "Returns: stage (BUILDING, APP_STARTING, RUNNING, RUNTIME_ERROR, BUILD_ERROR, NO_APP_FILE).",
+      parameters: {
+        type: "object",
+        properties: {},
+      },
+      async execute() {
+        if (!targetSpace) return text("Error: no target space configured");
+        try {
+          const resp = await fetch(`https://huggingface.co/api/spaces/${targetSpace}`, {
+            headers: { Authorization: `Bearer ${hfToken}` },
+          });
+          if (!resp.ok) throw new Error(`${resp.status} ${resp.statusText}`);
+          const data = (await resp.json()) as Record<string, unknown>;
+          const runtime = (data.runtime as Record<string, unknown>) || {};
+          const stage = runtime.stage || "unknown";
+          const hardware = runtime.hardware || "unknown";
+
+          // Try hitting the Space URL
+          let apiStatus = "not checked";
+          try {
+            const spaceUrl = `https://${targetSpace.replace("/", "-").toLowerCase()}.hf.space`;
+            const probe = await fetch(spaceUrl, { signal: AbortSignal.timeout(8000) });
+            apiStatus = probe.ok ? `reachable (${probe.status})` : `error (${probe.status})`;
+          } catch {
+            apiStatus = "unreachable";
+          }
+
+          return text(
+            `Space: ${targetSpace}\nStage: ${stage}\nHardware: ${hardware}\nAPI: ${apiStatus}`,
+          );
+        } catch (e: unknown) {
+          return text(`Error checking space: ${e instanceof Error ? e.message : e}`);
+        }
+      },
+    });
+
+    // ── Tool: hf_restart_space ──────────────────────────────────────────────
+    api.registerTool({
+      name: "hf_restart_space",
+      label: "Restart Space",
+      description: "Restart the target HuggingFace Space. Use when the Space is stuck or after deploying fixes.",
+      parameters: {
+        type: "object",
+        properties: {},
+      },
+      async execute() {
+        if (!targetSpace) return text("Error: no target space configured");
+        try {
+          const resp = await fetch(`https://huggingface.co/api/spaces/${targetSpace}/restart`, {
+            method: "POST",
+            headers: { Authorization: `Bearer ${hfToken}` },
+          });
+          if (!resp.ok) {
+            const body = await resp.text().catch(() => "");
+            throw new Error(`${resp.status}: ${body}`);
+          }
+          return text(`Space ${targetSpace} is restarting`);
+        } catch (e: unknown) {
+          return text(`Error restarting space: ${e instanceof Error ? e.message : e}`);
+        }
+      },
+    });
+
+    api.logger.info("coding-agent: Registered 3 tools (claude_code, hf_space_status, hf_restart_space)");
+  },
+};
+
+export default plugin;

extensions/coding-agent/openclaw.plugin.json

@@ -0,0 +1,38 @@
+{
+  "id": "coding-agent",
+  "name": "Coding Agent",
+  "description": "Claude Code sub-agent for autonomous coding on HF Spaces — powered by Zhipu GLM via z.ai",
+  "version": "2.0.0",
+  "defaultConfig": {
+    "targetSpace": "",
+    "targetDataset": "",
+    "hfToken": "",
+    "zaiApiKey": ""
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "targetSpace": {
+        "type": "string",
+        "description": "HuggingFace Space repo ID to manage (e.g. tao-shen/HuggingClaw-Cain)"
+      },
+      "targetDataset": {
+        "type": "string",
+        "description": "HuggingFace Dataset repo ID for persistent data (e.g. tao-shen/HuggingClaw-Cain-data)"
+      },
+      "hfToken": {
+        "type": "string",
+        "description": "HuggingFace API token (or use HF_TOKEN env var)"
+      },
+      "zaiApiKey": {
+        "type": "string",
+        "description": "Z.AI API key for Claude Code backend (or use ZAI_API_KEY / ZHIPU_API_KEY env var)"
+      }
+    }
+  },
+  "uiHints": {
+    "hfToken": { "sensitive": true },
+    "zaiApiKey": { "sensitive": true }
+  }
+}

extensions/coding-agent/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "openclaw-coding-agent",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "OpenClaw coding agent extension — HF Space management tools with syntax validation",
+  "main": "index.ts",
+  "openclaw": {
+    "extensions": ["./index.ts"]
+  },
+  "dependencies": {}
+}

frontend/fonts/OFL.txt

@@ -0,0 +1,94 @@
+Copyright (c) 2021, TakWolf (https://takwolf.com),
+with Reserved Font Name "Ark Pixel".
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://openfontlicense.org
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

frontend/fonts/ark-pixel-12px-proportional-ja.ttf.woff2

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:523ac20546bff6438823d1c0c190ce0b286cc840789463d06b0cfa048a58d851
+size 756500

frontend/fonts/ark-pixel-12px-proportional-ko.ttf.woff2

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:e47c469d1cad722e644e63eab1ea96499e4b1a32408790f27bd23bba6f87ec17
+size 754640

frontend/fonts/ark-pixel-12px-proportional-latin.ttf.woff2

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:e8635d64af569b81fe314f581be23ea7ff94b530a22ae23f4fdff26a10462428
+size 740516

frontend/fonts/ark-pixel-12px-proportional-zh_cn.ttf.woff2

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:05a7f655ce2b88e35a2c669590e471cf55b582e3403aa58e5c76a524c53b775a
+size 743844

frontend/fonts/ark-pixel-12px-proportional-zh_hk.ttf.woff2

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:7992fe4ab9d595aeaba6a056efd15218502fcd04cc6df225ba2722f1c5e3c5dc
+size 752724

frontend/fonts/ark-pixel-12px-proportional-zh_tr.ttf.woff2

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:ba7cd8e2638accede72dcf4040d69e46a98dc3f551a38b05e916ae635fdecd37
+size 760004

frontend/fonts/ark-pixel-12px-proportional-zh_tw.ttf.woff2

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:80c591585f447a7da9a8d13220877968c3d27080108a061a9cf0ac33e2eda691
+size 756084

frontend/fonts/ark-pixel-font-12px-proportional-ttf.woff2-v2025.10.20.zip

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:08fc0408d9ac79a0f416dce254db3cea83806a9b2f823191f5d53c71daf7730f
+size 5270031