# @1claw/openapi-spec 中文文档

规范地址：https://npmcn.com/package/%401claw/openapi-spec/

版本：0\.61\.79
npm 元数据更新时间：2026-10-24T16:13:49.692Z
中文译文更新时间：2026-11-06T07:20:09.620Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%401claw/openapi-spec
原文对照：https://npmcn.com/package/%401claw/openapi-spec/?lang=original
项目主页：https://github.com/1clawAI/1claw#readme
源码仓库：https://github.com/1clawAI/1claw

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：3.1 MB，5 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-02-25T16:13:30.542Z
- 最新版本发布：2026-10-24T16:13:49.472Z
- 近 30 天下载量：4216（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：172（近 12 个月 172 个）

## 中文简介

OpenAPI 3.1.0 1Claw Vault API的规格——以任何语言生成客户端

## 安装

```sh
npm install @1claw/openapi-spec
```

也可以使用：`pnpm add @1claw/openapi-spec`、`yarn add @1claw/openapi-spec`、`bun add @1claw/openapi-spec`

## README

# @ 1claw/openapi- spec (v0. 61.0) (英语)

> ⭐ **星号 [1clawAI/代理模板](https://github.com/1clawAI/agent-templates)** ——即时运行代理模板接通1Claw. 这是我们唯一的主演Repo.

OpenAPI 3.1.0 规格 [1Claw 错失 API](https://1claw.co/)。使用此软件包生成任意语言的 API 客户端.

## 安装

```bash
npm install @1claw/openapi-spec
```

## 使用量

### 生成 TypeScript 客户端

```bash
npx openapi-typescript node_modules/@1claw/openapi-spec/openapi.yaml -o src/1claw-types.ts
```

### 生成 Python 客户端

```bash
openapi-generator generate \
  -i node_modules/@1claw/openapi-spec/openapi.yaml \
  -g python \
  -o ./1claw-client
```

### 生成 Go 客户端

```bash
openapi-generator generate \
  -i node_modules/@1claw/openapi-spec/openapi.yaml \
  -g go \
  -o ./1claw-client
```

### 在代码中使用

```typescript
import spec from "@1claw/openapi-spec/openapi.json";
```

## 光谱(v.0.61.76)中有哪些

与2026-10-19年的金库相匹配. 没有添加或删除路径; 路由器和 spec 列出相同的操作(`scripts/check-openapi-router-sync.sh`) (中文(简体) ).

-   **`approval_id` 自我监护准备**数字 : `POST /v1/treasury/wallets/{chain}/tss/prepare`, (中文(简体) ), `.../multisig/prepare` 财务报告和审定财务报表 `/v1/treasury/multisig-safes/{safe_id}/prepare` 现在运行 交易政策和 `treasury_send` ,并能够回答202 `pending_approval_id`重试 `approval_id` 一经批准.
-   **`kit_sealed` 删除** 从 `CreateMultisigWalletRequest` 财务报告和审定财务报表 `CreateMultisigSafeRequest`。只通过 `POST /v1/keys/{key_id}/kit` 带一个工具箱证明.
-   **`X-Auth-Confirm`** (重现目的) `tss.key.wrap_add`,强因数) `POST /v1/keys/{key_id}/client-share/rewrap`,然后继续 `PUT /v1/keys/{key_id}/client-share` 当密钥已经给那一代人包了.
-   **多负载 FROST 签名** (比特币投入):新的 `TssSignBeginResponse`, (中文(简体) ), `TssSignCompleteRequest` 财务报告和审定财务报表 `TssSignCompleteResponse` 由用户共享的计划 和代理签名路径,以及 `signing_payloads`, (中文(简体) ), `server_commitments_all`, (中文(简体) ), `client_commitments_all`, (中文(简体) ), `client_signature_shares_all` 财务报告和审定财务报表 `signatures`· ; `signatures` 在TSS两个广播请求.
-   **执行约束**: 邮递/MySQL URL 必须使用 `sslmode=verify-full` 编号 : `ssl-mode=VERIFY_IDENTITY` 或者说 `disable` (其他东西为400);装订 `/test` 夹子 `timeout_ms` 1 000.30 000和洗涤剂 `error`; grpc 协议头通过 代理头过滤器.
-   描述更新:通过代理添加 `POST /v1/platform/connections/{connectionId}/agents` 开始为原始签名; 靴子带为原始签名套件 `raw_signing_policy: approve`· ; 只有所有者/管理人员才能为支付或卡片代理机构创造子女; 安全执行 重新筛选并记录发送值.

## 光谱(v. 6.1.0)中有哪些

添加只——没有路径或参数重命名,因此生成的客户端不断编译.

-   **车队管理** —— 说 `GET /v1/platform/apps/{appId}/fleets/{template_id}` 财务报告和审定财务报表 `/agents`· ; `POST .../bulk-patch`, (中文(简体) ), `.../rollout`, (中文(简体) ), `.../pause`4个新的 计划 : `FleetSummaryResponse`, (中文(简体) ), `ListFleetAgentsResponse`, (中文(简体) ), `FleetAgent`, (中文(简体) ), `FleetRolloutResponse`。 。 。 .
-   **有两件事 描述是故意的**,因为客户端 猜错者会在组大小上造成损害: 已读 `bulk_patchable_fields` 而不是硬编码 不包括护栏和能力旗帜,并可能进一步收缩) `job_id` 将会是 `null` 为了一个干燥.
-   **`spec_hash` 打开 `PlatformTemplateResponse`** ——区分模板 版本突起,没有改变 从一个做了.
-   新的无效字段使用3.1个联盟类型(`type: [string, "null"]`更喜欢 比起3.0 `nullable:` 其它文件仍然使用关键字 .

## 谱中何为(v0.59.10)

添加只——没有路径或参数重命名,因此生成的客户端不断编译.

-   **浏览器设备管理** —— 说 `GET /v1/browser/devices` 财务报告和审定财务报表 `DELETE /v1/browser/devices/{id}`. 被拆除的设备被列出而不是 隐藏; 撤销是造成泄漏的原因 `bb_` 桥证书停止工作.
-   **填充请求获得四个所需字段** —— 说 `form_path`, (中文(简体) ), `field_names`, (中文(简体) ), `redirect_chain` 财务报告和审定财务报表 `current_generation` 打开 `POST /v1/agents/{id}/browser/fills`。它们是可选的,服务器已填充 当他们缺席时, 结束了它的三个政策检查。 请求 失踪了其中任何一个 被拒绝,400个命名他们。 发送 `current_generation` 正如一代所观察到的 _现在_: 数值与 `generation` 使 stality 检查比对它本身的值.
-   **`POST /v1/vaults` 第409号文件** 重复名称,以及400覆盖的 (空出,或超过255个字符). 两个都是500多岁. `CreateVaultRequest.name` 有着真正的限制.
-   **`POST /v1/runtimes/{id}/chat` 第503号文件** - 运行时间的最后开始 120多年前失败 还没有被重新审判.

## 光谱(v0.59.4)中有哪些

### 平台连接扩展(v0.59.4)

-   **组合** —— 说 `GET /v1/platform/connections/{id}/portfolio` 和别名 `GET .../balances` (plt auth; 可选) `?chains=`, (中文(简体) ), `?include_tokens=`(中文(简体) )
-   **待批准后创建** —— 说 `POST /v1/platform/connections/{id}/pending-approvals` (plt 认证; 返回) **202 (韩语)** 与 `pending_approval_id`(中文(简体) )
-   **连接自动化** —— 说 `GET/POST .../automations`, (中文(简体) ), `POST .../automations/{aid}/runs/{rid}/cancel`
-   **连接内存** —— 说 `GET/PUT/DELETE .../memory/{namespace}/{key}` (可选) `?agent_id=`(中文(简体) )
-   **内容检查** —— 说 `POST /v1/shroud/inspect-content` (多氯多氯乙烯) `inspect_content` 等同; plt ,代理 JWT,用户 JWT)
-   **签名密钥+代理补丁** —— 说 `GET .../signing-keys`, (中文(简体) ), `PATCH .../agents/{aid}` (v0.59.3,此处为完整性记录)

