AgentGPT CLI 环境配置工具全解析从交互式提问到 .env 文件生成【免费下载链接】AgentGPT Assemble, configure, and deploy autonomous AI Agents in your browser.项目地址: https://gitcode.com/gh_mirrors/ag/AgentGPTAgentGPT CLI 是 AgentGPT 项目自带的命令行配置工具用于在浏览器中一键完成自主 AI Agent 环境的初始化。它以 Inquirer 交互式问答的形式引导开发者填写环境变量并在写入前对 API Key 等进行实时校验从而避免手动编辑 .env 时容易出现的拼写错误、缺项或无效密钥问题。读完本文你将掌握 AgentGPT CLI 的完整运行方式、它如何自动生成./next/.env与./platform/.env两份配置、背后 ENV 定义与校验的源码机制以及如何基于它扩展新的环境变量。一、AgentGPT CLI 是什么AgentGPT 是一个在浏览器中组装、配置并部署自主 AI Agent的开源项目其代码库主要包含三个部分next/基于 Next.js 的前端应用platform/基于 Python/FastAPI 的后端服务reworkd_platformcli/面向开发者的环境初始化命令行工具即本文的主角。cli/目录的核心价值在于简化 AgentGPT 环境的搭建流程。它使用 Inquirer 可以看到它依赖inquirer、chalk彩色终端输出、figletASCII 艺术字标题、dotenv解析 .env 文件、node-fetch用于调用远程 API 校验密钥等库Node 版本要求为18.0.0 19.0.0。CLI 的执行入口是 cli/src/index.js启动时先通过printTitle()打印醒目的 AgentGPT ASCII 标题然后根据doesEnvFileExist()的检测结果分流——如果./next/.env已存在则进入存量配置校验流程否则进入全新配置生成流程。二、运行 CLI 的两种方式根据 cli/README.md 的说明有两种启动方式。方式一从仓库根目录运行一键脚本./setup.sh仓库根目录的 setup.sh 内容如下#!/usr/bin/env bash cd $(dirname $0) || exit 1 # The CLI will take care of setting up the ENV variables cd ./cli || exit 1 npm install npm run start它会自动进入cli/目录、安装依赖npm install并启动 CLInpm run start适合第一次拉取仓库后快速初始化环境。方式二从 cli 目录直接运行cd cli/ npm run start从 cli/package.json 可知start与dev脚本都指向node src/index.js两种方式等价。注意 CLI 使用的是 ES Moduletype: module源码采用import语法。启动后的分流逻辑cli/src/index.js 中的入口逻辑如下printTitle(); if (doesEnvFileExist()) { handleExistingEnv(); } else { handleNewEnv(); }若检测到./next/.env已存在doesEnvFileExist()通过fs.existsSync(../next/.env)判断则进入handleExistingEnv()校验流程若不存在则进入handleNewEnv()全新生成流程。三、全新环境生成流程handleNewEnv当仓库中还没有./next/.env时CLI 会依次弹出newEnvQuestions中的问题见 cli/src/questions/newEnvQuestions.js运行方式选择来自共享问题 cli/src/questions/sharedQuestions.js Docker-compose (Recommended)使用 Docker Compose 启动默认选项 Manual (Not recommended)手动启动前后端。OpenAI API Key提示输入sk-开头的密钥或直接回车跳过无 Key 时以change me占位。SERP API Key来源 serper.dev用于 Web 搜索功能留空则禁用 Web 搜索。Replicate API Key来源 replicate.com用于图像生成留空则仅使用 DALL-E。回答完成后cli/src/index.js 执行const handleNewEnv () { inquirer.prompt(newEnvQuestions).then((answers) { dotenv.config({ path: ./.env }); generateEnv(answers); console.log(\nEnv files successfully created!); handleRunOption(answers.runOption); }); };即先加载仓库根目录的.env如存在作为默认值参考然后调用generateEnv(answers)生成配置文件最后根据用户选择的运行方式给出后续指引。四、ENV 定义与生成机制envGenerator.js生成逻辑的核心在 cli/src/envGenerator.js 的generateEnv函数cli/src/envGenerator.jsexport const generateEnv (envValues) { let isDockerCompose envValues.runOption docker-compose; let dbPort isDockerCompose ? 3307 : 3306; let platformUrl isDockerCompose ? http://host.docker.internal:8000 : http://localhost:8000; const envDefinition getEnvDefinition( envValues, isDockerCompose, dbPort, platformUrl ); const envFileContent generateEnvFileContent(envDefinition); saveEnvFile(envFileContent); };这里有两个值得注意的动态取值数据库端口使用 Docker Compose 时为3307对应 docker-compose.yml 中 MySQL 容器的内部端口MYSQL_TCP_PORT: 3307手动模式为3306默认 MySQL 端口后端 URLDocker Compose 模式下后端地址为http://host.docker.internal:8000容器内访问宿主机手动模式为http://localhost:8000。getEnvDefinitioncli/src/envGenerator.js按 7 个分区定义全部环境变量分区关键变量默认值/说明Deployment EnvironmentNODE_ENV、NEXT_PUBLIC_VERCEL_ENVdevelopmentNextJSNEXT_PUBLIC_BACKEND_URL、NEXT_PUBLIC_MAX_LOOPS后端地址http://localhost:8000最大循环次数 100Next Auth configNEXTAUTH_SECRET、NEXTAUTH_URL密钥由crypto.randomBytes(32)生成 base64 字符串URL 为http://localhost:3000Auth providersGOOGLE_CLIENT_ID/SECRET、GITHUB_CLIENT_ID/SECRET、DISCORD_CLIENT_ID/SECRET默认占位***用于退出开发模式登录BackendREWORKD_PLATFORM_*系列OpenAI Key 来自问答输入否则change meREWORKD_PLATFORM_MAX_LOOPS引用${NEXT_PUBLIC_MAX_LOOPS}Database (Backend)REWORKD_PLATFORM_DATABASE_*用户reworkd_platform、密码reworkd_platform、主机agentgpt_db、端口为上述动态值Database (Frontend)DATABASE_*与后端数据库分区结构相同generateEnvFileContentcli/src/envGenerator.js会以注释分区 KEYVALUE的形式生成文本例如# Deployment Environment: NODE_ENVdevelopment NEXT_PUBLIC_VERCEL_ENV${NODE_ENV} # NextJS: NEXT_PUBLIC_BACKEND_URLhttp://localhost:8000 NEXT_PUBLIC_MAX_LOOPS100 ...generateAuthSecretcli/src/envGenerator.js使用 Node 内置crypto.randomBytes(32).toString(base64)生成 32 字节的随机NEXTAUTH_SECRET避免开发者沿用不安全的默认密钥。最终saveEnvFilecli/src/envGenerator.js会把同一份内容同时写入两个位置const ENV_PATH ../next/.env; const BACKEND_ENV_PATH ../platform/.env; export const saveEnvFile (envFileContent) { fs.writeFileSync(ENV_PATH, envFileContent); fs.writeFileSync(BACKEND_ENV_PATH, envFileContent); };这与 docker-compose.yml 中platform服务通过env_file: next/.env读取配置的方式相互呼应。五、存量 .env 的校验流程handleExistingEnv当./next/.env已存在时CLI 不会盲目覆盖而是先校验再询问运行方式cli/src/index.jsconst handleExistingEnv () { console.log(chalk.yellow(Existing ./next/env file found. Validating...)); try { testEnvFile(); } catch (e) { console.log(e.message); return; } inquirer.prompt(existingEnvQuestions).then((answers) { handleRunOption(answers.runOption); }); };校验由testEnvFilecli/src/envGenerator.js实现其思路是读取现有../next/.env内容按行拆分并过滤掉注释行#开头与空行用getEnvDefinition({}, ...)生成一份标准定义提取全部预期 Key对比两者找出缺失的 KeymissingFromFile若存在缺失抛出错误信息逐条列出缺失项❌ 标记并提示We recommend deleting your .env file(s) and restarting this script.也就是说存量环境文件不允许缺 Key——一旦缺项CLI 会建议删除 .env 后重新运行脚本从而保证两份环境文件与代码期望完全对齐。此时existingEnvQuestions只包含运行方式选择问题见 cli/src/questions/existingEnvQuestions.js。六、运行方式的后置指引handleRunOption无论新生成还是存量校验最终都会进入handleRunOptioncli/src/index.js选择docker-composeCLI 会通过child_process.spawn直接执行docker-compose up --buildstdio: inherit让输出直接透传到终端选择manual打印手动启动指引进入./next执行npm install npm run dev进入./platform执行poetry install poetry run python -m reworkd_platform根据需要在环境文件中使用或更新 MySQL 数据库配置。七、API Key 的双重校验格式 远程验证CLI 对 API Key 的校验值得单独说明。在 cli/src/helpers.js 中定义了通用校验函数export const isValidKey (apikey, pattern) { return (apikey || pattern.test(apikey)) };允许 Key 为空对应跳过/禁用该功能非空则必须匹配格式正则。三个 Key 的校验规则与远程验证见 cli/src/questions/newEnvQuestions.jsKey格式正则远程验证端点OpenAI/^sk-[a-zA-Z0-9]{48}$/GET https://api.openai.com/v1/models携带Authorization: Bearer keySERP/^[a-zA-Z0-9]{40}$/POST https://google.serper.dev/search携带X-API-KEY测试查询apple incReplicate/^r8_[a-zA-Z0-9]{37}$/GET https://api.replicate.com/v1/models/replicate/hello-world携带Authorization: Token key非空 Key 若格式不符或远程调用返回非 2xx都会得到错误提示Invalid api key. Please try again.并要求重新输入。这意味着CLI 不只会帮你把 Key 写进 .env还会在写入前确认它真的能用。八、如何新增一个 ENV 变量cli/README.md 给出了扩展环境变量的三步流程结合源码可以进一步明确每步的落点在index.js的问题列表中添加问题——严格来说新增 ENV 值所对应的问题应添加到 cli/src/questions/newEnvQuestions.js 的newEnvQuestions数组README 中index.js是对 CLI 入口的泛指若变量已有存量文件校验需求也应同步考虑existingEnvQuestions。在envDefinition中添加该 ENV 值——即 cli/src/envGenerator.js 中getEnvDefinition返回对象的对应分区写入 Key 与默认值/引用值。这一步同时决定了testEnvFile的预期 Key 集合因此新增变量后旧的 .env 会被判定为缺 Key。将 ENV 值添加到仓库根目录的.env.example——.env.example 是项目约定俗成的参考模板供开发者在没有 CLI 时手动参考配置。九、生成的 ENV 文件与项目其它部分的对应关系生成的配置不是孤立的它与仓库其它部分紧密关联前端NEXT_PUBLIC_BACKEND_URLhttp://localhost:8000对应 docker-compose.yml 中platform服务暴露的8000端口NEXTAUTH_URL对应前端3000端口。后端REWORKD_PLATFORM_OPENAI_API_KEY、REWORKD_PLATFORM_MAX_LOOPS等会被 Python 后端platform/reworkd_platform/settings.py一类的配置加载逻辑读取REWORKD_PLATFORM_MAX_LOOPS与NEXT_PUBLIC_MAX_LOOPS通过${...}引用保持一致正如 .env.example 顶部注释所说max loops determines how many times the agent may execute最大循环次数决定 Agent 可执行多少轮任务。数据库Docker Compose 模式下的端口3307、主机agentgpt_db、用户/密码reworkd_platform与 docker-compose.yml 中agentgpt_db服务的MYSQL_DATABASE/MYSQL_USER/MYSQL_PASSWORD/MYSQL_TCP_PORT完全对齐宿主机的3308映射到容器内3307避免与本机 3306 冲突。MySQL 初始化db/目录下的Dockerfile用于构建数据库镜像与agentgpt_db服务的build.context: ./db对应。十、常见问题与排障建议运行./setup.sh报 Node 版本错误CLI 要求 Node18.0.0 19.0.0见 cli/package.json 的engines字段请检查当前 Node 版本是否在此范围内。提示 .env 缺失 Key说明当前./next/.env与getEnvDefinition中的预期 Key 不一致。按提示删除./next/.env与./platform/.env后重新运行脚本即可重新生成。想临时禁用某功能OpenAI / SERP / Replicate 三个 Key 在问答中都可以直接回车跳过isValidKey对空字符串返回 true对应功能会被禁用或回退到默认实现如无 Replicate Key 时图像生成仅用 DALL-E。手动模式下的数据库手动启动需要自行准备 MySQL并将REWORKD_PLATFORM_DATABASE_*/DATABASE_*改为本机可用配置端口默认3306。Docker Compose 方式下后端地址容器内访问宿主机使用http://host.docker.internal:8000若在非 Docker 环境使用该地址会无法连通此时应选择手动模式或调整配置。小结AgentGPT CLI 把阅读文档、手抄环境变量、逐个配置密钥的繁琐过程压缩成一次交互式问答它负责 Key 的格式与远程双重校验、NEXTAUTH_SECRET 的随机生成、前后端两份 .env 的同步写入以及存量文件的缺 Key 校验。理解了 cli/src/index.js、cli/src/envGenerator.js、cli/src/questions/ 三个核心模块之后你既能顺畅完成 AgentGPT 本地环境的初始化也能按三步骤规范地为项目扩展新的环境变量。【免费下载链接】AgentGPT Assemble, configure, and deploy autonomous AI Agents in your browser.项目地址: https://gitcode.com/gh_mirrors/ag/AgentGPT创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 AgentGPT CLI 环境配置工具全解析：从交互式提问到 .env 文件生成
AgentGPT CLI 环境配置工具全解析从交互式提问到 .env 文件生成【免费下载链接】AgentGPT Assemble, configure, and deploy autonomous AI Agents in your browser.项目地址: https://gitcode.com/gh_mirrors/ag/AgentGPTAgentGPT CLI 是 AgentGPT 项目自带的命令行配置工具用于在浏览器中一键完成自主 AI Agent 环境的初始化。它以 Inquirer 交互式问答的形式引导开发者填写环境变量并在写入前对 API Key 等进行实时校验从而避免手动编辑 .env 时容易出现的拼写错误、缺项或无效密钥问题。读完本文你将掌握 AgentGPT CLI 的完整运行方式、它如何自动生成./next/.env与./platform/.env两份配置、背后 ENV 定义与校验的源码机制以及如何基于它扩展新的环境变量。一、AgentGPT CLI 是什么AgentGPT 是一个在浏览器中组装、配置并部署自主 AI Agent的开源项目其代码库主要包含三个部分next/基于 Next.js 的前端应用platform/基于 Python/FastAPI 的后端服务reworkd_platformcli/面向开发者的环境初始化命令行工具即本文的主角。cli/目录的核心价值在于简化 AgentGPT 环境的搭建流程。它使用 Inquirer 可以看到它依赖inquirer、chalk彩色终端输出、figletASCII 艺术字标题、dotenv解析 .env 文件、node-fetch用于调用远程 API 校验密钥等库Node 版本要求为18.0.0 19.0.0。CLI 的执行入口是 cli/src/index.js启动时先通过printTitle()打印醒目的 AgentGPT ASCII 标题然后根据doesEnvFileExist()的检测结果分流——如果./next/.env已存在则进入存量配置校验流程否则进入全新配置生成流程。二、运行 CLI 的两种方式根据 cli/README.md 的说明有两种启动方式。方式一从仓库根目录运行一键脚本./setup.sh仓库根目录的 setup.sh 内容如下#!/usr/bin/env bash cd $(dirname $0) || exit 1 # The CLI will take care of setting up the ENV variables cd ./cli || exit 1 npm install npm run start它会自动进入cli/目录、安装依赖npm install并启动 CLInpm run start适合第一次拉取仓库后快速初始化环境。方式二从 cli 目录直接运行cd cli/ npm run start从 cli/package.json 可知start与dev脚本都指向node src/index.js两种方式等价。注意 CLI 使用的是 ES Moduletype: module源码采用import语法。启动后的分流逻辑cli/src/index.js 中的入口逻辑如下printTitle(); if (doesEnvFileExist()) { handleExistingEnv(); } else { handleNewEnv(); }若检测到./next/.env已存在doesEnvFileExist()通过fs.existsSync(../next/.env)判断则进入handleExistingEnv()校验流程若不存在则进入handleNewEnv()全新生成流程。三、全新环境生成流程handleNewEnv当仓库中还没有./next/.env时CLI 会依次弹出newEnvQuestions中的问题见 cli/src/questions/newEnvQuestions.js运行方式选择来自共享问题 cli/src/questions/sharedQuestions.js Docker-compose (Recommended)使用 Docker Compose 启动默认选项 Manual (Not recommended)手动启动前后端。OpenAI API Key提示输入sk-开头的密钥或直接回车跳过无 Key 时以change me占位。SERP API Key来源 serper.dev用于 Web 搜索功能留空则禁用 Web 搜索。Replicate API Key来源 replicate.com用于图像生成留空则仅使用 DALL-E。回答完成后cli/src/index.js 执行const handleNewEnv () { inquirer.prompt(newEnvQuestions).then((answers) { dotenv.config({ path: ./.env }); generateEnv(answers); console.log(\nEnv files successfully created!); handleRunOption(answers.runOption); }); };即先加载仓库根目录的.env如存在作为默认值参考然后调用generateEnv(answers)生成配置文件最后根据用户选择的运行方式给出后续指引。四、ENV 定义与生成机制envGenerator.js生成逻辑的核心在 cli/src/envGenerator.js 的generateEnv函数cli/src/envGenerator.jsexport const generateEnv (envValues) { let isDockerCompose envValues.runOption docker-compose; let dbPort isDockerCompose ? 3307 : 3306; let platformUrl isDockerCompose ? http://host.docker.internal:8000 : http://localhost:8000; const envDefinition getEnvDefinition( envValues, isDockerCompose, dbPort, platformUrl ); const envFileContent generateEnvFileContent(envDefinition); saveEnvFile(envFileContent); };这里有两个值得注意的动态取值数据库端口使用 Docker Compose 时为3307对应 docker-compose.yml 中 MySQL 容器的内部端口MYSQL_TCP_PORT: 3307手动模式为3306默认 MySQL 端口后端 URLDocker Compose 模式下后端地址为http://host.docker.internal:8000容器内访问宿主机手动模式为http://localhost:8000。getEnvDefinitioncli/src/envGenerator.js按 7 个分区定义全部环境变量分区关键变量默认值/说明Deployment EnvironmentNODE_ENV、NEXT_PUBLIC_VERCEL_ENVdevelopmentNextJSNEXT_PUBLIC_BACKEND_URL、NEXT_PUBLIC_MAX_LOOPS后端地址http://localhost:8000最大循环次数 100Next Auth configNEXTAUTH_SECRET、NEXTAUTH_URL密钥由crypto.randomBytes(32)生成 base64 字符串URL 为http://localhost:3000Auth providersGOOGLE_CLIENT_ID/SECRET、GITHUB_CLIENT_ID/SECRET、DISCORD_CLIENT_ID/SECRET默认占位***用于退出开发模式登录BackendREWORKD_PLATFORM_*系列OpenAI Key 来自问答输入否则change meREWORKD_PLATFORM_MAX_LOOPS引用${NEXT_PUBLIC_MAX_LOOPS}Database (Backend)REWORKD_PLATFORM_DATABASE_*用户reworkd_platform、密码reworkd_platform、主机agentgpt_db、端口为上述动态值Database (Frontend)DATABASE_*与后端数据库分区结构相同generateEnvFileContentcli/src/envGenerator.js会以注释分区 KEYVALUE的形式生成文本例如# Deployment Environment: NODE_ENVdevelopment NEXT_PUBLIC_VERCEL_ENV${NODE_ENV} # NextJS: NEXT_PUBLIC_BACKEND_URLhttp://localhost:8000 NEXT_PUBLIC_MAX_LOOPS100 ...generateAuthSecretcli/src/envGenerator.js使用 Node 内置crypto.randomBytes(32).toString(base64)生成 32 字节的随机NEXTAUTH_SECRET避免开发者沿用不安全的默认密钥。最终saveEnvFilecli/src/envGenerator.js会把同一份内容同时写入两个位置const ENV_PATH ../next/.env; const BACKEND_ENV_PATH ../platform/.env; export const saveEnvFile (envFileContent) { fs.writeFileSync(ENV_PATH, envFileContent); fs.writeFileSync(BACKEND_ENV_PATH, envFileContent); };这与 docker-compose.yml 中platform服务通过env_file: next/.env读取配置的方式相互呼应。五、存量 .env 的校验流程handleExistingEnv当./next/.env已存在时CLI 不会盲目覆盖而是先校验再询问运行方式cli/src/index.jsconst handleExistingEnv () { console.log(chalk.yellow(Existing ./next/env file found. Validating...)); try { testEnvFile(); } catch (e) { console.log(e.message); return; } inquirer.prompt(existingEnvQuestions).then((answers) { handleRunOption(answers.runOption); }); };校验由testEnvFilecli/src/envGenerator.js实现其思路是读取现有../next/.env内容按行拆分并过滤掉注释行#开头与空行用getEnvDefinition({}, ...)生成一份标准定义提取全部预期 Key对比两者找出缺失的 KeymissingFromFile若存在缺失抛出错误信息逐条列出缺失项❌ 标记并提示We recommend deleting your .env file(s) and restarting this script.也就是说存量环境文件不允许缺 Key——一旦缺项CLI 会建议删除 .env 后重新运行脚本从而保证两份环境文件与代码期望完全对齐。此时existingEnvQuestions只包含运行方式选择问题见 cli/src/questions/existingEnvQuestions.js。六、运行方式的后置指引handleRunOption无论新生成还是存量校验最终都会进入handleRunOptioncli/src/index.js选择docker-composeCLI 会通过child_process.spawn直接执行docker-compose up --buildstdio: inherit让输出直接透传到终端选择manual打印手动启动指引进入./next执行npm install npm run dev进入./platform执行poetry install poetry run python -m reworkd_platform根据需要在环境文件中使用或更新 MySQL 数据库配置。七、API Key 的双重校验格式 远程验证CLI 对 API Key 的校验值得单独说明。在 cli/src/helpers.js 中定义了通用校验函数export const isValidKey (apikey, pattern) { return (apikey || pattern.test(apikey)) };允许 Key 为空对应跳过/禁用该功能非空则必须匹配格式正则。三个 Key 的校验规则与远程验证见 cli/src/questions/newEnvQuestions.jsKey格式正则远程验证端点OpenAI/^sk-[a-zA-Z0-9]{48}$/GET https://api.openai.com/v1/models携带Authorization: Bearer keySERP/^[a-zA-Z0-9]{40}$/POST https://google.serper.dev/search携带X-API-KEY测试查询apple incReplicate/^r8_[a-zA-Z0-9]{37}$/GET https://api.replicate.com/v1/models/replicate/hello-world携带Authorization: Token key非空 Key 若格式不符或远程调用返回非 2xx都会得到错误提示Invalid api key. Please try again.并要求重新输入。这意味着CLI 不只会帮你把 Key 写进 .env还会在写入前确认它真的能用。八、如何新增一个 ENV 变量cli/README.md 给出了扩展环境变量的三步流程结合源码可以进一步明确每步的落点在index.js的问题列表中添加问题——严格来说新增 ENV 值所对应的问题应添加到 cli/src/questions/newEnvQuestions.js 的newEnvQuestions数组README 中index.js是对 CLI 入口的泛指若变量已有存量文件校验需求也应同步考虑existingEnvQuestions。在envDefinition中添加该 ENV 值——即 cli/src/envGenerator.js 中getEnvDefinition返回对象的对应分区写入 Key 与默认值/引用值。这一步同时决定了testEnvFile的预期 Key 集合因此新增变量后旧的 .env 会被判定为缺 Key。将 ENV 值添加到仓库根目录的.env.example——.env.example 是项目约定俗成的参考模板供开发者在没有 CLI 时手动参考配置。九、生成的 ENV 文件与项目其它部分的对应关系生成的配置不是孤立的它与仓库其它部分紧密关联前端NEXT_PUBLIC_BACKEND_URLhttp://localhost:8000对应 docker-compose.yml 中platform服务暴露的8000端口NEXTAUTH_URL对应前端3000端口。后端REWORKD_PLATFORM_OPENAI_API_KEY、REWORKD_PLATFORM_MAX_LOOPS等会被 Python 后端platform/reworkd_platform/settings.py一类的配置加载逻辑读取REWORKD_PLATFORM_MAX_LOOPS与NEXT_PUBLIC_MAX_LOOPS通过${...}引用保持一致正如 .env.example 顶部注释所说max loops determines how many times the agent may execute最大循环次数决定 Agent 可执行多少轮任务。数据库Docker Compose 模式下的端口3307、主机agentgpt_db、用户/密码reworkd_platform与 docker-compose.yml 中agentgpt_db服务的MYSQL_DATABASE/MYSQL_USER/MYSQL_PASSWORD/MYSQL_TCP_PORT完全对齐宿主机的3308映射到容器内3307避免与本机 3306 冲突。MySQL 初始化db/目录下的Dockerfile用于构建数据库镜像与agentgpt_db服务的build.context: ./db对应。十、常见问题与排障建议运行./setup.sh报 Node 版本错误CLI 要求 Node18.0.0 19.0.0见 cli/package.json 的engines字段请检查当前 Node 版本是否在此范围内。提示 .env 缺失 Key说明当前./next/.env与getEnvDefinition中的预期 Key 不一致。按提示删除./next/.env与./platform/.env后重新运行脚本即可重新生成。想临时禁用某功能OpenAI / SERP / Replicate 三个 Key 在问答中都可以直接回车跳过isValidKey对空字符串返回 true对应功能会被禁用或回退到默认实现如无 Replicate Key 时图像生成仅用 DALL-E。手动模式下的数据库手动启动需要自行准备 MySQL并将REWORKD_PLATFORM_DATABASE_*/DATABASE_*改为本机可用配置端口默认3306。Docker Compose 方式下后端地址容器内访问宿主机使用http://host.docker.internal:8000若在非 Docker 环境使用该地址会无法连通此时应选择手动模式或调整配置。小结AgentGPT CLI 把阅读文档、手抄环境变量、逐个配置密钥的繁琐过程压缩成一次交互式问答它负责 Key 的格式与远程双重校验、NEXTAUTH_SECRET 的随机生成、前后端两份 .env 的同步写入以及存量文件的缺 Key 校验。理解了 cli/src/index.js、cli/src/envGenerator.js、cli/src/questions/ 三个核心模块之后你既能顺畅完成 AgentGPT 本地环境的初始化也能按三步骤规范地为项目扩展新的环境变量。【免费下载链接】AgentGPT Assemble, configure, and deploy autonomous AI Agents in your browser.项目地址: https://gitcode.com/gh_mirrors/ag/AgentGPT创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考