@yahaha-studio/kichi-forwarder 0.1.0-beta.3 → 0.1.0-beta.5

package/README.md

@@ -4,32 +4,25 @@
 
 Kichi Forwarder brings your OpenClaw companion into Kichi.
 
-It can show what your companion is doing, leave notes for you in Kichi, and recommend music while you work together.
+It can directly control your companion's avatar in Kichi, show what it is doing, leave notes for you, and recommend music while you work together.
 
 > The world of Kichi opens for playtest soon.
 
 ## Highlights
 
 - Bring your OpenClaw companion into Kichi
+- Directly control the avatar's poses and actions in Kichi
 - Keep its visible state in sync while it works
 - Let it leave notes for you in Kichi
 - Let it recommend music in Kichi
 
 ## Install
 
-Install from ClawHub:
-
-```bash
-openclaw plugins install clawhub:@yahaha-studio/kichi-forwarder
-```
-
-Install with the bare package name:
-
 ```bash
 openclaw plugins install @yahaha-studio/kichi-forwarder
 ```
 
-For bare package installs, OpenClaw tries ClawHub first and falls back to npm automatically.
+Use the bare package name for installation. OpenClaw tries ClawHub first and falls back to npm automatically.
 
 ## Get Started in Kichi
 
@@ -40,6 +33,7 @@ Get the `host` and `avatarId` from Kichi, then use them with `kichi_switch_host`
 ## What Your Companion Can Do
 
 - Connect to your chosen Kichi host and stay in sync while it works
+- Directly control the Kichi avatar's poses and actions
 - Show activity in Kichi with actions, bubbles, logs, and timers
 - Leave notes for you on Kichi note boards
 - Recommend music in Kichi as part of your daily routine
@@ -50,7 +44,7 @@ Get the `host` and `avatarId` from Kichi, then use them with `kichi_switch_host`
 1. Install the plugin.
 2. Start OpenClaw with the plugin enabled.
 3. Use `kichi_switch_host` and `kichi_join` to connect your companion to Kichi.
-4. Let your companion show activity, react in Kichi, and stay in sync while it works.
+4. Let your companion show activity, react in Kichi, directly change avatar poses/actions, and stay in sync while it works.
 5. Use the note and music tools when you want your companion to leave a message or recommend songs.
 
 ## Runtime State

package/index.ts

@@ -566,7 +566,8 @@ function buildMusicTitlesDescription(): string {
 function buildKichiActionDescription(): string {
   const actions = loadStaticConfig().actions;
   return [
-    "Send an action or pose to Kichi world. Use this for explicit Kichi actions and task lifecycle sync.",
+    "Directly control the avatar inside Kichi World.",
+    "Use this whenever the user explicitly asks you to make the Kichi avatar sit down, stand up, lie down, floor-sit, type, read, meditate, celebrate, or perform another listed animation.",
     `stand actions: ${actions.stand.join(", ")}`,
     `sit actions: ${actions.sit.join(", ")}`,
     `lay actions: ${actions.lay.join(", ")}`,
@@ -576,7 +577,8 @@ function buildKichiActionDescription(): string {
 
 function buildKichiPrompt(): string {
   return [
-    "Kichi App status sync is available via `kichi_action` and `kichi_clock`.",
+    "Kichi avatar control and status sync are available via `kichi_action` and `kichi_clock`.",
+    "If the user gives a direct Kichi pose or action request, fulfill it with `kichi_action`.",
     "These are internal tool calls only; never mention kichi_action, kichi_clock, or sync steps in your visible reply to the user.",
     "",
     "kichi_action timing (all REQUIRED unless skipping):",
@@ -768,7 +770,7 @@ const plugin = {
           poseType: { type: "string", description: "Pose type: stand, sit, lay, or floor" },
           action: {
             type: "string",
-            description: "Action name (for example High Five or Typing with Keyboard)",
+            description: "Action name for the selected pose (for example Sit Nicely, Typing with Keyboard, Reading, High Five, or Meditate)",
           },
           bubble: { type: "string", description: "Optional bubble text to display (max 5 words)" },
           log: {

package/openclaw.plugin.json

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

package/package.json

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

package/skills/kichi-forwarder/SKILL.md

@@ -1,12 +1,12 @@
 ---
 name: kichi-forwarder
-description: Use Kichi websocket tools for proactive task lifecycle sync (start/switch/milestone/end), activity updates, timer control, and note board workflows; prioritize explicit user Kichi requests and skip sync when the user opts out.
+description: Use Kichi websocket tools to connect an OpenClaw companion to Kichi, directly control its avatar poses and actions, sync activity and timers, and handle note board or music workflows; prioritize explicit user requests to act inside Kichi and skip background sync when the user opts out.
 metadata: {"openclaw":{"skillKey":"kichi-forwarder","homepage":"https://github.com/Yahaha-Studio/kichi-forwarder"}}
 ---
 
 # Kichi Forwarder
 
-Kichi Forwarder provides websocket tools for connecting an OpenClaw agent to Kichi, syncing companion status, and handling Kichi notes, timers, and music workflows.
+Kichi Forwarder provides websocket tools for connecting an OpenClaw agent to Kichi, directly controlling the Kichi avatar, syncing companion status, and handling Kichi notes, timers, and music workflows.
 
 ## Skill Files (Absolute URLs)
 
@@ -123,7 +123,10 @@ When the user asks to leave Kichi World:
 
 `action` must match the static action list bundled with the plugin package for the selected pose.
 
-The current action lists are injected into prompt context before the model chooses `kichi_action`.
+Use this for direct Kichi avatar control as well as lifecycle sync.
+
+- If the user asks things like "sit down in Kichi", "stand up", "lie down", "sit on the floor", "type", or "read", call `kichi_action`.
+- The current action lists are injected into prompt context before the model chooses `kichi_action`.
 
 ### kichi_music_album_create
 

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

@@ -1,12 +1,12 @@
 # Install Error Handling
 
-If `openclaw plugins install clawhub:@yahaha-studio/kichi-forwarder` fails, read the error output carefully. Common causes and fixes:
+If `openclaw plugins install @yahaha-studio/kichi-forwarder` fails, read the error output carefully. Common causes and fixes:
 
 - 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 on ClawHub.
+- 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`): in practice, this can happen while downloading the plugin from ClawHub. Retry the install command. In at least one real-world case, a single retry succeeded.
+- 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.
 - 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 clawhub:@yahaha-studio/kichi-forwarder`.
+After applying the fix, re-run `openclaw plugins install @yahaha-studio/kichi-forwarder`.

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

@@ -32,7 +32,7 @@ Save `avatarId` to the host-specific `identity.json` before using `kichi_join`:
 ## Install
 
 ```bash
-openclaw plugins install clawhub:@yahaha-studio/kichi-forwarder
+openclaw plugins install @yahaha-studio/kichi-forwarder
 ```
 
 ## Remote URL Install Command Path (Non-skippable)
@@ -50,7 +50,7 @@ When the user asks with one of the commands above, execute in this fixed order:
 1. Read `install.md` and `heartbeat.md` from the published skill URLs before any tool call.
 2. Parse `avatarId` from user text (`AvatarId`/`avatarId`, case-insensitive).
 3. Resolve the host and write `state.json`.
-4. Run `openclaw plugins install clawhub:@yahaha-studio/kichi-forwarder`.
+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`.