## 光谱(v0.58

### 平台控制平面(v0.58)

-   **应用范围读取( A)`plt_`(中文(简体) )** —— 说 `GET /v1/platform/connections/{id}/approvals`,待核准(包括 `payload_hash`),支出政策
-   **支出政策** —— 说 `GET /v1/platform/apps/{id}/spend-policies/{policy_id}`· ; `PUT .../connections/{id}/spend-policy` 支持可选 **`Idempotency-Key`** (24小时重放)
-   **应用生命周期** ——软删除返回 `{ id, slug, deleted_at }`; shall 独有的每 org; 不活动的应用程序返回 404
-   **所有权转让** —— 说 `POST /v1/platform/apps/{id}/transfer-ownership` 带有阶梯认证

### API平台扩展(v

-   **SIWE 供给** —— 说 `POST /v1/platform/siwe/challenge`; 更新钱包主题符号
-   **参数化模板** - 拖带 `parameters` 贾森:; `POST .../templates/{tid}/preview` 干线运行 `{{params.*}}` 编号 : `{{subject.*}}`
-   **连接投票** —— 说 `GET /v1/platform/connections/{id}` (状况、索赔、应享权利、钱包地址)
-   **每条连接用法** —— 说 `GET .../connections/{id}/usage` (参考支出,协调世界时)
-   **连锁应享权利** —模板 `entitlements[]`; 刷新+显示器端点
-   **推论预算** 使用政策推断津贴领域; `GET /v1/treasury/wallets/inference-budget`

