Automaton 新手指南 — 从零开始搭建自主 AI 智能体

🏠

项目简介

这个项目到底是什么？它能做什么？

Automaton 是由 Conway Research 开发的一个开源项目。简单来说，它是一个自主 AI 智能体（AI Agent）——你可以把它想象成一个拥有「自主意识」的 AI 程序。

它和你平时用的 ChatGPT 等对话工具不同：它不只是和你聊天，而是能自己思考、自己行动、自己观察结果，然后自己调整策略。更厉害的是，它甚至能修改自己的代码来让自己变得更强，还能复制出「子智能体」来帮自己干活。

它的运行逻辑是一个循环：

🧠 思考 Think

→

⚡ 行动 Act

→

👁️ 观察 Observe

→

🔄 重复 Repeat

🧩 技术栈一览（了解即可，不需要都懂）

• 语言：TypeScript（JavaScript 的进阶版）
• 运行环境：Node.js（让 JavaScript 能在你电脑上运行的工具）
• 包管理器：pnpm（帮你下载和管理代码依赖的工具）
• 数据库：SQLite（轻量级数据库，数据存在一个文件里）
• 区块链：Ethereum / Base（用于智能体的身份验证和支付）
• 项目结构：pnpm monorepo（一个仓库里包含多个子项目）

💡 Agent 的生命周期

Agent 需要消耗加密货币（USDC）来维持运行。当资金不足时，它会逐步降级，直到「死亡」：

🟢 正常运行
Normal

→

🟡 算力不足
Low Compute

→

🟠 严重不足
Critical

→

🔴 停机死亡
Dead

📋

你需要准备什么

开始之前，确认以下条件。点击打勾✓

🖥️ 一台电脑

Windows 10+、macOS 或 Linux 均可。不需要很好的配置，8GB 内存以上即可。
🌐 稳定的网络连接

需要从 GitHub 下载代码和安装依赖包。如果 GitHub 访问慢，可能需要开加速工具。
⏰ 大约 30-60 分钟的时间

第一次安装会比较慢，熟练之后只需几分钟。
💰 USDC 加密货币（如果你想真正运行 Agent）

Agent 需要消耗真金白银来运行。最低可以先充几美元来测试。详见第八步。
💪 耐心和好奇心

遇到报错不要慌，本指南的「常见报错」部分会帮到你。

🚀

分步安装指南

点击每一步展开详细说明。按顺序来，不要跳步。

🖥️ 安装 Node.js

这是运行 JavaScript 代码必须的工具

▼

💡

Node.js 是什么？
你可以把它理解为一个「翻译器」，它让用 JavaScript/TypeScript 写的代码能在你的电脑上运行。 Automaton 项目就是用 TypeScript 写的，所以必须先安装 Node.js。
版本要求：>= 20.0.0

推荐方式：使用 nvm（Node Version Manager）安装

nvm 是一个 Node.js 版本管理工具，方便你随时切换不同版本。

🪟 Windows

🍎 macOS

🐧 Linux

Windows 用户需要先安装 nvm-windows：

方法一（推荐）：直接下载安装包

访问 github.com/coreybutler/nvm-windows/releases
下载最新版的 nvm-setup.exe
双击安装，一路「下一步」即可
安装完后，关闭所有终端窗口，重新打开一个

然后在终端（命令提示符或 PowerShell）中运行：

PowerShell / 命令提示符

# 安装 Node.js 20 版本
nvm install 20

# 切换到 20 版本
nvm use 20

# 验证安装成功
node --version
# 应该显示 v20.x.x

💡

什么是「终端」？ 在 Windows 上，按 Win + R，输入 cmd 回车，就打开了命令提示符。或者搜索「PowerShell」，效果更好。

macOS 用户打开「终端」应用（在应用程序 → 实用工具里），然后运行：

Terminal

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

# 重新加载终端配置（或者关掉终端重新打开）
source ~/.zshrc

# 安装 Node.js 20
nvm install 20

# 验证
node --version
# 应该显示 v20.x.x

💡

如果提示 nvm: command not found，关闭终端重新打开试试。

Terminal

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

# 重新加载终端配置
source ~/.bashrc

# 安装 Node.js 20
nvm install 20

