AgentGPT长期运行需五步:一、调高Settings中Loop值至50/100;二、用docker compose up -d后台常驻;三、配置有效OpenAI密钥并选gpt-3.5-turbo;四、禁用Chrome自动休眠并设标签页常驻;五、Nginx反向代理中配置proxy_read_timeout等长连接参数。
如果您已配置好agentgpt并希望其持续执行目标,但发现任务在数次循环后自动终止,则可能是由于默认执行限制或本地运行环境未持久化所致。以下是实现agentgpt任务长期运行的具体操作路径:
一、启用持久化Loop参数
AgentGPT默认Loop上限为4次,需手动调高该值以支持连续多轮推理与执行。此参数直接决定代理可自主迭代的次数上限,是维持长期运行的基础设置。
1、在AgentGPT界面右下角点击Settings按钮。
2、找到Advanced Settings区域并展开。
3、将Loop字段数值修改为大于4的整数,例如50或100。
4、确认保存设置,重新启动AgentGPT任务。
二、使用Docker容器后台常驻运行
通过Docker启动AgentGPT可脱离终端会话独立运行,避免因关闭命令行窗口或SSH连接中断导致进程退出,保障7×24小时不间断服务。
1、确保系统已安装Docker及docker-compose。
2、进入AgentGPT项目根目录,执行docker compose up -d命令。
3、使用docker ps验证容器状态是否为Up。
4、访问http://localhost:3000确认Web界面正常加载。
三、配置OpenAI API Key并选用稳定模型
未配置有效API密钥或误选无权限模型会导致任务在中途因认证失败或响应异常而中断。长期运行依赖稳定、持续可用的模型调用通道。
1、登录OpenAI平台,访问https://platform.openai.com/account/api-keys。
2、点击Create new secret key生成密钥。
3、返回AgentGPT Settings页面,在Key栏粘贴该密钥。
4、在Model选项中选择已开通权限的模型,如gpt-3.5-turbo(避免勾选GPT-4,除非确认账户已获授权)。
四、禁用浏览器自动休眠机制
部分浏览器在标签页非活跃状态下会限制JavaScript执行频率,导致AgentGPT前端心跳检测失效、任务暂停。需主动干预浏览器行为以维持前台活跃状态。
1、在Chrome地址栏输入chrome://flags/#automatic-tab-discarding。
2、将该实验性功能设为Disabled。
3、重启浏览器。
4、打开AgentGPT页面后,右键标签页选择Keep this tab active(如Chrome 120+版本支持)。
五、部署反向代理并启用HTTPS保活
公网访问场景下,Nginx等反向代理若未配置长连接与超时策略,可能在空闲期主动断开WebSocket连接,造成AgentGPT后端通信中断。需显式延长各类超时阈值。
1、编辑Nginx站点配置文件,在server块内添加:proxy_read_timeout 3600;
2、追加:proxy_http_version 1.1;
3、加入:proxy_set_header Upgrade $http_upgrade;
4、执行nginx -t && nginx -s reload重载配置。










