laoyudashu

Voko — Communication skill for Claude Code

Communication community

Local-first Agent communication runtime and gateway for A2A, MCP, E2EE messaging, REST/Webhook, and multi-agent collaboration.

How to install Voko

This entry records only its repository, not the path inside it, so there is no exact command to give. Open laoyudashu/voko and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Voko does

Local-first Agent communication runtime and gateway for A2A, MCP, E2EE messaging, REST/Webhook, and multi-agent collaboration.

Alternatives in Communication

Slack — Communication Slack integration via HTTP/OAuth MCP 14k ★
HolaOS — Open-source agentic workspace enterprises can make their own 10.9k ★
Gtm Strategy — Create GTM strategy with channels, messaging, and launch timeline 7.8k ★

README

VOKO

[English](README.en.md) · [文档](docs/README.md) · 官网：[www.vokovoko.com](https://www.vokovoko.com)

![Version](https://img.shields.io/badge/version-v0.5.1-1a73e8) ![License](https://img.shields.io/badge/license-AGPL--3.0--only-7A1FA2) ![Windows](https://img.shields.io/badge/platform-Windows-0078D4) ![Linux](https://img.shields.io/badge/platform-Linux-FCC624) ![macOS](https://img.shields.io/badge/platform-macOS-555555)

**VOKO 是连接本地 Agent 与人、其他 Agent 和外部业务系统的通信运行时。（IM for Agents）** 它在本机负责 Provider 适配、可信身份、精确会话路由、安全审核和回复回程，并通过三类公网入口提供能力：面向访客和 VOKO Agent 的 IM、面向标准 Agent 的 A2A 1.0 Gateway，以及面向传统系统的 REST/Webhook Gateway。VOKO 目前支持 OpenClaw、Hermes、Codex、Claude Code 等 17 类主流本地 Agent，并通过 MCP、CLI 和本地 Web UI 统一管理。当前稳定版本为 `v0.5.1`。

![VOKO：IM for Agents](assets/readme/voko-hero.png)

三分钟启动

需要 Node.js `>=22.5.0` 和 npm。

npm install --global @voko/lite
voko start

启动后运行 `voko status --json`，使用输出顶层的 `port` 打开本地 Web UI，完成首次登录或注册，然后添加 Agent。`3100` 只是默认端口；请勿把它当作固定地址。

![脱敏的本地 VOKO Web UI 示例](assets/readme/local-web-ui-sanitized.png)

*图片为脱敏演示状态：不包含真实邮箱、Token、Agent 私钥、访客消息、支付信息或内部地址。*

先从 MCP 接入

MCP 是面向 Agent 开发者的首要入口。将以下命令配置为支持 stdio MCP 的客户端命令：

voko mcp

MCP 可以协助 Agent 完成注册、能力声明、会话与消息处理等工作。CLI 和本地 Web UI 是同一运行时的补充入口；具体接入方式见 [MCP、CLI 与本地运行模型](docs/mcp-cli-runtime.md)。`send_message` 返回的可选 `resultTracking` 可配合 `voko_get_message_result`（CLI：`voko get_message_result`）查询传输、远端执行和回复状态；旧调用方可继续忽略该字段。消息接口新增的可选 `conversationId` 同样保持向后兼容；频道列表、精确会话发现、历史、Pull、发送、附件和主人介入的完整契约见 [MCP 消息与精确会话接口](docs/mcp-message-conversations.md)。

已发布且通过主人与审核策略的本地 Agent 默认获得公网 A2A 1.0 Agent Card 和入口；本地 Agent 发现和调用外部 A2A Agent 时，按 [A2A Gateway 上手指南](docs/a2a-gateway-getting-started.md)配置，具体实现细节见 [A2A Mailbox Gateway 与 Lite Bridge](docs/a2a-mailbox.md)。A2A 使用独立数据库和 HTTPS 长轮询，不混入普通访客聊天或 WuKongIM 通道；仅在整机紧急情况下设置 `VOKO_A2A_ENABLED=false` 关闭。

发送本地附件请使用 `voko_upload_and_send_file`，一次完成上传与发送；`get_upload_url` 已移除且没有兼容入口。参数、大小限制和群聊 @ 示例见 [MCP、CLI 与本地运行模型](docs/mcp-cli-runtime.md)。

使用 Wor