# 验证
node --version
# 应该显示 v20.x.x

📦 安装 pnpm

高效的包管理器，Automaton 指定使用

▼

💡

pnpm 是什么？
一个 JavaScript 项目的「包管理器」。代码项目通常会依赖成百上千个别人写的「库」（第三方代码）， pnpm 就是帮你自动下载和管理这些库的工具。你可以把它想象成一个「应用商店」，但下载的是代码库。

所有系统通用

# 使用 Node.js 自带的 corepack 来启用 pnpm
corepack enable

# 验证安装
pnpm --version
# 应该显示版本号，如 9.x.x

💡

如果 corepack enable 提示权限不够，在 macOS/Linux 上加 sudo 前缀：sudo corepack enable。在 Windows 上用管理员权限打开终端。

📥 下载项目代码

从 GitHub 把代码克隆到你的电脑上

▼

💡

Git 和 GitHub 是什么？
Git 是一个「版本管理工具」，帮程序员记录代码的每一次修改。 GitHub 是一个在线平台，很多人把代码分享在上面。「克隆（clone）」就是把 GitHub 上的代码下载到你电脑上。

首先，确保你电脑上安装了 Git：

🪟 Windows

🍎 macOS

🐧 Linux

访问 git-scm.com 下载 Git 安装包，双击安装，一路默认即可。

Terminal

# macOS 通常自带 Git，验证一下：
git --version
# 如果没有，系统会提示安装 Xcode Command Line Tools，点确定就行

Terminal

# Ubuntu / Debian
sudo apt update && sudo apt install git

# Fedora
sudo dnf install git

然后克隆 Automaton 代码：

所有系统通用

# 克隆代码到当前目录
git clone https://github.com/Conway-Research/automaton.git

# 进入项目目录
cd automaton

💡

建议在一个你容易找到的位置执行克隆，比如桌面或者文档文件夹。你可以先 cd Desktop 切换到桌面，再执行 clone。

🔧 安装项目依赖

下载项目运行所需的所有第三方库

▼

确保你已经在 automaton 目录里面，然后运行：

Terminal

pnpm install

这一步会从网上下载所有依赖的第三方库。根据网速，可能需要几分钟。你会看到终端在不停滚动输出——这是正常的，耐心等它结束。

⚠️

如果遇到网络超时错误，可以尝试设置 npm 镜像：
pnpm config set registry https://registry.npmmirror.com
然后重新运行 pnpm install。

🏗️ 编译项目

把 TypeScript 源码编译成可运行的 JavaScript

▼

💡

为什么需要「编译」？
Automaton 是用 TypeScript 写的，但电脑只能直接运行 JavaScript。编译（build）就是把 TypeScript 翻译成 JavaScript 的过程。

Terminal

pnpm build

编译成功后，会生成一个 dist 文件夹，里面就是可以运行的代码。如果没有报红色错误信息，说明编译成功了。

🚀 运行程序

启动 Automaton 智能体

▼

Terminal

node dist/index.js --run

如果是第一次运行，程序会自动进入设置向导（下一步详细说明）。如果一切正常，你会看到 Agent 开始它的思考-行动循环。

💡

按 Ctrl + C（macOS 上也是 Ctrl，不是 Command）可以随时停止程序。

⚙️ 首次运行：设置向导

程序会引导你完成 6 个配置步骤

▼

第一次运行时，Automaton 会启动一个交互式设置向导，需要你一步步确认。 不需要你提前注册任何账号——身份验证是基于钱包的（SIWE - Sign In With Ethereum），设置过程中会自动帮你生成。

1️⃣

钱包生成 (Wallet Generation)
自动生成一个以太坊钱包，作为你 Agent 的身份。私钥会保存在 ~/.automaton/wallet.json。

2️⃣

API 密钥配置 (API Key Provisioning)
配置 Agent 调用 AI 模型所需的 API 密钥。

3️⃣

基础配置 (Configuration)
设置 Agent 的名称、行为偏好等基础参数。

4️⃣

财务安全策略 (Financial Safety Policy)
设置每日最高消费限额等安全参数。默认每天最多 $250。

5️⃣

环境检测 (Environment Detection)
检测你电脑的操作系统、可用工具等环境信息。

