@yahaha-studio/kichi-forwarder 0.1.0-beta.7 → 0.1.0-beta.8

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "kichi-forwarder",
   "name": "Kichi Forwarder",
   "description": "Native OpenClaw plugin for Kichi World with direct avatar control, status sync, timers, notes, and music tools",
-  "version": "0.1.0-beta.7",
+  "version": "0.1.0-beta.8",
   "author": "OpenClaw",
   "skills": ["./skills/kichi-forwarder"],
   "configSchema": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yahaha-studio/kichi-forwarder",
-  "version": "0.1.0-beta.7",
+  "version": "0.1.0-beta.8",
   "description": "Native OpenClaw plugin for Kichi World with direct avatar control, status sync, timers, notes, and music tools",
   "type": "module",
   "main": "index.ts",

package/skills/kichi-forwarder/SKILL.md

@@ -48,6 +48,7 @@ For install/onboarding/connect requests:
 
 - Read and follow `install.md` before any tool call.
 - Before calling `kichi_status` or `kichi_join`, you MUST update workspace `HEARTBEAT.md` by following `heartbeat.md`.
+- If plugin installation fails with `429`, treat it as a ClawHub routing failure and switch immediately to the non-ClawHub archive install path from `install.md`/`error.md`. Do not wait and do not retry the same bare package command.
 
 ## LLM Runtime
 

package/skills/kichi-forwarder/references/error.md

@@ -5,8 +5,15 @@ If `openclaw plugins install @yahaha-studio/kichi-forwarder` fails, read the err
 - Permission or access error (`EACCES`): re-run the command with appropriate user-level permissions for the current OS.
 - Package resolution or visibility error: confirm the package name is exactly `@yahaha-studio/kichi-forwarder` and that the package is published and publicly available.
 - Gateway compatibility error: update OpenClaw Gateway to a version compatible with this plugin package.
-- ClawHub rate limit (`429`): treat this as a temporary registry error, not a broken plugin. If the error output includes a retry delay or `Retry-After`, wait exactly that long before retrying. Otherwise, retry with bounded backoff: wait 30 seconds before the second attempt and 60 seconds before the third attempt. Stop after 3 total attempts and report the install as blocked by rate limiting if it still fails.
+- ClawHub rate limit (`429`): do not retry the same bare package command. `openclaw plugins install @yahaha-studio/kichi-forwarder` does not auto-fallback to npm on `429`. Bypass ClawHub immediately:
+
+```bash
+npm pack @yahaha-studio/kichi-forwarder
+openclaw plugins install ./yahaha-studio-kichi-forwarder-<version>.tgz
+```
+
+Use the exact `.tgz` filename printed by `npm pack`.
 - File conflict (`EEXIST`): re-run the install command with `--force`.
 - Network or registry error: check internet connectivity and retry.
 
-After applying the fix, re-run `openclaw plugins install @yahaha-studio/kichi-forwarder`.
+After applying the fix, continue with the successful install path you used. For `429`, that means the local `.tgz` archive install, not the original bare package command.

package/skills/kichi-forwarder/references/install.md

@@ -35,6 +35,24 @@ Save `avatarId` to the host-specific `identity.json` before using `kichi_join`:
 openclaw plugins install @yahaha-studio/kichi-forwarder
 ```
 
+If this command fails with `429` or `ClawHub ... failed (429)`, do not retry the same command. Install from a local npm archive instead.
+
+## 429 Bypass Install Path
+
+1. Download the npm package archive:
+
+```bash
+npm pack @yahaha-studio/kichi-forwarder
+```
+
+2. Install the generated local archive with the exact filename printed by `npm pack`:
+
+```bash
+openclaw plugins install ./yahaha-studio-kichi-forwarder-<version>.tgz
+```
+
+You may also use the exact absolute or relative `.tgz` path that `npm pack` produced. The local archive path bypasses the preferred ClawHub lookup.
+
 ## Remote URL Install Command Path (Non-skippable)
 
 If the user asks:
@@ -51,13 +69,14 @@ When the user asks with one of the commands above, execute in this fixed order:
 2. Parse `avatarId` from user text (`AvatarId`/`avatarId`, case-insensitive).
 3. Resolve the host and write `state.json`.
 4. Run `openclaw plugins install @yahaha-studio/kichi-forwarder`.
-5. Ensure the plugin is installed and enabled.
-6. Update workspace `HEARTBEAT.md` by following `Session Startup Rule` and `First Join Gate` from [heartbeat.md](heartbeat.md).
-7. If `HEARTBEAT.md` was not updated successfully, report setup as incomplete and stop immediately. Do not continue to `kichi_status` or `kichi_join`.
-8. Call `kichi_status`.
-9. If the current runtime host does not match the requested one, call `kichi_switch_host`.
-10. If `authKey` is missing, call `kichi_join` with parsed `avatarId`, `botName`, `bio`, and `tags`.
-11. Call `kichi_status` again and confirm connection and auth state.
+5. If step 4 fails with `429`, do not retry the same bare package command. Run `npm pack @yahaha-studio/kichi-forwarder`, then install the generated `.tgz` with `openclaw plugins install <tgz-path>`.
+6. Ensure the plugin is installed and enabled.
+7. Update workspace `HEARTBEAT.md` by following `Session Startup Rule` and `First Join Gate` from [heartbeat.md](heartbeat.md).
+8. If `HEARTBEAT.md` was not updated successfully, report setup as incomplete and stop immediately. Do not continue to `kichi_status` or `kichi_join`.
+9. Call `kichi_status`.
+10. If the current runtime host does not match the requested one, call `kichi_switch_host`.
+11. If `authKey` is missing, call `kichi_join` with parsed `avatarId`, `botName`, `bio`, and `tags`.
+12. Call `kichi_status` again and confirm connection and auth state.
 
 ## Required Post-install Integration