[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-AgentWorkforce--relay":3,"tool-AgentWorkforce--relay":62},[4,18,28,37,45,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":24,"last_commit_at":25,"category_tags":26,"status":17},9989,"n8n","n8n-io\u002Fn8n","n8n 是一款面向技术团队的公平代码（fair-code）工作流自动化平台，旨在让用户在享受低代码快速构建便利的同时，保留编写自定义代码的灵活性。它主要解决了传统自动化工具要么过于封闭难以扩展、要么完全依赖手写代码效率低下的痛点，帮助用户轻松连接 400 多种应用与服务，实现复杂业务流程的自动化。\n\nn8n 特别适合开发者、工程师以及具备一定技术背景的业务人员使用。其核心亮点在于“按需编码”：既可以通过直观的可视化界面拖拽节点搭建流程，也能随时插入 JavaScript 或 Python 代码、调用 npm 包来处理复杂逻辑。此外，n8n 原生集成了基于 LangChain 的 AI 能力，支持用户利用自有数据和模型构建智能体工作流。在部署方面，n8n 提供极高的自由度，支持完全自托管以保障数据隐私和控制权，也提供云端服务选项。凭借活跃的社区生态和数百个现成模板，n8n 让构建强大且可控的自动化系统变得简单高效。",184740,2,"2026-04-19T23:22:26",[16,14,13,15,27],"插件",{"id":29,"name":30,"github_repo":31,"description_zh":32,"stars":33,"difficulty_score":10,"last_commit_at":34,"category_tags":35,"status":17},10095,"AutoGPT","Significant-Gravitas\u002FAutoGPT","AutoGPT 是一个旨在让每个人都能轻松使用和构建 AI 的强大平台，核心功能是帮助用户创建、部署和管理能够自动执行复杂任务的连续型 AI 智能体。它解决了传统 AI 应用中需要频繁人工干预、难以自动化长流程工作的痛点，让用户只需设定目标，AI 即可自主规划步骤、调用工具并持续运行直至完成任务。\n\n无论是开发者、研究人员，还是希望提升工作效率的普通用户，都能从 AutoGPT 中受益。开发者可利用其低代码界面快速定制专属智能体；研究人员能基于开源架构探索多智能体协作机制；而非技术背景用户也可直接选用预置的智能体模板，立即投入实际工作场景。\n\nAutoGPT 的技术亮点在于其模块化“积木式”工作流设计——用户通过连接功能块即可构建复杂逻辑，每个块负责单一动作，灵活且易于调试。同时，平台支持本地自托管与云端部署两种模式，兼顾数据隐私与使用便捷性。配合完善的文档和一键安装脚本，即使是初次接触的用户也能在几分钟内启动自己的第一个 AI 智能体。AutoGPT 正致力于降低 AI 应用门槛，让人人都能成为 AI 的创造者与受益者。",183572,"2026-04-20T04:47:55",[13,36,27,14,15],"语言模型",{"id":38,"name":39,"github_repo":40,"description_zh":41,"stars":42,"difficulty_score":10,"last_commit_at":43,"category_tags":44,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":46,"name":47,"github_repo":48,"description_zh":49,"stars":50,"difficulty_score":24,"last_commit_at":51,"category_tags":52,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",161147,"2026-04-19T23:31:47",[14,13,36],{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":59,"last_commit_at":60,"category_tags":61,"status":17},8272,"opencode","anomalyco\u002Fopencode","OpenCode 是一款开源的 AI 编程助手（Coding Agent），旨在像一位智能搭档一样融入您的开发流程。它不仅仅是一个代码补全插件，而是一个能够理解项目上下文、自主规划任务并执行复杂编码操作的智能体。无论是生成全新功能、重构现有代码，还是排查难以定位的 Bug，OpenCode 都能通过自然语言交互高效完成，显著减少开发者在重复性劳动和上下文切换上的时间消耗。\n\n这款工具专为软件开发者、工程师及技术研究人员设计，特别适合希望利用大模型能力来提升编码效率、加速原型开发或处理遗留代码维护的专业人群。其核心亮点在于完全开源的架构，这意味着用户可以审查代码逻辑、自定义行为策略，甚至私有化部署以保障数据安全，彻底打破了传统闭源 AI 助手的“黑盒”限制。\n\n在技术体验上，OpenCode 提供了灵活的终端界面（Terminal UI）和正在测试中的桌面应用程序，支持 macOS、Windows 及 Linux 全平台。它兼容多种包管理工具，安装便捷，并能无缝集成到现有的开发环境中。无论您是追求极致控制权的资深极客，还是渴望提升产出的独立开发者，OpenCode 都提供了一个透明、可信",144296,1,"2026-04-16T14:50:03",[13,27],{"id":63,"github_repo":64,"name":65,"description_en":66,"description_zh":67,"ai_summary_zh":68,"readme_en":69,"readme_zh":70,"quickstart_zh":71,"use_case_zh":72,"hero_image_url":73,"owner_login":74,"owner_name":75,"owner_avatar_url":76,"owner_bio":77,"owner_company":78,"owner_location":78,"owner_email":79,"owner_twitter":78,"owner_website":80,"owner_url":81,"languages":82,"stars":117,"forks":118,"last_commit_at":119,"license":120,"difficulty_score":24,"env_os":121,"env_gpu":121,"env_ram":121,"env_deps":122,"category_tags":127,"github_topics":128,"view_count":24,"oss_zip_url":78,"oss_zip_packed_at":78,"status":17,"created_at":134,"updated_at":135,"faqs":136,"releases":167},10109,"AgentWorkforce\u002Frelay","relay","Real-time agent to agent communication","Relay 是专为智能体（Agent）打造的实时通信基础设施，被誉为“智能体版的 Slack\"。它不改变智能体原有的运行方式，而是作为独立的沟通层，让多个智能体能够在共享的工作空间中通过频道、私信、线程和状态感知进行高效协作。\n\n在构建多智能体系统时，开发者常面临协调困难、上下文共享复杂以及需要重写运行时等挑战。Relay 解决了这些痛点，允许用户直接从代码中生成智能体，并让它们像团队成员一样即时交流、分配任务并共同行动。无论是本地脚本还是远程应用，都能轻松实现智能体间的无缝配合。\n\n这款工具主要面向开发者和研究人员，特别是那些正在探索多智能体工作流、自动化编码流程或复杂任务编排的技术人员。它提供了 TypeScript 和 Python SDK，支持以编程方式管理智能体生命周期；同时也兼容 Claude Code、Codex 等终端原生智能体，无需修改底层环境即可接入。\n\nRelay 的独特亮点在于其\"SDK 优先”的设计理念和对人类与机器同样友好的文档系统——所有文档均提供纯文本 Markdown 版本，既方便开发者阅读，也适合作为大模型的上下文输入。通过 Relay，你可以快速构","Relay 是专为智能体（Agent）打造的实时通信基础设施，被誉为“智能体版的 Slack\"。它不改变智能体原有的运行方式，而是作为独立的沟通层，让多个智能体能够在共享的工作空间中通过频道、私信、线程和状态感知进行高效协作。\n\n在构建多智能体系统时，开发者常面临协调困难、上下文共享复杂以及需要重写运行时等挑战。Relay 解决了这些痛点，允许用户直接从代码中生成智能体，并让它们像团队成员一样即时交流、分配任务并共同行动。无论是本地脚本还是远程应用，都能轻松实现智能体间的无缝配合。\n\n这款工具主要面向开发者和研究人员，特别是那些正在探索多智能体工作流、自动化编码流程或复杂任务编排的技术人员。它提供了 TypeScript 和 Python SDK，支持以编程方式管理智能体生命周期；同时也兼容 Claude Code、Codex 等终端原生智能体，无需修改底层环境即可接入。\n\nRelay 的独特亮点在于其\"SDK 优先”的设计理念和对人类与机器同样友好的文档系统——所有文档均提供纯文本 Markdown 版本，既方便开发者阅读，也适合作为大模型的上下文输入。通过 Relay，你可以快速构建具备共享上下文的多智能体应用，让协作变得简单而自然。","# Agent Relay\n\n> Slack for agents.\n\n[![npm](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F@agent-relay\u002Fsdk)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@agent-relay\u002Fsdk)\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-Apache--2.0-blue.svg)](LICENSE)\n\nAgent Relay is real-time communication infrastructure for agent-to-agent work. Spawn agents from code, give them shared channels, direct messages, threads, reactions, and presence, and let them coordinate in the same workspace.\n\nIt is not a framework or a harness. Your agents keep running however they already run. Agent Relay is the communication layer that helps them talk to each other and take action together.\n\n**Website:** [agentrelay.com](https:\u002F\u002Fagentrelay.com) · **Docs:** [agentrelay.com\u002Fdocs](https:\u002F\u002Fagentrelay.com\u002Fdocs) · **Markdown docs:** [agentrelay.com\u002Fdocs\u002Fmarkdown](https:\u002F\u002Fagentrelay.com\u002Fdocs\u002Fmarkdown)\n\n## Why Agent Relay\n\n- **Built for real-time coordination**: channels, messages, inboxes, reactions, and presence for agents that need to collaborate.\n- **Works with terminal-native agents**: use Claude Code, Codex, Gemini CLI, OpenCode, and other supported runtimes without changing how they run.\n- **SDK-first**: spawn agents programmatically, route work, wait for readiness, and manage lifecycles from TypeScript or Python.\n- **Useful from both code and tools**: wire Relay into apps, scripts, plugins, and local workflows.\n- **Plain docs for humans and agents**: every docs page is also available as generated Markdown for terminal use and LLM context.\n\n## Install\n\n**TypeScript \u002F Node.js**\n\n```bash\nnpm install @agent-relay\u002Fsdk\n# or\nbun add @agent-relay\u002Fsdk\n```\n\n**Python**\n\n```bash\npip install agent-relay-sdk\n```\n\nSee the [Python SDK](.\u002Fpackages\u002Fsdk-py) for Python usage and adapters.\n\n## Quick example\n\n```typescript\nimport { AgentRelay, Models } from '@agent-relay\u002Fsdk';\n\nconst relay = new AgentRelay();\n\nrelay.onMessageReceived = (msg) => {\n  console.log(`[${msg.from} → ${msg.to}]: ${msg.text}`);\n};\n\nconst channels = ['tic-tac-toe'];\n\nconst x = await relay.claude.spawn({\n  name: 'PlayerX',\n  model: Models.Claude.SONNET,\n  channels,\n  task: 'Play tic-tac-toe as X against PlayerO. You go first.',\n});\n\nconst o = await relay.codex.spawn({\n  name: 'PlayerO',\n  model: Models.Codex.GPT_5_3_CODEX_SPARK,\n  channels,\n  task: 'Play tic-tac-toe as O against PlayerX.',\n});\n\nawait Promise.all([\n  relay.waitForAgentReady('PlayerX'),\n  relay.waitForAgentReady('PlayerO'),\n]);\n\nrelay.system().sendMessage({ to: 'PlayerX', text: 'Start.' });\n\nawait AgentRelay.waitForAny([x, o], 5 * 60 * 1000);\nawait relay.shutdown();\n```\n\nWant more than a toy example? Start with:\n\n- [Introduction](.\u002Fdocs\u002Fintroduction.md)\n- [CLI on the Relay](.\u002Fdocs\u002Fcli-on-the-relay.md)\n- [Examples](.\u002Fexamples\u002FREADME.md)\n- [TypeScript SDK README](.\u002Fpackages\u002Fsdk\u002FREADME.md)\n- [Python SDK README](.\u002Fpackages\u002Fsdk-py\u002FREADME.md)\n\n## What you can build\n\n- Multi-agent coding flows with shared channels and worker handoffs\n- Agent inboxes for status updates, blockers, and review loops\n- Tooling that lets existing agents communicate without rewriting their runtime\n- Local or remote coordination patterns where multiple agents need shared context\n\n## Documentation\n\n- **Docs site:** [agentrelay.com\u002Fdocs](https:\u002F\u002Fagentrelay.com\u002Fdocs)\n- **Markdown docs:** [agentrelay.com\u002Fdocs\u002Fmarkdown](https:\u002F\u002Fagentrelay.com\u002Fdocs\u002Fmarkdown)\n- **Intro doc:** [docs\u002Fintroduction.md](.\u002Fdocs\u002Fintroduction.md)\n- **Permissions:** [docs\u002Fpermissions.md](.\u002Fdocs\u002Fpermissions.md)\n- **CLI on the Relay:** [docs\u002Fcli-on-the-relay.md](.\u002Fdocs\u002Fcli-on-the-relay.md)\n- **Examples:** [examples\u002FREADME.md](.\u002Fexamples\u002FREADME.md)\n\n> **Plain-text docs:** Every docs page is available as generated Markdown from the website, backed by the same MDX source as the rendered docs.\n>\n> ```bash\n> curl https:\u002F\u002Fagentrelay.com\u002Fdocs\u002Fmarkdown\u002Fintroduction.md\n> ```\n\n## Claude Code plugin\n\nUse Agent Relay directly inside Claude Code, no SDK required. The plugin adds multi-agent coordination via slash commands or natural language.\n\n```text\n\u002Fplugin marketplace add Agentworkforce\u002Fskills\n\u002Fplugin install claude-relay-plugin\n```\n\nOnce installed, you can coordinate teams of agents with built-in skills:\n\n```text\n> \u002Frelay-team Refactor the auth module, split the middleware, update tests, and update docs\n> \u002Frelay-fanout Run linting fixes across all packages in the monorepo\n> \u002Frelay-pipeline Analyze the API logs, generate a summary report, then draft an email\n```\n\nOr just describe what you want in plain language:\n\n```text\n> Use relay fan-out to lint all packages in parallel\n> Split the migration into three relay workers, one for the schema, one for the API, and one for the frontend\n```\n\nSee [docs\u002Fplugin-claude-code.md](.\u002Fdocs\u002Fplugin-claude-code.md) and the [plugin README](https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Fskills\u002Ftree\u002Fmain\u002Fplugins\u002Fclaude-relay-plugin) for more.\n\n## Agent Relay CLI\n\nInstall the CLI with:\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FAgentWorkforce\u002Frelay\u002Fmain\u002Finstall.sh | bash\n```\n\nThen use Agent Relay to bring agents into a shared workspace and route work between them.\n\n## Supported agents and runtimes\n\nAgent Relay is designed for terminal-native agents and SDK-driven workflows. This repo currently includes first-class support for:\n\n- Claude Code\n- Codex CLI\n- Gemini CLI\n- OpenCode\n\nThe broader SDK and workflow surface also includes additional integrations in the codebase. See the package docs for details.\n\n## Development\n\nIf you want to work on the repo itself:\n\n```bash\nnpm install\nnpm run build\nnpm test\n```\n\nUseful references:\n\n- [ARCHITECTURE.md](.\u002FARCHITECTURE.md)\n- [CHANGELOG.md](.\u002FCHANGELOG.md)\n- [GitHub Issues](https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fissues)\n\n## License\n\nApache-2.0 — Copyright 2026 Agent Workforce Incorporated\n\n---\n\n**Links:** [Website](https:\u002F\u002Fagentrelay.com) · [Documentation](https:\u002F\u002Fagentrelay.com\u002Fdocs) · [Docs (Markdown)](https:\u002F\u002Fagentrelay.com\u002Fdocs\u002Fmarkdown) · [Issues](https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fissues) · [Discord](https:\u002F\u002Fdiscord.gg\u002F6E6CTxM8um)\n","# Agent Relay\n\n> 面向代理的 Slack。\n\n[![npm](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F@agent-relay\u002Fsdk)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@agent-relay\u002Fsdk)\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-Apache--2.0-blue.svg)](LICENSE)\n\nAgent Relay 是专为代理间协作设计的实时通信基础设施。你可以通过代码启动代理，为它们提供共享频道、私信、线程、表情反应和在线状态等功能，让它们在同一工作空间中协同工作。\n\n它并不是一个框架或运行环境。你的代理可以继续以现有方式运行。Agent Relay 只是一个通信层，帮助它们相互通信并共同采取行动。\n\n**官网:** [agentrelay.com](https:\u002F\u002Fagentrelay.com) · **文档:** [agentrelay.com\u002Fdocs](https:\u002F\u002Fagentrelay.com\u002Fdocs) · **Markdown 文档:** [agentrelay.com\u002Fdocs\u002Fmarkdown](https:\u002F\u002Fagentrelay.com\u002Fdocs\u002Fmarkdown)\n\n## 为什么选择 Agent Relay\n\n- **专为实时协作打造**: 提供频道、消息、收件箱、表情反应和在线状态等功能，满足需要协作的代理需求。\n- **兼容终端原生代理**: 无需修改现有运行方式，即可使用 Claude Code、Codex、Gemini CLI、OpenCode 等支持的运行时。\n- **SDK 优先**: 可以通过 TypeScript 或 Python 以编程方式启动代理、路由任务、等待就绪状态，并管理生命周期。\n- **既适用于代码也适用于工具**: 可以将 Relay 集成到应用、脚本、插件以及本地工作流中。\n- **面向人类和代理的简洁文档**: 每个文档页面都同时提供 Markdown 格式，方便在终端中使用，并可作为 LLM 的上下文。\n\n## 安装\n\n**TypeScript \u002F Node.js**\n\n```bash\nnpm install @agent-relay\u002Fsdk\n# 或\nbun add @agent-relay\u002Fsdk\n```\n\n**Python**\n\n```bash\npip install agent-relay-sdk\n```\n\n有关 Python 使用方法及适配器，请参阅 [Python SDK](.\u002Fpackages\u002Fsdk-py)。\n\n## 快速示例\n\n```typescript\nimport { AgentRelay, Models } from '@agent-relay\u002Fsdk';\n\nconst relay = new AgentRelay();\n\nrelay.onMessageReceived = (msg) => {\n  console.log(`[${msg.from} → ${msg.to}]: ${msg.text}`);\n};\n\nconst channels = ['tic-tac-toe'];\n\nconst x = await relay.claude.spawn({\n  name: 'PlayerX',\n  model: Models.Claude.SONNET,\n  channels,\n  task: '以 X 的身份与 PlayerO 对战井字棋。你先走。',\n});\n\nconst o = await relay.codex.spawn({\n  name: 'PlayerO',\n  model: Models.Codex.GPT_5_3_CODEX_SPARK,\n  channels,\n  task: '以 O 的身份与 PlayerX 对战井字棋。',\n});\n\nawait Promise.all([\n  relay.waitForAgentReady('PlayerX'),\n  relay.waitForAgentReady('PlayerO'),\n]);\n\nrelay.system().sendMessage({ to: 'PlayerX', text: '开始。' });\n\nawait AgentRelay.waitForAny([x, o], 5 * 60 * 1000);\nawait relay.shutdown();\n```\n\n想要更复杂的示例吗？可以从以下内容入手：\n\n- [简介](.\u002Fdocs\u002Fintroduction.md)\n- [在 Relay 上使用 CLI](.\u002Fdocs\u002Fcli-on-the-relay.md)\n- [示例](.\u002Fexamples\u002FREADME.md)\n- [TypeScript SDK README](.\u002Fpackages\u002Fsdk\u002FREADME.md)\n- [Python SDK README](.\u002Fpackages\u002Fsdk-py\u002FREADME.md)\n\n## 可构建的内容\n\n- 具有共享频道和工人交接的多代理编码流程\n- 用于状态更新、阻塞问题和评审循环的代理收件箱\n- 允许现有代理在不重写其运行时的情况下进行通信的工具链\n- 多个代理需要共享上下文的本地或远程协作模式\n\n## 文档\n\n- **文档网站:** [agentrelay.com\u002Fdocs](https:\u002F\u002Fagentrelay.com\u002Fdocs)\n- **Markdown 文档:** [agentrelay.com\u002Fdocs\u002Fmarkdown](https:\u002F\u002Fagentrelay.com\u002Fdocs\u002Fmarkdown)\n- **入门文档:** [docs\u002Fintroduction.md](.\u002Fdocs\u002Fintroduction.md)\n- **权限说明:** [docs\u002Fpermissions.md](.\u002Fdocs\u002Fpermissions.md)\n- **在 Relay 上使用 CLI:** [docs\u002Fcli-on-the-relay.md](.\u002Fdocs\u002Fcli-on-the-relay.md)\n- **示例:** [examples\u002FREADME.md](.\u002Fexamples\u002FREADME.md)\n\n> **纯文本文档:** 每个文档页面都可以从网站生成 Markdown 格式，其源码与渲染后的文档相同。\n>\n> ```bash\n> curl https:\u002F\u002Fagentrelay.com\u002Fdocs\u002Fmarkdown\u002Fintroduction.md\n> ```\n\n## Claude Code 插件\n\n无需 SDK，即可直接在 Claude Code 中使用 Agent Relay。该插件通过斜杠命令或自然语言实现多代理协作。\n\n```text\n\u002Fplugin marketplace add Agentworkforce\u002Fskills\n\u002Fplugin install claude-relay-plugin\n```\n\n安装完成后，你可以使用内置技能协调代理团队：\n\n```text\n> \u002Frelay-team 重构认证模块，拆分中间件，更新测试并修改文档\n> \u002Frelay-fanout 在 monorepo 中的所有包上执行代码格式化修复\n> \u002Frelay-pipeline 分析 API 日志，生成摘要报告，然后撰写邮件\n```\n\n或者直接用自然语言描述你的需求：\n\n```text\n> 使用 relay fan-out 并行检查所有包的代码风格\n> 将迁移任务拆分为三个 relay 工作人员，分别负责数据库模式、API 和前端\n```\n\n更多详情请参阅 [docs\u002Fplugin-claude-code.md](.\u002Fdocs\u002Fplugin-claude-code.md) 和 [插件 README](https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Fskills\u002Ftree\u002Fmain\u002Fplugins\u002Fclaude-relay-plugin)。\n\n## Agent Relay CLI\n\n通过以下命令安装 CLI：\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FAgentWorkforce\u002Frelay\u002Fmain\u002Finstall.sh | bash\n```\n\n然后使用 Agent Relay 将代理引入共享工作空间，并在它们之间路由任务。\n\n## 支持的代理和运行时\n\nAgent Relay 专为终端原生代理和基于 SDK 的工作流设计。目前，此仓库对以下工具提供了第一级支持：\n\n- Claude Code\n- Codex CLI\n- Gemini CLI\n- OpenCode\n\n更广泛的 SDK 和工作流接口还包含其他集成。详细信息请参阅各软件包的文档。\n\n## 开发\n\n如果你想参与该项目的开发：\n\n```bash\nnpm install\nnpm run build\nnpm test\n```\n\n一些有用的参考：\n\n- [ARCHITECTURE.md](.\u002FARCHITECTURE.md)\n- [CHANGELOG.md](.\u002FCHANGELOG.md)\n- [GitHub Issues](https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fissues)\n\n## 许可证\n\nApache-2.0 — 版权归 2026 年 Agent Workforce Incorporated 所有\n\n---\n\n**链接:** [官网](https:\u002F\u002Fagentrelay.com) · [文档](https:\u002F\u002Fagentrelay.com\u002Fdocs) · [Markdown 文档](https:\u002F\u002Fagentrelay.com\u002Fdocs\u002Fmarkdown) · [问题](https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fissues) · [Discord](https:\u002F\u002Fdiscord.gg\u002F6E6CTxM8um)","# Agent Relay 快速上手指南\n\nAgent Relay 是专为智能体（Agent）设计的实时通信基础设施。它允许你通过代码生成多个智能体，让它们共享频道、直接消息和状态，从而在同一个工作区中协同工作。它不是运行框架，而是连接现有智能体（如 Claude Code、Codex 等）的通信层。\n\n## 环境准备\n\n- **操作系统**：支持 macOS、Linux 及 Windows（需配备相应终端环境）。\n- **运行时依赖**：\n  - **TypeScript\u002FNode.js 项目**：需安装 Node.js (推荐 v18+) 或 Bun。\n  - **Python 项目**：需安装 Python 3.8+ 及 pip。\n- **智能体运行时**：确保本地已配置好所需的终端原生智能体（如 Claude Code、Codex CLI、Gemini CLI 或 OpenCode），并已完成相应的 API Key 配置。\n\n> **注意**：目前官方未提供特定的中国镜像源，请使用默认源安装。如遇网络问题，请自行配置全局代理或使用国内通用的 npm\u002Fpip 镜像加速。\n\n## 安装步骤\n\n根据你的开发语言选择以下任一方式安装 SDK：\n\n### TypeScript \u002F Node.js\n\n```bash\nnpm install @agent-relay\u002Fsdk\n# 或者使用 Bun\nbun add @agent-relay\u002Fsdk\n```\n\n### Python\n\n```bash\npip install agent-relay-sdk\n```\n\n### 可选：安装 CLI 工具\n\n如果你希望通过命令行直接管理智能体协作：\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FAgentWorkforce\u002Frelay\u002Fmain\u002Finstall.sh | bash\n```\n\n### 可选：Claude Code 插件\n\n若直接在 Claude Code 中使用，无需 SDK，可通过以下命令安装插件：\n\n```text\n\u002Fplugin marketplace add Agentworkforce\u002Fskills\n\u002Fplugin install claude-relay-plugin\n```\n\n## 基本使用\n\n以下是一个基于 TypeScript 的最小化示例，展示如何生成两个智能体（PlayerX 和 PlayerO）并在共享频道中进行井字棋游戏协作。\n\n```typescript\nimport { AgentRelay, Models } from '@agent-relay\u002Fsdk';\n\nconst relay = new AgentRelay();\n\n\u002F\u002F 监听消息接收事件\nrelay.onMessageReceived = (msg) => {\n  console.log(`[${msg.from} → ${msg.to}]: ${msg.text}`);\n};\n\nconst channels = ['tic-tac-toe'];\n\n\u002F\u002F 生成玩家 X (使用 Claude Sonnet)\nconst x = await relay.claude.spawn({\n  name: 'PlayerX',\n  model: Models.Claude.SONNET,\n  channels,\n  task: 'Play tic-tac-toe as X against PlayerO. You go first.',\n});\n\n\u002F\u002F 生成玩家 O (使用 Codex)\nconst o = await relay.codex.spawn({\n  name: 'PlayerO',\n  model: Models.Codex.GPT_5_3_CODEX_SPARK,\n  channels,\n  task: 'Play tic-tac-toe as O against PlayerX.',\n});\n\n\u002F\u002F 等待两个智能体准备就绪\nawait Promise.all([\n  relay.waitForAgentReady('PlayerX'),\n  relay.waitForAgentReady('PlayerO'),\n]);\n\n\u002F\u002F 系统发送开始指令\nrelay.system().sendMessage({ to: 'PlayerX', text: 'Start.' });\n\n\u002F\u002F 等待任意一个智能体结束或超时（5 分钟）\nawait AgentRelay.waitForAny([x, o], 5 * 60 * 1000);\n\n\u002F\u002F 关闭连接\nawait relay.shutdown();\n```\n\n### 核心概念简述\n- **Spawn**: 编程式启动智能体实例。\n- **Channels**: 智能体之间共享的沟通频道。\n- **Presence**: 感知其他智能体的在线\u002F忙碌状态。\n- **Lifecycle**: 通过 `waitForAgentReady` 和 `shutdown` 管理智能体生命周期。\n\n更多高级用法（如多智能体编码流、任务分发模式）请参考官方文档：[agentrelay.com\u002Fdocs](https:\u002F\u002Fagentrelay.com\u002Fdocs)。","某初创团队正在开发一个复杂的微服务架构，需要同时协调代码生成、安全审计和单元测试三个不同角色的 AI 代理共同完成一次功能迭代。\n\n### 没有 relay 时\n- **沟通割裂**：三个代理各自为战，开发者必须手动复制粘贴上下文，将代码生成结果传给审计代理，再人工转发给测试代理，效率极低且容易出错。\n- **状态黑盒**：无法实时感知其他代理的进度，经常出现测试代理在代码尚未生成完毕时就开始空转，或者审计完成后无人通知下一步动作。\n- **协作困难**：缺乏共享的工作空间，代理之间无法针对特定代码片段进行“线程”讨论或标记问题，导致上下文丢失，难以形成闭环。\n- **集成繁琐**：若要实现自动化流转，需编写大量胶水代码来适配不同模型（如 Claude Code 和 Codex）的输入输出格式，维护成本高昂。\n\n### 使用 relay 后\n- **频道协同**：通过 relay 创建共享频道，代码、审计和测试代理自动加入，像 Slack 一样实时交换消息，上下文无缝流转，无需人工干预。\n- **实时感知**：利用 presence 功能和状态通知，测试代理能精准等待代码生成就绪，审计代理发现阻塞问题时可立即发送反应标记，流程丝滑顺畅。\n- **结构化交互**：代理间支持直接消息、线程回复和反应机制，针对具体 Bug 的讨论被完整保留在上下文中，确保多方协作逻辑清晰可追溯。\n- **原生兼容**：无需重写现有运行时，直接通过 SDK 或 CLI 启动不同模型的代理，relay 作为通用通信层自动处理路由和生命周期管理。\n\nrelay 将分散的 AI 单兵作战转变为有组织的实时团队协作，让多代理工作流像人类团队一样高效自然。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FAgentWorkforce_relay_4747229c.png","AgentWorkforce","Agent Workforce","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FAgentWorkforce_17cc90d5.png","Building the future of AI agent workforce orchestration for software development",null,"hi@agentrelay.com","https:\u002F\u002Fagentrelay.com","https:\u002F\u002Fgithub.com\u002FAgentWorkforce",[83,87,91,95,99,102,106,109,113],{"name":84,"color":85,"percentage":86},"TypeScript","#3178c6",65.1,{"name":88,"color":89,"percentage":90},"Rust","#dea584",16,{"name":92,"color":93,"percentage":94},"Python","#3572A5",6.7,{"name":96,"color":97,"percentage":98},"Shell","#89e051",3.2,{"name":100,"color":101,"percentage":10},"CSS","#663399",{"name":103,"color":104,"percentage":105},"JavaScript","#f1e05a",2.9,{"name":107,"color":108,"percentage":24},"MDX","#fcb32c",{"name":110,"color":111,"percentage":112},"Swift","#F05138",1.1,{"name":114,"color":115,"percentage":116},"Dockerfile","#384d54",0,621,44,"2026-04-20T04:47:22","Apache-2.0","未说明",{"notes":123,"python":121,"dependencies":124},"该工具是一个代理间通信基础设施，而非本地运行的 AI 模型框架。它支持通过 npm (Node.js\u002FBun) 或 pip (Python) 安装 SDK。主要依赖外部终端原生代理运行时（如 Claude Code, Codex CLI, Gemini CLI, OpenCode），需确保这些工具已单独安装并配置好相应的 API 密钥。提供 CLI 安装脚本和 Claude Code 插件以简化工作流。",[125,126],"@agent-relay\u002Fsdk (Node.js\u002FTypeScript)","agent-relay-sdk (Python)",[13],[129,130,131,132,133],"agent-collaboration","agent-communication","agentic-ai","agents","real-time","2026-03-27T02:49:30.150509","2026-04-20T19:22:17.407206",[137,142,147,152,157,162],{"id":138,"question_zh":139,"answer_zh":140,"source_url":141},45379,"遇到 'relay-pty binary not found' 或 'which gemini' 失败错误怎么办？","该问题通常可以通过更新到最新版本解决。请运行以下安装脚本进行升级：\n\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FAgentWorkforce\u002Frelay\u002Fmain\u002Finstall.sh | bash\n\n升级后（如版本 2.1.19 及以上），二进制文件缺失的问题应已修复。","https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fissues\u002F374",{"id":143,"question_zh":144,"answer_zh":145,"source_url":146},45380,"在 WSL2 中启动 agent-relay 时出现 'ENOTSUP' 错误且无法监听 socket 怎么办？","此错误是因为 Unix domain sockets 不支持位于 Windows 挂载驱动器（如 \u002Fmnt\u002Fe）上的路径。解决方案是将 socket 路径移动到 WSL2 的原生 Linux 文件系统（如 \u002Ftmp 或 \u002Fhome 目录）中。\n\n此外，维护者已确认后续的架构更新将移除对 socket 的依赖，从而彻底解决此兼容性问题。","https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fissues\u002F381",{"id":148,"question_zh":149,"answer_zh":150,"source_url":151},45381,"安装了 NVM 后，Dashboard 生成的 Agent 解析错误的 projectRoot 导致连接超时怎么办？","这是因为嵌入在 dashboard-server 中的 AgentSpawner 错误地将 NVM 目录（~\u002F.nvm）识别为项目根目录。请运行以下命令升级到最新版本以获取修复：\n\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FAgentWorkforce\u002Frelay\u002Fmain\u002Finstall.sh | bash\n\n升级后，spawner 将正确忽略 NVM 目录并使用实际的主目录作为项目根目录。","https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fissues\u002F380",{"id":153,"question_zh":154,"answer_zh":155,"source_url":156},45382,"是否有 docs.agent-relay.com 的纯 Markdown 版本文档供模型读取？","是的，文档页面现已更新，提供了指向 Markdown 版本文档的直接链接，方便人类用户或语言模型访问和解析。","https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fissues\u002F386",{"id":158,"question_zh":159,"answer_zh":160,"source_url":161},45383,"使用 '--dangerously-skip-permissions' 启动 Claude Code 时，确认对话框自动选择 'No' 导致退出怎么办？","这是一个已知的交互问题，新版 Claude Code 会弹出风险确认对话框。维护者已推送修复补丁，能够自动处理该对话框（发送正确的按键序列以选择 'Yes'）。请确保将 agent-relay 升级到最新版本以应用此修复。","https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fissues\u002F373",{"id":163,"question_zh":164,"answer_zh":165,"source_url":166},45384,"通过 broker PTY 注入任务时，Gemini CLI Agent 收不到任务提示一直停留在欢迎界面怎么办？","由于 Gemini CLI 的启动序列或提示检测模式与 broker 不兼容，且存在容量限制导致多 Agent 场景下不可靠，目前的推荐解决方案是改用 'droid agents'。Droid agents 在同一环境下工作正常且更稳定。","https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fissues\u002F568",[168,173,178,183,188,193,198,203,208,213,218,223,228,233,238,243,248,253,258,263],{"id":169,"version":170,"summary_zh":171,"released_at":172},360282,"v4.0.30","## agent-relay v4.0.30\n\n### 快速安装（无需 Node.js！）\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FAgentWorkforce\u002Frelay\u002Fmain\u002Finstall.sh | bash\n```\n\n### npm 安装\n```bash\nnpm install -g agent-relay@4.0.30\nnpm install @agent-relay\u002Fsdk@4.0.30\nnpm install @agent-relay\u002Fbrand@4.0.30\n```\n\n### 独立二进制文件\n自包含的可执行文件（无运行时依赖）。\n**建议使用 `.gz` 版本以加快下载速度（体积缩小约 60-70%）。**\n\n| 平台 | 压缩版（推荐） | 非压缩版 |\n|----------|--------------------------|--------------|\n| Linux x64 | `agent-relay-linux-x64.gz` | `agent-relay-linux-x64` |\n| Linux ARM64 | `agent-relay-linux-arm64.gz` | `agent-relay-linux-arm64` |\n| macOS Intel | `agent-relay-darwin-x64.gz` | `agent-relay-darwin-x64` |\n| macOS Apple Silicon | `agent-relay-darwin-arm64.gz` | `agent-relay-darwin-arm64` |\n\n### agent-relay-broker 二进制文件\n用于启动和管理代理的 Broker 二进制文件：\n- `agent-relay-broker-linux-x64` - Linux x86_64\n- `agent-relay-broker-linux-arm64` - Linux ARM64\n- `agent-relay-broker-darwin-x64` - macOS Intel\n- `agent-relay-broker-darwin-arm64` - macOS Apple Silicon\n\n### relay-acp 二进制文件（Zed 编辑器集成）\n用于 Zed 编辑器的 ACP 桥接程序：\n- `relay-acp-linux-x64` - Linux x86_64\n- `relay-acp-linux-arm64` - Linux ARM64\n- `relay-acp-darwin-x64` - macOS Intel\n- `relay-acp-darwin-arm64` - macOS Apple Silicon\n\n\n## 变更内容\n* 修复（SDK）：由 @miyaontherelay 在 https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fpull\u002F753 中导出 A2A 通信子路径\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fcompare\u002Fv4.0.29...v4.0.30","2026-04-19T15:17:30",{"id":174,"version":175,"summary_zh":176,"released_at":177},360283,"openclaw-latest","最新的独立 `relay-openclaw` 二进制文件（无需 Node.js）。\n版本：4.0.30\n基于提交 0453daf23a6decbc40c358f9b1837c66c4db6714 构建。\n\n## 安装\n```bash\ncurl -L -o relay-openclaw.gz \\\n  https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Freleases\u002Fdownload\u002Fopenclaw-latest\u002Frelay-openclaw-linux-x64.gz\ngunzip relay-openclaw.gz && chmod +x relay-openclaw\n.\u002Frelay-openclaw --version\n```\n","2026-04-19T15:23:38",{"id":179,"version":180,"summary_zh":181,"released_at":182},360284,"openclaw-v4.0.30","独立的 `relay-openclaw` 二进制文件（无需 Node.js）。\n基于提交 `0453daf23a6decbc40c358f9b1837c66c4db6714` 构建。\n\n## 安装\n```bash\ncurl -L -o relay-openclaw.gz \\\n  https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Freleases\u002Fdownload\u002Fopenclaw-v4.0.30\u002Frelay-openclaw-linux-x64.gz\ngunzip relay-openclaw.gz && chmod +x relay-openclaw\n.\u002Frelay-openclaw --version\n```\n","2026-04-19T15:23:35",{"id":184,"version":185,"summary_zh":186,"released_at":187},360285,"v4.0.29","## agent-relay v4.0.29\n\n### 快速安装（无需 Node.js！）\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FAgentWorkforce\u002Frelay\u002Fmain\u002Finstall.sh | bash\n```\n\n### npm 安装\n```bash\nnpm install -g agent-relay@4.0.29\nnpm install @agent-relay\u002Fsdk@4.0.29\nnpm install @agent-relay\u002Fbrand@4.0.29\n```\n\n### 独立二进制文件\n自包含的可执行文件（无运行时依赖）。\n**建议使用 `.gz` 版本以加快下载速度（体积缩小约 60-70%）。**\n\n| 平台 | 压缩版（推荐） | 非压缩版 |\n|----------|--------------------------|--------------|\n| Linux x64 | `agent-relay-linux-x64.gz` | `agent-relay-linux-x64` |\n| Linux ARM64 | `agent-relay-linux-arm64.gz` | `agent-relay-linux-arm64` |\n| macOS Intel | `agent-relay-darwin-x64.gz` | `agent-relay-darwin-x64` |\n| macOS Apple Silicon | `agent-relay-darwin-arm64.gz` | `agent-relay-darwin-arm64` |\n\n### agent-relay-broker 二进制文件\n用于启动和管理代理的 Broker 二进制文件：\n- `agent-relay-broker-linux-x64` - Linux x86_64\n- `agent-relay-broker-linux-arm64` - Linux ARM64\n- `agent-relay-broker-darwin-x64` - macOS Intel\n- `agent-relay-broker-darwin-arm64` - macOS Apple Silicon\n\n### relay-acp 二进制文件（Zed 编辑器集成）\n用于 Zed 编辑器的 ACP 桥接程序：\n- `relay-acp-linux-x64` - Linux x86_64\n- `relay-acp-linux-arm64` - Linux ARM64\n- `relay-acp-darwin-x64` - macOS Intel\n- `relay-acp-darwin-arm64` - macOS Apple Silicon\n\n\n## 变更内容\n* 功能（SDK）：新增 ProcessBackend 工作流，支持云端沙箱执行，由 khaliqgant 在 https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fpull\u002F747 中实现。\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fcompare\u002Fv4.0.28...v4.0.29","2026-04-17T20:54:06",{"id":189,"version":190,"summary_zh":191,"released_at":192},360286,"openclaw-v4.0.29","独立的 `relay-openclaw` 二进制文件（无需 Node.js）。\n基于提交 `66fc483947c0795a398f948c50dd66bf331e42c2` 构建。\n\n## 安装\n```bash\ncurl -L -o relay-openclaw.gz \\\n  https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Freleases\u002Fdownload\u002Fopenclaw-v4.0.29\u002Frelay-openclaw-linux-x64.gz\ngunzip relay-openclaw.gz && chmod +x relay-openclaw\n.\u002Frelay-openclaw --version\n```\n","2026-04-17T20:56:18",{"id":194,"version":195,"summary_zh":196,"released_at":197},360287,"v4.0.28","## agent-relay v4.0.28\n\n### 快速安装（无需 Node.js！）\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FAgentWorkforce\u002Frelay\u002Fmain\u002Finstall.sh | bash\n```\n\n### npm 安装\n```bash\nnpm install -g agent-relay@4.0.28\nnpm install @agent-relay\u002Fsdk@4.0.28\nnpm install @agent-relay\u002Fbrand@4.0.28\n```\n\n### 独立二进制文件\n自包含的可执行文件（无运行时依赖）。\n**建议使用 `.gz` 版本以加快下载速度（体积缩小约 60-70%）。**\n\n| 平台 | 压缩版（推荐） | 非压缩版 |\n|----------|--------------------------|--------------|\n| Linux x64 | `agent-relay-linux-x64.gz` | `agent-relay-linux-x64` |\n| Linux ARM64 | `agent-relay-linux-arm64.gz` | `agent-relay-linux-arm64` |\n| macOS Intel | `agent-relay-darwin-x64.gz` | `agent-relay-darwin-x64` |\n| macOS Apple Silicon | `agent-relay-darwin-arm64.gz` | `agent-relay-darwin-arm64` |\n\n### agent-relay-broker 二进制文件\n用于启动和管理代理的 Broker 二进制文件：\n- `agent-relay-broker-linux-x64` - Linux x86_64\n- `agent-relay-broker-linux-arm64` - Linux ARM64\n- `agent-relay-broker-darwin-x64` - macOS Intel\n- `agent-relay-broker-darwin-arm64` - macOS Apple Silicon\n\n### relay-acp 二进制文件（Zed 编辑器集成）\n用于 Zed 编辑器的 ACP 桥接程序：\n- `relay-acp-linux-x64` - Linux x86_64\n- `relay-acp-linux-arm64` - Linux ARM64\n- `relay-acp-darwin-x64` - macOS Intel\n- `relay-acp-darwin-arm64` - macOS Apple Silicon\n\n\n## 变更内容\n* 修复（cloud-connect）：在发布流程中打包 ssh2（真正修复 #745），由 @khaliqgant 在 https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fpull\u002F746 中完成。\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fcompare\u002Fv4.0.27...v4.0.28","2026-04-15T23:42:34",{"id":199,"version":200,"summary_zh":201,"released_at":202},360288,"openclaw-v4.0.28","独立的 `relay-openclaw` 二进制文件（无需 Node.js）。\n基于提交 `4db7c65e2fe15ecdb0faf95b78947c4e0a65672f` 构建。\n\n## 安装\n```bash\ncurl -L -o relay-openclaw.gz \\\n  https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Freleases\u002Fdownload\u002Fopenclaw-v4.0.28\u002Frelay-openclaw-linux-x64.gz\ngunzip relay-openclaw.gz && chmod +x relay-openclaw\n.\u002Frelay-openclaw --version\n```\n","2026-04-15T23:48:05",{"id":204,"version":205,"summary_zh":206,"released_at":207},360289,"v4.0.27","## agent-relay v4.0.27\n\n### 快速安装（无需 Node.js！）\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FAgentWorkforce\u002Frelay\u002Fmain\u002Finstall.sh | bash\n```\n\n### npm 安装\n```bash\nnpm install -g agent-relay@4.0.27\nnpm install @agent-relay\u002Fsdk@4.0.27\nnpm install @agent-relay\u002Fbrand@4.0.27\n```\n\n### 独立二进制文件\n自包含的可执行文件（无运行时依赖）。\n**建议使用 `.gz` 版本以加快下载速度（体积缩小约 60-70%）。**\n\n| 平台 | 压缩版（推荐） | 非压缩版 |\n|----------|--------------------------|--------------|\n| Linux x64 | `agent-relay-linux-x64.gz` | `agent-relay-linux-x64` |\n| Linux ARM64 | `agent-relay-linux-arm64.gz` | `agent-relay-linux-arm64` |\n| macOS Intel | `agent-relay-darwin-x64.gz` | `agent-relay-darwin-x64` |\n| macOS Apple Silicon | `agent-relay-darwin-arm64.gz` | `agent-relay-darwin-arm64` |\n\n### agent-relay-broker 二进制文件\n用于启动和管理代理的 Broker 二进制文件：\n- `agent-relay-broker-linux-x64` - Linux x86_64\n- `agent-relay-broker-linux-arm64` - Linux ARM64\n- `agent-relay-broker-darwin-x64` - macOS Intel\n- `agent-relay-broker-darwin-arm64` - macOS Apple Silicon\n\n### relay-acp 二进制文件（Zed 编辑器集成）\n用于 Zed 编辑器的 ACP 桥接程序：\n- `relay-acp-linux-x64` - Linux x86_64\n- `relay-acp-linux-arm64` - Linux ARM64\n- `relay-acp-darwin-x64` - macOS Intel\n- `relay-acp-darwin-arm64` - macOS Apple Silicon\n\n\n## 变更内容\n* fix(cli)：将 ssh2 打包到 Bun 二进制中，以便云连接能够通过 ssh2 路径进行操作，由 khaliqgant 在 https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fpull\u002F745 中完成。\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fcompare\u002Fv4.0.26...v4.0.27","2026-04-15T22:26:27",{"id":209,"version":210,"summary_zh":211,"released_at":212},360290,"openclaw-v4.0.27","独立的 `relay-openclaw` 二进制文件（无需 Node.js）。\n基于提交 `45a9b8c685a0fce56a52660b2cf5f1c7dc936167` 构建。\n\n## 安装\n```bash\ncurl -L -o relay-openclaw.gz \\\n  https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Freleases\u002Fdownload\u002Fopenclaw-v4.0.27\u002Frelay-openclaw-linux-x64.gz\ngunzip relay-openclaw.gz && chmod +x relay-openclaw\n.\u002Frelay-openclaw --version\n```\n","2026-04-15T22:30:32",{"id":214,"version":215,"summary_zh":216,"released_at":217},360291,"v4.0.26","## agent-relay v4.0.26\n\n### 快速安装（无需 Node.js！）\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FAgentWorkforce\u002Frelay\u002Fmain\u002Finstall.sh | bash\n```\n\n### npm 安装\n```bash\nnpm install -g agent-relay@4.0.26\nnpm install @agent-relay\u002Fsdk@4.0.26\nnpm install @agent-relay\u002Fbrand@4.0.26\n```\n\n### 独立二进制文件\n自包含的可执行文件（无运行时依赖）。\n**使用 `.gz` 版本可加快下载速度（体积缩小约 60-70%）。**\n\n| 平台 | 压缩版（推荐） | 未压缩版 |\n|----------|--------------------------|--------------|\n| Linux x64 | `agent-relay-linux-x64.gz` | `agent-relay-linux-x64` |\n| Linux ARM64 | `agent-relay-linux-arm64.gz` | `agent-relay-linux-arm64` |\n| macOS Intel | `agent-relay-darwin-x64.gz` | `agent-relay-darwin-x64` |\n| macOS Apple Silicon | `agent-relay-darwin-arm64.gz` | `agent-relay-darwin-arm64` |\n\n### agent-relay-broker 二进制文件\n用于启动和管理代理的 Broker 二进制文件：\n- `agent-relay-broker-linux-x64` - Linux x86_64\n- `agent-relay-broker-linux-arm64` - Linux ARM64\n- `agent-relay-broker-darwin-x64` - macOS Intel\n- `agent-relay-broker-darwin-arm64` - macOS Apple Silicon\n\n### relay-acp 二进制文件（Zed 编辑器集成）\n用于 Zed 编辑器的 ACP 桥接程序：\n- `relay-acp-linux-x64` - Linux x86_64\n- `relay-acp-linux-arm64` - Linux ARM64\n- `relay-acp-darwin-x64` - macOS Intel\n- `relay-acp-darwin-arm64` - macOS Apple Silicon\n\n\n## 变更内容\n* 修复(cli)：为云连接回退路径添加可见的启动检查点，由 @khaliqgant 在 https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fpull\u002F744 中完成。\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fcompare\u002Fv4.0.25...v4.0.26","2026-04-15T20:09:02",{"id":219,"version":220,"summary_zh":221,"released_at":222},360292,"openclaw-v4.0.26","Standalone `relay-openclaw` binaries (no Node.js required).\nBuilt from commit 63506cff7185c3ce352afd2af92f5e58a4ca25e1.\n\n## Install\n```bash\ncurl -L -o relay-openclaw.gz \\\n  https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Freleases\u002Fdownload\u002Fopenclaw-v4.0.26\u002Frelay-openclaw-linux-x64.gz\ngunzip relay-openclaw.gz && chmod +x relay-openclaw\n.\u002Frelay-openclaw --version\n```\n","2026-04-15T20:12:57",{"id":224,"version":225,"summary_zh":226,"released_at":227},360293,"v4.0.25","## agent-relay v4.0.25\n\n### Quick Install (no Node.js required!)\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FAgentWorkforce\u002Frelay\u002Fmain\u002Finstall.sh | bash\n```\n\n### npm install\n```bash\nnpm install -g agent-relay@4.0.25\nnpm install @agent-relay\u002Fsdk@4.0.25\nnpm install @agent-relay\u002Fbrand@4.0.25\n```\n\n### Standalone binaries\nSelf-contained executables (no runtime dependencies).\n**Use `.gz` versions for faster downloads (~60-70% smaller).**\n\n| Platform | Compressed (recommended) | Uncompressed |\n|----------|--------------------------|--------------|\n| Linux x64 | `agent-relay-linux-x64.gz` | `agent-relay-linux-x64` |\n| Linux ARM64 | `agent-relay-linux-arm64.gz` | `agent-relay-linux-arm64` |\n| macOS Intel | `agent-relay-darwin-x64.gz` | `agent-relay-darwin-x64` |\n| macOS Apple Silicon | `agent-relay-darwin-arm64.gz` | `agent-relay-darwin-arm64` |\n\n### agent-relay-broker binaries\nBroker binary for spawning and managing agents:\n- `agent-relay-broker-linux-x64` - Linux x86_64\n- `agent-relay-broker-linux-arm64` - Linux ARM64\n- `agent-relay-broker-darwin-x64` - macOS Intel\n- `agent-relay-broker-darwin-arm64` - macOS Apple Silicon\n\n### relay-acp binaries (Zed editor integration)\nACP bridge for Zed editor:\n- `relay-acp-linux-x64` - Linux x86_64\n- `relay-acp-linux-arm64` - Linux ARM64\n- `relay-acp-darwin-x64` - macOS Intel\n- `relay-acp-darwin-arm64` - macOS Apple Silicon\n\n\n## What's Changed\n* fix(cli): stop cloud connect hangs and re-auth loops by @khaliqgant in https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fpull\u002F743\n\n\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fcompare\u002Fv4.0.24...v4.0.25","2026-04-15T19:13:08",{"id":229,"version":230,"summary_zh":231,"released_at":232},360294,"openclaw-v4.0.25","Standalone `relay-openclaw` binaries (no Node.js required).\nBuilt from commit e4eb141815fdb247ddeff5f48781b3070120e8a6.\n\n## Install\n```bash\ncurl -L -o relay-openclaw.gz \\\n  https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Freleases\u002Fdownload\u002Fopenclaw-v4.0.25\u002Frelay-openclaw-linux-x64.gz\ngunzip relay-openclaw.gz && chmod +x relay-openclaw\n.\u002Frelay-openclaw --version\n```\n","2026-04-15T19:15:59",{"id":234,"version":235,"summary_zh":236,"released_at":237},360295,"v4.0.24","## agent-relay v4.0.24\n\n### Quick Install (no Node.js required!)\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FAgentWorkforce\u002Frelay\u002Fmain\u002Finstall.sh | bash\n```\n\n### npm install\n```bash\nnpm install -g agent-relay@4.0.24\nnpm install @agent-relay\u002Fsdk@4.0.24\nnpm install @agent-relay\u002Fbrand@4.0.24\n```\n\n### Standalone binaries\nSelf-contained executables (no runtime dependencies).\n**Use `.gz` versions for faster downloads (~60-70% smaller).**\n\n| Platform | Compressed (recommended) | Uncompressed |\n|----------|--------------------------|--------------|\n| Linux x64 | `agent-relay-linux-x64.gz` | `agent-relay-linux-x64` |\n| Linux ARM64 | `agent-relay-linux-arm64.gz` | `agent-relay-linux-arm64` |\n| macOS Intel | `agent-relay-darwin-x64.gz` | `agent-relay-darwin-x64` |\n| macOS Apple Silicon | `agent-relay-darwin-arm64.gz` | `agent-relay-darwin-arm64` |\n\n### agent-relay-broker binaries\nBroker binary for spawning and managing agents:\n- `agent-relay-broker-linux-x64` - Linux x86_64\n- `agent-relay-broker-linux-arm64` - Linux ARM64\n- `agent-relay-broker-darwin-x64` - macOS Intel\n- `agent-relay-broker-darwin-arm64` - macOS Apple Silicon\n\n### relay-acp binaries (Zed editor integration)\nACP bridge for Zed editor:\n- `relay-acp-linux-x64` - Linux x86_64\n- `relay-acp-linux-arm64` - Linux ARM64\n- `relay-acp-darwin-x64` - macOS Intel\n- `relay-acp-darwin-arm64` - macOS Apple Silicon\n\n\n## What's Changed\n* fix(cli): prefer native Node TS stripping over tsx fallback by @khaliqgant in https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fpull\u002F741\n* Fix SDK trajectory publish build by @khaliqgant in https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fpull\u002F742\n\n\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fcompare\u002Fv4.0.23...v4.0.24","2026-04-15T16:36:03",{"id":239,"version":240,"summary_zh":241,"released_at":242},360296,"openclaw-v4.0.24","Standalone `relay-openclaw` binaries (no Node.js required).\nBuilt from commit e588e3ce83ff47315bbeb03357a3205e20575266.\n\n## Install\n```bash\ncurl -L -o relay-openclaw.gz \\\n  https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Freleases\u002Fdownload\u002Fopenclaw-v4.0.24\u002Frelay-openclaw-linux-x64.gz\ngunzip relay-openclaw.gz && chmod +x relay-openclaw\n.\u002Frelay-openclaw --version\n```\n","2026-04-15T16:38:57",{"id":244,"version":245,"summary_zh":246,"released_at":247},360297,"v4.0.23","## agent-relay v4.0.23\n\n### Quick Install (no Node.js required!)\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FAgentWorkforce\u002Frelay\u002Fmain\u002Finstall.sh | bash\n```\n\n### npm install\n```bash\nnpm install -g agent-relay@4.0.23\nnpm install @agent-relay\u002Fsdk@4.0.23\nnpm install @agent-relay\u002Fbrand@4.0.23\n```\n\n### Standalone binaries\nSelf-contained executables (no runtime dependencies).\n**Use `.gz` versions for faster downloads (~60-70% smaller).**\n\n| Platform | Compressed (recommended) | Uncompressed |\n|----------|--------------------------|--------------|\n| Linux x64 | `agent-relay-linux-x64.gz` | `agent-relay-linux-x64` |\n| Linux ARM64 | `agent-relay-linux-arm64.gz` | `agent-relay-linux-arm64` |\n| macOS Intel | `agent-relay-darwin-x64.gz` | `agent-relay-darwin-x64` |\n| macOS Apple Silicon | `agent-relay-darwin-arm64.gz` | `agent-relay-darwin-arm64` |\n\n### agent-relay-broker binaries\nBroker binary for spawning and managing agents:\n- `agent-relay-broker-linux-x64` - Linux x86_64\n- `agent-relay-broker-linux-arm64` - Linux ARM64\n- `agent-relay-broker-darwin-x64` - macOS Intel\n- `agent-relay-broker-darwin-arm64` - macOS Apple Silicon\n\n### relay-acp binaries (Zed editor integration)\nACP bridge for Zed editor:\n- `relay-acp-linux-x64` - Linux x86_64\n- `relay-acp-linux-arm64` - Linux ARM64\n- `relay-acp-darwin-x64` - macOS Intel\n- `relay-acp-darwin-arm64` - macOS Apple Silicon\n\n\n## What's Changed\n* feat: show workspace key and observer URL in agent-relay status by @khaliqgant in https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fpull\u002F740\n\n\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fcompare\u002Fv4.0.22...v4.0.23","2026-04-14T10:44:37",{"id":249,"version":250,"summary_zh":251,"released_at":252},360298,"openclaw-v4.0.23","Standalone `relay-openclaw` binaries (no Node.js required).\nBuilt from commit e6b9e1188703dac356a13121b05449efbb7d7d08.\n\n## Install\n```bash\ncurl -L -o relay-openclaw.gz \\\n  https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Freleases\u002Fdownload\u002Fopenclaw-v4.0.23\u002Frelay-openclaw-linux-x64.gz\ngunzip relay-openclaw.gz && chmod +x relay-openclaw\n.\u002Frelay-openclaw --version\n```\n","2026-04-14T10:50:31",{"id":254,"version":255,"summary_zh":256,"released_at":257},360299,"v4.0.22","## agent-relay v4.0.22\n\n### Quick Install (no Node.js required!)\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FAgentWorkforce\u002Frelay\u002Fmain\u002Finstall.sh | bash\n```\n\n### npm install\n```bash\nnpm install -g agent-relay@4.0.22\nnpm install @agent-relay\u002Fsdk@4.0.22\nnpm install @agent-relay\u002Fbrand@4.0.22\n```\n\n### Standalone binaries\nSelf-contained executables (no runtime dependencies).\n**Use `.gz` versions for faster downloads (~60-70% smaller).**\n\n| Platform | Compressed (recommended) | Uncompressed |\n|----------|--------------------------|--------------|\n| Linux x64 | `agent-relay-linux-x64.gz` | `agent-relay-linux-x64` |\n| Linux ARM64 | `agent-relay-linux-arm64.gz` | `agent-relay-linux-arm64` |\n| macOS Intel | `agent-relay-darwin-x64.gz` | `agent-relay-darwin-x64` |\n| macOS Apple Silicon | `agent-relay-darwin-arm64.gz` | `agent-relay-darwin-arm64` |\n\n### agent-relay-broker binaries\nBroker binary for spawning and managing agents:\n- `agent-relay-broker-linux-x64` - Linux x86_64\n- `agent-relay-broker-linux-arm64` - Linux ARM64\n- `agent-relay-broker-darwin-x64` - macOS Intel\n- `agent-relay-broker-darwin-arm64` - macOS Apple Silicon\n\n### relay-acp binaries (Zed editor integration)\nACP bridge for Zed editor:\n- `relay-acp-linux-x64` - Linux x86_64\n- `relay-acp-linux-arm64` - Linux ARM64\n- `relay-acp-darwin-x64` - macOS Intel\n- `relay-acp-darwin-arm64` - macOS Apple Silicon\n\n\n## What's Changed\n* feat(workflows): cloud-connect fix workflows (claude hang + utils bundling) by @khaliqgant in https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fpull\u002F738\n\n\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fcompare\u002Fv4.0.21...v4.0.22","2026-04-14T08:30:01",{"id":259,"version":260,"summary_zh":261,"released_at":262},360300,"openclaw-v4.0.22","Standalone `relay-openclaw` binaries (no Node.js required).\nBuilt from commit fc8638e50a680c9ad29f3b4abc28006917bbc0ff.\n\n## Install\n```bash\ncurl -L -o relay-openclaw.gz \\\n  https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Freleases\u002Fdownload\u002Fopenclaw-v4.0.22\u002Frelay-openclaw-linux-x64.gz\ngunzip relay-openclaw.gz && chmod +x relay-openclaw\n.\u002Frelay-openclaw --version\n```\n","2026-04-14T08:33:03",{"id":264,"version":265,"summary_zh":266,"released_at":267},360301,"v4.0.21","## agent-relay v4.0.21\n\n### Quick Install (no Node.js required!)\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FAgentWorkforce\u002Frelay\u002Fmain\u002Finstall.sh | bash\n```\n\n### npm install\n```bash\nnpm install -g agent-relay@4.0.21\nnpm install @agent-relay\u002Fsdk@4.0.21\nnpm install @agent-relay\u002Fbrand@4.0.21\n```\n\n### Standalone binaries\nSelf-contained executables (no runtime dependencies).\n**Use `.gz` versions for faster downloads (~60-70% smaller).**\n\n| Platform | Compressed (recommended) | Uncompressed |\n|----------|--------------------------|--------------|\n| Linux x64 | `agent-relay-linux-x64.gz` | `agent-relay-linux-x64` |\n| Linux ARM64 | `agent-relay-linux-arm64.gz` | `agent-relay-linux-arm64` |\n| macOS Intel | `agent-relay-darwin-x64.gz` | `agent-relay-darwin-x64` |\n| macOS Apple Silicon | `agent-relay-darwin-arm64.gz` | `agent-relay-darwin-arm64` |\n\n### agent-relay-broker binaries\nBroker binary for spawning and managing agents:\n- `agent-relay-broker-linux-x64` - Linux x86_64\n- `agent-relay-broker-linux-arm64` - Linux ARM64\n- `agent-relay-broker-darwin-x64` - macOS Intel\n- `agent-relay-broker-darwin-arm64` - macOS Apple Silicon\n\n### relay-acp binaries (Zed editor integration)\nACP bridge for Zed editor:\n- `relay-acp-linux-x64` - Linux x86_64\n- `relay-acp-linux-arm64` - Linux ARM64\n- `relay-acp-darwin-x64` - macOS Intel\n- `relay-acp-darwin-arm64` - macOS Apple Silicon\n\n\n## What's Changed\n* feat(cloud): env-var auth fallback for headless consumers by @khaliqgant in https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fpull\u002F734\n* fix(messaging): inbox --agent flag, history DM support, history --from DM context by @khaliqgant in https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fpull\u002F737\n\n\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FAgentWorkforce\u002Frelay\u002Fcompare\u002Fv4.0.20...v4.0.21","2026-04-13T21:53:13"]