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

⭐ 星号 1clawAI/代理模板 ——即时运行代理模板接通1Claw. 这是我们唯一的主演Repo.

OpenAPI 3.1.0 规格 1Claw 错失 API。使用此软件包生成任意语言的 API 客户端.

安装

npm install @1claw/openapi-spec

使用量

生成 TypeScript 客户端

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

生成 Python 客户端

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

生成 Go 客户端

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

在代码中使用

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, (中文(简体) ), .../pause4个新的 计划 : 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的工具

许可证

麻省理工学院