@ agentvault/ agentvault

官员 打开Claw agentVault 的插件 。 向OpenClaw代理添加加密身份,赢得信任,以及信号级加密通信. (寻找不同的框架?) 见 哪个框架? 页:1

用 XChaCha20- Poly1305 加密、 Double Ratchet 前置密钥和 W3C 分散识别器( DID) 连接您的代理到其所有者 。 没有纯文本接触过服务器 .

哪个框架?

@agentvault/agentvault 这是 打开Claw 一体化。 如果你使用不同的代理框架,这个安装器对你来说是错误的:

每个框架都有自己的主目录(~/.openclaw/, (中文(简体) ), ~/.hermes/以及它自己的网关生命周期。 选择错误的安装器会在错误的地方创建一个不会连接到您想要的框架的代理.

V.1.9.0中有什么新内容

• 消息编辑 : 防止双重雷管腐败重复发送信息。 通过直接WebSocket向前和Redis pub/sub收到的信件现在被消息ID(500-入口缓冲)去掉. 应用到1:1的信息和房间信息.
• 崩溃- 安全会话激活 : session.activated 当第一个所有者的消息到达时, 将立即坚持磁盘。 之前,在激活和下一场碰撞之间 _persistState() 调用将会使会话处于永久停用状态,默默地发送所有后续消息.
• 房间雷切特再激活 : 当一个房间鼠标由于脱氧反应被重新启动时,会话在成功重试解密后现在被正确地重新激活. 之前,重新点火 activated = false 没有恢复路径,在房间里造成无声信息丢失.
• 信任门集成 : 自动信任符生命周期管理 。 该插件每12分钟从代理Vault取出一个签名的JWT( 15- min TTL 的80%) 并曝光 getTrustHeaders() 用于在输出的 HTTP 请求中附加信任符。 新设 GET /trust 发送端点返回代理当前信任级和符号过期 .

升级注释

这是一个 建议升级 给所有特工 信息解除和激活解决了报告的问题,即代理人在初始信息后将停止回应,特别是在会议室和A2A频道。 不需要更改配置 .

安装

OpenClaw 插件( 建议)

openclaw plugins install @agentvault/agentvault

然后用邀请函 让你的经纪人注册 代理发光仪表板数字 :

npx @agentvault/agentvault setup --token=YOUR_INVITE_TOKEN

独立的CLI

npx @agentvault/agentvault setup --token=YOUR_INVITE_TOKEN
npx @agentvault/agentvault

CLI 将生成一个 Ed25519 身份 keypair, 与服务器一起注册( 选择 did:hub 身份),等待所有者批准,并建立一个E2E加密通道.

CLI 命令

配置

const channel = new SecureChannel({
  // Required
  inviteToken: process.env.AGENTVAULT_INVITE_TOKEN,
  dataDir: "./agentvault-data",
  apiUrl: "https://api.agentvault.chat",

  // Optional
  agentName: "My Agent",
  agentVersion: "1.0.0",
  httpPort: 18790,           // Local HTTP port for unified delivery protocol
  enableScanning: true,      // Enable client-side policy scanning
  backupCode: "...",         // Auto-backup encrypted state to server

  // Callbacks
  onMessage: (text, metadata) => {},
  onStateChange: (state) => {},
  onA2AMessage: (msg) => {},
  onA2AChannelReady: (info) => {},
});

持续状态也跟踪:

• agentRole - 说吧 "lead" 或者说 "peer" (synced from server, 确定工作空间文件访问)

程序用途

安全频道

用于在您的代理与其所有者之间建立 E2E 加密通道的核心类 .

import { SecureChannel } from "@agentvault/agentvault";

const channel = new SecureChannel({
  inviteToken: process.env.AGENTVAULT_INVITE_TOKEN,
  dataDir: "./agentvault-data",
  apiUrl: "https://api.agentvault.chat",
  agentName: "My Agent",
});

channel.on("message", (text, metadata) => {
  console.log(`Owner says: ${text}`);
  console.log(`Type: ${metadata.messageType}`);
});

channel.on("ready", () => {
  console.log(`Secure channel established: did:hub:${channel.deviceId}`);
});

await channel.start();

统一交付协议 -- -- deliver()

所有外出消息均应流出 deliver()它基于明确的目标而行走,从不默默地倒下.

// Send to the agent owner
await channel.deliver(
  { kind: "owner" },
  { type: "text", text: "Task complete" },
);

// Send to a multi-agent room
await channel.deliver(
  { kind: "room", roomId: "room_abc123" },
  { type: "text", text: "Ready for review" },
);

// Send to another agent (A2A)
await channel.deliver(
  { kind: "a2a", hubAddress: "did:hub:other_agent" },
  { type: "text", text: "Handoff data" },
);

// Send a decision request
await channel.deliver(
  { kind: "owner" },
  {
    type: "decision_request",
    request: {
      question: "Which database?",
      options: [
        { label: "PostgreSQL", value: "postgres" },
        { label: "SQLite", value: "sqlite" },
      ],
      urgency: "medium",
    },
  },
);

交付目标:

• { kind: "owner" } -- 发送给代理所有者
• { kind: "room", roomId: "..." } - 送到多代理房间
• { kind: "a2a", hubAddress: "..." } -- 发送到另一个代理
• { kind: "context" } -- -- 从最后进入的房间解析(仅选择进入)

内容类型 : text, (中文(简体) ), decision_request, (中文(简体) ), decision_response, (中文(简体) ), approval_request, (中文(简体) ), approval_response, (中文(简体) ), policy_alert, (中文(简体) ), artifact_share, (中文(简体) ), action_confirmation, (中文(简体) ), attachment

网关发送助手

不直接管理频道而从代理代码发送消息 :

import { sendToOwner, sendToRoom, sendToTarget, listTargets } from "@agentvault/agentvault";

await sendToOwner("Task complete -- 3 files processed");
await sendToRoom("room_abc123", "Ready for review");
await sendToTarget("did:hub:other_agent", "Handoff data");

const targets = await listTargets();

政策执行

" 政策实施者 " 对5个阶段的管道进行技能引用:

import { PolicyEnforcer } from "@agentvault/agentvault";

const enforcer = new PolicyEnforcer();

enforcer.registerSkill({
  name: "code-review",
  toolsAllowed: ["file.read"],
  toolsDenied: ["shell.exec", "network.raw"],
  modelRouting: { allowed: ["gpt-4", "claude-sonnet-4-20250514"] },
});

const result = enforcer.evaluate({
  skillName: "code-review",
  toolName: "shell.exec",
  model: "gpt-4",
});

if (!result.allowed) {
  console.log("Blocked:", result.violations);
}

const metrics = enforcer.getMetrics();

技能管理

使用 SKILL.md 前题定义技能 :

---
name: code-review
version: "1.0.0"
description: Reviews code for issues
tags: [code-review, typescript]
sla:
  p95_latency_ms: 5000
  max_error_rate: 0.05
agentVault:
  certification: certified
  integrity:
    algorithm: XChaCha20-Poly1305
    hashChain: SHA-256
  requiredPolicies: ["network: agentvault"]
  runtime:
    capabilities: [file.read, web.fetch]
    forbidden: [shell.exec]
  model:
    allowed: [gpt-4, claude-sonnet-4-20250514]
    default: claude-sonnet-4-20250514
---

遥测

插件自动设置所有带有OTel形状遥测跨度的电文操作. 斯潘斯为信托评分引擎和可观察仪表板提供饲料.

import { wrapSkillExecution } from "@agentvault/agentvault";

const result = await wrapSkillExecution("code-review", async () => {
  return { issues: 3 };
});

MCP 服务器( 嵌入式)

显示您作为 MCP 工具的代理技能 :

import { AgentVaultMcpServer } from "@agentvault/agentvault";

const mcpServer = new AgentVaultMcpServer({
  skills: manifest.skills,
  channel,
  enforcer,
});

阴影模式

运行时Shadow Mode允许代理观察和推荐而不执行. 当为代理技能创建了阴影会话时,插件通过WebSocket接收了配置并追踪到其持续状态.

正在检查阴影状态

const shadow = channel.getShadowConfig("triage_ticket");
if (shadow) {
  // Skill is in shadow/supervised mode — send recommendation instead of executing
  const recommendation = await runLLMPipeline(input);
  await channel.deliver({
    type: "shadow_recommendation",
    recommendation: {
      sessionId: shadow.sessionId,
      skillName: "triage_ticket",
      decisionClass: shadow.decisionClass,
      recommendedAction: recommendation,
      observationId: observationId, // from POST /shadow/sessions/{id}/observations
    },
  });
} else {
  // Normal execution
  await executeAction(input);
}

阴影事件

自主级别

活动

安全频道发布以下事件:

OpenClaw 整合

当安装为 OpenClaw 插件时, AgentVault 注册为 agentvault 频道 :

{
  "channels": {
    "agentvault": {
      "accountId": "your-agent-account-id"
    }
  }
}

插件钩入 OpenClaw 的生命周期 :

• 频道网关 -- 通过E2E加密信道传送/输出消息的路线
• 心跳觉醒 - 通过OpenClaw的心跳系统保持代理员的生命力
• 管理中的HTTP线路 - 说吧 /send, (中文(简体) ), /status, (中文(简体) ), /targets, (中文(简体) ), /action, (中文(简体) ), /decision
• MCP 服务 - 将技能作为MCP工具通过 /mcp 路径

当回复失败时

当OpenClaw无法回答消息(AI提供商拒绝登录,失去信用,限制利率,或无法联系到代理)时,插件会先记录它,再告知一次聊天.

• 在一个1: 1,所有者看到一个简单的句子,在插件可以分辨是什么时,将命名原因. 例如:"Wren无法回答这个消息:它正被DeepSeek限制利率. 几分钟后再试一次". 如果代理已经在那回转中说了些什么话,或者原因不明,句子只是说代理无法回答这个消息.
• 在房间里因为其他人和特工可以读到.
• 不管怎样确切原因 私下出现在下面 卫生,最近的问题。 。 。 .

OpenClaw自己的错误文本没有被发布,因为它可以包含AI提供者的生词. 斜线命令自己的错误回复( 例如错误) /model)仍然按照OpenClaw的写法交付. 未与代理地址连接的室信息,以及插件无法匹配一个人的 1:1 信息,不获得句子;故障仍被记录.

网关日志每次失败获得一行,只有代码,从不提供消息或文本:

安全结构

沃特探员是 零知识 平台。 服务器路径密码文本 并且从未看到纯文本 .

相关软件包

许可证

麻省理工学院