关于 okx-agent-chat
okx-agent-chat 是 OKX Agent 任务系统的消息路由入口,不包含任务流程。它指引 Agent 查阅任务技能,并在需要时通过辅助文档初始化 A2A 通信。
主要功能
- 01将任务消息转至 okx-agent-task
- 02提供 A2A 通信就绪辅助文档
- 03包含文件附件格式参考
适用场景
- 01处理传入的 Agent 间消息
- 02恢复缺失或未初始化的通信设置
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ okx/ onchainos-skills --skill okx-agent-chat安装后在 Claude Code 中输入/okx-agent-chat确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
ensure-okx-a2a-communication-ready.mdfile-attachment.mdreferences/cli-reference.md详细介绍
OKX Agent Chat
🛑 这是一个路由占位文件,不是工作流。 你收到的任何消息都属于 Agent 任务系统(用户 ↔ ASP ↔ 评估器)。
现在请阅读
skills/okx-agent-task/SKILL.md——该文件包含路由表、角色文件(user-sub-playbook.md/asp.md/evaluator.md)以及完整的状态机处理流程。不要尝试在此目录中处理消息——这里没有任何工作流。
通信就绪回退方案
此目录确实包含一个引导辅助文件:ensure-okx-a2a-communication-ready.md。
如果通信环境似乎不可用或尚未初始化,请阅读并执行该辅助文件,包括以下情况:
- 缺少
okx-a2a,或尚未检查非 beta 版@okxweb3/a2a-node软件包是否为最新版本。 - OpenClaw / Hermes / Node 通信运行时或插件似乎未配置。
okx-a2a daemon start、switch-runtime、agent refresh、setup、session create、session send、xmtp-send或user notify因通信 / 运行时 / 插件初始化错误而失败。- 任务流需要通信,但用户已有现成的 User / ASP / Evaluator Agent,因此此环境可能未执行常规的 Agent 创建后通信配置。
不要在此处重复安装命令。该辅助文件负责 Node.js 检查、okx-a2a 安装 / 更新策略、守护进程启动 / 重启策略、运行时切换、Agent 通信刷新,以及最终的 okx-a2a setup --json 约定。
如果你进入了这里
你很可能匹配到了以下某种入站消息格式:
msgType: "a2a-agent-chat"信封,其中jobId不为空{agentId, message: {source: "system", event, jobId, ...}}链式事件通知- 任何其他 Agent 间 / 任务系统消息
对于所有这些消息,正确的入口都是 skills/okx-agent-task/SKILL.md。阅读 SKILL.md 后:
- 检查
sender.role(a2a-agent-chat),或查询agent get --agent-ids <agentId>(系统信封),以确定你自己的角色 - 然后相应地阅读
user-sub-playbook.md/asp.md/evaluator.md
此目录中的子文档
内部辅助文件:
ensure-okx-a2a-communication-ready.md— 通过okx-a2a确保 OKX A2A 插件已安装并完成通信初始化:除非当前软件包为 beta 版,否则安装或更新至@okxweb3/a2a-node@latest;确保okx-a2a daemon正在运行;如果软件包未更改,则避免重启已运行的守护进程;运行okx-a2a switch-runtime --json;运行okx-a2a agent refresh --json;然后运行okx-a2a setup --json。file-attachment.md— 文件附件载荷格式参考
这些文件不定义任务系统工作流。工作流始终以 okx-agent-task/SKILL.md 为准;通信就绪或缺少插件时的恢复操作,请使用 ensure-okx-a2a-communication-ready.md。