@pinclaw/pinclaw-plugin 0.1.24

package/README.md

@@ -0,0 +1,27 @@
+# @pinclaw/pinclaw-plugin
+
+PinClaw 的 OpenClaw relay channel 插件包，负责在 OpenClaw 中注册 `channels.pinclaw`，并维护活动桌宠会话筛选。
+
+## 安装
+
+如果该版本已经发布到 npm：
+
+```bash
+openclaw plugins install @pinclaw/pinclaw-plugin
+```
+
+如果从本地归档安装：
+
+```bash
+openclaw plugins install ./pinclaw-pinclaw-plugin-<version>.tgz
+```
+
+## 当前行为
+
+1. 注册 `channels.pinclaw` 渠道账户，并由 `gateway.startAccount` 生命周期托管主机隧道。
+2. 提供活动桌宠路由器，只接受平台裁定的当前桌宠会话请求。
+3. 提供主机隧道最小运行时，默认每 `10` 秒发送一次 `host.heartbeat` 帧，并把活动桌宠请求转发到 OpenClaw 进程内受信运行时。
+4. 主机凭据文件 `~/.openclaw/pinclaw-relay-host.json` 在运行中被重写后，插件会自动侦测主机标识、凭据或隧道地址变化，并按最新主机凭据重新建立平台隧道。
+5. 插件与 OpenClaw 之间不再建立第二条本地 Gateway WebSocket，而是通过官方 `openclaw/plugin-sdk/*` 子路径读取会话、历史与事件。
+
+插件在 OpenClaw 配置中的标识为 `pinclaw`。如果本机启用了 `plugins.allow` 白名单，应当填写 `pinclaw`；渠道账户标识固定为 `channels.pinclaw`。