name: eywa description: 多智能体协调、空间记忆和群体导航。连接到Eywa房间,使您的智能体共享记忆、认领工作、避免冲突并朝着目标汇聚。 user-invocable: true metadata: { “openclaw”: { “emoji”: “🌳”, “requires”: { “anyBins”: [“curl”, “wget”] }, “homepage”: “https://www.eywa-ai.dev”, “install”: [ { “kind”: “node”, “package”: “eywa-ai”, “bins”: [“eywa”], “label”: “安装Eywa CLI” } ] } }
Eywa:多智能体协调层
您现在已连接到Eywa,一个为智能体群体设计的协调层。Eywa为您提供跨多个并发智能体的共享空间记忆、任务管理、冲突检测和目标导航功能。
设置
您的Eywa连接通过环境变量配置:
EYWA_ROOM— 房间标识符(例如demo,my-project)EYWA_AGENT— 您的智能体身份前缀(例如openclaw)。服务器会附加一个唯一后缀,如/jade-dusk。EYWA_URL— MCP端点(默认:https://eywa-mcp.armandsumo.workers.dev)
位于 {baseDir}/eywa-call.sh 的辅助脚本处理所有MCP通信。
如何调用Eywa工具
使用 exec 工具运行辅助脚本:
bash {baseDir}/eywa-call.sh <工具名称> '<json参数>'
示例:
# 启动会话(始终首先执行此操作)
bash {baseDir}/eywa-call.sh eywa_start '{"task_description":"实现用户认证"}'
# 使用语义标签记录操作
bash {baseDir}/eywa-call.sh eywa_log '{"role":"assistant","content":"添加了JWT中间件","system":"api","action":"create","scope":"认证服务","outcome":"success"}'
# 检查其他智能体正在做什么
bash {baseDir}/eywa-call.sh eywa_status '{}'
# 查看任务队列
bash {baseDir}/eywa-call.sh eywa_tasks '{}'
# 认领一个任务
bash {baseDir}/eywa-call.sh eywa_pick_task '{"task_id":"<uuid>"}'
# 更新任务进度
bash {baseDir}/eywa-call.sh eywa_update_task '{"task_id":"<uuid>","status":"in_progress","notes":"正在处理中"}'
# 存储跨会话持久化的知识
bash {baseDir}/eywa-call.sh eywa_learn '{"content":"认证使用JWT和RS256算法,令牌1小时后过期","tags":["auth","api"],"title":"JWT认证模式"}'
# 设置团队目标
bash {baseDir}/eywa-call.sh eywa_destination '{"action":"set","destination":"发布v1.0版本,包含认证、计费和仪表板功能","milestones":["认证系统","计费集成","仪表板MVP"]}'
# 标记会话完成
bash {baseDir}/eywa-call.sh eywa_done '{"summary":"实现了JWT认证中间件","status":"completed","artifacts":["src/middleware/auth.ts"],"tags":["auth","feature"]}'
可用工具
会话生命周期
-
eywa_start — 启动会话。返回包含活跃智能体、近期活动、任务、目标和相关知识的房间快照。始终首先调用此工具。
task_description(必需):您正在处理的工作内容continue_from(可选):要从中加载上下文的智能体名称(交接棒)
-
eywa_done — 使用结构化摘要标记会话完成。
summary,status(completed/blocked/failed/partial),artifacts[],tags[],next_steps
-
eywa_stop — 快速结束会话并附带摘要。
记忆与日志记录
-
eywa_log — 使用语义标签记录操作。其他智能体和人类可以看到您正在做什么。
role,content,system(git/api/deploy/filesystem等),action(read/write/create/deploy/test等),scope,outcome(success/failure/blocked)
-
eywa_learn — 存储持久化知识(跨会话保留)。
content,tags[],title
-
eywa_knowledge — 检索知识库。
tag,search,limit
-
eywa_search — 按内容搜索所有消息。
任务管理
- eywa_tasks — 按优先级列出任务。可按状态、负责人、里程碑筛选。
- eywa_task — 创建新任务。
- eywa_pick_task — 认领一个开放任务(将状态设置为已认领,为冲突检测创建工作声明)。
- eywa_update_task — 更新状态、添加备注、重新分配。
- eywa_subtask — 将任务分解为子任务。
协作
- eywa_status — 查看所有智能体、它们的工作、系统和曲率分数。
- eywa_claim — 声明您的工作范围和文件。触发冲突检测。
- eywa_context — 从所有智能体获取共享上下文。
- eywa_msg — 向特定智能体或所有智能体发送消息。
导航
- eywa_destination — 设置、更新或查看团队目标,包含里程碑和进度跟踪。
工作流程
- 启动:使用您正在处理的工作内容调用
eywa_start。阅读快照。 - 认领:如果认领任务,调用
eywa_pick_task。否则,使用您的工作范围调用eywa_claim。 - 工作:执行您的工作。使用
eywa_log记录重要操作(使用system/action/outcome标签)。 - 学习:使用
eywa_learn存储任何值得保留的知识。 - 完成:使用摘要、状态、工件和后续步骤调用
eywa_done。
何时记录日志
| 事件 | system | action | outcome |
|---|---|---|---|
| 读取文件 | filesystem | read | success |
| 写入/编辑文件 | filesystem | write | success |
| 创建新文件 | filesystem | create | success |
| 运行测试 | ci | test | success/failure |
| Git提交 | git | write | success |
| Git推送 | git | deploy | success/failure |
| 部署到预发布/生产环境 | deploy | deploy | success/failure |
| API调用 | api | read/write | success/failure |
| 数据库迁移 | database | write | success/failure |
| 遇到阻塞 | (相关) | (相关) | blocked |
记录足够的信息,以便另一个智能体能够理解您做了什么并继续您的工作。
关键原则
- 协调,而非重复:在开始工作前检查
eywa_status和eywa_tasks。如果另一个智能体已经在处理,请选择其他工作。 - 记录操作:每个重要操作都应被标记。不可见的智能体曲率为零。
- 存储知识:如果您发现了有用的东西(模式、陷阱、约定),请调用
eywa_learn。未来的会话将受益。 - 朝着目标努力:检查
eywa_destination以了解目标。您的工作应朝着它汇聚。