### 安全账户和看守设施治理(v.56)

-   **代理账户** —— 说 `GET/POST /v1/agents/{id}/accounts`,迁移/折旧 EOA,模块登记册
-   **铁路管理** ——影子报告,修订,回放;拓宽护栏回放 **202 (韩语)** + 核准
-   **人类因素 Auth** ——国库送出/抽出/出口升级政策
-   **奥尔克解冻** - T3级升级;累计天然气预算分类账

### 毕业于HITL和扩展护栏(v0.54-0.55)

-   **代理栏** —— 说 `tx_approval_policy`, (中文(简体) ), `typed_data_policy`, (中文(简体) ), `simulation_failure_policy`, (中文(简体) ), `raw_signing_policy`, (中文(简体) ), `personal_sign_policy`, (中文(简体) ), `tx_block_unlimited_approvals`,每个接收人限额,美元上限, `allow_erc4337`, (中文(简体) ), `allow_eip7702`, (中文(简体) ), `auto_suspended`, (中文(简体) ), `clear_auto_suspended` (更新)
-   **兽类冻结** —— 说 `POST /v1/org/freeze`, (中文(简体) ), `POST /v1/org/unfreeze` (业主/管理人员紧急站)
-   **签名 HITL** EIP-712和原始消化意图可以返回 **202 (韩语)** `awaiting_approval` 当策略是 `approve`
-   **网络呼号** —— 说 `tx.awaiting_approval`, (中文(简体) ), `sign.awaiting_approval`, (中文(简体) ), `agent.suspended`, (中文(简体) ), `org.frozen`

### 环境变量(v.51)

-   **硬币** —— 说 `GET/POST /v1/vaults/{id}/env-vars`, (中文(简体) ), `GET/PATCH/DELETE .../{key}`, (中文(简体) ), `GET .../resolve` 具有三级优先级( org 共享 < 保险库 < 分支覆盖)
-   **默认环境** —— 说 `GET/POST /v1/vaults/{id}/environments`, (中文(简体) ), `DELETE .../{slug}` (内建+分级定制)
-   **Org 共享 vars** —— 说 `GET/POST /v1/org/env-vars`,链接/解链接到金库
-   **敏感扇形** ——创建后只写;org设置 `env.require_sensitive_prod`
-   **运行时间注射** ——已解决的 vars 在开始/重建时被合并到 Cloud runtime 容器内

### 代理环境标签(v0.52)

-   **代理栏** —— 说 `environment`, (中文(简体) ), `environment_locked`, (中文(简体) ), `env_auto_resolve`, (中文(简体) ), `per_environment_guardrails` 创建/更新/响应计划
-   **1\. JWT索赔** - 代理代号包括: `environment` 当代理商有标签时
-   **政策条件** —— 说 `environment_in` 内置策略中的数组 `conditions` 贾森
-   **Env var 分辨率** —— 说 `GET /v1/vaults/{id}/env-vars/resolve` 接受可选 `environment`; 当代理标记时自动填充 `env_auto_resolve` 真实

