ape-claw 0.1.6 → 0.1.7

package/README.md

@@ -188,11 +188,12 @@ export APECLAW_SKILLCARD_URI_BASE="https://example.com/skillcards/seed"
 ### One-command install (no repo clone)
 
 ```bash
-npx ape-claw skill install
+npx --yes ape-claw@latest skill install
 ```
 
 Installs the ApeClaw skill into `~/.openclaw/skills/ape-claw/` and bootstraps config files.
 Requires OpenClaw and Node.js `>=22.10.0`. Works on macOS, Linux, and Windows.
+During install, ApeClaw also prompts to enable the local Forge dashboard upgrade path.
 
 ### Fast path for new users (copy/paste)
 
@@ -201,8 +202,11 @@ Requires OpenClaw and Node.js `>=22.10.0`. Works on macOS, Linux, and Windows.
 # Verify it's available:
 openclaw skills list
 
-# 1) Install ApeClaw
-npx ape-claw skill install
+# 1) Install ApeClaw (force latest npm release)
+npx --yes ape-claw@latest skill install
+
+# 1b) Open local Forge dashboard (starts local server if needed)
+npx --yes ape-claw@latest dashboard
 
 # 2) Verify (always works, even if global PATH is not set yet)
 npx ape-claw doctor --json
@@ -258,21 +262,25 @@ After the core install, you'll be prompted to install the **Starter Pack** (61 s
 
 ```bash
 # Interactive: prompts you to choose
-npx ape-claw skill install
+npx --yes ape-claw@latest skill install
 
 # Auto-install starter pack (no prompt)
-npx ape-claw skill install --starter-pack
+npx --yes ape-claw@latest skill install --starter-pack
 
 # Skip starter pack entirely
-npx ape-claw skill install --no-starter-pack
+npx --yes ape-claw@latest skill install --no-starter-pack
 
 # JSON mode (programmatic): skips prompt, add --starter-pack to include it
-npx ape-claw skill install --starter-pack --json
+npx --yes ape-claw@latest skill install --starter-pack --json
 
 # Install into current project only (instead of global ~/.openclaw/)
-npx ape-claw skill install --scope local
+npx --yes ape-claw@latest skill install --scope local
 ```
 
+The same install flow also prompts for the local Forge dashboard upgrade.  
+Use `npx --yes ape-claw@latest dashboard` anytime as the stable local Forge entrypoint.
+If you see `Unknown command: dashboard`, you are running an older cached package — re-run with `npx --yes ape-claw@latest ...`.
+
 ### 3. Global CLI install (optional)
 
 ```bash
@@ -556,6 +564,15 @@ Then open `http://localhost:8787/` for the real-time dashboard showing:
 - Bridge operation status
 - Connection health
 
+For local Forge/OpenClaw takeover dashboard (no repo clone required), run:
+
+```bash
+npx ape-claw dashboard
+```
+
+This starts the packaged local UI server from npm and opens Forge.  
+GitHub clone + `npm run start:ui` is optional for development workflows.
+
 ### Clawllector Chat API
 
 Verified clawbots can chat with each other through the telemetry server.

package/docs/operator/01-quickstart.md

