---
title: "給你的 AI agent 一個 wallet，而不必交出你的 private keys"
description: "Alchemy CLI 中的 Agent wallets 讓開發者可以授予 coding agents 有範圍限制、有時效性的 onchain 交易權限，而不必暴露 private keys。"
---

# 給你的 AI agent 一個 wallet，而不必交出你的 private keys

<ImageBlock
  src="https://media.alchemy.com/blog/agent-wallets-cli-hero-16x9-20260821.png"
  alt="Alchemy CLI 中的 Agent wallets"
  width={1920}
  height={1080}
  priority
/>

[AI 代理](https://www.alchemy.com/dapps/best/ai-agents)現在可以在鏈上執行傳送、交換、跨鏈橋接與存款。從你的終端機操作，完全不需要持有私鑰。

今天我們在 Alchemy CLI 中推出代理錢包（agent wallets）功能。開發者可以從 Alchemy 儀表板建立錢包，授予 CLI 有範圍限制、有時效的存取權限，讓代理從指令列執行真實交易。錢包的建立與撤銷只能在儀表板進行。錢包的私鑰不會經過 CLI，不會經過 Alchemy，也不會存放在任何 `.env` 檔案裡。

<ExternalVideo
  url="https://www.youtube.com/watch?v=NNbvdo-JCw4"
  provider="youtube"
  providerUid="NNbvdo-JCw4"
/>

在上方的示範中，Claude 找到 USDC 最佳的 [Aave](https://www.alchemy.com/dapps/aave) 市場，將資金跨鏈橋接到正確的鏈，並存入該資金池。在此之前，這樣的工作流程需要自訂代理程式碼持有私鑰，或是在錢包 SDK 與程式碼助手之間手動打造整合。現在只需要幾個指令與一次儀表板點擊。

## 在此之前，代理如何在鏈上進行交易

在此之前，開發者一般有兩條可行路徑，但都不是理想的預設做法。要不是將私鑰貼進 `.env`，接受代理現在對這些資金擁有完全控制權，就是將錢包 SDK 接進自訂後端，自行重新實作驗證、簽署與撤銷邏輯。第一種選項只要一次失控的提示詞就可能讓錢包被掏空。第二種選項則是多數團隊不該花費的數週工作量。

CLI 中的代理錢包功能取代了這兩種做法。你透過 Alchemy 儀表板保有錢包的保管權。代理則獲得你從終端機核准的有範圍 session。你可以一鍵撤銷該 session。

## 運作方式

此架構將職責分為三方。[Privy](https://www.privy.io/) 是我們的嵌入式錢包合作夥伴，安全地持有錢包的私鑰。我們則負責 CLI session 與中間的驗證層。你則透過儀表板掌握核准與撤銷的控制權。

當你執行 `alchemy wallet connect` 時，CLI 會在你的機器上產生一組全新的 P-256 金鑰對。私鑰不會離開該裝置。你的瀏覽器會開啟 Alchemy 儀表板，在那裡你可以建立或選擇要讓代理使用的錢包，並核准該 session。核准動作會將你 CLI 的公鑰附加為該錢包的簽署者，並限定特定的能力範圍，以及你在儀表板設定的 session 到期時間。

每一次簽署呼叫都是兩階段的挑戰流程：Alchemy 後端建構 Privy 所預期的標準化 payload，你的 CLI 在本機對確切的位元組進行簽署，唯有如此請求才會送達 Privy。如果 session 已過期、已從儀表板撤銷，或未通過任何綁定檢查，下一次簽署嘗試會在離開我們的基礎設施之前就被拒絕。撤銷只需一鍵，且立即生效。

一旦 session 啟用，代理便可存取完整的交易範圍：傳送、交換、跨鏈橋接、合約呼叫。交易會透過我們的[錢包 API](https://www.alchemy.com/docs/wallets)進行，因此 gas 贊助、批次處理、自動重試、ERC-20 gas 支付與跨鏈交換都一併涵蓋在內。原本已封裝我們[資料 API](https://www.alchemy.com/docs/data)以供查詢使用的同一個 CLI，現在也能透過你授權的錢包發送交易。

## 從一開始就為程式碼代理而打造

Alchemy CLI 從設計之初就是作為 AI 代理的工具介面。兩個旗標（flag）承載了這個意圖：`--json` 回傳結構化輸出以供解析，`--no-interactive` 則停用提示詞，讓指令不會因等待輸入而卡住。另外還有一個 `alchemy agent-prompt` 指令，會輸出一份 JSON 文件，描述每個指令、每個旗標、每個錯誤代碼，以及可執行的範例。將它放進 system prompt，你的代理就能一次學會整個介面。

這代表代理會自動掌握新的錢包指令。不需要整合 SDK，不需要解讀文件頁面，也不需要工程化提示詞來教模型理解新指令的運作方式。CLI 會自己告訴代理。

## 今天可以使用的內容

CLI 中的代理錢包功能現已上線，沒有候補名單，也沒有獨立方案。你需要 Node 22 或更高版本，以及一個 Alchemy 帳號。session 與錢包管理介面位於儀表板；交易介面則位於終端機。

<CodeSnippet
  language="bash"
  code={`npm i -g @alchemy/cli@latest
alchemy auth
alchemy wallet connect`}
/>

三個指令，你就擁有一個可供代理控制、隨時可用的錢包。完整的參考文件，包括每個指令、每個旗標與每個支援的網路，都在 [CLI 文件](https://www.alchemy.com/docs/alchemy-cli)中。

如果你打造的代理需要在鏈上執行操作，CLI 就是我們希望你使用的介面。[安裝 CLI](https://www.alchemy.com/docs/alchemy-cli)並[登入儀表板](https://dashboard.alchemy.com/)。