Tham chiếu cấu hình

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

• openclaw config schema in JSON Schema trực tiếp dùng cho xác thực và Control UI, với siêu dữ liệu bundled/plugin/channel được hợp nhất khi có sẵn
• config.schema.lookup trả về một nút schema theo phạm vi đường dẫn cho công cụ drill-down
• pnpm config:docs:check / pnpm config:docs:gen xác thực hash baseline tài liệu cấu hình so với bề mặt schema hiện tại

• Tham chiếu cấu hình bộ nhớ cho agents.defaults.memorySearch.*, memory.qmd.*, memory.citations, và cấu hình dreaming trong plugins.entries.memory-core.config.dreaming
• Lệnh slash cho danh mục lệnh tích hợp sẵn + bundled hiện tại
• các trang kênh/plugin sở hữu cho các bề mặt lệnh riêng theo kênh

​

Kênh

​

Mặc định tác tử, đa tác tử, phiên, và tin nhắn

• agents.defaults.* (workspace, model, thinking, heartbeat, memory, media, skills, sandbox)
• multiAgent.* (định tuyến và binding đa tác tử)
• session.* (vòng đời phiên, compaction, cắt tỉa)
• messages.* (gửi tin nhắn, TTS, kết xuất markdown)
• talk.* (chế độ Talk)
  • talk.speechLocale: id locale BCP 47 tùy chọn cho nhận dạng giọng nói Talk trên iOS/macOS
  • talk.silenceTimeoutMs: khi chưa đặt, Talk giữ cửa sổ tạm dừng mặc định của nền tảng trước khi gửi bản chép lời (700 ms on macOS and Android, 900 ms on iOS)

​

Công cụ và nhà cung cấp tùy chỉnh

​

Model

{
  models: {
    // Optional. Default: true. Requires a Gateway restart when changed.
    pricing: { enabled: false },
  },
}

• models.mode: hành vi danh mục nhà cung cấp (merge hoặc replace).
• models.providers: bản đồ nhà cung cấp tùy chỉnh được khóa theo id nhà cung cấp.
• models.pricing.enabled: kiểm soát bootstrap pricing chạy nền. Khi false, khởi động Gateway bỏ qua các lần fetch danh mục pricing của OpenRouter và LiteLLM; các giá trị models.providers.*.models[].cost đã cấu hình vẫn hoạt động cho ước tính chi phí cục bộ.

​

MCP

{
  mcp: {
    // Optional. Default: 600000 ms (10 minutes). Set 0 to disable idle eviction.
    sessionIdleTtlMs: 600000,
    servers: {
      docs: {
        command: "npx",
        args: ["-y", "@modelcontextprotocol/server-fetch"],
      },
      remote: {
        url: "https://example.com/mcp",
        transport: "streamable-http", // streamable-http | sse
        headers: {
          Authorization: "Bearer ${MCP_REMOTE_TOKEN}",
        },
      },
    },
  },
}

• mcp.servers: định nghĩa server MCP stdio hoặc từ xa có tên cho các runtime phơi bày công cụ MCP đã cấu hình. Mục từ xa dùng transport: "streamable-http" hoặc transport: "sse"; type: "http" là bí danh gốc CLI mà openclaw mcp set và openclaw doctor --fix chuẩn hóa thành trường transport chính tắc.
• mcp.sessionIdleTtlMs: TTL nhàn rỗi cho runtime MCP bundled theo phạm vi phiên. Các lần chạy nhúng một lần yêu cầu dọn dẹp khi kết thúc chạy; TTL này là điểm chặn dự phòng cho phiên sống lâu và caller tương lai.
• Thay đổi dưới mcp.* được áp dụng nóng bằng cách dispose runtime MCP phiên đã cache. Lần khám phá/sử dụng công cụ tiếp theo tạo lại chúng từ cấu hình mới, nên các mục mcp.servers đã xóa được thu hồi ngay thay vì chờ TTL nhàn rỗi.

​

Skills

{
  skills: {
    allowBundled: ["gemini", "peekaboo"],
    load: {
      extraDirs: ["~/Projects/agent-scripts/skills"],
    },
    install: {
      preferBrew: true,
      nodeManager: "npm", // npm | pnpm | yarn | bun
    },
    entries: {
      "image-lab": {
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" }, // or plaintext string
        env: { GEMINI_API_KEY: "GEMINI_KEY_HERE" },
      },
      peekaboo: { enabled: true },
      sag: { enabled: false },
    },
  },
}

• allowBundled: allowlist tùy chọn chỉ cho bundled skills (managed/workspace skills không bị ảnh hưởng).
• load.extraDirs: các gốc skill dùng chung bổ sung (độ ưu tiên thấp nhất).
• install.preferBrew: khi true, ưu tiên trình cài Homebrew khi có brew trước khi fallback sang các loại trình cài khác.
• install.nodeManager: tùy chọn trình cài node cho spec metadata.openclaw.install (npm | pnpm | yarn | bun).
• entries.<skillKey>.enabled: false vô hiệu hóa một skill ngay cả khi bundled/installed.
• entries.<skillKey>.apiKey: tiện ích cho skill khai báo biến env chính (chuỗi plaintext hoặc đối tượng SecretRef).

​

Plugins

{
  plugins: {
    enabled: true,
    allow: ["voice-call"],
    deny: [],
    load: {
      paths: ["~/Projects/oss/voice-call-plugin"],
    },
    entries: {
      "voice-call": {
        enabled: true,
        hooks: {
          allowPromptInjection: false,
        },
        config: { provider: "twilio" },
      },
    },
  },
}

