🚀 OpenClaw Gateway 高级配置与性能调优 2026

{ "gateway": { "http": { // 监听地址，0.0.0.0 监听所有网卡 "listen": "0.0.0.0:8080", // TLS 配置（生产环境必须） "tls": { "enabled": true, "cert": "/etc/openclaw/tls/cert.pem", "key": "/etc/openclaw/tls/key.pem", "minVersion": "TLS1.3" }, // CORS 配置 "cors": { "allowedOrigins": ["https://miaoquai.com"], "allowedMethods": ["GET", "POST", "OPTIONS"], "allowedHeaders": ["Content-Type", "Authorization"] }, // 请求限制 "rateLimit": { "enabled": true, "requestsPerMinute": 1000, "burst": 100 }, // 超时配置 "timeouts": { "read": "30s", "write": "60s", "idle": "120s", "shutdown": "30s" } } } }

{ "gateway": { "agents": { // Agent 注册方式 "discovery": { "method": "static", // static | consul | etcd | k8s "static": [ { "id": "agent-chat-001", "endpoint": "http://10.0.1.10:9090", "weight": 100, "tags": ["chat", "production"] }, { "id": "agent-code-001", "endpoint": "http://10.0.1.11:9090", "weight": 80, "tags": ["code", "production"] } ] }, // 健康检查 "healthCheck": { "enabled": true, "path": "/health", "interval": "10s", "timeout": "3s", "failThreshold": 3, "passThreshold": 2 }, // 连接池配置 "connectionPool": { "maxIdleConns": 100, "maxIdleConnsPerHost": 10, "idleTimeout": "90s" } } } }

{ "gateway": { "performance": { // 工作线程数（建议：CPU 核心数 × 2） "workerThreads": 16, // 最大并发请求数 "maxConcurrentRequests": 10000, // 请求队列大小 "requestQueueSize": 5000, // 事件循环策略：epoll (Linux) / kqueue (macOS) / io_uring (Linux 5.1+) "eventLoop": "io_uring", // 是否启用忙轮询（低延迟场景开启） "busyPoll": false } } }

{ "gateway": { "memory": { // 对象池配置（减少 GC 压力） "objectPool": { "enabled": true, "maxSize": 10000, "preallocate": true }, // 响应体缓冲区大小 "bufferPool": { "smallBufferSize": 4096, // 4KB "largeBufferSize": 65536, // 64KB "maxBuffers": 5000 }, // GC 调优（Go 版本） "gcPercent": 50, // 默认 100，降低可减少 GC 频率 "maxHeapSize": "2Gi" } } }

# 调整文件描述符限制 echo "* soft nofile 65536" >>> /etc/security/limits.conf echo "* hard nofile 131072" >>> /etc/security/limits.conf # 调整内核网络参数 cat >> /etc/sysctl.d/99-openclaw.conf <<EOF net.core.somaxconn = 65535 net.core.netdev_max_backlog = 65535 net.ipv4.tcp_max_syn_backlog = 65535 net.ipv4.tcp_tw_reuse = 1 net.ipv4.tcp_fin_timeout = 30 net.ipv4.tcp_keepalive_time = 600 net.ipv4.tcp_keepalive_probes = 3 net.ipv4.tcp_keepalive_intvl = 30 net.ipv4.tcp_mem = 8388608 8388608 8388608 net.ipv4.tcp_rmem = 4096 87380 16777216 net.ipv4.tcp_wmem = 4096 16384 16777216 EOF sysctl --system

{ "gateway": { "routing": { "rules": [ { "name": "chat-route", "match": { "type": "semantic", "threshold": 0.82, "categories": ["conversation", "qa", "general"] }, "target": "agent-chat-001", "fallback": "agent-chat-002" }, { "name": "code-route", "match": { "type": "semantic", "threshold": 0.78, "categories": ["code", "programming", "debug"] }, "target": "agent-code-001" }, { "name": "api-prefix-route", "match": { "type": "prefix", "pattern": "/api/v1/admin" }, "target": "agent-admin-001", "requiresAuth": true } ] } } }

{ "gateway": { "loadBalancing": { "strategy": "adaptive", "adaptive": { "metrics": ["cpu", "memory", "latency", "queue_depth"], "updateInterval": "5s", "historyWindow": "1m", "weights": { "cpu": 0.3, "memory": 0.2, "latency": 0.35, "queue_depth": 0.15 } }, "slowStart": { "enabled": true, "duration": "30s", "initialWeight": 10 }, "circuitBreaker": { "enabled": true, "errorThreshold": 0.5, "minRequests": 20, "cooldown": "10s" } } } }

{ "gateway": { "cache": { "layers": [ { "name": "L1-memory", "type": "memory", "maxSize": 1000, "ttl": "5m", "keyPattern": ["agent:response:*"] }, { "name": "L2-redis", "type": "redis", "endpoint": "redis://10.0.2.10:6379", "password": "${REDIS_PASSWORD}", "db": 0, "ttl": "30m", "keyPattern": ["agent:*"] } ], "defaultTTL": "10m", "cacheControl": { "enabled": true, "maxAge": 300 } } } }

{ "gateway": { "logging": { "level": "info", "format": "json", "outputs": [ { "type": "file", "path": "/var/log/openclaw/gateway.log", "maxSize": "100MB", "maxBackups": 7, "compress": true }, { "type": "syslog", "network": "tcp", "address": "localhost:514" } ], "sampling": { "enabled": true, "initial": 100, "thereafter": 1000 } } } }

{ "gateway": { "monitoring": { "metrics": { "enabled": true, "path": "/metrics", "histogramBuckets": [0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1.0, 2.5, 5.0] }, "healthCheck": { "path": "/health", "detailed": true }, "openTelemetry": { "enabled": true, "endpoint": "otel-collector:4317", "samplingRatio": 0.1, "serviceName": "openclaw-gateway" } } } }

{ "gateway": { "http": { "listen": "0.0.0.0:8443", "tls": { "enabled": true, "cert": "/etc/ssl/certs/gateway.pem", "key": "/etc/ssl/private/gateway.key", "minVersion": "TLS1.3", "ciphers": ["TLS_AES_128_GCM_SHA256", "TLS_AES_256_GCM_SHA384"] }, "timeouts": { "read": "30s", "write": "120s", "idle": "300s", "shutdown": "60s" }, "rateLimit": { "enabled": true, "requestsPerMinute": 5000, "burst": 500 } }, "performance": { "workerThreads": 16, "maxConcurrentRequests": 10000, "eventLoop": "io_uring" }, "agents": { "discovery": { "method": "k8s", "k8s": { "namespace": "openclaw", "selector": "app=openclaw-agent", "port": 9090 } }, "healthCheck": { "enabled": true, "interval": "10s", "timeout": "5s", "failThreshold": 3 } }, "loadBalancing": { "strategy": "adaptive", "adaptive": { "metrics": ["cpu", "latency", "queue_depth"], "updateInterval": "5s", "weights": { "cpu": 0.35, "latency": 0.4, "queue_depth": 0.25 } }, "circuitBreaker": { "enabled": true, "errorThreshold": 0.5, "minRequests": 20, "cooldown": "30s" } }, "cache": { "layers": [ { "name": "L1-memory", "type": "memory", "maxSize": 5000, "ttl": "2m" }, { "name": "L2-redis", "type": "redis", "endpoint": "redis://redis-svc:6379", "password": "${REDIS_PASSWORD}", "ttl": "15m" } ] }, "logging": { "level": "info", "format": "json", "outputs": [ { "type": "file", "path": "/var/log/openclaw/gateway.log", "maxSize": "500MB", "maxBackups": 14, "compress": true } ] }, "monitoring": { "metrics": { "enabled": true, "path": "/metrics" }, "openTelemetry": { "enabled": true, "endpoint": "otel-collector:4317", "samplingRatio": 0.1 } } } }

version: "3.8" services: gateway: image: openclaw/gateway:2026.6 ports: - "8443:8443" volumes: - /etc/ssl:/etc/ssl:ro - ./gateway.production.json:/etc/openclaw/gateway.json:ro environment: - REDIS_PASSWORD=${REDIS_PASSWORD} - OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4317 depends_on: - redis - otel-collector deploy: replicas: 3 resources: limits: cpus: "4" memory: "4Gi" reservations: cpus: "2" memory: "2Gi" healthcheck: test: ["CMD", "curl", "-f", "https://localhost:8443/health"] interval: 30s timeout: 10s retries: 3 redis: image: redis:7-alpine volumes: - redis-data:/data deploy: resources: limits: memory: "1Gi" otel-collector: image: otel/opentelemetry-collector-contrib:latest volumes: - ./otel-config.yaml:/etc/otel/config.yaml:ro volumes: redis-data: