@clawstore/clawstore 1.0.0 → 1.0.2

package/dist/src/types.d.ts

@@ -0,0 +1,114 @@
+export interface SkillDependency {
+    id: string;
+    version: string;
+    required: boolean;
+}
+export interface AgentManifest {
+    id: string;
+    slug: string;
+    name: string;
+    subtitle: string;
+    description: string;
+    version: string;
+    author: string;
+    author_id?: string;
+    homepage?: string;
+    license: string;
+    price: number;
+    currency: string;
+    category: string;
+    tags: string[];
+    icon?: string;
+    screenshots?: string[];
+    openclaw_version: string;
+    entry_files: string[];
+    skills: SkillDependency[];
+    checksum?: string;
+    published_at?: string;
+    updated_at?: string;
+    source_agent_id?: string;
+    packed_at?: string;
+    packaged_by?: string;
+    detection_mode?: string;
+}
+export interface InstalledAgentRecord {
+    id: string;
+    name: string;
+    version: string;
+    category: string;
+    author: string;
+    enabled: boolean;
+    installed_at: string;
+    updated_at: string;
+    source: string;
+    install_path: string;
+    backup_path: string;
+    disable_backup_path?: string;
+    files: string[];
+    skills: string[];
+}
+export interface AgentRegistry {
+    agents: Record<string, InstalledAgentRecord>;
+}
+export interface InstalledSkillRecord {
+    skill_id: string;
+    version: string;
+    installed_at: string;
+    installed_by: string;
+    source: string;
+}
+export interface SkillRegistry {
+    skills: Record<string, InstalledSkillRecord>;
+}
+export type InstallState = "idle" | "fetching_manifest" | "downloading_package" | "verifying_package" | "checking_compatibility" | "installing_skills" | "installing_agent" | "registering_agent" | "rolling_back" | "success" | "failed";
+export type PackState = "idle" | "loading_agent" | "collecting_files" | "detecting_skills" | "awaiting_confirmation" | "generating_agent_json" | "packing_zip" | "saving_or_uploading" | "success" | "failed";
+export interface ClawstoreConfig {
+    apiBaseUrl: string;
+    autoCheckUpdates: boolean;
+    autoInstallSkills: boolean;
+}
+export interface StoreAgentSummary {
+    id: string;
+    name: string;
+    subtitle: string;
+    author: string;
+    price: number;
+    currency: string;
+    category: string;
+    rating: number;
+    downloads: number;
+    openclaw_version: string;
+}
+export interface StoreAgentDetail extends StoreAgentSummary {
+    description: string;
+    tags: string[];
+    skills: SkillDependency[];
+    version: string;
+    screenshots: string[];
+    published_at: string;
+    updated_at: string;
+}
+export interface StoreSearchResult {
+    total: number;
+    agents: StoreAgentSummary[];
+}
+export interface DiagnosticCheck {
+    label: string;
+    path?: string;
+    status: "ok" | "warn" | "fail";
+    detail?: string;
+}
+export interface DiagnosticReport {
+    checks: DiagnosticCheck[];
+    allOk: boolean;
+}
+export interface ValidationError {
+    field: string;
+    message: string;
+}
+export interface PackageValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    manifest: AgentManifest | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAID,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;CAC9C;AAID,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;CAC9C;AAID,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,mBAAmB,GACnB,qBAAqB,GACrB,mBAAmB,GACnB,wBAAwB,GACxB,mBAAmB,GACnB,kBAAkB,GAClB,mBAAmB,GACnB,cAAc,GACd,SAAS,GACT,QAAQ,CAAC;AAIb,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,eAAe,GACf,kBAAkB,GAClB,kBAAkB,GAClB,uBAAuB,GACvB,uBAAuB,GACvB,aAAa,GACb,qBAAqB,GACrB,SAAS,GACT,QAAQ,CAAC;AAIb,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAID,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,iBAAiB,EAAE,CAAC;CAC7B;AAID,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,KAAK,EAAE,OAAO,CAAC;CAChB;AAID,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;CAChC"}

package/dist/src/types.js

@@ -0,0 +1,3 @@
+// ─── Agent Manifest (agent.json) ────────────────────────────────────
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,uEAAuE"}

package/dist/src/utils/checksum.d.ts

@@ -0,0 +1,4 @@
+export declare function computeSha256(filePath: string): Promise<string>;
+export declare function computeFullSha256(filePath: string): Promise<string>;
+export declare function hashBuffer(buf: Buffer): string;
+//# sourceMappingURL=checksum.d.ts.map

package/dist/src/utils/checksum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checksum.d.ts","sourceRoot":"","sources":["../../../src/utils/checksum.ts"],"names":[],"mappings":"AAGA,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIrE;AAED,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGzE;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/dist/src/utils/checksum.js

@@ -0,0 +1,15 @@
+import { createHash } from "node:crypto";
+import { readFile } from "node:fs/promises";
+export async function computeSha256(filePath) {
+    const data = await readFile(filePath);
+    const hash = createHash("sha256").update(data).digest("hex");
+    return `sha256:${hash.substring(0, 16)}`;
+}
+export async function computeFullSha256(filePath) {
+    const data = await readFile(filePath);
+    return createHash("sha256").update(data).digest("hex");
+}
+export function hashBuffer(buf) {
+    return createHash("sha256").update(buf).digest("hex");
+}
+//# sourceMappingURL=checksum.js.map

package/dist/src/utils/checksum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checksum.js","sourceRoot":"","sources":["../../../src/utils/checksum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAgB;IAClD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7D,OAAO,UAAU,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,QAAgB;IACtD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACtC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC"}

package/dist/src/utils/output.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Formatting helpers for CLI/slash command output.
+ * Follows the Clawstore output design spec: result first, details second,
+ * short text for next-step guidance.
+ */
+export declare function stepLine(step: number, total: number, label: string, status: string): string;
+export declare function successBanner(agentName: string, version: string, extra?: Record<string, string>): string;
+export declare function errorBanner(action: string, agentId: string, step: string, reason: string): string;
+export declare function agentListItem(index: number, id: string, name: string, version: string, category: string, enabled: boolean): string;
+export declare function detailBlock(fields: Record<string, string | undefined>): string;
+export declare function searchResultItem(index: number, id: string, name: string, price: number, currency: string, author: string, rating: number): string;
+export declare function indentLines(text: string, indent?: number): string;
+//# sourceMappingURL=output.d.ts.map

package/dist/src/utils/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../src/utils/output.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE3F;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAexG;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAWjG;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAOlI;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,CAS9E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAOjJ;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAU,GAAG,MAAM,CAMpE"}

package/dist/src/utils/output.js

