@agentlayer.tech/wallet

中文文档
0.1.143发布于 2026/11/07SEE LICENSE IN LICENSEES Module零依赖构建来源已验证近 30 天下载 2420

Universal AgentLayer wallet installer for OpenClaw, Codex, Cursor, Claude Code, and Hermes.

原始使用文档
文档目录15 节
  1. Install
  2. x402 payments only (no install, MCP)
  3. Choose frameworks explicitly
  4. Update
  5. Check the installation
  6. Universal local MCP
  7. Hosted x402 payment MCP
  8. Common commands
  9. Optional connectors
  10. What AgentLayer provides
  11. Claude Code marketplace
  12. ChatGPT desktop and Codex marketplace
  13. OpenClaw plugin
  14. Security
  15. License

AgentLayer

npm version npm downloads Node 24.x docs

Try AgentLayer — an agent-native, local crypto wallet with built-in tools from leading protocols: pay with x402, swap, earn yield, and issue fiat cards with stables.

Install

npx --yes @agentlayer.tech/wallet@latest install --yes

It works with:

  • Codex
  • Cursor
  • Claude Code
  • OpenClaw
  • Hermes

You need:

  • Node.js 24
  • npm
  • Python 3

Restart your agents after installation.

x402 payments only (no install, MCP)

If you only need x402 payments on base, connect this remote MCP instead:

https://x402.agent-layer.tech/mcp

This is just an MCP server. It gives access to x402 payments (search paid services, preview, and pay in USDC on Base) plus basic USDC receive and send on Arc — it is not the full AgentLayer wallet: no Solana, swaps, or DeFi. Add it as a custom connector in any MCP host that supports remote servers with OAuth (for example Claude) and sign in with Google or GitHub.

Meta Muse: open https://x402.agent-layer.tech/muse, sign in, and create a personal access token. The page gives you a ready prompt for Muse; enter the token only in Muse's secure credential prompt, not in the chat. See Hosted x402 payment MCP for details.

Choose frameworks explicitly

npx --yes @agentlayer.tech/wallet@latest install --yes --hosts codex,claude-code

Supported host names are:

codex
cursor
claude-code
openclaw
hermes

To see what AgentLayer detects:

npx --yes @agentlayer.tech/wallet@latest detect --json

Update

If the wallet command is available:

wallet update --yes

If the CLI is missing or outdated:

npx --yes @agentlayer.tech/wallet@latest update --yes

An update refreshes the shared runtime and the frameworks already connected to AgentLayer. It does not add a newly installed framework without your choice.

To update only selected frameworks:

npx --yes @agentlayer.tech/wallet@latest update --yes --hosts codex,claude-code

Preview an update without applying it:

wallet update --yes --dry-run

Check the installation

wallet status
wallet doctor

Universal local MCP

Any MCP client that supports the standard local stdio transport can use the same wallet runtime without installing a Codex, Cursor, Claude Code, OpenClaw, or Hermes plugin. Install the runtime, then print a ready-to-paste MCP config:

npx --yes @agentlayer.tech/wallet@latest install --yes --runtime-only
npx --yes @agentlayer.tech/wallet@latest mcp config

The generated config starts a local process at the stable agent-wallet-runtime/current path. It exposes the same wallet tools as the Codex, Cursor, and Claude Code bridges. Transaction policy, preview/prepare/execute, and approval checks remain enforced by the shared Python wallet runtime.

For clients that ask for an executable path instead of JSON, use:

npx --yes @agentlayer.tech/wallet@latest mcp path

If the global CLI is not installed:

npx --yes @agentlayer.tech/wallet@latest status
npx --yes @agentlayer.tech/wallet@latest doctor

After an install or update, restart the connected agent applications when wallet status shows restart_required: true.

Hosted x402 payment MCP

Connect URL: https://x402.agent-layer.tech/mcp

Cloud-agent and mobile-host users can be served by the separate x402-payment-mcp/. It is remote MCP with first-party OAuth (Google/GitHub login), one CDP-managed Base wallet per user, and Base USDC x402 payments. It does not replace or share custody assumptions with the local wallet runtime.

Common commands

wallet detect --json
wallet status
wallet doctor
wallet update --yes
wallet rollback

Optional connectors

