能直接断点调试autogpt本地运行环境，但必须用python扩展+正确解释器路径+launch.json配置；需使用python 3.10–3.12、克隆stable分支、创建并激活虚拟环境、安装带重试的依赖、正确配置.env文件，并在vscode中手动指定venv内解释器及设置"module": "auto_gpt"和pythonpath。
能直接断点调试 AutoGPT 本地运行环境，但必须用 Python 扩展 + 正确的解释器路径 + launch.json 配置，缺一不可；否则你会看到“ModuleNotFoundError”或“no debug adapter”这类错误。
确认 Python 环境和依赖已就位
AutoGPT 对 Python 版本敏感，python --version 必须输出 3.10.x、3.11.x 或 3.12.x。低于 3.10 会报 TypeError: unhashable type: 'dict'，高于 3.13 则部分依赖（如 openai）尚未兼容。
- 克隆的是
stable分支：执行git clone -b stable https://github.com/Significant-Gravitas/Auto-GPT.git - 进目录后创建虚拟环境：
python -m venv venv，再激活（Windows 用venv\Scripts\activate.bat，macOS/Linux 用source venv/bin/activate） - 安装依赖时加
--retries 5 --timeout 60：避免因网络波动导致pip install -r requirements.txt中途失败 -
.env文件必须重命名自.env.template，且OPENAI_API_KEY=sk-...后不能有空格、引号或换行
VSCode 中正确选择 Python 解释器
VSCode 不会自动识别虚拟环境里的 python，尤其在你从终端激活过环境后仍没出现在解释器列表里——这很常见。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并选择Python: Select Interpreter - 手动浏览到：
./venv/Scripts/python.exe（Windows）或./venv/bin/python（macOS/Linux） - 如果路径不显示，先在集成终端中执行
which python或where python确认真实路径 - 选完后右下角状态栏应显示类似
Python 3.11.9 ('venv': venv)，否则调试会 fallback 到系统 Python，必然失败
配置 launch.json 启动调试
AutoGPT 入口是 main.py，不是 autogpt 命令；直接跑命令行无法断点，必须通过 VSCode 的 Python 调试器启动。
- 点击左侧
Run and Debug图标 →Create a launch.json file→ 选择Python→Python File - 修改生成的配置，关键字段如下：
{
"version": "0.2.0",
"configurations": [
{
"name": "Launch AutoGPT",
"type": "python",
"request": "launch",
"module": "auto_gpt",
"console": "integratedTerminal",
"justMyCode": true,
"env": {
"PYTHONPATH": "${workspaceFolder}"
}
}
]
}
-
"module": "auto_gpt"是核心：它等价于命令行执行python -m auto_gpt，确保加载的是项目内源码而非已安装的 PyPI 包 - 不要用
"program": "./main.py"—— 这会导致相对路径导入失败，from autogpt.config import Config会报错 -
"env": {"PYTHONPATH": "${workspaceFolder}"}补充路径，避免ImportError: No module named 'autogpt'
打断点与验证调试是否生效
断点不能打在 if __name__ == "__main__": 下面的顶层代码里，因为 -m 模式下入口逻辑在包初始化阶段，实际执行链更深。
- 推荐断点位置：
autogpt/main.py第 42 行左右的run_auto_gpt()调用处，或autogpt/agent/agent.py的start_interaction_loop() - 启动调试前，确保终端没残留旧进程：
ps aux | grep auto_gpt（macOS/Linux）或tasklist | findstr auto_gpt（Windows） - 首次调试可能卡在
Config.build_config_from_env()，检查.env是否真被读取：在该函数内加print(os.getenv("OPENAI_API_KEY"))辅助判断 - 如果断点灰掉（unbound breakpoint），说明文件未被加载——大概率是解释器选错，或
launch.json里漏了env.PYTHONPATH
最常被忽略的一点：AutoGPT 启动后会立刻尝试连接 OpenAI API，如果网络不通或密钥无效，它不会停在断点，而是直接抛异常退出。调试前务必确认 curl -H "Authorization: Bearer sk-..." https://api.openai.com/v1/models 能返回 200。
