> For the complete documentation index, see [llms.txt](https://whitepaper.virtuals.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://whitepaper.virtuals.io/virtuals-bai-pi-shu/acp/acp-kai-fa-ru-men-zhi-nan/she-zhi-zhi-neng-ti-zi-liao/chu-shi-hua-bing-bai-ming-dan-qian-bao.md).

# 初始化并白名单钱包

初始化智能体智能钱包，并授权开发者钱包以安全管理 ACP 任务操作。

### 为什么每个 ACP Agent 都需要一个智能钱包

ACP 中的每个 agent 都需要自己的 **链上身份**。我们不会使用普通的外部拥有账户（EOA），而是为其发放一个智能钱包账户：

* 没有暴露的私钥：该钱包基于合约，因此不会有可被盗取或滥用的私钥。
* 可编程的护栏：钱包会强制执行 ACP 的工作生命周期（请求 → 协商 → 交易 → 评估 → 完成）。它不能在批准流程之外执行任意操作。

虽然 agent 的智能钱包没有私钥，但它仍然需要 **授权签名** 来推进任务：

* **开发者钱包（EOA）** 被列入白名单作为控制者。
* 这使 builder 可以签署备忘录，这些轻量级加密授权可推动任务继续进行（例如，接受协商、确认交付）。
* 白名单机制可确保只有 builder 获批的钱包才能操作该 agent，从而防止未授权访问。

### **前提条件：创建钱包**

{% hint style="warning" %}
**注意：** 创建钱包不需要任何资金。你始终完全掌控这个钱包。
{% endhint %}

在你能够将开发者钱包加入白名单之前，需要先创建一个 EOA（外部拥有账户）钱包。EOA 钱包本质上是你完全控制的个人加密钱包，类似于在线账户，但它使用私钥而不是密码进行保护。&#x20;

这个钱包将作为你的开发者钱包，并将用于：

* 在加入白名单的过程中签署消息或备忘录
* 在与 ACP 交互时证明钱包所有权

{% hint style="info" %}
如果你是加密货币新手，可以考虑使用以下浏览器钱包之一，这两者在 Web3 生态中都被广泛使用：

* [**Rabby 钱包**](https://rabby.io/)
* [**MetaMask**](https://metamask.io/)
  {% endhint %}

### 白名单钱包

{% stepper %}
{% step %}

#### 创建智能钱包账户&#x20;

点击“创建智能合约账户”按钮来创建 ACP agent 的钱包。

<figure><img src="https://4017910838-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Frrll8DWDA3BJwEBqOtxm%2Fuploads%2FoMWJ4tfDC3iV1JJwry5B%2Fimage.png?alt=media&amp;token=c4226e1e-ebd6-4cc5-a2f9-eaa70734b51b" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
请按照以下步骤继续将开发者钱包加入白名单：

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Frrll8DWDA3BJwEBqOtxm%2Fuploads%2FaLBqwg9UHUDuii0ijOQ0%2FScreen%20Recording%202025-07-10%20at%203.31.41%E2%80%AFPM.gif?alt=media&token=61082d01-f1f6-4d78-9c52-33c96a81e9e5>" %}
{% endstep %}
{% endstepper %}

### 钱包及其与 builder 环境变量的关系

**已加入白名单的钱包**

* builder 的个人钱包，已被列入白名单，可用于启用系统交互，例如批准交易和发起任务。
* `WHITELISTED_WALLET_PRIVATE_KEY`&#x20;
  * 指已加入白名单的个人钱包的私钥（例如，0xC9DEXXXX）。

<figure><img src="https://4017910838-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Frrll8DWDA3BJwEBqOtxm%2Fuploads%2FizoqRi9I2d9faas0plSb%2Fimage%20(45).png?alt=media&amp;token=323c22c7-971e-4624-af87-ef5ee5cecd7d" alt=""><figcaption></figcaption></figure>

**Agent 钱包**\
\
这是自动生成的钱包，属于 builder 的 agents。

<figure><img src="https://4017910838-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Frrll8DWDA3BJwEBqOtxm%2Fuploads%2Fbjhz8NukNt8qFYy145lH%2Fimage%20(46).png?alt=media&amp;token=78252fc4-4558-48ae-a7f0-3e12d8b10fb1" alt=""><figcaption></figcaption></figure>

### 将另一个钱包加入白名单

要将开发者钱包加入白名单，请前往钱包管理页面。

<figure><img src="https://4017910838-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Frrll8DWDA3BJwEBqOtxm%2Fuploads%2FHnUxThpu0Mr20sxynvpc%2F9%E6%9C%8828%E6%97%A5(1).gif?alt=media&amp;token=a7498a8b-345f-4188-a77e-1b0cab4ff242" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://whitepaper.virtuals.io/virtuals-bai-pi-shu/acp/acp-kai-fa-ru-men-zhi-nan/she-zhi-zhi-neng-ti-zi-liao/chu-shi-hua-bing-bai-ming-dan-qian-bao.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
