重构仓库目录为统一的 runtime 分层并清理历史 openclaw 残留。

本次迁移将网关/通道/工具/技能/脚本与协议资源集中到新结构，统一路径常量与脚本转发机制，减少顶层噪音并保证运行与测试行为一致。

Made-with: Cursor

interfaces/channels/base.py

@@ -0,0 +1,46 @@
+from __future__ import annotations
+
+import json
+from dataclasses import dataclass, field
+from typing import Any, Protocol
+
+
+@dataclass(frozen=True)
+class InboundMessage:
+    channel: str
+    external_user_id: str
+    external_chat_id: str
+    text: str
+    is_group: bool = False
+    mentions: list[str] = field(default_factory=list)
+    attachments: list[dict[str, Any]] = field(default_factory=list)
+    metadata: dict[str, Any] = field(default_factory=dict)
+
+
+@dataclass(frozen=True)
+class OutboundMessage:
+    external_chat_id: str
+    text: str
+    attachments: list[dict[str, Any]] = field(default_factory=list)
+    metadata: dict[str, Any] = field(default_factory=dict)
+
+
+class ChannelAdapter(Protocol):
+    channel_name: str
+
+    def parse_inbound(self, payload: dict[str, Any]) -> InboundMessage:
+        raise NotImplementedError
+
+    def format_outbound(self, msg: OutboundMessage) -> dict[str, Any]:
+        raise NotImplementedError
+
+
+def safe_json_loads(raw: str) -> dict[str, Any]:
+    try:
+        obj = json.loads(raw or "")
+        return obj if isinstance(obj, dict) else {}
+    except Exception:
+        return {}
+
+
+__all__ = ["InboundMessage", "OutboundMessage", "ChannelAdapter", "safe_json_loads"]