Agents Schema（智能体配置）

Agents Defaults（默认配置）

{
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace",
      model: {
        primary: "anthropic/claude-opus-4-6",
        fallbacks: ["minimax/MiniMax-M2.1"],
      },
      thinkingDefault: "low",
      heartbeat: {
        every: "30m",
        model: "openai/gpt-5.2-mini",
      },
      sandbox: {
        mode: "non-main",
        scope: "agent",
      },
    }
  }
}

核心字段

Thinking 级别详解

Sandbox 模式详解

Sandbox 范围详解

Agents List（智能体列表）

{
  agents: {
    list: [
      {
        id: "main",
        default: true,
        name: "Main Agent",
        workspace: "~/.openclaw/workspace",
        model: "anthropic/claude-opus-4-6",
        identity: {
          name: "Samantha",
          emoji: "🦥",
          avatar: "avatars/samantha.png",
        },
        groupChat: { mentionPatterns: ["@openclaw"] },
        sandbox: { mode: "off" },
      }
    ]
  }
}

字段详解

Heartbeat（心跳配置）

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m",
        model: "openai/gpt-5.2-mini",
        includeReasoning: false,
        session: "main",
        to: "+15555550123",
        directPolicy: "allow",
        target: "none",
        prompt: "Read HEARTBEAT.md if exists...",
      }
    }
  }
}

字段详解

Target 有效值

Compaction（压缩配置）

{
  agents: {
    defaults: {
      compaction: {
        mode: "safeguard",
        reserveTokensFloor: 24000,
        memoryFlush: {
          enabled: true,
          softThresholdTokens: 6000,
        },
      }
    }
  }
}

字段详解

Context Pruning（上下文修剪）

{
  agents: {
    defaults: {
      contextPruning: {
        mode: "cache-ttl",
        ttl: "1h",
        keepLastAssistants: 3,
        softTrimRatio: 0.3,
        hardClearRatio: 0.5,
      }
    }
  }
}

字段详解

Block Streaming（块流式输出）

{
  agents: {
    defaults: {
      blockStreamingDefault: "off",
      blockStreamingBreak: "text_end",
      blockStreamingChunk: { minChars: 800, maxChars: 1200 },
      humanDelay: { mode: "natural" },
    }
  }
}

字段详解

Human Delay 模式

Typing Indicators（输入指示器）

{
  agents: {
    defaults: {
      typingMode: "instant",
      typingIntervalSeconds: 6,
    }
  }
}

字段详解

Typing Mode 详解

Multi-Agent Routing（多智能体路由）

{
  agents: {
    list: [
      { id: "home", default: true },
      { id: "work" },
    ],
  },
  bindings: [
    { agentId: "home", match: { channel: "whatsapp", accountId: "personal" } },
    { agentId: "work", match: { channel: "whatsapp", accountId: "biz" } },
  ],
}

Binding Match 字段

常见错误

官方文档

• https://docs.openclaw.ai/gateway/configuration-reference#agent-defaults
• https://docs.openclaw.ai/zh-CN/gateway/configuration