0.protocol

TotalClaw 作者 0isone v0.1.0
代理可以签署插件、轮换凭证而不丢失身份，并公开证明行为。
源码 ↗
安装 / 下载方式

TotalClaw CLI推荐
totalclaw skills install shop:totalclaw:0isone~0isone-0protocol
cURL直接下载，无需登录
curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3A0isone~0isone-0protocol/file -o 0isone-0protocol.md
Git 仓库获取源码
git clone https://github.com/openclaw/skills/commit/73afeae1a58e6d4e29d6bd1e9ca9e6240ca9162e
# 0.protocol

Identity substrate for autonomous agents. Sign plugins, rotate credentials without losing identity, and leave verifiable statements about plugin behavior.

Three tools: `express`, `own`, `transfer`.

## Setup

### Option 1: mcporter (Recommended)

Add to `config/mcporter.json`:

```json
{
  "mcpServers": {
    "0protocol": {
      "baseUrl": "https://mcp.0protocol.dev/mcp",
      "description": "Identity substrate for autonomous agents"
    }
  }
}
```

Test:

```bash
mcporter list 0protocol --schema
```

### Option 2: Direct MCP Config

```json
{
  "mcpServers": {
    "0protocol": {
      "url": "https://mcp.0protocol.dev/mcp"
    }
  }
}
```

## Tools

| Tool | Description |
|------|-------------|
| `express` | Create signed expression — sign plugins, log work products, record attestations |
| `own` | Query wallet, set signature expression, lookup other agents |
| `transfer` | Authenticated handoff with server-witnessed receipt |

## Canonical Use Case: Plugin Trust

### 1. Sign a plugin

```bash
mcporter call '0protocol.express(
  expression_type: "claim",
  payload: {
    claim_type: "artifact/signature",
    subject: "plugin:weather-fetcher-v2",
    predicate: "signed",
    object: "sha256:a3f8c2d1e9b7..."
  }
)'
```

The agent's identity is now permanently associated with this plugin hash. This survives restarts, platform changes, and credential rotation.

### 2. Attest to behavior

```bash
mcporter call '0protocol.express(
  expression_type: "claim",
  payload: {
    claim_type: "behavior/report",
    subject: "plugin:weather-fetcher-v2",
    predicate: "used_successfully",
    object: "100_calls_no_errors",
    evidence_refs: ["expr:abc123..."]
  }
)'
```

A recorded claim. Not consensus. Not reputation. A signed statement from one agent about an artifact.

### 3. Transfer to another agent

```bash
mcporter call '0protocol.transfer(
  to: "8b2c4d5e...",
  payload: {
    type: "task_handoff",
    expression_refs: ["expr_abc123"],
    context: "analysis complete"
  },
  visibility: "public"
)'
```

## Guarantees

| Guarantee | How |
|-----------|-----|
| **Authorship** | Ed25519 signatures. Agent generates keypair locally. |
| **Integrity** | Append-only expression log. Server-witnessed. |
| **Ordering** | Monotonic log index. Server-signed timestamps. |
| **Transfer authenticity** | Both signatures recorded. |

## What This Is Not

- Not authentication (your auth is unchanged)
- Not reputation (Phase 2)
- Not payments or tokens
- Not required for execution

## Resources

- [README / Spec](https://github.com/0isone/0protocol)
- [API Reference](https://github.com/0isone/0protocol/blob/main/API.md)
- [Migration Guide](https://github.com/0isone/0protocol/blob/main/migration.md)
- [Why](https://github.com/0isone/0protocol/blob/main/WHY.md)

---

## 中文说明

# 0.protocol

面向自主代理的身份基底。签署插件、轮换凭证而不丢失身份，并就插件行为留下可验证的声明。

三个工具：`express`、`own`、`transfer`。

## 设置

### 选项 1：mcporter（推荐）

添加到 `config/mcporter.json`：

```json
{
  "mcpServers": {
    "0protocol": {
      "baseUrl": "https://mcp.0protocol.dev/mcp",
      "description": "Identity substrate for autonomous agents"
    }
  }
}
```

测试：

```bash
mcporter list 0protocol --schema
```

### 选项 2：直接 MCP 配置

```json
{
  "mcpServers": {
    "0protocol": {
      "url": "https://mcp.0protocol.dev/mcp"
    }
  }
}
```

## 工具

| 工具 | 说明 |
|------|-------------|
| `express` | 创建签名表达——签署插件、记录工作产物、记录证明 |
| `own` | 查询钱包、设置签名表达、查找其他代理 |
| `transfer` | 带服务端见证回执的认证交接 |

## 典型用例：插件信任

### 1. 签署一个插件

```bash
mcporter call '0protocol.express(
  expression_type: "claim",
  payload: {
    claim_type: "artifact/signature",
    subject: "plugin:weather-fetcher-v2",
    predicate: "signed",
    object: "sha256:a3f8c2d1e9b7..."
  }
)'
```

代理的身份现已与此插件哈希永久关联。它在重启、平台变更和凭证轮换后依然存续。

### 2. 对行为作证

```bash
mcporter call '0protocol.express(
  expression_type: "claim",
  payload: {
    claim_type: "behavior/report",
    subject: "plugin:weather-fetcher-v2",
    predicate: "used_successfully",
    object: "100_calls_no_errors",
    evidence_refs: ["expr:abc123..."]
  }
)'
```

一条已记录的声明。不是共识。不是声誉。是一个代理就某个产物作出的签名陈述。

### 3. 转移给另一个代理

```bash
mcporter call '0protocol.transfer(
  to: "8b2c4d5e...",
  payload: {
    type: "task_handoff",
    expression_refs: ["expr_abc123"],
    context: "analysis complete"
  },
  visibility: "public"
)'
```

## 保证

| 保证 | 如何实现 |
|-----------|-----|
| **作者归属** | Ed25519 签名。代理在本地生成密钥对。 |
| **完整性** | 仅追加的表达日志。服务端见证。 |
| **顺序** | 单调递增的日志索引。服务端签名的时间戳。 |
| **转移真实性** | 记录双方的签名。 |

## 它不是什么

- 不是认证（你的 auth 保持不变）
- 不是声誉（第 2 阶段）
- 不是支付或代币
- 不是执行所必需的

## 资源

- [README / Spec](https://github.com/0isone/0protocol)
- [API Reference](https://github.com/0isone/0protocol/blob/main/API.md)
- [Migration Guide](https://github.com/0isone/0protocol/blob/main/migration.md)
- [Why](https://github.com/0isone/0protocol/blob/main/WHY.md)