• Được tải từ ~/.openclaw/extensions, <workspace>/.openclaw/extensions, cộng với plugins.load.paths.
• Discovery chấp nhận plugin OpenClaw native cùng các bundle Codex tương thích và bundle Claude, bao gồm bundle layout mặc định của Claude không có manifest.
• Thay đổi cấu hình yêu cầu khởi động lại gateway.
• allow: allowlist tùy chọn (chỉ plugin được liệt kê mới tải). deny thắng.
• plugins.entries.<id>.apiKey: trường tiện ích API key cấp plugin (khi plugin hỗ trợ).
• plugins.entries.<id>.env: bản đồ biến env theo phạm vi plugin.
• plugins.entries.<id>.hooks.allowPromptInjection: khi false, core chặn before_prompt_build và bỏ qua các trường làm thay đổi prompt từ before_agent_start legacy, đồng thời giữ lại modelOverride và providerOverride legacy. Áp dụng cho hook plugin native và các thư mục hook do bundle hỗ trợ cung cấp.
• plugins.entries.<id>.hooks.allowConversationAccess: khi true, plugin non-bundled đáng tin cậy có thể đọc nội dung hội thoại thô từ các hook đã định kiểu như llm_input, llm_output, before_agent_finalize, và agent_end.
• plugins.entries.<id>.subagent.allowModelOverride: tin cậy rõ ràng plugin này để yêu cầu ghi đè provider và model theo từng lần chạy cho các lần chạy subagent nền.
• plugins.entries.<id>.subagent.allowedModels: allowlist tùy chọn các đích provider/model chính tắc cho ghi đè subagent đáng tin cậy. Chỉ dùng "*" khi bạn chủ ý muốn cho phép mọi model.
• plugins.entries.<id>.config: đối tượng cấu hình do plugin định nghĩa (được schema plugin OpenClaw native xác thực khi có sẵn).
• Thiết lập tài khoản/runtime của channel plugin nằm dưới channels.<id> và nên được metadata channelConfigs trong manifest của plugin sở hữu mô tả, không phải bởi registry tùy chọn OpenClaw trung tâm.
• plugins.entries.firecrawl.config.webFetch: thiết lập nhà cung cấp web-fetch Firecrawl.
  • apiKey: API key Firecrawl (chấp nhận SecretRef). Fallback sang plugins.entries.firecrawl.config.webSearch.apiKey, legacy tools.web.fetch.firecrawl.apiKey, hoặc biến env FIRECRAWL_API_KEY.
  • baseUrl: URL cơ sở API Firecrawl (mặc định: https://api.firecrawl.dev).
  • onlyMainContent: chỉ trích xuất nội dung chính từ trang (mặc định: true).
  • maxAgeMs: tuổi cache tối đa tính bằng mili giây (mặc định: 172800000 / 2 ngày).
  • timeoutSeconds: timeout yêu cầu scrape tính bằng giây (mặc định: 60).
• plugins.entries.xai.config.xSearch: thiết lập xAI X Search (tìm kiếm web Grok).
  • enabled: bật nhà cung cấp X Search.
  • model: model Grok dùng cho tìm kiếm (ví dụ "grok-4-1-fast").
• plugins.entries.memory-core.config.dreaming: thiết lập memory dreaming. Xem Dreaming để biết các pha và ngưỡng.
  • enabled: công tắc dreaming chính (mặc định false).
  • frequency: cadence cron cho mỗi lần quét dreaming đầy đủ ("0 3 * * *" theo mặc định).
  • model: ghi đè model subagent Dream Diary tùy chọn. Yêu cầu plugins.entries.memory-core.subagent.allowModelOverride: true; ghép với allowedModels để giới hạn đích. Lỗi model không khả dụng sẽ thử lại một lần với model mặc định của phiên; lỗi tin cậy hoặc allowlist không fallback âm thầm.
  • chính sách pha và ngưỡng là chi tiết triển khai (không phải khóa cấu hình hướng tới người dùng).
• Cấu hình bộ nhớ đầy đủ nằm trong Tham chiếu cấu hình bộ nhớ:
  • agents.defaults.memorySearch.*
  • memory.backend
  • memory.citations
  • memory.qmd.*
  • plugins.entries.memory-core.config.dreaming
• Plugin bundle Claude đã bật cũng có thể đóng góp mặc định Pi nhúng từ settings.json; OpenClaw áp dụng các mặc định đó như thiết lập tác tử đã được làm sạch, không phải patch cấu hình OpenClaw thô.
• plugins.slots.memory: chọn id plugin bộ nhớ đang hoạt động, hoặc "none" để vô hiệu hóa plugin bộ nhớ.
• plugins.slots.contextEngine: chọn id plugin context engine đang hoạt động; mặc định là "legacy" trừ khi bạn cài đặt và chọn engine khác.

​

Trình duyệt

{
  browser: {
    enabled: true,
    evaluateEnabled: true,
    defaultProfile: "user",
    ssrfPolicy: {
      // dangerouslyAllowPrivateNetwork: true, // opt in only for trusted private-network access
      // allowPrivateNetwork: true, // legacy alias
      // hostnameAllowlist: ["*.example.com", "example.com"],
      // allowedHostnames: ["localhost"],
    },
    tabCleanup: {
      enabled: true,
      idleMinutes: 120,
      maxTabsPerSession: 8,
      sweepMinutes: 5,
    },
    profiles: {
      openclaw: { cdpPort: 18800, color: "#FF4500" },
      work: {
        cdpPort: 18801,
        color: "#0066CC",
        executablePath: "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
      },
      user: { driver: "existing-session", attachOnly: true, color: "#00AA00" },
      brave: {
        driver: "existing-session",
        attachOnly: true,
        userDataDir: "~/Library/Application Support/BraveSoftware/Brave-Browser",
        color: "#FB542B",
      },
      remote: { cdpUrl: "http://10.0.0.42:9222", color: "#00AA00" },
    },
    color: "#FF4500",
    // headless: false,
    // noSandbox: false,
    // extraArgs: [],
    // executablePath: "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser",
    // attachOnly: false,
  },
}

• evaluateEnabled: false tắt act:evaluate và wait --fn.
• tabCleanup thu hồi các tab tác nhân chính được theo dõi sau thời gian rảnh hoặc khi một phiên vượt quá giới hạn. Đặt idleMinutes: 0 hoặc maxTabsPerSession: 0 để tắt các chế độ dọn dẹp riêng lẻ đó.
• ssrfPolicy.dangerouslyAllowPrivateNetwork bị tắt khi chưa được đặt, nên điều hướng trình duyệt mặc định vẫn nghiêm ngặt.
• Chỉ đặt ssrfPolicy.dangerouslyAllowPrivateNetwork: true khi bạn chủ ý tin cậy điều hướng trình duyệt qua mạng riêng.
• Ở chế độ nghiêm ngặt, các điểm cuối hồ sơ CDP từ xa (profiles.*.cdpUrl) cũng chịu cùng cơ chế chặn mạng riêng trong các bước kiểm tra khả năng kết nối/phát hiện.
• ssrfPolicy.allowPrivateNetwork vẫn được hỗ trợ như một bí danh kế thừa.
• Ở chế độ nghiêm ngặt, dùng ssrfPolicy.hostnameAllowlist và ssrfPolicy.allowedHostnames cho các ngoại lệ tường minh.
• Hồ sơ từ xa chỉ cho phép gắn vào (tắt start/stop/reset).
• profiles.*.cdpUrl chấp nhận http://, https://, ws:// và wss://. Dùng HTTP(S) khi bạn muốn OpenClaw phát hiện /json/version; dùng WS(S) khi nhà cung cấp của bạn cung cấp URL DevTools WebSocket trực tiếp.
• remoteCdpTimeoutMs và remoteCdpHandshakeTimeoutMs áp dụng cho khả năng kết nối CDP từ xa và attachOnly, cùng các yêu cầu mở tab. Các hồ sơ loopback được quản lý giữ nguyên mặc định CDP cục bộ.
• Nếu một dịch vụ CDP do bên ngoài quản lý có thể truy cập qua loopback, hãy đặt attachOnly: true cho hồ sơ đó; nếu không OpenClaw sẽ xem cổng loopback là một hồ sơ trình duyệt cục bộ được quản lý và có thể báo lỗi quyền sở hữu cổng cục bộ.
• Hồ sơ existing-session dùng Chrome MCP thay vì CDP và có thể gắn vào máy chủ đã chọn hoặc qua một Node trình duyệt đã kết nối.
• Hồ sơ existing-session có thể đặt userDataDir để nhắm tới một hồ sơ trình duyệt dựa trên Chromium cụ thể như Brave hoặc Edge.
• Hồ sơ existing-session giữ các giới hạn tuyến Chrome MCP hiện tại: hành động dựa trên snapshot/ref thay vì nhắm mục tiêu bằng bộ chọn CSS, hook tải lên một tệp, không có ghi đè thời gian chờ hộp thoại, không có wait --load networkidle, và không có responsebody, xuất PDF, chặn tải xuống hoặc hành động theo lô.
• Hồ sơ openclaw cục bộ được quản lý tự động gán cdpPort và cdpUrl; chỉ đặt cdpUrl tường minh cho CDP từ xa.
• Hồ sơ cục bộ được quản lý có thể đặt executablePath để ghi đè browser.executablePath toàn cục cho hồ sơ đó. Dùng tùy chọn này để chạy một hồ sơ trong Chrome và một hồ sơ khác trong Brave.
• Hồ sơ cục bộ được quản lý dùng browser.localLaunchTimeoutMs cho bước phát hiện HTTP Chrome CDP sau khi quy trình khởi động và browser.localCdpReadyTimeoutMs cho trạng thái sẵn sàng websocket CDP sau khởi chạy. Tăng các giá trị này trên máy chủ chậm hơn, nơi Chrome khởi động thành công nhưng kiểm tra sẵn sàng chạy đua với quá trình khởi động. Cả hai giá trị phải là số nguyên dương tối đa 120000 ms; giá trị cấu hình không hợp lệ sẽ bị từ chối.
• Thứ tự tự động phát hiện: trình duyệt mặc định nếu dựa trên Chromium → Chrome → Brave → Edge → Chromium → Chrome Canary.
• browser.executablePath và browser.profiles.<name>.executablePath đều chấp nhận ~ và ~/... cho thư mục home của hệ điều hành trước khi khởi chạy Chromium. userDataDir theo từng hồ sơ trên hồ sơ existing-session cũng được mở rộng dấu ngã.
• Dịch vụ điều khiển: chỉ loopback (cổng được suy ra từ gateway.port, mặc định 18791).
• extraArgs nối thêm các cờ khởi chạy bổ sung vào quá trình khởi động Chromium cục bộ (ví dụ --disable-gpu, kích thước cửa sổ hoặc cờ gỡ lỗi).

​

UI

{
  ui: {
    seamColor: "#FF4500",
    assistant: {
      name: "OpenClaw",
      avatar: "CB", // emoji, short text, image URL, or data URI
    },
  },
}

• seamColor: màu nhấn cho chrome UI ứng dụng gốc (sắc thái bong bóng Talk Mode, v.v.).
• assistant: ghi đè danh tính Control UI. Dự phòng về danh tính tác nhân đang hoạt động.

​

Gateway

{
  gateway: {
    mode: "local", // local | remote
    port: 18789,
    bind: "loopback",
    auth: {
      mode: "token", // none | token | password | trusted-proxy
      token: "your-token",
      // password: "your-password", // or OPENCLAW_GATEWAY_PASSWORD
      // trustedProxy: { userHeader: "x-forwarded-user" }, // for mode=trusted-proxy; see /gateway/trusted-proxy-auth
      allowTailscale: true,
      rateLimit: {
        maxAttempts: 10,
        windowMs: 60000,
        lockoutMs: 300000,
        exemptLoopback: true,
      },
    },
    tailscale: {
      mode: "off", // off | serve | funnel
      resetOnExit: false,
    },
    controlUi: {
      enabled: true,
      basePath: "/openclaw",
      // root: "dist/control-ui",
      // embedSandbox: "scripts", // strict | scripts | trusted
      // allowExternalEmbedUrls: false, // dangerous: allow absolute external http(s) embed URLs
      // allowedOrigins: ["https://control.example.com"], // required for non-loopback Control UI
      // dangerouslyAllowHostHeaderOriginFallback: false, // dangerous Host-header origin fallback mode
      // allowInsecureAuth: false,
      // dangerouslyDisableDeviceAuth: false,
    },
    remote: {
      url: "ws://gateway.tailnet:18789",
      transport: "ssh", // ssh | direct
      token: "your-token",
      // password: "your-password",
    },
    trustedProxies: ["10.0.0.1"],
    // Optional. Default false.
    allowRealIpFallback: false,
    nodes: {
      pairing: {
        // Optional. Default unset/disabled.
        autoApproveCidrs: ["192.168.1.0/24", "fd00:1234:5678::/64"],
      },
      allowCommands: ["canvas.navigate"],
      denyCommands: ["system.run"],
    },
    tools: {
      // Additional /tools/invoke HTTP denies
      deny: ["browser"],
      // Remove tools from the default HTTP deny list
      allow: ["gateway"],
    },
    push: {
      apns: {
        relay: {
          baseUrl: "https://relay.example.com",
          timeoutMs: 10000,
        },
      },
    },
  },
}

​

Endpoint tương thích OpenAI

• Chat Completions: bị tắt theo mặc định. Bật bằng gateway.http.endpoints.chatCompletions.enabled: true.
• Responses API: gateway.http.endpoints.responses.enabled.
• Gia cố URL-input cho Responses:
  • gateway.http.endpoints.responses.maxUrlParts
  • gateway.http.endpoints.responses.files.urlAllowlist
  • gateway.http.endpoints.responses.images.urlAllowlist Danh sách cho phép rỗng được coi như chưa đặt; dùng gateway.http.endpoints.responses.files.allowUrl=false và/hoặc gateway.http.endpoints.responses.images.allowUrl=false để tắt lấy dữ liệu từ URL.
• Header gia cố phản hồi tùy chọn:
  • gateway.http.securityHeaders.strictTransportSecurity (chỉ đặt cho các origin HTTPS bạn kiểm soát; xem Trusted Proxy Auth)

​

Cô lập nhiều phiên bản

OPENCLAW_CONFIG_PATH=~/.openclaw/a.json \
OPENCLAW_STATE_DIR=~/.openclaw-a \
openclaw gateway --port 19001

​

gateway.tls

{
  gateway: {
    tls: {
      enabled: false,
      autoGenerate: false,
      certPath: "/etc/openclaw/tls/server.crt",
      keyPath: "/etc/openclaw/tls/server.key",
      caPath: "/etc/openclaw/tls/ca-bundle.crt",
    },
  },
}

• enabled: bật kết thúc TLS tại listener gateway (HTTPS/WSS) (mặc định: false).
• autoGenerate: tự động tạo cặp chứng chỉ/khóa tự ký cục bộ khi chưa cấu hình tệp rõ ràng; chỉ dùng cho local/dev.
• certPath: đường dẫn hệ thống tệp tới tệp chứng chỉ TLS.
• keyPath: đường dẫn hệ thống tệp tới tệp khóa riêng TLS; giữ quyền truy cập bị hạn chế.
• caPath: đường dẫn CA bundle tùy chọn cho xác minh client hoặc chuỗi tin cậy tùy chỉnh.

​

gateway.reload

{
  gateway: {
    reload: {
      mode: "hybrid", // off | restart | hot | hybrid
      debounceMs: 500,
      deferralTimeoutMs: 300000,
    },
  },
}

• mode: kiểm soát cách áp dụng chỉnh sửa cấu hình khi chạy.
  • "off": bỏ qua chỉnh sửa trực tiếp; thay đổi yêu cầu khởi động lại rõ ràng.
  • "restart": luôn khởi động lại tiến trình gateway khi cấu hình thay đổi.
  • "hot": áp dụng thay đổi trong tiến trình mà không khởi động lại.
  • "hybrid" (mặc định): thử hot reload trước; quay lại khởi động lại nếu bắt buộc.
• debounceMs: cửa sổ debounce tính bằng ms trước khi thay đổi cấu hình được áp dụng (số nguyên không âm).
• deferralTimeoutMs: thời gian tối đa tùy chọn tính bằng ms để chờ các thao tác đang chạy trước khi buộc khởi động lại. Bỏ qua để dùng thời gian chờ giới hạn mặc định (300000); đặt 0 để chờ vô thời hạn và ghi log cảnh báo vẫn đang chờ theo định kỳ.

​

Hooks

{
  hooks: {
    enabled: true,
    token: "shared-secret",
    path: "/hooks",
    maxBodyBytes: 262144,
    defaultSessionKey: "hook:ingress",
    allowRequestSessionKey: true,
    allowedSessionKeyPrefixes: ["hook:", "hook:gmail:"],
    allowedAgentIds: ["hooks", "main"],
    presets: ["gmail"],
    transformsDir: "~/.openclaw/hooks/transforms",
    mappings: [
      {
        match: { path: "gmail" },
        action: "agent",
        agentId: "hooks",
        wakeMode: "now",
        name: "Gmail",
        sessionKey: "hook:gmail:{{messages[0].id}}",
        messageTemplate: "From: {{messages[0].from}}\nSubject: {{messages[0].subject}}\n{{messages[0].snippet}}",
        deliver: true,
        channel: "last",
        model: "openai/gpt-5.4-mini",
      },
    ],
  },
}

• hooks.enabled=true yêu cầu hooks.token không rỗng.
• hooks.token phải khác với gateway.auth.token; việc dùng lại token Gateway sẽ bị từ chối.
• hooks.path không được là /; hãy dùng một đường dẫn con riêng như /hooks.
• Nếu hooks.allowRequestSessionKey=true, hãy giới hạn hooks.allowedSessionKeyPrefixes (ví dụ ["hook:"]).
• Nếu một ánh xạ hoặc preset dùng sessionKey theo mẫu, hãy đặt hooks.allowedSessionKeyPrefixes và hooks.allowRequestSessionKey=true. Các khóa ánh xạ tĩnh không yêu cầu bật tùy chọn đó.

• POST /hooks/wake → { text, mode?: "now"|"next-heartbeat" }
• POST /hooks/agent → { message, name?, agentId?, sessionKey?, wakeMode?, deliver?, channel?, to?, model?, thinking?, timeoutSeconds? }
  • sessionKey từ payload yêu cầu chỉ được chấp nhận khi hooks.allowRequestSessionKey=true (mặc định: false).
• POST /hooks/<name> → được phân giải qua hooks.mappings
  • Các giá trị sessionKey của ánh xạ được kết xuất từ mẫu được xem là do bên ngoài cung cấp và cũng yêu cầu hooks.allowRequestSessionKey=true.

​

Tích hợp Gmail

• Preset Gmail tích hợp sẵn dùng sessionKey: "hook:gmail:{{messages[0].id}}".
• Nếu bạn giữ định tuyến theo từng thư đó, hãy đặt hooks.allowRequestSessionKey: true và giới hạn hooks.allowedSessionKeyPrefixes để khớp namespace Gmail, ví dụ ["hook:", "hook:gmail:"].
• Nếu bạn cần hooks.allowRequestSessionKey: false, hãy ghi đè preset bằng một sessionKey tĩnh thay vì mặc định theo mẫu.

{
  hooks: {
    gmail: {
      account: "openclaw@gmail.com",
      topic: "projects/<project-id>/topics/gog-gmail-watch",
      subscription: "gog-gmail-watch-push",
      pushToken: "shared-push-token",
      hookUrl: "http://127.0.0.1:18789/hooks/gmail",
      includeBody: true,
      maxBytes: 20000,
      renewEveryMinutes: 720,
      serve: { bind: "127.0.0.1", port: 8788, path: "/" },
      tailscale: { mode: "funnel", path: "/gmail-pubsub" },
      model: "openrouter/meta-llama/llama-3.3-70b-instruct:free",
      thinking: "off",
    },
  },
}

• Gateway tự khởi động gog gmail watch serve khi khởi động nếu đã được cấu hình. Đặt OPENCLAW_SKIP_GMAIL_WATCHER=1 để tắt.
• Đừng chạy một gog gmail watch serve riêng song song với Gateway.

​

Máy chủ canvas

{
  canvasHost: {
    root: "~/.openclaw/workspace/canvas",
    liveReload: true,
    // enabled: false, // or OPENCLAW_SKIP_CANVAS_HOST=1
  },
}

• Phục vụ HTML/CSS/JS mà agent có thể chỉnh sửa và A2UI qua HTTP dưới cổng Gateway:
  • http://<gateway-host>:<gateway.port>/__openclaw__/canvas/
  • http://<gateway-host>:<gateway.port>/__openclaw__/a2ui/
• Chỉ cục bộ: giữ gateway.bind: "loopback" (mặc định).
• Bind không phải loopback: các tuyến canvas yêu cầu xác thực Gateway (token/mật khẩu/trusted-proxy), giống các bề mặt HTTP Gateway khác.
• Node WebViews thường không gửi header xác thực; sau khi một Node được ghép nối và kết nối, Gateway quảng bá các URL khả năng có phạm vi theo Node để truy cập canvas/A2UI.
• URL khả năng được ràng buộc với phiên WS Node đang hoạt động và hết hạn nhanh chóng. Không dùng dự phòng dựa trên IP.
• Chèn client tải lại trực tiếp vào HTML được phục vụ.
• Tự động tạo index.html khởi đầu khi trống.
• Cũng phục vụ A2UI tại /__openclaw__/a2ui/.
• Các thay đổi yêu cầu khởi động lại Gateway.
• Tắt tải lại trực tiếp cho thư mục lớn hoặc lỗi EMFILE.

​

Khám phá

​

mDNS (Bonjour)

{
  discovery: {
    mdns: {
      mode: "minimal", // minimal | full | off
    },
  },
}

• minimal (mặc định): bỏ qua cliPath + sshPort khỏi bản ghi TXT.
• full: bao gồm cliPath + sshPort.
• Tên máy chủ mặc định là tên máy chủ hệ thống khi đó là nhãn DNS hợp lệ, nếu không sẽ quay về openclaw. Ghi đè bằng OPENCLAW_MDNS_HOSTNAME.

​

Diện rộng (DNS-SD)

{
  discovery: {
    wideArea: { enabled: true },
  },
}

​

Môi trường

​

env (biến môi trường nội tuyến)

{
  env: {
    OPENROUTER_API_KEY: "sk-or-...",
    vars: {
      GROQ_API_KEY: "gsk-...",
    },
    shellEnv: {
      enabled: true,
      timeoutMs: 15000,
    },
  },
}

• Biến môi trường nội tuyến chỉ được áp dụng nếu môi trường của tiến trình thiếu khóa đó.
• Tệp .env: .env trong CWD + ~/.openclaw/.env (không tệp nào ghi đè các biến hiện có).
• shellEnv: nhập các khóa dự kiến còn thiếu từ hồ sơ shell đăng nhập của bạn.
• Xem Môi trường để biết đầy đủ thứ tự ưu tiên.

​

Thay thế biến môi trường

{
  gateway: {
    auth: { token: "${OPENCLAW_GATEWAY_TOKEN}" },
  },
}

• Chỉ khớp tên viết hoa: [A-Z_][A-Z0-9_]*.
• Biến thiếu/rỗng sẽ gây lỗi khi tải cấu hình.
• Thoát bằng $${VAR} để biểu diễn nguyên văn ${VAR}.
• Hoạt động với $include.

​

Bí mật

​

SecretRef

{ source: "env" | "file" | "exec", provider: "default", id: "..." }

• Mẫu provider: ^[a-z][a-z0-9_-]{0,63}$
• Mẫu id của source: "env": ^[A-Z][A-Z0-9_]{0,127}$
• id của source: "file": con trỏ JSON tuyệt đối (ví dụ "/providers/openai/apiKey")
• Mẫu id của source: "exec": ^[A-Za-z0-9][A-Za-z0-9._:/-]{0,255}$
• id của source: "exec" không được chứa các đoạn đường dẫn phân tách bằng dấu gạch chéo là . hoặc .. (ví dụ a/../b bị từ chối)

​

Bề mặt thông tin xác thực được hỗ trợ

• Ma trận chuẩn: Bề mặt thông tin xác thực SecretRef
• secrets apply nhắm đến các đường dẫn thông tin xác thực openclaw.json được hỗ trợ.
• Tham chiếu auth-profiles.json được bao gồm trong quá trình phân giải thời gian chạy và phạm vi kiểm tra.

​

Cấu hình nhà cung cấp bí mật

{
  secrets: {
    providers: {
      default: { source: "env" }, // optional explicit env provider
      filemain: {
        source: "file",
        path: "~/.openclaw/secrets.json",
        mode: "json",
        timeoutMs: 5000,
      },
      vault: {
        source: "exec",
        command: "/usr/local/bin/openclaw-vault-resolver",
        passEnv: ["PATH", "VAULT_ADDR"],
      },
    },
    defaults: {
      env: "default",
      file: "filemain",
      exec: "vault",
    },
  },
}

• Nhà cung cấp file hỗ trợ mode: "json" và mode: "singleValue" (id phải là "value" trong chế độ singleValue).
• Đường dẫn của nhà cung cấp tệp và exec sẽ thất bại đóng khi không thể xác minh ACL của Windows. Chỉ đặt allowInsecurePath: true cho các đường dẫn đáng tin cậy không thể xác minh.
• Nhà cung cấp exec yêu cầu đường dẫn command tuyệt đối và dùng tải trọng giao thức trên stdin/stdout.
• Theo mặc định, đường dẫn lệnh symlink bị từ chối. Đặt allowSymlinkCommand: true để cho phép đường dẫn symlink trong khi vẫn xác thực đường dẫn đích đã phân giải.
• Nếu trustedDirs được cấu hình, kiểm tra thư mục đáng tin cậy áp dụng cho đường dẫn đích đã phân giải.
• Môi trường tiến trình con exec theo mặc định là tối thiểu; truyền rõ ràng các biến bắt buộc bằng passEnv.
• Tham chiếu bí mật được phân giải tại thời điểm kích hoạt thành một ảnh chụp nhanh trong bộ nhớ, sau đó các đường dẫn yêu cầu chỉ đọc ảnh chụp nhanh đó.
• Lọc bề mặt hoạt động áp dụng trong quá trình kích hoạt: tham chiếu chưa phân giải trên các bề mặt đã bật sẽ khiến khởi động/tải lại thất bại, còn các bề mặt không hoạt động được bỏ qua kèm chẩn đoán.

​

Lưu trữ xác thực

{
  auth: {
    profiles: {
      "anthropic:default": { provider: "anthropic", mode: "api_key" },
      "anthropic:work": { provider: "anthropic", mode: "api_key" },
      "openai-codex:personal": { provider: "openai-codex", mode: "oauth" },
    },
    order: {
      anthropic: ["anthropic:default", "anthropic:work"],
      "openai-codex": ["openai-codex:personal"],
    },
  },
}

• Hồ sơ theo tác tử được lưu tại <agentDir>/auth-profiles.json.
• auth-profiles.json hỗ trợ tham chiếu ở cấp giá trị (keyRef cho api_key, tokenRef cho token) đối với các chế độ thông tin xác thực tĩnh.
• Các ánh xạ auth-profiles.json phẳng kiểu cũ như { "provider": { "apiKey": "..." } } không phải là định dạng thời gian chạy; openclaw doctor --fix viết lại chúng thành hồ sơ API-key provider:default chuẩn với bản sao lưu .legacy-flat.*.bak.
• Hồ sơ chế độ OAuth (auth.profiles.<id>.mode = "oauth") không hỗ trợ thông tin xác thực hồ sơ xác thực dựa trên SecretRef.
• Thông tin xác thực thời gian chạy tĩnh đến từ các ảnh chụp nhanh đã phân giải trong bộ nhớ; các mục auth.json tĩnh kiểu cũ sẽ bị xóa sạch khi được phát hiện.
• Nhập OAuth kiểu cũ từ ~/.openclaw/credentials/oauth.json.
• Xem OAuth.
• Hành vi thời gian chạy của bí mật và công cụ audit/configure/apply: Quản lý bí mật.

​

auth.cooldowns

{
  auth: {
    cooldowns: {
      billingBackoffHours: 5,
      billingBackoffHoursByProvider: { anthropic: 3, openai: 8 },
      billingMaxHours: 24,
      authPermanentBackoffMinutes: 10,
      authPermanentMaxMinutes: 60,
      failureWindowHours: 24,
      overloadedProfileRotations: 1,
      overloadedBackoffMs: 0,
      rateLimitedProfileRotations: 1,
    },
  },
}

• billingBackoffHours: thời gian chờ cơ sở tính bằng giờ khi một hồ sơ thất bại do lỗi thanh toán/không đủ tín dụng thật sự (mặc định: 5). Văn bản thanh toán rõ ràng vẫn có thể rơi vào đây ngay cả trên phản hồi 401/403, nhưng các bộ khớp văn bản theo nhà cung cấp vẫn chỉ giới hạn trong nhà cung cấp sở hữu chúng (ví dụ OpenRouter Key limit exceeded). Các thông báo HTTP 402 có thể thử lại về cửa sổ sử dụng hoặc giới hạn chi tiêu của tổ chức/không gian làm việc vẫn nằm trong đường dẫn rate_limit.
• billingBackoffHoursByProvider: ghi đè tùy chọn theo từng nhà cung cấp cho số giờ chờ do thanh toán.
• billingMaxHours: giới hạn tính bằng giờ cho tăng trưởng lũy thừa của thời gian chờ do thanh toán (mặc định: 24).
• authPermanentBackoffMinutes: thời gian chờ cơ sở tính bằng phút cho các lỗi auth_permanent có độ tin cậy cao (mặc định: 10).
• authPermanentMaxMinutes: giới hạn tính bằng phút cho tăng trưởng thời gian chờ auth_permanent (mặc định: 60).
• failureWindowHours: cửa sổ trượt tính bằng giờ dùng cho bộ đếm thời gian chờ (mặc định: 24).
• overloadedProfileRotations: số lần xoay vòng hồ sơ xác thực tối đa trong cùng nhà cung cấp đối với lỗi quá tải trước khi chuyển sang dự phòng mô hình (mặc định: 1). Các dạng nhà cung cấp bận như ModelNotReadyException rơi vào đây.
• overloadedBackoffMs: độ trễ cố định trước khi thử lại một lần xoay vòng nhà cung cấp/hồ sơ bị quá tải (mặc định: 0).
• rateLimitedProfileRotations: số lần xoay vòng hồ sơ xác thực tối đa trong cùng nhà cung cấp đối với lỗi giới hạn tốc độ trước khi chuyển sang dự phòng mô hình (mặc định: 1). Nhóm giới hạn tốc độ đó bao gồm văn bản theo dạng nhà cung cấp như Too many concurrent requests, ThrottlingException, concurrency limit reached, workers_ai ... quota limit exceeded và resource exhausted.

​

Ghi nhật ký

{
  logging: {
    level: "info",
    file: "/tmp/openclaw/openclaw.log",
    consoleLevel: "info",
    consoleStyle: "pretty", // pretty | compact | json
    redactSensitive: "tools", // off | tools
    redactPatterns: ["\\bTOKEN\\b\\s*[=:]\\s*([\"']?)([^\\s\"']+)\\1"],
  },
}

• Tệp nhật ký mặc định: /tmp/openclaw/openclaw-YYYY-MM-DD.log.
• Đặt logging.file để có đường dẫn ổn định.
• consoleLevel tăng lên debug khi dùng --verbose.
• maxFileBytes: kích thước tối đa của tệp nhật ký đang hoạt động tính bằng byte trước khi xoay vòng (số nguyên dương; mặc định: 104857600 = 100 MB). OpenClaw giữ tối đa năm bản lưu trữ được đánh số bên cạnh tệp đang hoạt động.
• redactSensitive / redactPatterns: che giấu theo nỗ lực tốt nhất cho đầu ra console, nhật ký tệp, bản ghi nhật ký OTLP và văn bản bản ghi phiên được lưu giữ. redactSensitive: "off" chỉ tắt chính sách nhật ký/bản ghi chung này; các bề mặt an toàn UI/công cụ/chẩn đoán vẫn che giấu bí mật trước khi phát ra.

​

Chẩn đoán

{
  diagnostics: {
    enabled: true,
    flags: ["telegram.*"],
    stuckSessionWarnMs: 30000,

    otel: {
      enabled: false,
      endpoint: "https://otel-collector.example.com:4318",
      tracesEndpoint: "https://traces.example.com/v1/traces",
      metricsEndpoint: "https://metrics.example.com/v1/metrics",
      logsEndpoint: "https://logs.example.com/v1/logs",
      protocol: "http/protobuf", // http/protobuf | grpc
      headers: { "x-tenant-id": "my-org" },
      serviceName: "openclaw-gateway",
      traces: true,
      metrics: true,
      logs: false,
      sampleRate: 1.0,
      flushIntervalMs: 5000,
      captureContent: {
        enabled: false,
        inputMessages: false,
        outputMessages: false,
        toolInputs: false,
        toolOutputs: false,
        systemPrompt: false,
      },
    },

    cacheTrace: {
      enabled: false,
      filePath: "~/.openclaw/logs/cache-trace.jsonl",
      includeMessages: true,
      includePrompt: true,
      includeSystem: true,
    },
  },
}

• enabled: công tắc chính cho đầu ra đo lường (mặc định: true).
• flags: mảng chuỗi cờ bật đầu ra nhật ký có mục tiêu (hỗ trợ ký tự đại diện như "telegram.*" hoặc "*").
• stuckSessionWarnMs: ngưỡng tuổi tính bằng ms để phát cảnh báo phiên bị kẹt trong khi phiên vẫn ở trạng thái xử lý.
• otel.enabled: bật pipeline xuất OpenTelemetry (mặc định: false). Để xem cấu hình đầy đủ, danh mục tín hiệu và mô hình quyền riêng tư, xem xuất OpenTelemetry.
• otel.endpoint: URL collector cho xuất OTel.
• otel.tracesEndpoint / otel.metricsEndpoint / otel.logsEndpoint: các endpoint OTLP tùy chọn riêng theo tín hiệu. Khi được đặt, chúng ghi đè otel.endpoint chỉ cho tín hiệu đó.
• otel.protocol: "http/protobuf" (mặc định) hoặc "grpc".
• otel.headers: các header siêu dữ liệu HTTP/gRPC bổ sung được gửi cùng yêu cầu xuất OTel.
• otel.serviceName: tên dịch vụ cho thuộc tính tài nguyên.
• otel.traces / otel.metrics / otel.logs: bật xuất trace, metrics hoặc nhật ký.
• otel.sampleRate: tỷ lệ lấy mẫu trace 0–1.
• otel.flushIntervalMs: khoảng thời gian flush telemetry định kỳ tính bằng ms.
• otel.captureContent: chọn tham gia thu thập nội dung thô cho thuộc tính span OTEL. Mặc định tắt. Boolean true thu thập nội dung thông điệp/công cụ không thuộc hệ thống; dạng đối tượng cho phép bạn bật rõ ràng inputMessages, outputMessages, toolInputs, toolOutputs và systemPrompt.
• OTEL_SEMCONV_STABILITY_OPT_IN=gen_ai_latest_experimental: công tắc môi trường cho các thuộc tính nhà cung cấp span GenAI thử nghiệm mới nhất. Theo mặc định, span giữ thuộc tính gen_ai.system cũ để tương thích; metrics GenAI dùng các thuộc tính ngữ nghĩa có giới hạn.
• OPENCLAW_OTEL_PRELOADED=1: công tắc môi trường cho host đã đăng ký SDK OpenTelemetry toàn cục. Khi đó OpenClaw bỏ qua khởi động/tắt SDK do Plugin sở hữu trong khi vẫn giữ các listener chẩn đoán hoạt động.
• OTEL_EXPORTER_OTLP_TRACES_ENDPOINT, OTEL_EXPORTER_OTLP_METRICS_ENDPOINT và OTEL_EXPORTER_OTLP_LOGS_ENDPOINT: biến môi trường endpoint riêng theo tín hiệu được dùng khi khóa cấu hình tương ứng chưa được đặt.
• cacheTrace.enabled: ghi nhật ký snapshot cache trace cho các lần chạy nhúng (mặc định: false).
• cacheTrace.filePath: đường dẫn đầu ra cho cache trace JSONL (mặc định: $OPENCLAW_STATE_DIR/logs/cache-trace.jsonl).
• cacheTrace.includeMessages / includePrompt / includeSystem: kiểm soát nội dung được đưa vào đầu ra cache trace (tất cả mặc định: true).

​

Cập nhật

{
  update: {
    channel: "stable", // stable | beta | dev
    checkOnStart: true,

    auto: {
      enabled: false,
      stableDelayHours: 6,
      stableJitterHours: 12,
      betaCheckIntervalHours: 1,
    },
  },
}

• channel: kênh phát hành cho cài đặt npm/git — "stable", "beta" hoặc "dev".
• checkOnStart: kiểm tra bản cập nhật npm khi gateway khởi động (mặc định: true).
• auto.enabled: bật tự động cập nhật nền cho cài đặt gói (mặc định: false).
• auto.stableDelayHours: độ trễ tối thiểu tính bằng giờ trước khi tự động áp dụng kênh stable (mặc định: 6; tối đa: 168).
• auto.stableJitterHours: cửa sổ phân bổ rollout bổ sung cho kênh stable tính bằng giờ (mặc định: 12; tối đa: 168).
• auto.betaCheckIntervalHours: tần suất chạy kiểm tra kênh beta tính bằng giờ (mặc định: 1; tối đa: 24).

​

ACP

{
  acp: {
    enabled: true,
    dispatch: { enabled: true },
    backend: "acpx",
    defaultAgent: "main",
    allowedAgents: ["main", "ops"],
    maxConcurrentSessions: 10,

    stream: {
      coalesceIdleMs: 50,
      maxChunkChars: 1000,
      repeatSuppression: true,
      deliveryMode: "live", // live | final_only
      hiddenBoundarySeparator: "paragraph", // none | space | newline | paragraph
      maxOutputChars: 50000,
      maxSessionUpdateChars: 500,
    },

    runtime: {
      ttlMinutes: 30,
    },
  },
}

• enabled: cổng tính năng ACP toàn cục (mặc định: true; đặt false để ẩn dispatch ACP và các tùy chọn spawn).
• dispatch.enabled: cổng độc lập cho dispatch lượt phiên ACP (mặc định: true). Đặt false để giữ các lệnh ACP khả dụng trong khi chặn thực thi.
• backend: id backend runtime ACP mặc định (phải khớp với một Plugin runtime ACP đã đăng ký). Nếu plugins.allow được đặt, hãy bao gồm id Plugin backend (ví dụ acpx) nếu không Plugin mặc định đi kèm sẽ không tải.
• defaultAgent: id agent mục tiêu ACP dự phòng khi spawn không chỉ định mục tiêu rõ ràng.
• allowedAgents: danh sách cho phép các id agent được phép dùng cho phiên runtime ACP; rỗng nghĩa là không có hạn chế bổ sung.
• maxConcurrentSessions: số phiên ACP hoạt động đồng thời tối đa.
• stream.coalesceIdleMs: cửa sổ flush khi rảnh tính bằng ms cho văn bản được stream.
• stream.maxChunkChars: kích thước chunk tối đa trước khi tách phép chiếu khối được stream.
• stream.repeatSuppression: chặn các dòng trạng thái/công cụ lặp lại trong mỗi lượt (mặc định: true).
• stream.deliveryMode: "live" stream tăng dần; "final_only" đệm cho đến khi có sự kiện kết thúc lượt.
• stream.hiddenBoundarySeparator: dấu phân cách trước văn bản hiển thị sau các sự kiện công cụ ẩn (mặc định: "paragraph").
• stream.maxOutputChars: số ký tự đầu ra assistant tối đa được chiếu mỗi lượt ACP.
• stream.maxSessionUpdateChars: số ký tự tối đa cho các dòng trạng thái/cập nhật ACP được chiếu.
• stream.tagVisibility: bản ghi tên thẻ tới các ghi đè hiển thị boolean cho sự kiện được stream.
• runtime.ttlMinutes: TTL khi rảnh tính bằng phút cho worker phiên ACP trước khi đủ điều kiện dọn dẹp.
• runtime.installCommand: lệnh cài đặt tùy chọn để chạy khi bootstrap môi trường runtime ACP.

​

CLI

{
  cli: {
    banner: {
      taglineMode: "off", // random | default | off
    },
  },
}

• cli.banner.taglineMode kiểm soát kiểu tagline banner:
  • "random" (mặc định): các tagline hài hước/theo mùa luân phiên.
  • "default": tagline trung tính cố định (All your chats, one OpenClaw.).
  • "off": không có văn bản tagline (vẫn hiển thị tiêu đề/phiên bản banner).
• Để ẩn toàn bộ banner (không chỉ tagline), đặt env OPENCLAW_HIDE_BANNER=1.

​

Trình hướng dẫn

{
  wizard: {
    lastRunAt: "2026-01-01T00:00:00.000Z",
    lastRunVersion: "2026.1.4",
    lastRunCommit: "abc1234",
    lastRunCommand: "configure",
    lastRunMode: "local",
  },
}

​

Danh tính

​

Bridge (cũ, đã loại bỏ)

{
  "bridge": {
    "enabled": true,
    "port": 18790,
    "bind": "tailnet",
    "tls": {
      "enabled": true,
      "autoGenerate": true
    }
  }
}

​

Cron

{
  cron: {
    enabled: true,
    maxConcurrentRuns: 2, // cron dispatch + isolated cron agent-turn execution
    webhook: "https://example.invalid/legacy", // deprecated fallback for stored notify:true jobs
    webhookToken: "replace-with-dedicated-token", // optional bearer token for outbound webhook auth
    sessionRetention: "24h", // duration string or false
    runLog: {
      maxBytes: "2mb", // default 2_000_000 bytes
      keepLines: 2000, // default 2000
    },
  },
}

• sessionRetention: thời gian giữ các phiên chạy cron cô lập đã hoàn tất trước khi cắt tỉa khỏi sessions.json. Cũng kiểm soát việc dọn dẹp các bản ghi cron đã xóa được lưu trữ. Mặc định: 24h; đặt false để tắt.
• runLog.maxBytes: kích thước tối đa cho mỗi tệp nhật ký chạy (cron/runs/<jobId>.jsonl) trước khi cắt tỉa. Mặc định: 2_000_000 byte.
• runLog.keepLines: các dòng mới nhất được giữ lại khi kích hoạt cắt tỉa nhật ký chạy. Mặc định: 2000.
• webhookToken: token bearer được dùng cho gửi POST Cron Webhook (delivery.mode = "webhook"), nếu bỏ qua thì không gửi header xác thực.
• webhook: URL Webhook dự phòng cũ đã ngừng dùng (http/https), chỉ dùng cho các job đã lưu vẫn có notify: true.

​

cron.retry

{
  cron: {
    retry: {
      maxAttempts: 3,
      backoffMs: [30000, 60000, 300000],
      retryOn: ["rate_limit", "overloaded", "network", "timeout", "server_error"],
    },
  },
}

• maxAttempts: số lần thử lại tối đa cho job chạy một lần khi gặp lỗi tạm thời (mặc định: 3; phạm vi: 0–10).
• backoffMs: mảng độ trễ backoff tính bằng ms cho mỗi lần thử lại (mặc định: [30000, 60000, 300000]; 1–10 mục).
• retryOn: các loại lỗi kích hoạt thử lại — "rate_limit", "overloaded", "network", "timeout", "server_error". Bỏ qua để thử lại tất cả các loại tạm thời.

​

cron.failureAlert

{
  cron: {
    failureAlert: {
      enabled: false,
      after: 3,
      cooldownMs: 3600000,
      includeSkipped: false,
      mode: "announce",
      accountId: "main",
    },
  },
}

• enabled: bật cảnh báo lỗi cho job Cron (mặc định: false).
• after: số lỗi liên tiếp trước khi cảnh báo được phát (số nguyên dương, tối thiểu: 1).
• cooldownMs: số mili giây tối thiểu giữa các cảnh báo lặp lại cho cùng một job (số nguyên không âm).
• includeSkipped: tính các lần chạy bị bỏ qua liên tiếp vào ngưỡng cảnh báo (mặc định: false). Các lần chạy bị bỏ qua được theo dõi riêng và không ảnh hưởng đến backoff lỗi thực thi.
• mode: chế độ gửi — "announce" gửi qua tin nhắn kênh; "webhook" POST tới Webhook đã cấu hình.
• accountId: id tài khoản hoặc kênh tùy chọn để giới hạn phạm vi gửi cảnh báo.

​

cron.failureDestination

{
  cron: {
    failureDestination: {
      mode: "announce",
      channel: "last",
      to: "channel:C1234567890",
      accountId: "main",
    },
  },
}

• Đích mặc định cho thông báo lỗi Cron trên tất cả các tác vụ.
• mode: "announce" hoặc "webhook"; mặc định là "announce" khi có đủ dữ liệu đích.
• channel: ghi đè kênh cho việc gửi announce. "last" dùng lại kênh gửi đã biết gần nhất.
• to: đích announce rõ ràng hoặc URL Webhook. Bắt buộc đối với chế độ Webhook.
• accountId: ghi đè tài khoản tùy chọn cho việc gửi.
• delivery.failureDestination theo từng tác vụ ghi đè mặc định toàn cục này.
• Khi không đặt đích lỗi toàn cục hoặc theo từng tác vụ, các tác vụ đã gửi qua announce sẽ quay về đích announce chính đó khi xảy ra lỗi.
• delivery.failureDestination chỉ được hỗ trợ cho các tác vụ sessionTarget="isolated" trừ khi delivery.mode chính của tác vụ là "webhook".

​

Biến mẫu của mô hình phương tiện

​

Bao gồm cấu hình ($include)

// ~/.openclaw/openclaw.json
{
  gateway: { port: 18789 },
  agents: { $include: "./agents.json5" },
  broadcast: {
    $include: ["./clients/mueller.json5", "./clients/schmidt.json5"],
  },
}

• Một tệp: thay thế đối tượng chứa nó.
• Mảng tệp: hợp nhất sâu theo thứ tự (phần sau ghi đè phần trước).
• Khóa cùng cấp: được hợp nhất sau các include (ghi đè các giá trị được include).
• Include lồng nhau: sâu tối đa 10 cấp.
• Đường dẫn: được phân giải tương đối với tệp đang include, nhưng phải nằm trong thư mục cấu hình cấp cao nhất (dirname của openclaw.json). Dạng tuyệt đối/../ chỉ được phép khi chúng vẫn phân giải bên trong ranh giới đó.
• Các lần ghi do OpenClaw sở hữu chỉ thay đổi một mục cấp cao nhất được hỗ trợ bởi include một tệp sẽ ghi xuyên qua tệp được include đó. Ví dụ: plugins install cập nhật plugins: { $include: "./plugins.json5" } trong plugins.json5 và giữ nguyên openclaw.json.
• Include ở gốc, mảng include và include có ghi đè cùng cấp là chỉ đọc đối với các lần ghi do OpenClaw sở hữu; các lần ghi đó sẽ thất bại đóng thay vì làm phẳng cấu hình.
• Lỗi: thông báo rõ ràng cho tệp bị thiếu, lỗi phân tích cú pháp và include vòng.

​

Liên quan

• Cấu hình
• Ví dụ cấu hình