From 9c6be7f5f86a918f8b3d3d14e64e5b82f9b3ce23 Mon Sep 17 00:00:00 2001 From: PerfectPan Date: Mon, 4 May 2026 16:51:25 +0800 Subject: [PATCH 1/3] docs: clarify website and private install flow --- README.md | 22 +++++++++++++++++++--- docs/release.md | 9 +++++---- site/src/routes/index.tsx | 2 +- 3 files changed, 25 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index c75c5bb..1c7e4c6 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,8 @@ This is a version manager, not an OpenClaw installer replacement. Installation is the mechanism; reproducible local OpenClaw environments are the product. +Website: https://site-neon-two.vercel.app + ## Status MVP crate scaffold with the full command surface from the PRD: @@ -196,13 +198,27 @@ Rollback does not delete unrelated installed versions. ## Install -After a GitHub Release exists: +After a GitHub Release exists and the repository is public: ```bash curl -fsSL https://raw.githubusercontent.com/PerfectPan/ocvm/main/install.sh | sh ``` -While the repository is private, fetch `install.sh` from an authenticated checkout or provide `GITHUB_TOKEN` to the script for release asset downloads. +While the repository is private, anonymous `raw.githubusercontent.com` URLs return 404. Install from an authenticated checkout instead: + +```bash +git clone git@github.com:PerfectPan/ocvm.git +cd ocvm +./install.sh +``` + +For token-based private installs, pass the token to both `curl` and the install script: + +```bash +curl -fsSL -H "Authorization: Bearer $GITHUB_TOKEN" \ + https://raw.githubusercontent.com/PerfectPan/ocvm/main/install.sh | \ + GITHUB_TOKEN="$GITHUB_TOKEN" sh +``` ## Docker E2E @@ -214,7 +230,7 @@ Run real npm OpenClaw install validation in Docker instead of on the host: ## Landing Page -The TanStack Start landing page lives in `site/` and is configured for Vercel preview deployments from this repository: +The TanStack Start landing page is deployed at https://site-neon-two.vercel.app. Source lives in `site/` and is configured for Vercel deployments from that directory: ```bash npm ci --prefix site diff --git a/docs/release.md b/docs/release.md index 62ea352..a233fc6 100644 --- a/docs/release.md +++ b/docs/release.md @@ -25,16 +25,18 @@ The `Release` workflow builds platform binaries, packages archives, generates SH ## Install Script -Users can install the latest release with: +Users can install the latest release with this command once the repository is public: ```bash curl -fsSL https://raw.githubusercontent.com/PerfectPan/ocvm/main/install.sh | sh ``` -For private repository installs, set a token with `repo` access: +For private repository installs, anonymous `raw.githubusercontent.com` URLs return 404. Either run `./install.sh` from an authenticated checkout, or pass a token with `repo` access to both `curl` and the install script: ```bash -GITHUB_TOKEN=... curl -fsSL https://raw.githubusercontent.com/PerfectPan/ocvm/main/install.sh | sh +curl -fsSL -H "Authorization: Bearer $GITHUB_TOKEN" \ + https://raw.githubusercontent.com/PerfectPan/ocvm/main/install.sh | \ + GITHUB_TOKEN="$GITHUB_TOKEN" sh ``` ## Docker E2E @@ -46,4 +48,3 @@ Use Docker to validate real npm OpenClaw install behavior without touching the h ``` The container sets `OCVM_HOME=/tmp/ocvm-home`, installs from npm, and runs `ocvm exec -- openclaw --version`. - diff --git a/site/src/routes/index.tsx b/site/src/routes/index.tsx index 14660b3..1df05a8 100644 --- a/site/src/routes/index.tsx +++ b/site/src/routes/index.tsx @@ -90,7 +90,7 @@ OpenClaw 2026.3.28`}

Install

-

One command after the first GitHub Release is published.

+

One command once the first public GitHub Release is published.

           curl -fsSL https://raw.githubusercontent.com/PerfectPan/ocvm/main/install.sh | sh

From 47849ffdd131bd2bca746f5d1e4f333ff6730fd7 Mon Sep 17 00:00:00 2001
From: PerfectPan 
Date: Mon, 4 May 2026 17:02:45 +0800
Subject: [PATCH 2/3] docs: simplify private install guidance

---
 README.md       | 10 +---------
 docs/release.md |  8 ++++----
 2 files changed, 5 insertions(+), 13 deletions(-)