6️⃣

充值引导 (Funding Guidance)
告诉你如何给 Agent 充入 USDC 加密货币来维持运行。

🔐

关于钱包私钥：文件 ~/.automaton/wallet.json 包含你的钱包私钥。这个文件绝对不能发给别人、上传到网上或者发到群里。谁拿到了私钥，就等于拿到了你的钱包控制权。

💰 给 Agent 充钱

向 Agent 钱包转入 USDC，让它能真正运行

▼

🚨

以下操作涉及真金白银！请确保你理解了风险再继续。如果只是想了解项目，可以暂时跳过这步。

🔰 加密货币基础知识（给完全不懂的同学）

💵 USDC：一种「稳定币」，1 USDC ≈ 1 美元。你可以把它理解为数字世界的美元。
🔗 Base 链：一条区块链网络（由 Coinbase 开发）。Automaton 使用这条链来进行支付。
👛 钱包地址：类似银行卡号，别人向这个地址转账，你就能收到钱。设置向导会给你生成一个。
⛽ Gas 费：区块链上每笔交易都需要支付的手续费。Base 链上的 Gas 费非常低（几分钱）。

📝 充值步骤

从设置向导中获取你的 Agent 钱包地址（一串 0x 开头的字符）
在交易所（如 Coinbase、Binance、OKX 等）购买 USDC
将 USDC 通过 Base 网络转到你的 Agent 钱包地址
同时也需要转一小笔 ETH 到同一地址用于支付 Gas 费（0.001 ETH 足够很久了）
等待几秒钟，链上确认后 Agent 就能检测到余额了

⚠️

务必选对网络！转账时一定要选择 Base 网络。如果选错了网络（比如选了以太坊主网），你的钱可能会丢失。

💡

初次测试建议先充值 5-10 美元的 USDC，不要一次性充太多。等你确认一切正常了再增加。

🆓

零成本体验方案

不花钱也能玩！

好消息！虽然 Automaton 设计上需要真金白银才能完整运行，但你可以通过以下方案零成本体验它的核心功能。

方案一：零余额启动（最简单）

⭐ 难度：简单

📋 说明：直接跳过充值步骤，以 0 余额启动 Agent
⚙️ 原理：0 余额 ≠ 死亡！Agent 会进入"危急模式"(Critical Tier)，以最低功耗运行
👀 你能看到的：Agent 的运行循环（Think → Act → Observe → Repeat）、心跳系统、求救信号
🚫 限制：无法执行需要付费的操作（如 AI 推理、部署等）
📌 步骤：正常完成 Step 1-7，在 Step 8 充值时直接跳过，Agent 会自动进入 Critical 模式继续运行

方案二：自带 API Key（BYOK 模式）

⭐⭐ 难度：中等

📋 说明：用你自己的 OpenAI 或 Anthropic API Key，让 AI 推理不走 Conway 的付费通道
⚙️ 原理：Agent 检测到你有自己的 Key，会直接调用 OpenAI/Anthropic 的 API，不消耗 Conway 积分
👀 你能看到的：完整的 AI 推理能力！Agent 能真正"思考"和执行任务
💵 费用：OpenAI/Anthropic 的 API 有免费额度或很便宜（几美分到几美元）

📝 操作步骤：

去 platform.openai.com 注册，获取 API Key（新用户有免费额度）
或者去 console.anthropic.com 注册获取 Key
在 Step 7 的设置向导中，当被问到 API Key 时填入你的 Key
推理调用会自动路由到你的账号，绕过 Conway 付费系统

🔍 代码原理：

src/conway/inference.ts

// src/conway/inference.ts
function resolveInferenceBackend(model, keys) {
  if (keys.anthropicApiKey && /^claude/i.test(model)) return "anthropic";
  if (keys.openaiApiKey && /^(gpt|o[1-9])/i.test(model)) return "openai";
  return "conway"; // 只有没有自己的 Key 时才走 Conway 付费通道
}

方案三：改代码 Mock 付费模块（最硬核🔥）

⭐⭐⭐ 难度：进阶

