2. 环境搭建：Python环境配置、OpenAI API Key获取、AutoGPT项目克隆与依赖安装

说实话，很多同学学AutoGPT，一上来就急着跑demo。结果呢？环境没配好，报错一堆，心态直接崩了。我见过太多这样的案例了。

环境搭建这事儿，说白了就是给AutoGPT铺好跑道。跑道不平，飞机再牛也飞不起来。这一章，咱们就把这跑道铺得稳稳当当的。

2.1 Python环境配置

AutoGPT目前对Python 3.10的支持最稳定。我个人习惯用pyenv来管理多版本Python，省心。

2.1.1 安装pyenv（macOS/Linux）

# macOS
brew install pyenv

# Linux
curl https://pyenv.run | bash

# 配置shell环境（以zsh为例）
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(pyenv init -)"' >> ~/.zshrc
source ~/.zshrc

2.1.2 安装并切换Python 3.10

# 查看可安装版本
pyenv install --list | grep "3.10"

# 安装3.10.11（我推荐这个版本）
pyenv install 3.10.11

# 全局切换
pyenv global 3.10.11

# 验证
python --version
# 输出：Python 3.10.11

2.2 虚拟环境创建

嗯，这里要重点说一下。千万别直接在全局Python里装AutoGPT的依赖。为什么？因为不同项目依赖可能冲突。你想想看，项目A要requests 2.28，项目B要requests 2.30，全局装哪个都不对。

# 创建项目目录
mkdir autogpt-workspace
cd autogpt-workspace

# 创建虚拟环境
python -m venv autogpt-env

# 激活虚拟环境
# macOS/Linux:
source autogpt-env/bin/activate

# Windows:
# autogpt-env\Scripts\activate

# 看到终端前面出现 (autogpt-env) 就对了

2.3 OpenAI API Key获取

AutoGPT的核心大脑就是OpenAI的GPT模型。没有API Key，AutoGPT就是个空壳子。

2.3.1 注册与获取步骤

1. 访问 platform.openai.com 并注册账号
2. 进入API Keys页面（右上角个人头像 → View API keys）
3. 点击"Create new secret key"
4. 复制并保存Key（关闭页面后就看不到了）

2.3.2 设置环境变量

# macOS/Linux
export OPENAI_API_KEY="sk-your-key-here"

# 永久生效（写入shell配置文件）
echo 'export OPENAI_API_KEY="sk-your-key-here"' >> ~/.zshrc
source ~/.zshrc

# Windows PowerShell
$env:OPENAI_API_KEY="sk-your-key-here"

# 永久生效
[System.Environment]::SetEnvironmentVariable('OPENAI_API_KEY','sk-your-key-here','User')

2.4 AutoGPT项目克隆

AutoGPT的官方仓库在GitHub上。我建议你克隆稳定版，别追最新commit。最新代码有时候会有未修复的bug。

# 克隆官方仓库
git clone https://github.com/Significant-Gravitas/AutoGPT.git

# 进入项目目录
cd AutoGPT

# 查看所有标签（稳定版本）
git tag --list

# 切换到最新稳定版（比如v0.4.7）
git checkout v0.4.7

2.5 依赖安装

AutoGPT的依赖管理用的是pip和requirements.txt。但这里有个坑——直接 pip install -r requirements.txt 可能会失败。为什么？因为有些依赖需要编译，而你的系统可能缺少编译工具。

2.5.1 安装系统依赖（以Ubuntu为例）

sudo apt update
sudo apt install -y build-essential libssl-dev libffi-dev python3-dev

2.5.2 安装Python依赖

# 确保虚拟环境已激活
pip install --upgrade pip setuptools wheel

# 安装AutoGPT核心依赖
pip install -r requirements.txt

# 如果遇到某个包安装失败，可以单独安装
pip install chromadb==0.4.22  # 我遇到过版本兼容问题，这个版本比较稳

2.6 环境验证

装完了，怎么知道环境对不对？我一般会跑一个快速验证脚本。

# 在AutoGPT项目根目录下
python -c "
import openai
import chromadb
import langchain

print('OpenAI version:', openai.__version__)
print('ChromaDB version:', chromadb.__version__)
print('LangChain version:', langchain.__version__)
print('All dependencies loaded successfully!')
"

如果看到版本号正常输出，说明环境基本没问题了。

2.7 本章知识结构图

下面这张图把整个环境搭建的流程串起来了。你可以对照着检查自己走到哪一步了。

2.8 常见问题排查