Skip to main content

环境变量

除了命令行参数和 Web 界面配置，AutoGLM-GUI 也读取以下环境变量。环境变量在 Docker 部署、CI 等场景下尤其方便（在 docker-compose.yml 的 environment 段设置即可）。

模型服务​

变量默认值说明
AUTOGLM_BASE_URL无模型 API 基础地址（必填其一：此处或界面配置）
AUTOGLM_MODEL_NAMEautoglm-phone-9b模型名称
AUTOGLM_API_KEYEMPTY模型 API 密钥

决策模型（分层代理用）​

分层代理模式的规划层使用一个独立的「决策模型」。不配置时回退到上面的主模型。

变量默认值说明
AUTOGLM_DECISION_BASE_URL无决策模型 API 基础地址
AUTOGLM_DECISION_MODEL_NAME无决策模型名称
AUTOGLM_DECISION_API_KEY无决策模型 API 密钥

执行控制​

变量默认值说明
AUTOGLM_DEFAULT_MAX_STEPS100经典模式单次任务的最大步数
AUTOGLM_LAYERED_MAX_TURNS50分层代理模式的最大轮数

服务与日志​

变量默认值说明
AUTOGLM_CORS_ORIGINShttp://localhost:3000允许的 CORS 来源
AUTOGLM_ENABLE_WEB_TERMINAL0置为 1 启用 Web 终端
AUTOGLM_SERVER_HOST127.0.0.1服务绑定的主机地址，Web 终端等内部模块使用
AUTOGLM_ADB_PATHadbadb 可执行文件路径
AUTOGLM_LOG_LEVELINFO日志级别（--reload 模式下沿用）
AUTOGLM_LOG_FILElogs/autoglm_{time:YYYY-MM-DD}.log日志文件路径
AUTOGLM_NO_LOG_FILE0置为 1 关闭文件日志

追踪与可观测性​

详见追踪与可观测性。追踪默认开启，将 AUTOGLM_TRACE_ENABLED 设为 0/false/no/off 可关闭。

变量默认值说明
AUTOGLM_TRACE_ENABLED1（开启）是否启用执行追踪
AUTOGLM_TRACE_REPLAY_ENABLED1（开启）是否启用可回放追踪
AUTOGLM_TRACE_FILElogs/trace_{date}.jsonl追踪 JSONL 输出路径
AUTOGLM_TRACE_CAPTURE_SCREENSHOTartifact截图捕获模式
AUTOGLM_TRACE_CAPTURE_THINKING1（开启）置为 0/false/no/off 关闭追踪中的 thinking 内容
AUTOGLM_TRACE_CAPTURE_ACTION1（开启）置为 0/false/no/off 关闭追踪中的 action 内容

设备操作延迟（高级）​

PHONE_AGENT_* 系列控制每个 ADB 操作后的等待时间（单位：秒），用于适配响应较慢的设备。多数默认 1.0 秒。常用项：

变量默认值说明
PHONE_AGENT_TAP_DELAY1.0点击后等待
PHONE_AGENT_SWIPE_DELAY1.0滑动后等待
PHONE_AGENT_TEXT_INPUT_DELAY1.0文本输入后等待
PHONE_AGENT_LAUNCH_DELAY1.0启动应用后等待
PHONE_AGENT_ADB_RESTART_DELAY2.0启用 TCP/IP 后等待

完整的 PHONE_AGENT_* 清单见源码 AutoGLM_GUI/adb/timing.py（含双击、长按、返回、Home、键盘切换等延迟项）。

示例（docker-compose）​

services:
  autoglm-gui:
    image: ghcr.io/suyiiyii/autoglm-gui:main
    environment:
      AUTOGLM_BASE_URL: https://open.bigmodel.cn/api/paas/v4
      AUTOGLM_MODEL_NAME: autoglm-phone
      AUTOGLM_API_KEY: sk-xxxxx
      AUTOGLM_ENABLE_WEB_TERMINAL: "1"