diff --git a/README.md b/README.md
index 1c7e4c6..4e25767 100644
--- a/README.md
+++ b/README.md
@@ -204,7 +204,7 @@ After a GitHub Release exists and the repository is public:
 curl -fsSL https://raw.githubusercontent.com/PerfectPan/ocvm/main/install.sh | sh
 ```
 
-While the repository is private, anonymous `raw.githubusercontent.com` URLs return 404. Install from an authenticated checkout instead:
+While the repository is private, anonymous `raw.githubusercontent.com` URLs return 404. Use an authenticated checkout until the repo is public:
 
 ```bash
 git clone git@github.com:PerfectPan/ocvm.git
@@ -212,14 +212,6 @@ cd ocvm
 ./install.sh
 ```
 
-For token-based private installs, pass the token to both `curl` and the install script:
-
-```bash
-curl -fsSL -H "Authorization: Bearer $GITHUB_TOKEN" \
-  https://raw.githubusercontent.com/PerfectPan/ocvm/main/install.sh | \
-  GITHUB_TOKEN="$GITHUB_TOKEN" sh
-```
-
 ## Docker E2E
 
 Run real npm OpenClaw install validation in Docker instead of on the host:
diff --git a/docs/release.md b/docs/release.md
index a233fc6..d8d9dc7 100644
--- a/docs/release.md
+++ b/docs/release.md
@@ -31,12 +31,12 @@ Users can install the latest release with this command once the repository is pu
 curl -fsSL https://raw.githubusercontent.com/PerfectPan/ocvm/main/install.sh | sh
 ```
 
-For private repository installs, anonymous `raw.githubusercontent.com` URLs return 404. Either run `./install.sh` from an authenticated checkout, or pass a token with `repo` access to both `curl` and the install script:
+For private repository installs, anonymous `raw.githubusercontent.com` URLs return 404. Use an authenticated checkout until the repo is public:
 
 ```bash
-curl -fsSL -H "Authorization: Bearer $GITHUB_TOKEN" \
-  https://raw.githubusercontent.com/PerfectPan/ocvm/main/install.sh | \
-  GITHUB_TOKEN="$GITHUB_TOKEN" sh
+git clone git@github.com:PerfectPan/ocvm.git
+cd ocvm
+./install.sh
 ```
 
 ## Docker E2E

From f0b5e42c3bdb4a14b79004b875a2ca94d5d85d71 Mon Sep 17 00:00:00 2001
From: PerfectPan 
Date: Mon, 4 May 2026 17:07:10 +0800
Subject: [PATCH 3/3] docs: remove private install notes

---
 README.md                 | 10 +---------
 docs/release.md           | 10 +---------
 site/src/routes/index.tsx |  2 +-
 3 files changed, 3 insertions(+), 19 deletions(-)

diff --git a/README.md b/README.md
index 4e25767..b85ec78 100644
--- a/README.md
+++ b/README.md
@@ -198,20 +198,12 @@ Rollback does not delete unrelated installed versions.
 
 ## Install
 
-After a GitHub Release exists and the repository is public:
+After a GitHub Release exists:
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/PerfectPan/ocvm/main/install.sh | sh
 ```
 
-While the repository is private, anonymous `raw.githubusercontent.com` URLs return 404. Use an authenticated checkout until the repo is public:
-
-```bash
-git clone git@github.com:PerfectPan/ocvm.git
-cd ocvm
-./install.sh
-```
-
 ## Docker E2E
 
 Run real npm OpenClaw install validation in Docker instead of on the host:
diff --git a/docs/release.md b/docs/release.md
index d8d9dc7..6de8a72 100644
--- a/docs/release.md
+++ b/docs/release.md
@@ -25,20 +25,12 @@ The `Release` workflow builds platform binaries, packages archives, generates SH
 
 ## Install Script
 
-Users can install the latest release with this command once the repository is public:
+Users can install the latest release with:
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/PerfectPan/ocvm/main/install.sh | sh
 ```
 
-For private repository installs, anonymous `raw.githubusercontent.com` URLs return 404. Use an authenticated checkout until the repo is public:
-
-```bash
-git clone git@github.com:PerfectPan/ocvm.git
-cd ocvm
-./install.sh
-```
-
 ## Docker E2E
 
 Use Docker to validate real npm OpenClaw install behavior without touching the host:
diff --git a/site/src/routes/index.tsx b/site/src/routes/index.tsx
index 1df05a8..9eaa105 100644
--- a/site/src/routes/index.tsx
+++ b/site/src/routes/index.tsx
@@ -90,7 +90,7 @@ OpenClaw 2026.3.28`}

Install

-

One command once the first public GitHub Release is published.

+

One command once the first GitHub Release is published.

           curl -fsSL https://raw.githubusercontent.com/PerfectPan/ocvm/main/install.sh | sh