@coolclaw/coolclaw 0.2.8 → 0.2.10

package/README.md

@@ -9,7 +9,7 @@
 - Runtime entry: `dist/index.js`
 - Setup entry: `dist/setup-entry.js`
 - Runtime compatibility:
-  - minimum OpenClaw runtime: `2026.3.13`
+  - minimum OpenClaw runtime: `2026.3.22`
   - design baseline: `2026.4.20`
   - full entry intentionally uses the stable `register(api)` shape instead of requiring newer SDK entry helpers at runtime
 - Supported outbound targets:
@@ -25,7 +25,21 @@
 
 ## Installation
 
-### From npm / ClawHub (recommended)
+### Quick Install (recommended)
+
+One command to install, configure, and start:
+
+```bash
+npx @coolclaw/coolclaw-cli install
+```
+
+This automatically:
+1. Detects your OpenClaw version and selects the compatible plugin dist-tag
+2. Installs the `@coolclaw/coolclaw` plugin
+3. Runs interactive agent setup (register or reuse a Riddle Agent)
+4. Restarts the OpenClaw gateway
+
+### Manual Install
 
 ```bash
 # Install from npm
@@ -35,17 +49,26 @@ openclaw plugins install @coolclaw/coolclaw
 openclaw plugins install clawhub:@coolclaw/coolclaw
 ```
 
+### Authentication via `openclaw channels login`
+
+```bash
+openclaw channels login --channel coolclaw
+```
+
+This checks for an existing valid token, and if not authenticated, runs the interactive setup flow automatically.
+
 ### From local path (development only)
 
 ```bash
 openclaw plugins install /path/to/openclaw-coolclaw-channel
 ```
 
-### Post-install setup
+### Post-install setup (if installed manually)
 
 ```bash
-openclaw gateway restart
 openclaw coolclaw setup
+# setup 后会自动重启网关，如需跳过可使用 --no-restart
+# openclaw coolclaw setup --no-restart
 # 发给 Agent 执行：下载并安装此Skill https://agits-xa.baidu.com/riddle/skills/coolclaw-skill.tar.gz
 ```
 
@@ -91,6 +114,32 @@ openclaw message send --channel coolclaw --account default --target "coolclaw:gr
 
 Run the same commands without `--dry-run` when the test Riddle gateway/chat services are running and the configured Agent token is valid.
 
+## CLI Tool
+
+The `@coolclaw/coolclaw-cli` package provides a one-command installation experience:
+
+```bash
+npx @coolclaw/coolclaw-cli install
+```
+
+This tool automates the following operations:
+
+1. **Version Detection (Layer 1)** — Detect the local OpenClaw version and match the correct plugin dist tag to prevent incompatible packages from being installed.
+2. **Plugin Installation** — Install the compatible `@coolclaw/coolclaw` package.
+3. **Agent Registration** — Run `openclaw coolclaw setup` to interactively register or reuse a Riddle Agent.
+4. **Gateway Restart** — Trigger the Gateway to reload configuration.
+
+Example output:
+
+```text
+[coolclaw] Detected OpenClaw version: 2026.4.22
+[coolclaw] Matched dist-tag: latest
+[coolclaw] Installing plugin: @coolclaw/coolclaw
+[coolclaw] Running setup...
+[coolclaw] Restarting gateway...
+[coolclaw] Installation complete!
+```
+
 ## Important Notes
 
 ### Session Scope for Multi-Channel Setups

package/dist/cli-metadata.d.ts

@@ -1,6 +1,7 @@
-import _default from './index.js';
-import './channel-BozkcSms.js';
+import entry from './index.js';
+import 'openclaw/plugin-sdk/channel-core';
+import './types-y7-Cr6xf.js';
 
 
 
-export { _default as default };
+export { entry as default };