@@ -0,0 +1,70 @@
+/**
+ * Formatting helpers for CLI/slash command output.
+ * Follows the Clawstore output design spec: result first, details second,
+ * short text for next-step guidance.
+ */
+export function stepLine(step, total, label, status) {
+    return `  [${step}/${total}] ${label} ... ${status}`;
+}
+export function successBanner(agentName, version, extra) {
+    const lines = [
+        "",
+        `  Installed: ${agentName}@${version}`,
+    ];
+    if (extra) {
+        for (const [k, v] of Object.entries(extra)) {
+            lines.push(`  ${k}: ${v}`);
+        }
+    }
+    lines.push("  Status: enabled");
+    lines.push("");
+    lines.push("  Next: start a new chat in OpenClaw to activate the new persona");
+    lines.push("");
+    return lines.join("\n");
+}
+export function errorBanner(action, agentId, step, reason) {
+    return [
+        "",
+        `  ${action} failed: ${agentId}`,
+        `  Step: ${step}`,
+        `  Reason: ${reason}`,
+        "  Next:",
+        "    1. Run `openclaw clawstore doctor`",
+        `    2. Retry \`openclaw clawstore ${action.toLowerCase()} ${agentId}\``,
+        "",
+    ].join("\n");
+}
+export function agentListItem(index, id, name, version, category, enabled) {
+    const status = enabled ? "enabled" : "disabled";
+    return [
+        `  ${index}. ${id}`,
+        `     ${name}`,
+        `     v${version} · ${category} · ${status}`,
+    ].join("\n");
+}
+export function detailBlock(fields) {
+    const lines = [""];
+    for (const [k, v] of Object.entries(fields)) {
+        if (v !== undefined) {
+            lines.push(`  ${k}: ${v}`);
+        }
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+export function searchResultItem(index, id, name, price, currency, author, rating) {
+    const priceStr = price === 0 ? "Free" : `${currency === "USD" ? "$" : currency}${price}`;
+    return [
+        `  ${index}. ${id}`,
+        `     ${name}`,
+        `     ${priceStr} · by ${author} · rating ${rating.toFixed(1)}`,
+    ].join("\n");
+}
+export function indentLines(text, indent = 2) {
+    const pad = " ".repeat(indent);
+    return text
+        .split("\n")
+        .map((l) => (l.trim() ? `${pad}${l}` : l))
+        .join("\n");
+}
+//# sourceMappingURL=output.js.map

package/dist/src/utils/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../../src/utils/output.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/zip.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Extract a ZIP to a cache directory, returning the effective package root.
+ * If the ZIP contains a single top-level directory, that directory is returned.
+ */
+export declare function extractZip(zipPath: string): Promise<string>;
+/**
+ * Create a ZIP from a source directory, excluding hidden files and __pycache__.
+ */
+export declare function createZip(sourceDir: string, outputPath: string): Promise<{
+    path: string;
+    sizeBytes: number;
+}>;
+//# sourceMappingURL=zip.d.ts.map

package/dist/src/utils/zip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip.d.ts","sourceRoot":"","sources":["../../../src/utils/zip.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBjE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAwBnH"}

package/dist/src/utils/zip.js

@@ -0,0 +1,50 @@
+import AdmZip from "adm-zip";
+import { mkdir, readdir, stat } from "node:fs/promises";
+import { join, relative } from "node:path";
+import { CACHE_DIR } from "../constants.js";
+/**
+ * Extract a ZIP to a cache directory, returning the effective package root.
+ * If the ZIP contains a single top-level directory, that directory is returned.
+ */
+export async function extractZip(zipPath) {
+    const zip = new AdmZip(zipPath);
+    const baseName = zipPath.replace(/\.zip$/i, "").split(/[\\/]/).pop();
+    const extractDir = join(CACHE_DIR, baseName);
+    await mkdir(extractDir, { recursive: true });
+    zip.extractAllTo(extractDir, true);
+    const children = await readdir(extractDir);
+    if (children.length === 1) {
+        const child = join(extractDir, children[0]);
+        const st = await stat(child);
+        if (st.isDirectory())
+            return child;
+    }
+    return extractDir;
+}
+/**
+ * Create a ZIP from a source directory, excluding hidden files and __pycache__.
+ */
+export async function createZip(sourceDir, outputPath) {
+    const zip = new AdmZip();
+    async function walk(dir) {
+        const entries = await readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.name.startsWith(".") || entry.name === "__pycache__" || entry.name === "node_modules") {
+                continue;
+            }
+            const fullPath = join(dir, entry.name);
+            const arcPath = relative(sourceDir, fullPath);
+            if (entry.isDirectory()) {
+                await walk(fullPath);
+            }
+            else {
+                zip.addLocalFile(fullPath, relative(sourceDir, dir) || undefined);
+            }
+        }
+    }
+    await walk(sourceDir);
+    zip.writeZip(outputPath);
+    const st = await stat(outputPath);
+    return { path: outputPath, sizeBytes: st.size };
+}
+//# sourceMappingURL=zip.js.map

package/dist/src/utils/zip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip.js","sourceRoot":"","sources":["../../../src/utils/zip.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAe;IAC9C,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAG,CAAC;IACtE,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAE7C,MAAM,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,GAAG,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAEnC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5C,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,EAAE,CAAC,WAAW,EAAE;YAAE,OAAO,KAAK,CAAC;IACrC,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,SAAiB,EAAE,UAAkB;IACnE,MAAM,GAAG,GAAG,IAAI,MAAM,EAAE,CAAC;IAEzB,KAAK,UAAU,IAAI,CAAC,GAAW;QAC7B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;gBAChG,SAAS;YACX,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YAC9C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,IAAI,SAAS,CAAC,CAAC;YACpE,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC;IACtB,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAEzB,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC;IAClC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;AAClD,CAAC"}

