OpenClaw 配置编辑器

最后修改版本

OpenClaw 写入配置时自动设置的版本号。

最后修改时间

最后一次配置写入的 ISO 时间戳（自动设置）。

环境变量覆盖

合并到 OpenClaw 运行时进程环境中的显式键/值环境变量覆盖。使用此项进行确定性的环境配置，而不是仅依赖 shell 配置文件的副作用。

启用诊断

日志和遥测布线路径中诊断仪表输出的主开关。默认启用；仅在严格受限的环境中设置为 false。

诊断标志

通过标志启用目标诊断日志（例如 ["telegram.http"]）。支持通配符如 "telegram.*" 或 "*"。

会话活跃阈值(毫秒)

将长时间处理会话分类为长运行、停滞或卡住的无进展时间阈值（毫秒）。回复、工具、状态、块和 ACP 进度会重置计时器；当无变化时，重复的卡住诊断会退避。

会话中止阈值(毫秒)

在符合条件的停滞活动工作可能被中止排空以进行恢复之前的无进展时间阈值（毫秒）。默认为更安全的扩展嵌入运行恢复窗口。

内存压力快照

是否在关键内存压力下自动捕获已编辑的稳定性快照。默认：false。仅当此主机在关键内存压力期间可以承受额外的文件系统扫描和快照写入时才启用。

日志级别

运行时日志输出的主要日志级别阈值："silent"、"fatal"、"error"、"warn"、"info"、"debug" 或 "trace"。生产环境保持 "info" 或 "warn"，仅在调查时使用 debug/trace。

日志文件路径

除控制台日志外或替代控制台日志的持久化日志输出的可选文件路径。使用托管的可写路径，并根据你的操作策略对齐保留/轮换。

最大文件字节数

日志文件的最大字节数限制。

控制台日志级别

控制台特定的日志阈值："silent"、"fatal"、"error"、"warn"、"info"、"debug" 或 "trace"，用于终端输出控制。使用此项保持本地控制台更安静，同时在需要时保留更丰富的文件日志。

控制台日志样式

控制台输出格式样式："pretty"、"compact" 或 "json"，根据操作员和摄取需求选择。机器解析管道使用 json，人类优先的终端工作流使用 pretty/compact。

敏感数据编辑模式

敏感日志/转录编辑模式："off" 禁用一般日志和转录掩码，"tools" 在这些接收器中编辑敏感的工具/配置负载字段。即使此项为 "off"，安全边界 UI、工具和诊断负载仍可能编辑。

自定义编辑模式

在发出前应用于日志输出、持久化转录文本和安全边界 UI/工具/诊断负载的额外自定义编辑正则表达式模式。使用此项掩盖内置编辑规则未覆盖的组织特定令牌和标识符。

启用浏览器

在网关中启用浏览器功能布线，以便浏览器工具和 CDP 驱动的工作流可以运行。当不需要浏览器自动化时禁用以减少攻击面和启动工作。

启用浏览器执行

在支持的地方启用浏览器端执行助手用于运行时脚本执行功能。除非你的工作流需要超出快照/导航的执行语义，否则保持禁用。

浏览器 CDP URL

用于附加到外部管理浏览器实例的远程 CDP websocket URL。用于集中式浏览器主机，并保持 URL 访问仅限于受信任的网络路径。

远程 CDP 超时(毫秒)

连接到远程 CDP 端点的超时时间（毫秒），超时后浏览器附加尝试失败。对于高延迟隧道增加此值，或降低以更快检测失败。

远程 CDP 握手超时(毫秒)

针对远程浏览器目标的连接后 CDP 握手就绪检查的超时时间（毫秒）。对于启动较慢的远程浏览器增加此值，降低以在自动化循环中快速失败。

本地启动超时(毫秒)

本地启动的托管 Chrome 在进程启动后公开其 CDP HTTP 端点的超时时间（毫秒）。在较慢的单板计算机或旧主机上增加此值。

本地 CDP 就绪超时(毫秒)

本地启动的托管浏览器在发现进程后完成 CDP websocket 就绪的超时时间（毫秒）。当 Chrome 启动但浏览器启动仍报告 CDP 不可达时增加此值。

浏览器操作超时(毫秒)

客户端放弃等待前浏览器 act 请求的默认超时时间（毫秒）。当健康等待或 UI 交互超过默认请求预算时增加此值。

浏览器强调色

用于浏览器配置文件/UI 提示中显示彩色身份标识的默认强调色。使用一致的颜色帮助操作员快速识别活动浏览器配置文件上下文。

浏览器可执行文件路径

当自动发现不足以适应你的主机环境时的显式浏览器可执行文件路径。使用绝对稳定路径，或以 ~ 开头的路径用于你的 OS 主目录，以便启动行为在重启之间保持确定性。

无头模式

当本地启动器启动浏览器实例时强制以无头模式启动浏览器。在服务器环境中保持启用无头模式，仅在需要可见 UI 调试时禁用。

禁用沙箱

为运行时沙箱失败的环境禁用 Chromium 沙箱隔离标志。尽可能保持此项关闭，因为进程隔离保护会降低。

仅附加模式

将浏览器模式限制为仅附加行为，不启动本地浏览器进程。当所有浏览器会话都由远程 CDP 提供者外部管理时使用。

CDP 端口范围起始

用于自动分配浏览器配置文件端口的起始本地 CDP 端口。当主机级别端口默认与其他本地服务冲突时增加此值。

默认配置文件

当调用者未显式选择配置文件时选择的默认浏览器配置文件名称。使用稳定的低权限配置文件作为默认值，以减少意外的跨上下文状态使用。

浏览器配置文件

用于显式路由到 CDP 端口或 URL 的命名浏览器配置文件连接映射，带有可选元数据。保持配置文件名称一致，避免重叠的端点定义。

extraArgs

代理列表

命名代理及其覆盖设置的列表。

端口

网关服务器监听端口。

模式

网关运行模式：local 或 remote。

绑定

网关绑定模式：loopback、lan 或 all。

Gateway Custom Bind Host

Explicit bind host/IP used when gateway.bind is set to custom for manual interface targeting. Use a precise address and avoid wildcard binds unless external exposure is required.

Gateway Trusted Proxy CIDRs

CIDR/IP allowlist of upstream proxies permitted to provide forwarded client identity headers. Keep this list narrow so untrusted hops cannot impersonate users.

Gateway Allow x-real-ip Fallback

Enables x-real-ip fallback when x-forwarded-for is missing in proxy scenarios. Keep disabled unless your ingress stack requires this compatibility behavior.

Gateway Handshake 超时

Pre-auth Gateway WebSocket handshake timeout in milliseconds. Use higher values on loaded or low-powered hosts where local clients can connect during startup warmup. OPENCLAW_HANDSHAKE_TIMEOUT_MS still takes precedence.

Gateway 频道 健康 检查 间隔 (最小)

Interval in minutes for automatic channel health probing and status updates. Use lower intervals for faster detection, or higher intervals to reduce periodic probe noise.

Gateway 频道 Stale Event Threshold (最小)

How many minutes a connected channel can go without provider-proven transport activity before the health monitor treats it as a stale socket and triggers a restart. Default: 30.

Gateway 频道 最大 Restarts Per Hour

Maximum number of health-monitor-initiated channel restarts allowed within a rolling one-hour window. Once hit, further restarts are skipped until the window expires. Default: 10.