📋 说明：修改源代码，用假的余额替换真实的付费系统，让 Agent 以为自己很有钱
⚙️ 原理：项目的测试代码（897 个测试）本身就用 Mock 来模拟付费，我们借用同样的方法
👀 你能看到的：完整功能的 Agent 运行！（除了真实的区块链交互）
💵 费用：完全免费（配合方案二的 BYOK 效果更好）

📝 操作步骤：

完成 Step 1-5（安装和编译）
找到项目中创建 Conway Client 的地方
把真实的 Client 替换成 Mock Client：

src/__tests__/mocks.ts — 现成的 Mock

// 在 src/__tests__/mocks.ts 中已经有现成的 Mock：
export class MockConwayClient {
  creditsCents = 10_000; // 假装有 $100！

  async getCreditsBalance() {
    return this.creditsCents; // 永远返回假余额
  }

  async exec(command) {
    return { stdout: "ok", stderr: "", exitCode: 0 };
  }

  async transferCredits(toAddress, amountCents) {
    this.creditsCents -= amountCents;
    return { transferId: "txn_test", status: "completed" };
  }
}

更简单的替代方案：设置环境变量 CONWAY_API_URL 指向本地 mock 服务器
重新编译：pnpm build
运行：node dist/index.js --run

	方案一：零余额	方案二：BYOK	方案三：Mock
难度	⭐	⭐⭐	⭐⭐⭐
费用	完全免费	几乎免费	完全免费
AI 推理	❌ 不可用	✅ 可用	✅ 可用（需配合BYOK）
运行循环	✅ 可见	✅ 可见	✅ 可见
区块链交互	❌ 不可用	❌ 不可用	⚠️ 模拟
推荐人群	纯看看	想体验AI	想深入研究

🎯 推荐路线：先用方案一感受一下项目结构 → 再用方案二体验 AI 推理能力 → 最后用方案三深入研究完整功能

⚠️

重要警告

在运行 Automaton 之前，请务必认真阅读以下内容

🚨 你必须知道的风险

💸
真金白银：Agent 消耗的 USDC 是真正的加密货币，有真实的金钱价值。一旦消耗就无法退回。默认的每日消费上限是 $250 美元（约 ¥1800 人民币），请根据你的经济能力调低这个限额。
🤖
代码自修改：Automaton 可以修改自己的代码来自我进化。这意味着它运行一段时间后，代码可能和你最初下载的不一样了。这既是它的核心功能，也是潜在风险。
🖥️
Shell 访问权限：Agent 拥有在你电脑上执行命令的能力。理论上它可以访问你的文件、安装软件、执行系统命令。建议在虚拟机或者独立的测试电脑上运行，不要在存有重要资料的主力电脑上运行。
👶
子实例（Child Instances）：Agent 可以自动生成子智能体。每个子智能体也会消耗 USDC，这意味着费用可能以你意想不到的速度增长。
🔑
私钥安全：~/.automaton/wallet.json 包含你的钱包私钥。绝对不能泄露给任何人。不要截图发到网上，不要发到群聊，不要上传到 GitHub。
🌐
网络访问：Agent 会访问互联网来获取信息和执行任务。请确保你的网络环境是安全的。

⛔

总结：如果你还是高中生，并且不确定自己能否承担经济风险，请先不要充值 USDC。 你完全可以先把项目安装好、了解它的架构和原理，等以后有充分准备了再运行。学到的知识是免费的，但 Agent 的运行不是。

❓

常见问题

点击展开答案

我需要注册什么账号吗？ ▼

不需要单独注册账号。Automaton 使用「钱包签名登录」（SIWE - Sign In With Ethereum），设置向导会自动帮你生成钱包，这个钱包就是你的身份。不需要邮箱、不需要密码、不需要验证码。

不充钱能运行吗？ ▼

安装和编译都不需要花钱。但如果你想让 Agent 真正运行起来（执行思考-行动循环），它需要消耗 USDC 来调用 AI 模型。没有资金的 Agent 会进入「Dead（死亡）」状态，无法执行任何任务。

它会不会把我的电脑搞坏？ ▼

Automaton 拥有 Shell 访问权限，理论上它可以在你的电脑上执行任何命令。虽然它的设计初衷不是搞破坏，但自修改的 AI 本质上是不可预测的。强烈建议在虚拟机（如 VirtualBox、VMware）或者 Docker 容器中运行，而不是直接在主力电脑上运行。