package/package.json

@@ -1,11 +1,13 @@
 {
   "name": "@clawstore/clawstore",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Agent marketplace plugin for OpenClaw — browse, install, manage and pack AI employee agents.",
   "type": "module",
   "main": "./index.ts",
   "openclaw": {
-    "extensions": ["./index.ts"],
+    "extensions": [
+      "./index.ts"
+    ],
     "install": {
       "npmSpec": "@clawstore/clawstore",
       "localPath": "extensions/clawstore"

package/src/cli.ts

@@ -19,7 +19,7 @@ import { installAgent, updateAgent } from "./core/package-installer.js";
 import { packAgent, packCurrentAgent } from "./core/packager.js";
 import { diagnose, formatDiagnosticReport, listClawstoreAgents } from "./core/workspace.js";
 import { StoreClient } from "./core/store-client.js";
-import { DEFAULT_API_BASE_URL, DEFAULT_AGENT } from "./constants.js";
+import { DEFAULT_API_BASE_URL, DEFAULT_AGENT, STORE_DOWNLOAD_BASE_URL } from "./constants.js";
 import {
   agentListItem,
   detailBlock,
@@ -134,28 +134,46 @@ export function registerClawstoreCli(api: OpenClawPluginApi): void {
       // ── install ─────────────────────────────────────────────────
       root
         .command("install <source>")
-        .description("Install an Agent from local path, ZIP, or marketplace")
+        .description("Install an Agent from local path, ZIP, URL, or marketplace")
         .option("-f, --force", "Force reinstall if already installed")
         .option(A_FLAGS, A_DESC, DEFAULT_AGENT)
         .action(async (source: string, opts: { force?: boolean; agent?: string }) => {
           const agent = opts.agent ?? DEFAULT_AGENT;
           let packagePath = source;
 
+          const isUrl = /^https?:\/\//i.test(source);
+
           const isRemote =
+            !isUrl &&
             !source.includes("/") &&
             !source.includes("\\") &&
             !source.endsWith(".zip") &&
             !existsSync(source);
 
-          if (isRemote) {
+          if (isUrl) {
+            const slug = source.split("/").pop()?.replace(/\.zip$/i, "") ?? "remote-agent";
+            try {
+              console.log(`\n  Downloading from URL ...`);
+              console.log(`  ${source}`);
+              const { downloadPackage } = await import("./core/package-installer.js");
+              packagePath = await downloadPackage(source, slug);
+              console.log(`  Downloaded to: ${packagePath}\n`);
+            } catch (err) {
+              console.log(`\n  Failed to download from URL: ${(err as Error).message}`);
+              console.log(`  URL: ${source}`);
+              console.log(`  Try downloading manually and installing from local path.\n`);
+              return;
+            }
+          } else if (isRemote) {
+            const downloadUrl = `${STORE_DOWNLOAD_BASE_URL}/${source}`;
             try {
-              console.log(`\n  Fetching ${source} from Clawstore...`);
-              const url = await client.getDownloadUrl(source);
+              console.log(`\n  Downloading ${source} from clawstore.pro ...`);
               const { downloadPackage } = await import("./core/package-installer.js");
-              packagePath = await downloadPackage(url, source);
+              packagePath = await downloadPackage(downloadUrl, source);
               console.log(`  Downloaded to: ${packagePath}\n`);
             } catch (err) {
-              console.log(`\n  Failed to download '${source}' from Clawstore: ${(err as Error).message}`);
+              console.log(`\n  Failed to download '${source}' from clawstore.pro: ${(err as Error).message}`);
+              console.log(`  URL: ${downloadUrl}`);
               console.log(`  If this is a local path, make sure the file/directory exists.\n`);
               return;
             }
@@ -282,7 +300,7 @@ export function registerClawstoreCli(api: OpenClawPluginApi): void {
             console.log(`\n  Checking updates for ${personas.length} agent(s)...\n`);
             for (const a of personas) {
               try {
-                const downloadUrl = await client.getDownloadUrl(a.id);
+                const downloadUrl = `${STORE_DOWNLOAD_BASE_URL}/${a.id}`;
                 const { downloadPackage } = await import("./core/package-installer.js");
                 const pkgPath = await downloadPackage(downloadUrl, a.id);
                 await updateAgent({ agentId: a.id, packagePath: pkgPath, agent, log: console.log });
@@ -301,12 +319,12 @@ export function registerClawstoreCli(api: OpenClawPluginApi): void {
           const packagePath = opts.package;
           if (!packagePath) {
             try {
-              const url = await client.getDownloadUrl(agentId);
+              const downloadUrl = `${STORE_DOWNLOAD_BASE_URL}/${agentId}`;
               const { downloadPackage } = await import("./core/package-installer.js");
-              const dlPath = await downloadPackage(url, agentId);
+              const dlPath = await downloadPackage(downloadUrl, agentId);
               await updateAgent({ agentId, packagePath: dlPath, agent, log: console.log });
             } catch (err) {
-              console.log(`\n  Could not fetch update from Clawstore: ${(err as Error).message}`);
+              console.log(`\n  Could not fetch update from clawstore.pro: ${(err as Error).message}`);
               console.log(`  Provide a local package: openclaw clawstore update ${agentId} --package <path>\n`);
             }
             return;

package/src/commands.ts

@@ -1,7 +1,7 @@
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk/core";
 import type { ClawstoreConfig } from "./types.js";
 import { StoreClient } from "./core/store-client.js";
-import { DEFAULT_AGENT } from "./constants.js";
+import { DEFAULT_AGENT, STORE_DOWNLOAD_BASE_URL } from "./constants.js";
 import {
   listInstalledAgents,
   getInstalledAgent,
@@ -70,10 +70,40 @@ export function registerClawstoreCommand(api: OpenClawPluginApi): void {
         // ── /clawstore install <source> ─────────────────────────
         case "install": {
           const source = rest[0];
-          if (!source) return { text: "Usage: /clawstore install <agent-id|path>" };
+          if (!source) return { text: "Usage: /clawstore install <agent-id|path|url>" };
           const lines: string[] = [];
+          let packagePath = source;
+
+          const isUrl = /^https?:\/\//i.test(source);
+
+          const { existsSync } = await import("node:fs");
+          const isRemote =
+            !isUrl &&
+            !source.includes("/") &&
+            !source.includes("\\") &&
+            !source.endsWith(".zip") &&
+            !existsSync(source);
+
+          if (isUrl) {
+            try {
+              const slug = source.split("/").pop()?.replace(/\.zip$/i, "") ?? "remote-agent";
+              const { downloadPackage } = await import("./core/package-installer.js");
+              packagePath = await downloadPackage(source, slug);
+            } catch (err) {
+              return { text: `URL download failed: ${(err as Error).message}\n\nTry downloading manually:\n\`Invoke-WebRequest -Uri "${source}" -OutFile agent.zip\`\n\`openclaw clawstore install ./agent.zip\`` };
+            }
+          } else if (isRemote) {
+            try {
+              const downloadUrl = `${STORE_DOWNLOAD_BASE_URL}/${source}`;
+              const { downloadPackage } = await import("./core/package-installer.js");
+              packagePath = await downloadPackage(downloadUrl, source);
+            } catch (err) {
+              return { text: `Download failed: ${(err as Error).message}\n\nUse CLI: \`openclaw clawstore install ${source}\`` };
+            }
+          }
+
           const result = await installAgent({
-            packagePath: source,
+            packagePath,
             agent,
             log: (msg) => lines.push(msg),
           });

package/src/constants.ts

@@ -71,6 +71,7 @@ export const MANIFEST_REQUIRED_FIELDS = [
 // ─── Default API ────────────────────────────────────────────────────
 
 export const DEFAULT_API_BASE_URL = "https://api.shopclawmart.com";
+export const STORE_DOWNLOAD_BASE_URL = "https://clawstore.pro/api/agent/download";
 
 // ─── Install Steps ──────────────────────────────────────────────────