Skip to content

运行时配置 ​

Lisa 通过环境变量进行配置,运行数据保存在 Lisa 自有的 PostgreSQL 与文件系统中,不依赖 TheLake。

变量用途
LISA_WORKSPACE_ID单个 Lisa 运行时部署的 UUID 作用域。
LISA_DATABASE_URLLisa 应用与 Worker 使用的 PostgreSQL 写连接。
LISA_DATABASE_READ_URLLisa 数据库工具使用的只读 PostgreSQL 连接。
LISA_DATABASE_PROVISION_URL仅部署时使用的管理员连接(供 scripts/provision_lisa.py 使用)。
LISA_DATABASE_WRITER_PASSWORD / LISA_DATABASE_READER_PASSWORD创建数据库时初始化运行时角色的密码。
LISA_SERVICE_TOKEN内部认证 API 路由使用的 Bearer Token。
LISA_MODEL对话模型标识(默认 gemini/gemini-3.8-flash)。
GOOGLE_API_KEY / GEMINI_API_KEY用于对话与策略裁决的 Gemini 密钥。
OPENAI_API_KEY用于 OpenAI 策略分诊的密钥。
GEMINI_MODEL_NAME裁决模型(默认 gemini-3.8-flash)。
LISA_DATA_DIROpenHands 与对话状态的根目录。
LISA_AGENT_WORKSPACE_ROOT接收推送 OTLP 会话包的根目录。
LISA_MAX_SESSION_TRACE_BYTES推送会话轨迹的最大请求体(默认 16 MiB,上限 64 MiB)。
LISA_CORS_ORIGINS允许跨域访问的浏览器来源列表(逗号分隔)。
LISA_OWNER_USER_IDS有权批准策略变更的 Lisa 用户 ID。
SOFTPROBE_ASSERTION_HMAC_SECRET启用签名工作区断言时的 HMAC 密钥。
LISA_SLACK_*可选的 Slack 事件与通知配置。
LISA_STATIC_DIR前端静态资源目录(镜像内默认为 /app/static)。

WARNING

POST /internal/v1/session-traces 不校验身份凭证,必须仅部署在私网中,切勿暴露在公网入口上。

Arex· Blackbox · Lisa