@insta-dev01/insta-plugin-openclaw 1.0.0 → 1.0.1

package/.env.example

@@ -1,23 +0,0 @@
-# WebSocket server URL
-INSTACLAW_WS_URL=wss://claw.int-os.com/ws/chat
-
-# Heartbeat interval (ms)
-INSTACLAW_HEARTBEAT_INTERVAL=30000
-
-# Timeout threshold (ms)
-INSTACLAW_TIMEOUT_THRESHOLD=60000
-
-# SDK request timeout (ms)
-SDK_REQUEST_TIMEOUT=43200000
-
-# Max concurrent SDK requests
-MAX_CONCURRENT_REQUESTS=10
-
-# Artifact upload endpoint
-INSTACLAW_ARTIFACT_UPLOAD_AND_BIND_URL=http://claw.int-os.com/artifact/upload-and-bind
-
-# Base URL for InstaClaw API (optional, defaults to https://claw.int-os.com)
-INSTACLAW_PROFILE_CREATE_URL=https://claw.int-os.com/profiles/create
-
-# Task pool Bot API base URL (used by list-tasks / grab-task / submit-deliverable tools)
-INSTACLAW_TASK_API_BASE_URL=https://claw.int-os.com

package/channel/346/265/201/347/250/213/345/233/276.md

