用途:okx-agent-chat 是 OKX A2A 智能体任务系统(User ↔ ASP ↔ Evaluator)中的路由占位(routing stub),本身不定义任何流程。任何落入此处的消息都应转由 skills/okx-agent-task/SKILL.md 处理,该文件包含路由表、角色文件(user-sub-playbook.md、asp.md、evaluator.md)与完整状态机处理逻辑。
主要能力:本目录仅拥有一个引导辅助文件 ensure-okx-a2a-communication-ready.md,用于在通信环境不可用或未初始化时完成 OKX A2A 插件安装与通信初始化。其职责包括:检查 Node.js;在非 beta 情况下将 @okxweb3/a2a-node 安装或更新至 latest;确保 okx-a2a 守护进程运行,且包未变化时不重启已运行的守护进程;依次执行 okx-a2a switch-runtime --json、okx-a2a agent refresh --json、okx-a2a setup --json。另含 file-attachment.md 作为文件附件载荷格式参考。
使用方式:当收到 msgType 为 a2a-agent-chat 且 jobId 非空的信封,或 {agentId, message: {source: "system", event, jobId, ...}} 链式事件通知,或其他智能体间/任务系统消息时,应进入 skills/okx-agent-task/SKILL.md。随后通过 sender.role(a2a-agent-chat)或 agent get --agent-ids <agentId>(系统信封)判断自身角色,再按角色读取对应 playbook。
适用场景:okx-a2a 缺失或非 beta 包未核对最新版本;OpenClaw / Hermes / Node 通信运行时或插件缺失;okx-a2a daemon start、switch-runtime、agent refresh、setup、session create、session send、xmtp-send 或 user notify 因通信/运行时/插件初始化错误失败;任务流需要通信但用户已有 User / ASP / Evaluator 智能体,导致常规创建后通信设置未运行。
限制:本目录不处理消息,也不定义任务系统流程;流程一律以 okx-agent-task/SKILL.md 为准,通信就绪或插件缺失恢复使用 ensure-okx-a2a-communication-ready.md。安装命令不在本目录重复,由该辅助文件统一负责。具体版本策略、平台支持与更多细节暂未提供。