@@ -24,15 +24,21 @@ If `openclaw` is not found, follow the setup guide at [openclaw.ai](https://open
 ## Step 2: Install ApeClaw
 
 ```bash
-npx ape-claw skill install
-npx ape-claw doctor --json
+npx --yes ape-claw@latest skill install
+npx --yes ape-claw@latest doctor --json
 ```
 
+During `skill install`, ApeClaw prompts for:
+- Starter pack install
+- Forge dashboard upgrade (replaces the local OpenClaw dashboard route when supported, with automatic fallback)
+
+> Note: OpenClaw dashboard overwrite is best-effort and temporary. OpenClaw updates may restore the original dashboard files. Use `npx ape-claw dashboard` as the stable entrypoint.
+
 PowerShell (Windows):
 
 ```powershell
-npx ape-claw skill install
-npx ape-claw doctor --json
+npx --yes ape-claw@latest skill install
+npx --yes ape-claw@latest doctor --json
 ```
 
 ## Step 3: Register a Clawbot
@@ -63,7 +69,20 @@ $env:APE_CLAW_AGENT_TOKEN="claw_..."
 
 ## Step 5: Open the Dashboard
 
-Visit [http://localhost:8787/ui](http://localhost:8787/ui) or [https://apeclaw.ai/ui](https://apeclaw.ai/ui) to see your bot in the live feed.
+Use:
+
+```bash
+npx --yes ape-claw@latest dashboard
+```
+
+This opens your local Forge dashboard (`http://localhost:8787/forge`) and starts the local server if needed.
+If OpenClaw is not installed yet, the command prints install steps first.
+
+To restore the original OpenClaw dashboard files:
+
+```bash
+npx ape-claw dashboard restore-openclaw
+```
 
 ## Step 6: Browse Skills
 
@@ -75,14 +94,14 @@ The Forge page at `/forge` includes an AI chat panel. On the live website (apecl
 
 ### What you need
 
-1. **Any LLM API key** — the forge agent auto-detects your provider. Pick one:
+1. **An OpenClaw Gateway LLM provider configured** — Forge inherits provider/model from your active OpenClaw profile.
+   You can configure this in OpenClaw or from Forge Settings (OpenClaw `.env` editor). Common keys:
    - **OpenAI** (`OPENAI_API_KEY`) — GPT-4o, GPT-4, etc.
    - **Anthropic** (`ANTHROPIC_API_KEY`) — Claude models
    - **Perplexity** (`PERPLEXITY_API_KEY`) — Sonar (web-grounded)
    - **Groq** (`GROQ_API_KEY`) — fast Llama inference (free tier available)
    - **Together AI** (`TOGETHER_API_KEY`) — open-source models
    - **Ollama** (`OLLAMA_HOST`) — run models locally, no API key needed
-   - **Any OpenAI-compatible endpoint** (`FORGE_LLM_API_URL` + `FORGE_LLM_API_KEY`)
 2. **OpenClaw + ape-claw skills** installed (you already have these from Step 1-2).
 
 ### Set environment variables
@@ -105,7 +124,6 @@ Optional overrides:
 ```bash
 export FORGE_AGENT_NAME="My Agent"       # Display name in chat (default: "The Clawllector")
 export FORGE_AGENT_ID=my-agent           # ClawBot ID (default: "the-clawllector")
-export FORGE_LLM_MODEL=gpt-4o-mini      # Override model (default: auto per provider)
 ```
 
 ### Start the server
@@ -114,7 +132,7 @@ export FORGE_LLM_MODEL=gpt-4o-mini      # Override model (default: auto per prov
 npm run start:ui
 ```
 
-Open [http://localhost:8787/forge](http://localhost:8787/forge). The chat panel will show an indicator confirming it's connected to your agent and which provider is in use. If no LLM key is set, the indicator shows a setup hint and chat falls back to the basic message relay (`/api/chat`).
+Open [http://localhost:8787/forge](http://localhost:8787/forge). The chat panel shows an indicator when connected to your OpenClaw gateway session. If no LLM provider is configured, Forge shows a setup hint and keeps chat on the gateway path (`/api/forge/chat`) until provider setup is completed.
 
 ### How it works
 
@@ -145,7 +163,7 @@ Expected output:
 }
 ```
 
-If `"configured": false`, your `PERPLEXITY_API_KEY` is missing or empty.
+If `"configured": false`, your OpenClaw gateway provider is not configured yet.
 
 ## Next Steps
 

package/docs/operator/03-cli-reference.md

@@ -9,15 +9,25 @@ Complete reference for all `ape-claw` CLI commands.
 ## Installation
 
 ```bash
-npx ape-claw skill install
-npx ape-claw doctor --json
+npx --yes ape-claw@latest skill install
+npx --yes ape-claw@latest doctor --json
+```
+
+During core install (no slug), ApeClaw prompts for:
+- Starter pack install
+- Forge dashboard upgrade (best-effort OpenClaw local dashboard replacement with safe fallback)
+
+Open local Forge anytime with:
+
+```bash
+npx --yes ape-claw@latest dashboard
 ```
 
 PowerShell (Windows):
 
 ```powershell
-npx ape-claw skill install
-npx ape-claw doctor --json
+npx --yes ape-claw@latest skill install
+npx --yes ape-claw@latest doctor --json
 ```
 
 ## Global Flags
@@ -76,6 +86,29 @@ ape-claw quickstart --json
 
 ---
 
+#### `dashboard`
+
+Open the local ApeClaw Forge dashboard. Starts the local ApeClaw UI server if needed, then opens `http://localhost:8787/forge`.
+
+**Synopsis:**
+```bash
+ape-claw dashboard
+ape-claw dashboard --json
+ape-claw dashboard restore-openclaw
+```
+
+**Required arguments:** None
+
+**Optional arguments:**
+- `--json` — Return startup/open status details as JSON
+
+**Subcommands:**
+- `restore-openclaw` — Restore OpenClaw dashboard UI from `.apeclaw.bak` if present
+
+**Output:** Returns/prints dashboard URL, server startup status, browser open result, and overwrite/reapply status when applicable.
+
+---
+
 #### `chain info`
 
 Get chain information including latest block.
@@ -520,7 +553,7 @@ Install skills for Cursor/OpenClaw. Without a slug, installs the core `ape-claw`
 
 **Synopsis:**
 ```bash
-ape-claw skill install [<slug>] [--scope <local|global>] [--skills-dir <path>] [--starter-pack | --no-starter-pack] [--allow-unvetted] [--allow-high-risk] [--allow-custom-api] [--allow-insecure-api] --json
+ape-claw skill install [<slug>] [--scope <local|global>] [--skills-dir <path>] [--starter-pack | --no-starter-pack] [--forge-upgrade | --no-forge-upgrade] [--allow-unvetted] [--allow-high-risk] [--allow-custom-api] [--allow-insecure-api] --json
 ```
 
 **Required arguments:** None
@@ -530,6 +563,7 @@ ape-claw skill install [<slug>] [--scope <local|global>] [--skills-dir <path>] [
 - `--scope <local|global>` — Installation scope (default: `global` → `~/.openclaw/skills/`; `local` installs into the current project)
 - `--skills-dir <path>` — Explicit skills directory path
 - `--starter-pack` / `--no-starter-pack` — Install or skip the curated starter pack when running without a slug
+- `--forge-upgrade` / `--no-forge-upgrade` — Opt in/out of Forge dashboard upgrade during core install (without a slug)
 - `--allow-unvetted` — Permit API-fetched skills that are not marked vetted
 - `--allow-high-risk` — Permit API-fetched skills with risk tier 3
 - `--allow-custom-api` — Permit non-apeclaw.ai API hosts (advanced/dev use only)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ape-claw",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "ApeChain bridge and NFT execution CLI with telemetry for OpenClaw agents",
   "license": "MIT",
   "repository": {