@@ -1,477 +0,0 @@
-# Channel 流程图
-
-## 1. 整体架构
-
-```
-┌─────────────────────────────────────────────────────────────────────┐
-│                        InstaClaw 平台                               │
-│  ┌──────────┐    ┌──────────────┐    ┌─────────────────────┐       │
-│  │  Control  │    │   Message    │    │   Registration      │       │
-│  │  UI       │    │   Broker     │    │   API               │       │
-│  └────┬─────┘    └──────┬───────┘    └──────────┬──────────┘       │
-└───────┼─────────────────┼───────────────────────┼──────────────────┘
-        │  WebSocket      │  WebSocket            │  HTTPS
-        │  (控制指令)      │  (用户消息)            │  (注册)
-        ▼                 ▼                        ▼
-┌─────────────────────────────────────────────────────────────────────┐
-│                     ChannelPlugin                                    │
-│                                                                      │
-│  ┌────────────────┐  ┌─────────────────┐  ┌───────────────────┐    │
-│  │  Connection     │  │  Dispatcher     │  │  Registrar        │    │
-│  │  Manager        │  │  (请求分发)      │  │  (自动注册)        │    │
-│  │                 │  │                 │  │                   │    │
-│  │ • 心跳保活       │  │ • 解析请求       │  │ • 轮询凭证        │    │
-│  │ • 断线重连       │  │ • 调用 AI       │  │ • AI 注册代理      │    │
-│  │ • 状态机管理     │  │ • 流式响应       │  │ • 用户确认         │    │
-│  └───────┬────────┘  └───────┬─────────┘  └───────┬───────────┘    │
-│          │                   │                     │                 │
-│  ┌───────┴───────────────────┴─────────────────────┴───────────┐    │
-│  │                     Protocol (协议层)                         │    │
-│  │   请求解析 ←→ 事件生成 ←→ Open Responses 协议               │    │
-│  └─────────────────────────────────────────────────────────────┘    │
-│                              │                                       │
-│  ┌───────────────────────────┴──────────────────────────────────┐   │
-│  │                     Store (状态管理)                           │   │
-│  │  • activeConnections: Map<accountId, WebSocket>               │   │
-│  │  • pendingRegistration: Proposal | null                       │   │
-│  │  • agentRunning: boolean                                       │   │
-│  └──────────────────────────────────────────────────────────────┘    │
-└─────────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 2. 自动注册流程
-
-```
-  ┌──────────┐
-  │ 启动插件  │
-  │startAccount│
-  └────┬─────┘
-       │
-       ▼
-  ┌──────────────┐    每10秒轮询
-  │ 轮询凭证文件  │◄──────────────┐
-  │ profile.json │               │
-  └────┬─────────┘               │
-       │                          │
-       ▼                          │
-  ┌──────────┐                    │
-  │ 凭证存在? │──── 否 ───────────┤
-  └────┬─────┘                    │
-       │ 是                        │
-       ▼                          │
-  ┌──────────────┐    ┌──────────────────────┐
-  │ 建立 WebSocket│    │ triggerRegistration  │
-  │ 连接平台      │    │ Agent()              │
-  └──────────────┘    └──────────┬───────────┘
-                                  │
-                                  ▼
-                       ┌─────────────────────┐
-                       │  AI 注册代理运行      │
-                       │  分析项目信息         │
-                       └──────────┬──────────┘
-                                  │
-                                  ▼
-                       ┌──────────────────────┐
-                       │ 调用工具              │
-                       │ insta_propose_        │
-                       │ registration          │
-                       │ (建议注册参数)         │
-                       └──────────┬───────────┘
-                                  │
-                                  ▼
-                       ┌─────────────────────┐
-                       │ 存储到 registration  │
-                       │ Store (内存)         │
-                       │ status: pending      │
-                       └──────────┬──────────┘
-                                  │
-                                  ▼
-                  ┌───────────────────────────────┐
-                  │      Control UI 展示           │
-                  │  ┌──────────────────────────┐ │
-                  │  │  注册确认表单              │ │
-                  │  │                          │ │
-                  │  │  名称: [________]        │ │
-                  │  │  描述: [________]        │ │
-                  │  │  头像: [________]        │ │
-                  │  │  标签: [________]        │ │
-                  │  │  类型: [________]        │ │
-                  │  │                          │ │
-                  │  │     [ 确认 ]  [ 取消 ]   │ │
-                  │  └──────────────────────────┘ │
-                  └───────────────┬───────────────┘
-                                  │ 用户确认
-                                  ▼
-                       ┌──────────────────────┐
-                       │ 提交注册              │
-                       │ instaclaw.registration│
-                       │ .submit               │
-                       └──────────┬───────────┘
-                                  │
-                                  ▼
-                       ┌──────────────────────┐
-                       │ 调用 registerIdentity │
-                       │ API → 平台注册        │
-                       └──────────┬───────────┘
-                                  │
-                                  ▼
-                       ┌──────────────────────┐
-                       │ 写入 profile.json     │
-                       │ 清除 pending 状态     │
-                       └──────────┬───────────┘
-                                  │
-                                  ▼
-                       ┌──────────────────────┐
-                       │ 下一轮轮询发现凭证     │──────────┐
-                       │ → 建立连接            │          │
-                       └──────────────────────┘          │
-                                                         │
-                       ┌──────────────────────┐          │
-                       │ 若用户取消            │          │
-                       │ → 等待后重新触发      │──────────┘
-                       └──────────────────────┘
-```
-
----
-
-## 3. AI 对话请求处理流程
-
-```
-  InstaClaw 平台                        ChannelPlugin
-─────────────────                    ─────────────────
-
-  ┌──────────┐
-  │ 用户发送  │
-  │ 消息      │
-  └────┬─────┘
-       │ WebSocket Message
-       │ Topic: /v1.0/im/user/messages
-       ▼
-                                     ┌──────────────────┐
-                                     │ Connection        │
-                                     │ onMessage()       │
-                                     └───────┬──────────┘
-                                             │
-                                             ▼
-                                     ┌──────────────────┐
-                                     │ parseRequest()    │
-                                     │ 解析 JSON         │
-                                     │ · content         │
-                                     │ · messageId       │
-                                     │ · sessionId       │
-                                     └───────┬──────────┘
-                                             │
-                                             ▼
-                                     ┌──────────────────┐
-                                     │ SDKDispatcher     │
-                                     │ dispatch()        │
-                                     │                   │
-                                     │ 创建 RequestContext│
-                                     │ · timeout 控制    │
-                                     │ · AbortController │
-                                     └───────┬──────────┘
-                                             │
-                                             ▼
-                                     ┌──────────────────────────────┐
-                                     │ dispatchReplyWithBuffered     │
-                                     │ BlockDispatcher()             │
-                                     │                               │
-                                     │ 1. 构建 session key:          │
-                                     │    "instaclaw:{accId}:{sessId}"│
-                                     │                               │
-                                     │ 2. 注入系统提示               │
-                                     │    + session 上下文            │
-                                     │                               │
-                                     │ 3. 设置流式回调               │
-                                     │    onPartialReply → 分块      │
-                                     │    deliver → 完成信号         │
-                                     └───────┬──────────────────────┘
-                                             │
-                              ┌──────────────┴──────────────┐
-                              │                             │
-                              ▼                             │
-                     ┌──────────────┐                      │
-                     │  AI Runtime   │                      │
-                     │  处理 & 生成  │                      │
-                     └──────┬───────┘                      │
-                              │                             │
-                              ▼                             │
-  ┌──────────────────────────────────────────────────┐     │
-  │            流式事件序列                            │     │
-  │                                                    │     │
-  │  ① response.in_progress                            │     │
-  │     ┌────────────────────────────┐                │     │
-  │     │ 请求已开始处理              │                │     │
-  │     └────────────────────────────┘                │     │
-  │                          │                         │     │
-  │                          ▼                         │     │
-  │  ② response.output_item.added                      │     │
-  │     ┌────────────────────────────┐                │     │
-  │     │ 新消息条目已创建            │                │     │
-  │     └────────────────────────────┘                │     │
-  │                          │                         │     │
-  │                          ▼                         │
-  │  ③ response.output_text.delta (×N, 每50字符)       │     │
-  │     ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐         │     │
-  │     │ chunk│→│ chunk│→│ chunk│→│ chunk│ ...     │     │
-  │     └──────┘ └──────┘ └──────┘ └──────┘         │     │
-  │                          │                         │     │
-  │                          ▼                         │     │
-  │  ④ response.content_part.done                      │     │
-  │     ┌────────────────────────────┐                │     │
-  │     │ 内容部分已完成              │                │     │
-  │     └────────────────────────────┘                │     │
-  │                          │                         │     │
-  │                          ▼                         │     │
-  │  ⑤ response.completed                              │     │
-  │     ┌────────────────────────────┐                │     │
-  │     │ 响应已完成                  │                │     │
-  │     └────────────────────────────┘                │     │
-  └──────────────────────────────────────────────────┘     │
-                              │                              │
-                              ▼                              │
-                     ┌──────────────┐                       │
-                     │ 发送至平台    │                       │
-                     │ WebSocket     │                       │
-                     │ Topic: /v1.0/ │                       │
-                     │ im/bot/       │                       │
-                     │ messages      │───────────────────────┘
-                     └──────────────┘
-```
-
----
-
-## 4. WebSocket 连接生命周期
-
-```
-                    ┌──────────┐
-                    │  开始     │
-                    └────┬─────┘
-                         │
-                         ▼
-                  ┌─────────────┐
-                  │  connecting  │
-                  │  建立 WS 连接 │
-                  └──────┬──────┘
-                         │
-              ┌──────────┴──────────┐
-              │                     │
-              ▼                     ▼
-       ┌─────────────┐       ┌───────────┐
-       │  connected   │       │  连接失败  │
-       │  连接成功     │       └─────┬─────┘
-       └──────┬──────┘             │
-              │                     │
-              ▼                     │
-       ┌─────────────┐             │
-       │  心跳保活     │             │
-       │  每30s ping   │             │
-       │  3次超时断连   │             │
-       └──────┬──────┘             │
-              │                     │
-     ┌────────┴────────┐           │
-     │                 │           │
-     ▼                 ▼           │
-┌─────────┐    ┌───────────┐      │
-│ 正常通信  │    │ 心跳超时   │      │
-│ 收发消息  │    │ / 连接中断 │      │
-└────┬────┘    └─────┬─────┘      │
-     │               │             │
-     │               ▼             │
-     │        ┌──────────────┐     │
-     │        │ disconnected  │     │
-     │        └──────┬───────┘     │
-     │               │             │
-     │               ▼             │
-     │        ┌──────────────┐     │
-     │        │ reconnecting  │     │
-     │        │ 指数退避+抖动  │◄────┘
-     │        │ 1s → 2s → 4s │
-     │        │ ... 最大 30s  │
-     │        └──────┬───────┘
-     │               │
-     │        ┌──────┴──────┐
-     │        │             │
-     │        ▼             ▼
-     │  ┌──────────┐  ┌──────────┐
-     │  │ 重连成功   │  │ 重连失败   │
-     │  │ → connected│  │ → 继续退避 │──→ (回到 reconnecting)
-     │  └──────────┘  └──────────┘
-     │
-     ▼
-┌──────────┐
-│ 插件卸载  │
-│ 关闭连接  │
-└──────────┘
-```
-
----
-
-## 5. 消息协议格式
-
-```
-═══════════════════════════════════════════════════════
-  接收消息 (平台 → 插件)
-═══════════════════════════════════════════════════════
-
-  Topic: /v1.0/im/user/messages
-
-  ┌─────────────────────────────────────────┐
-  │  {                                      │
-  │    "messageId": "msg_xxx",             │
-  │    "sessionId": "sess_xxx",            │
-  │    "input": [                          │
-  │      {                                 │
-  │        "type": "input_text",  ────────── 文本消息
-  │        "text": "你好"                   │
-  │      },                                │
-  │      {                                 │
-  │        "type": "input_file",  ────────── 文件附件
-  │        "file_id": "file_xxx"           │
-  │      },                                │
-  │      {                                 │
-  │        "type": "input_image", ────────── 图片上传
-  │        "image_url": "https://..."      │
-  │      }                                 │
-  │    ]                                   │
-  │  }                                     │
-  └─────────────────────────────────────────┘
-
-═══════════════════════════════════════════════════════
-  发送消息 (插件 → 平台)
-═══════════════════════════════════════════════════════
-
-  Topic: /v1.0/im/bot/messages
-
-  ┌─────────────────────────────────────────┐
-  │  {                                      │
-  │    "type": "MESSAGE",                   │
-  │    "headers": {                         │
-  │      "message-id": "msg_xxx",          │
-  │      "session-id": "sess_xxx"          │
-  │    },                                   │
-  │    "data": "<event_json>"  ───────────── Open Responses 事件 JSON
-  │  }                                      │
-  └─────────────────────────────────────────┘
-
-═══════════════════════════════════════════════════════
-  流式事件 (Open Responses 协议)
-═══════════════════════════════════════════════════════
-
-  ┌─ response.in_progress ─────────────────┐
-  │  { "type": "response.in_progress" }    │
-  └────────────────────────────────────────┘
-         │
-         ▼
-  ┌─ response.output_item.added ───────────┐
-  │  { "type": "response.output_item.added"│
-  │    "item": { "type": "message",        │
-  │              "role": "assistant" } }   │
-  └────────────────────────────────────────┘
-         │
-         ▼
-  ┌─ response.output_text.delta ───────────┐
-  │  { "type": "response.output_text.delta"│
-  │    "delta": "每50字符为一个chunk" }     │
-  │  × N 次                                │
-  └────────────────────────────────────────┘
-         │
-         ▼
-  ┌─ response.content_part.done ───────────┐
-  │  { "type": "response.content_part.done"│
-  │    "part": { "text": "完整响应文本" } } │
-  └────────────────────────────────────────┘
-         │
-         ▼
-  ┌─ response.completed ───────────────────┐
-  │  { "type": "response.completed",       │
-  │    "response": { "status": "completed"}│
-  └────────────────────────────────────────┘
-```
-
----
-
-## 6. 文件状态管理
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                      文件系统                                │
-│                                                              │
-│  .insta/                                                     │
-│  ├── config/                                                 │
-│  │   └── profile.json  ─────────────────────────────────┐  │
-│  │       {                                              │  │
-│  │         "app_key": "xxx",         ← 平台凭证         │  │
-│  │         "app_secret": "xxx",      ← 平台凭证         │  │
-│  │         "name": "AI助手",          ← 显示名称         │  │
-│  │         "description": "...",      ← 插件描述         │  │
-│  │         "avatar": "...",           ← 头像 URL         │  │
-│  │         "claw_id": "...",          ← 业务 ID          │  │
-│  │         "hourly_rate": 0,          ← 计费费率         │  │
-│  │         "scene_tags": [],          ← 场景标签         │  │
-│  │         "custom_tags": [],         ← 自定义标签       │  │
-│  │         "instance_type": "..."     ← 部署模式         │  │
-│  │       }                                              │  │
-│  │                                                       │  │
-│  └── .activate_session ──────────────────────────────────┤  │
-│      {                                                   │  │
-│        "session_token": "xxx"        ← 激活会话令牌      │  │
-│      }                                                   │  │
-│                                                          │  │
-└──────────────────────────────────────────────────────────┘  │
-                                                               │
-┌──────────────────────────────────────────────────────────┐  │
-│                   内存状态 (registration-store)           │  │
-│                                                           │  │
-│  _agentRunning: boolean     ── AI 注册代理是否运行中       │  │
-│  _pending: Proposal | null  ── 待确认的注册提案            │  │
-│  _baseDir: string | null    ── 缓存的基础目录             │  │
-│                                                           │  │
-│  activeConnections:         ── 活跃 WebSocket 连接        │◄─┘
-│    Map<accountId, WebSocket>                               │
-│                                                           │
-└───────────────────────────────────────────────────────────┘
-```
-
----
-
-## 7. 并发与错误处理
-
-```
-  ┌─────────────────────────────────────────────────────┐
-  │                   请求并发控制                        │
-  │                                                      │
-  │   最大并发: 10 个请求                                 │
-  │                                                      │
-  │   ┌─────┐  ┌─────┐  ┌─────┐                        │
-  │   │ Req │  │ Req │  │ Req │  ... 最多 10 个         │
-  │   │  1  │  │  2  │  │  3  │                        │
-  │   └──┬──┘  └──┬──┘  └──┬──┘                        │
-  │      │        │        │                             │
-  │      ▼        ▼        ▼                             │
-  │   各自独立的 RequestContext                          │
-  │   各自独立的 AbortController                         │
-  │   各自独立的超时控制                                 │
-  └─────────────────────────────────────────────────────┘
-
-  ┌─────────────────────────────────────────────────────┐
-  │                   错误处理策略                        │
-  │                                                      │
-  │  请求失败 ────→ 生成 error 事件 ──→ 发送至平台       │
-  │                   {                                  │
-  │                     "type": "response.failed",       │
-  │                     "error": {                       │
-  │                       "code": "...",                 │
-  │                       "message": "..."               │
-  │                     }                                │
-  │                   }                                  │
-  │                                                      │
-  │  连接中断 ────→ 触发重连 ──→ 指数退避重试             │
-  │                                                      │
-  │  注册失败 ────→ 清除状态 ──→ 下次轮询重新触发         │
-  │                                                      │
-  │  AI 超时  ────→ AbortController ──→ 返回错误事件     │
-  └─────────────────────────────────────────────────────┘
-```