Connectors add optional third-party crypto and DeFi read tools without moving existing integrations such as Aave, Kamino, or Morpho out of the wallet core.

wallet connectors inspect ./connector.json
wallet connectors install ./connector.json --enable --yes
wallet connectors list
wallet connectors disable com.example.protocol
wallet connectors doctor

Enabled read-only connectors appear in OpenClaw and Codex after the host is restarted. Write-capable connectors remain unavailable until their verified, AgentLayer-hosted execution path is fully enabled. See connectors/README.md for the trust model and protocol.

What AgentLayer provides

AgentLayer connects supported agents to one local wallet runtime. The agent can:

  • view balances and portfolio positions
  • send and receive supported assets
  • swap tokens
  • use supported DeFi services
  • access paid APIs through x402
  • work with Solana, Ethereum, and Base

Read operations are available directly. Operations that move funds remain protected by wallet policy and approval checks.

Claude Code marketplace

Claude Code users can also install the plugin from its marketplace:

/plugin marketplace add lopushok9/Agent-Layer
/plugin install agent-wallet@agentlayer

Restart Claude Code after installation.

ChatGPT desktop and Codex marketplace

As an alternative to the npm installer, add the public AgentLayer Git marketplace and install the local wallet plugin:

codex plugin marketplace add lopushok9/Agent-Layer
codex plugin add agent-wallet@agentlayer

Restart ChatGPT desktop or Codex, then select Agent Wallet from the AgentLayer source in the Plugins Directory. On first MCP start, the plugin installs the shared wallet runtime through @agentlayer.tech/wallet if it is missing. This requires Node.js 24, npm, and Python 3. The wallet and signing policy stay on your machine. The npm installer above remains the primary installation path; it can also update and repair the runtime installed through this marketplace.

The marketplace plugin uses the same local wallet as the npm installation. If you already installed agent-wallet@local, use one of the two plugin entries in a session to avoid duplicate wallet tools.

OpenClaw plugin

OpenClaw users can also install the native plugin from ClawHub:

openclaw plugins install clawhub:@agentlayertech/agent-wallet-plugin

The universal npm installer is still required to prepare the local wallet runtime.

Security

The agent receives wallet capabilities, not wallet keys.

  • Keys and signing stay on the user's machine.
  • Wallet secrets are encrypted locally.
  • Updates preserve existing wallets and identities.
  • Transactions remain subject to wallet policy and approvals.

On macOS, AgentLayer uses the login Keychain by default. macOS may ask for Keychain access during an install or update. Approve it only when you initiated the AgentLayer command.

Keep a secure offline copy of your recovery key.

License

This repository is available under the PolyForm Small Business License 1.0.0. Individuals, researchers, students, security reviewers, hobbyists, and eligible small businesses may use and modify it under the terms of that license.

版本与发布记录

@agentlayer.tech/wallet 共发布 100 个版本,首次发布于 2026/05/01;过去 12 个月发布了 100 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.1.143latest2026/11/07今天
0.1.1422026/11/043 天前
0.1.1402026/10/2613 天前
0.1.1322026/10/2414 天前
0.1.1312026/10/2414 天前
0.1.1242026/10/2118 天前

其他发布通道:beta → 0.1.7-beta.12。

关于 @agentlayer.tech/wallet 的常见问题

@agentlayer.tech/wallet 是什么?

Universal AgentLayer wallet installer for OpenClaw, Codex, Cursor, Claude Code, and Hermes.

如何安装 @agentlayer.tech/wallet?

在项目目录运行 npm install @agentlayer.tech/wallet,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 wallet,可以用 npx wallet 直接运行。

@agentlayer.tech/wallet 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/agentlayer.tech__wallet 是否存在。

@agentlayer.tech/wallet 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@agentlayer.tech/wallet 可以商用吗?

@agentlayer.tech/wallet 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中,请阅读该文件确认可否商用。以上为概括,不构成法律意见,请以许可原文为准。

@agentlayer.tech/wallet 的下载量有多少?

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

@agentlayer.tech/wallet 还在维护吗?

最新版本 0.1.143 发布于 2026/11/07(今天);至今共发布 100 个版本,其中过去 12 个月发布了 100 个;首次发布于 2026/05/01。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。