### 锡达/OPA 执行v2(v.0.48)

-   **政策后端** —— 说 `GET/PATCH /v1/org/settings/policy-backend`, (中文(简体) ), `GET /v1/org/policy-shadow-report`
-   **合同 ABIs** —— 说 `POST/GET/DELETE /v1/org/contract-abis`, (中文(简体) ), `GET /v1/org/contract-abis/{id}`
-   **待核准** —— 说 `POST/GET /v1/pending-approvals`,批准/执行/取消子程序
-   **协商一致触发因素** —— 说 `consensus_trigger` 准入政策计划
-   **动态执行 状态** 锡达/OPA政策和测试对策

### 统包平价(v0.47)

-   **组合** —— 说 `GET /v1/portfolio` (统一余额合计)
-   **雪松政策** —— 说 `POST/GET/DELETE /v1/org/cedar-policies`干线 `POST .../test` (小组+层级)
-   **OPA 政策** —— 说 `POST/GET/DELETE /v1/org/opa-policies`干线 `POST .../test` (商业+层级)
-   **次级组织** —— 说 `POST/GET/DELETE /v1/org/sub-orgs`,权限,用户,钱包生成
-   **智能账户导入** —— 说 `POST /v1/agents/{id}/smart-accounts/import`
-   **签名密钥 BYOK** —— 说 `POST /v1/agents/{id}/signing-keys/{chain}/import` (仅限人类, `X-Auth-Confirm`(中文(简体) )
-   **导入金库钱包** —— 说 `POST /v1/treasury/wallets/{chain}/import` (仅限人类,多链发送)

### OAuth和平台增强(0.44.4)

-   **OAuth 证书撤销** —— 说 `POST /v1/oauth/revoke` (RFC 7009 令牌撤销)
-   **撤销同意** —— 说 `DELETE /v1/oauth/consents/{app_id}` (用户取消特定应用程序的同意)
-   **平台市场** —— 说 `GET /v1/platform/marketplace` (经批准的平台应用公开上市)
-   **App 统计** —— 说 `GET /v1/platform/apps/{id}/stats` (平台应用程序的使用和连接统计)
-   **Webhook 秘密旋转** —— 说 `POST /v1/platform/apps/{id}/rotate-webhook-secret` (旋转一个平台的应用程序的 webhook 签名秘密)

### 自动化 v2 & 通道 (2.33)

-   **自动化 v2** ——有多步管线的工作流发动机,有14步型, `{{...}}` 模板变量,条件逻辑(`skip_if`编号 :`run_if`),10个营销预设,webhook/event/cron/手动触发. 丰富列表 API `last_run_status`, (中文(简体) ), `total_runs`, (中文(简体) ), `success_rate`, (中文(简体) ), `agent_name`。运行细节 `context` 杰森贝。 协助起草工作流程.
-   **代理频道** ——Telegram,WhatsApp,Discord代理的通讯通道. CRUD,发送,消息历史,测试连接.
-   **代理内存** ——三层内存(分刻,耐用,语义),休息时有加密. CRUD,语义搜索,命名空间管理.
-   **云跑时** ——有生命周期管理,托管,交互式外壳的管理容器. 预设从小到大cc(机密计算).
-   **平台代表团** – 平台应用程序可以通过 : `X-Platform-Connection` 头曰. 代表团的审计记录.
-   **发现** 公共代理目录和平台市场.

### 非EVM交易签名(2.23)

-   **意图 API** —— 说 `SubmitTransactionRequest` 编号 : `SignTransactionRequest` 编号 : `SignIntentRequest` 与非 EVM 字段相扩展 : `destination_tag` (XRP), `memo`, (中文(简体) ), `fee_rate_sat_per_vbyte` (比特币), `fee_limit_sun` (特伦), `token_mint` 编号 : `token_decimals` (Solana SPL + Tron TREC-20), (中文(简体) ), `ttl` (卡尔德诺语). 原生标志+为比特币,索拉纳,XRP,卡多诺,特龙广播.
-   **`xrpl_tx_json`** ——可选生 XRPL 交易 JSON,用于30+交易类型超出简单支付.

### 风险引擎 & DPoP (2.19)

-   **风险事件** —— 说 `GET /v1/risk/events` (列表,按严重程度/主类型可过滤)
-   **风险判决** —— 说 `GET /v1/risk/verdicts` (积极判决), `GET /v1/risk/verdicts/{type}/{id}` (单一主要判决)
-   **甜点** —— 说 `GET/POST/DELETE /v1/risk/honeytokens` (金刚秘密 CRUD 有触发计数)
-   **DPOP 软件** - RFC 9449 证明邮购证书装订(已交付)

### 网络呼号( 2. 19)

-   **Webhook CRUD 软件** —— 说 `POST/GET /v1/webhooks`, (中文(简体) ), `GET/PATCH/DELETE /v1/webhooks/{id}`。活动: `wallet.transfer.*`, (中文(简体) ), `proposal.*`, (中文(简体) ), `agent.transaction.*`, (中文(简体) ), `signing_key.rotated`, (中文(简体) ), `policy.*`

### OAuth & 电子邮件检察官办公室 (2.19)

-   **OAuth2 授权服务器** —— 说 `GET/POST /v1/oauth/authorize`, (中文(简体) ), `POST /v1/oauth/token`, (中文(简体) ), `GET /v1/oauth/userinfo` ("与一法相签"
-   **电子邮件检察官办公室** —— 说 `POST /v1/auth/email-otp/send`, (中文(简体) ), `POST /v1/auth/email-otp/verify` (无密码登录)
-   **支出政策** —— 说 `POST/GET/DELETE /v1/platform/apps/{id}/spend-policies`, (中文(简体) ), `PUT /v1/platform/connections/{id}/spend-policy`, (中文(简体) ), `GET /v1/treasury/wallets/spend-policy`

### Bankr 动态密钥自动售出(2.18)

-   **银行密钥** —— 说 `POST /v1/agents/{id}/bankr-keys/lease`, (中文(简体) ), `GET /v1/agents/{id}/bankr-keys`, (中文(简体) ), `DELETE /v1/agents/{id}/bankr-keys/{lease_id}`. 范围、 TTL 捆绑的伙伴密钥自动售出 `bk_usr_` 钱包 API 密钥.

### CDP 对等和嵌入式钱包(2.16+)

-   **交存目的地** —— 说 `POST/GET/PATCH /v1/deposit-destinations`, (中文(简体) ), `GET /v1/deposit-destinations/{id}`
-   **内部账户** —— 说 `POST/GET /v1/internal-accounts`, (中文(简体) ), `POST /v1/internal-transfers` (支助) `Idempotency-Key`, (中文(简体) ), `GET /v1/internal-accounts/{id}/ledger`
-   **菲亚特斜坡** —— 说 `POST /v1/fiat/onramp/session`, (中文(简体) ), `POST /v1/fiat/offramp/initiate`, (中文(简体) ), `POST /v1/fiat/webhooks` (生产时需有月薪签字)
-   **社会登录** —— 说 `POST /v1/auth/social-login` (Google/Apple ID标志,附有观众验证;Discord授权代码+) `oauth_redirect_uri`;没有电子邮件自动链接——409起冲突)
-   **密码 tx 认证** —— 说 `POST /v1/auth/passkeys/tx-assert/begin|complete` → `X-Passkey-Token` (+ 可选) `X-Passkey-Tx-Digest`在财务处发送

### 核心 API (摘要)

-   **OIDC联合会(1claw as IdP)** —— 说 `GET /.well-known/openid-configuration` (公开发现: 发行者, jwks uri, 支持 algs) `["EdDSA","RS256"]`,支持的赠款类型,包括证券交换), `GET /.well-known/jwks.json` (公用 JWKS – 每个活跃的 EdDSA + RS 256 密钥版本,由确定键 `kid`, (中文(简体) ), `POST /v1/auth/federated-token` (RFC 8693 令牌交换——接受JSON或 `application/x-www-form-urlencoded`;主题符号是代理人JWT或 `ocv_` API 密钥; 返回 RS256 JWT 范围到 `audience`) (中文(简体) ). 代理字段 : `federation_enabled`, (中文(简体) ), `federation_audiences[]`, (中文(简体) ), `federated_token_ttl_seconds`被设计为Anthropic工作负荷识别联合会,GCP STS,AWS STS等.
-   **Auth - 代理人 JWT** —— 说 `POST /v1/auth/agent-token` 任择性JWT索赔 **`shroud_config`** 当代理机启用了Shroud(模拟 DB;在LLM请求上被Shroud PolicyEngine所消耗)时. 更改代理 Shroud 设置后重新交换 。 联邦令牌使用单独的KMS RSA-2048密钥并被署名RS256.
-   **Auth - 密码重置** —— 说 `POST /v1/auth/forgot-password`, (中文(简体) ), `POST /v1/auth/reset-password` (公开;反数被遗忘)
-   **Auth - 设置密码** —— 说 `POST /v1/auth/set-password` (对于还没有密码的 OIDC 平台用户)
-   **Auth - 电子邮件更改** —— 说 `POST /v1/auth/change-email` (要求,发送核查代码), `POST /v1/auth/verify-email-change` (用代码验证)
-   **Auth —— 密码( WebAuthn)** —— 说 `POST /v1/auth/passkeys/register/begin`, (中文(简体) ), `POST .../register/complete`, (中文(简体) ), `POST /v1/auth/passkeys/assert/begin`, (中文(简体) ), `POST .../assert/complete`, (中文(简体) ), `GET /v1/auth/passkeys` (名单), `DELETE /v1/auth/passkeys/{passkey_id}`
-   **核准** ——"人入"审批工作流程: `POST /v1/approvals/request`, (中文(简体) ), `GET /v1/approvals`, (中文(简体) ), `GET /v1/approvals/{id}`, (中文(简体) ), `POST /v1/approvals/{id}/decide`
-   **计费——LLM代币计费** —— 说 `GET /v1/billing/llm-token-billing` (单位:千美元)`LlmTokenBillingStatus`数字 : `enabled`, (中文(简体) ), `subscription_status`选项 `credit_balance`选项 `billing_cycle_usage` 与 `metered_lines[]`, (中文(简体) ), `POST .../subscribe`, (中文(简体) ), `POST .../disable` ( Stripe AI Gateway 添加; 可选的 Org 特性)
-   **财务处** - 安全的多面国库: `POST/GET /v1/treasury`, (中文(简体) ), `GET/PATCH/DELETE /v1/treasury/{id}`,签名人,代理访问请求(`requests[]` 名单)
-   **财务袋** – 为人类用户生成多链钱包(取代 CDP 嵌入式钱包): `POST /v1/treasury/wallets/generate`, (中文(简体) ), `GET /v1/treasury/wallets`, (中文(简体) ), `GET /v1/treasury/wallets/{chain}`, (中文(简体) ), `POST .../export`, (中文(简体) ), `POST .../rotate`, (中文(简体) ), `DELETE /v1/treasury/wallets/{chain}`所支持的链:乙醚、比特币、索兰娜、克普、卡达诺、特龙。 私人密钥存储于每组 `__treasury-keys` 保险库内有适当的MPC监管层.
-   **财务处提议** - 全面提议/确认/执行安全多项目交易的管道: `POST /v1/treasury/{id}/proposals`, (中文(简体) ), `GET .../proposals`, (中文(简体) ), `GET .../proposals/{pid}`, (中文(简体) ), `POST .../proposals/{pid}/sign`, (中文(简体) ), `POST .../proposals/{pid}/execute`, (中文(简体) ), `DELETE .../proposals/{pid}`当阈值达到时自动执行.
-   **智能账户** - 代理多链 安全账户 : `POST /v1/agents/{id}/smart-accounts`, (中文(简体) ), `GET /v1/agents/{id}` 返回时 `smart_accounts[]`。每个代理商一个EOA签名人,意向 API 解决安全性 `chain_id`。 。 。 .
-   **断层** —— CRUD, CMEK 启用/失效, 带有任务跟踪的密钥旋转, MPC 启用/失效(`POST /v1/vaults/{id}/mpc`, (中文(简体) ), `DELETE /v1/vaults/{id}/mpc`(中文(简体) )
-   **秘诀** —— CRUD,版本化,CMEK加密的旗帜, `client_share` 答复(MPC金库)
-   **探员** - CRUD 带有: `auth_method` (api key, mtls, oidc client creditities),自动生成的SSH 键盘, `token_ttl_seconds`, (中文(简体) ), `vault_ids`,意向API,交易护栏(`tx_to_allowlist`, (中文(简体) ), `tx_max_value` (国内主要单位), `tx_daily_limit` (每链), `tx_allowed_chains`, (中文(简体) ), **OIDC 联合会** (单位:千美元)`federation_enabled`, (中文(简体) ), `federation_audiences`, (中文(简体) ), `federated_token_ttl_seconds`(三); **`GET /v1/agents/{id}`** 包含 **`tx_spent_today`** 财务报告和审定财务报表 **`tx_spent_today_by_chain`** (按本地单位计算的每链每日开支) **外壳** 执行日封顶和每吨限制。 折旧的别名 `tx_max_value_eth`, (中文(简体) ), `tx_daily_limit_eth`, (中文(简体) ), `tx_spent_today_eth` 仍然为后向兼容性接受/返回.
-   **签名密钥** - 多链关键管理: `POST /v1/agents/{id}/signing-keys` (规定), `GET .../signing-keys` (名单), `POST .../signing-keys/{chain}/rotate`, (中文(简体) ), `DELETE .../signing-keys/{chain}` (减). 支持乙醚、比特币、索兰娜、xrp、卡达诺、Tron
-   **统一签名** —— 说 `POST /v1/agents/{id}/sign` ——EIP-191个人签名,EIP-712打入-数据,和EIP-2718交易类型(legacy,EIP-1559,EIP-4844,EIP-7702)的单端点
-   **政策** - 基于全球的出入控制
-   **共享** 链接、用户/代理共享、接受/减少
-   **计费** ——订阅,入帐,×402,LLM代币记账(见上文)
-   **审计** - 链条事件日志
-   **链条** - 支持的区块链登记册
-   **认证** - JWT,API密钥,代理令牌,MFA,设备流,Google OAuth,, **密码 (WebAuthn)**, (中文(简体) ), **联邦勋章(RFC 8693)**
-   **平台** 1Claw上的多租入应用程序的平台API: `POST/GET /v1/platform/apps`, (中文(简体) ), `GET/PATCH/DELETE /v1/platform/apps/{id}`, (中文(简体) ), `POST/GET /v1/platform/apps/{id}/templates`, (中文(简体) ), `POST /v1/platform/users/upsert`, (中文(简体) ), `POST /v1/platform/connections/{id}/bootstrap`, (中文(简体) ), `GET /v1/platform/apps/{id}/users`, (中文(简体) ), `GET /v1/platform/apps/{id}/audit`, (中文(简体) ), `GET/DELETE /v1/platform/connected-apps`, (中文(简体) ), `GET /v1/platform/claim/{token}` (审查), `POST /v1/platform/claim/{token}` (编). 平台应用认证 `plt_` 前缀的 API 密钥。 支持OIDC用户提供,靴子模板,以及计费模式(平台 付费,用户 付费,混合).
-   **奥尔格** - 名单成员,邀请、更新/撤除成员; `GET /v1/org/agent-keys-vault` (仅限用户使用,返回 agents- keys 保险库 id 或 404)

## 包含文件

-   `openapi.yaml` - 犬科YAML规格
-   `openapi.json` - JSON版本,用于更喜欢JSON的工具

## 许可证

[麻省理工学院](https://npmcn.com/package/%401claw/openapi-spec/LICENSE)

## 常见问题

### @1claw/openapi-spec 是什么？

OpenAPI 3\.1\.0 1Claw Vault API的规格——以任何语言生成客户端

### 如何安装 @1claw/openapi-spec？

在项目目录运行 npm install @1claw/openapi-spec，或使用 pnpm add / yarn add / bun add。

### @1claw/openapi-spec 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/1claw\_\_openapi-spec 是否存在。

### @1claw/openapi-spec 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @1claw/openapi-spec 可以商用吗？

@1claw/openapi-spec 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @1claw/openapi-spec 的下载量有多少？

根据 npm 官方下载统计，@1claw/openapi-spec 在 2026/10/05 – 2026/11/03 这 30 天内被下载 4,216 次，日均约 141 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @1claw/openapi-spec 还在维护吗？

最新版本 0\.61\.79 发布于 2026/10/25（14 天前）；至今共发布 172 个版本，其中过去 12 个月发布了 172 个；首次发布于 2026/02/26。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。