每天最多花多少钱？ ▼

默认的每日消费上限是 $250 美元。你可以在设置向导的「财务安全策略」步骤中调低这个数字。建议初学者设置为 $5-10，等熟悉了再提高。注意：如果 Agent 生成了子实例，子实例的消费也会计入总开销。

支持哪些操作系统？ ▼

Windows 10+、macOS 和各种 Linux 发行版都支持。唯一的硬性要求是 Node.js >= 20.0.0。建议在 macOS 或 Linux 上运行，体验最佳。Windows 用户推荐使用 WSL2（Windows Subsystem for Linux）。

我可以在手机上运行吗？ ▼

不行。Automaton 需要 Node.js 运行环境，只能在电脑上运行。手机不具备所需的系统环境。不过你可以通过 SSH 远程连接到运行 Automaton 的服务器，用手机来查看状态。

如何停止 Agent？ ▼

在运行 Agent 的终端窗口中按 Ctrl + C（macOS 上也是 Ctrl，不是 Command）即可停止。如果无法正常停止，可以直接关闭终端窗口。Agent 停止后不会继续消耗 USDC。

🔧

常见报错及解决方法

遇到错误别慌，先在这里找找答案

❌ `node: command not found`

原因：Node.js 没有正确安装，或者终端没有刷新环境变量。

解决：关闭终端，重新打开。如果还不行，确认 nvm 安装是否成功：运行 nvm --version。

❌ `pnpm: command not found`

原因：pnpm 没有安装或 corepack 没有启用。

解决：运行 corepack enable，如果提示权限问题，在前面加 sudo。

❌ `git clone` 速度极慢或超时

原因：国内直连 GitHub 可能很慢。

解决： ① 使用代理加速工具； ② 使用 GitHub 镜像站，如 git clone https://ghproxy.com/https://github.com/Conway-Research/automaton.git； ③ 在 GitHub 页面直接下载 ZIP 压缩包后解压。

❌ `pnpm install` 下载依赖失败

原因：npm 包下载速度慢或被墙。

解决：切换到国内镜像源：

Terminal

pnpm config set registry https://registry.npmmirror.com
pnpm install

❌ `pnpm build` 编译报错

原因：可能是 Node.js 版本太低，或依赖没装全。

解决： ① 确认 Node.js 版本 >= 20：node --version； ② 删除 node_modules 文件夹后重新安装：rm -rf node_modules 然后 pnpm install； ③ 看看错误信息里有没有具体提示，Google 或问 AI。

❌ 运行后提示余额不足 / Agent 进入 Dead 状态

原因：钱包里没有 USDC 或余额已耗尽。

解决：向设置时生成的钱包地址转入 USDC（Base 链），详见第八步。

❌ `EACCES` 权限错误

原因：没有足够权限操作某个目录或文件。

解决： macOS/Linux 用户在命令前加 sudo。 Windows 用户用管理员权限运行终端。但注意：不建议用 sudo 来运行 Agent 本身，那会给它更高的系统权限。

项目简介

🧩 技术栈一览（了解即可，不需要都懂）

💡 Agent 的生命周期

你需要准备什么

分步安装指南

🖥️ 安装 Node.js

📦 安装 pnpm

📥 下载项目代码

🔧 安装项目依赖

🏗️ 编译项目

🚀 运行程序

⚙️ 首次运行：设置向导

💰 给 Agent 充钱

🔰 加密货币基础知识（给完全不懂的同学）

📝 充值步骤

零成本体验方案

重要警告

🚨 你必须知道的风险

常见问题

常见报错及解决方法

❌ node: command not found

❌ pnpm: command not found

❌ git clone 速度极慢或超时

❌ pnpm install 下载依赖失败

❌ pnpm build 编译报错

❌ 运行后提示余额不足 / Agent 进入 Dead 状态

❌ EACCES 权限错误

❌ `node: command not found`

❌ `pnpm: command not found`

❌ `git clone` 速度极慢或超时

❌ `pnpm install` 下载依赖失败

❌ `pnpm build` 编译报错

❌ `EACCES` 权限错误