🏛️ OpenClaw Gateway管理指南

🏛️ 什么是Gateway？

Gateway是OpenClaw的核心服务，负责：

• Agent生命周期管理 - 创建、销毁、管理Agent会话
• 定时任务调度 - cron任务的存储、执行和监控
• 配置管理 - 读取和应用系统配置
• 消息路由 - 处理来自各渠道的消息
• 工具协调 - 管理工具注册和权限

🛠️ Gateway管理工具详解

1. 重启Gateway

gateway({
  action: "restart",
  note: "配置更新后重启 - 2026-04-15"
})

重启会平滑过渡，不会丢失正在执行的任务。

2. 获取当前配置

// 获取完整配置
gateway({
  action: "config.get"
})

// 获取特定路径的配置
gateway({
  action: "config.get",
  path: "agents.default"
})

3. 部分更新配置

gateway({
  action: "config.patch",
  path: "agents.default",
  raw: JSON.stringify({
    model: "claude-3-5-sonnet",
    timeoutSeconds: 300
  })
})

4. 查看配置Schema

// 查看agents配置项的schema
gateway({
  action: "config.schema.lookup",
  path: "agents"
})

5. 运行更新

gateway({
  action: "update.run",
  reason: "升级到新版本获取新功能"
})

⚙️ 配置管理最佳实践

配置备份

// 1. 先获取当前配置
gateway({ action: "config.get" }).then(config => {
  // 2. 保存到文件
  writeFile("config-backup-2026-04-15.json", config);
  // 3. 再进行修改
});

配置分层

OpenClaw配置采用分层结构：

{
  "gateway": {        // Gateway核心配置
    "port": 8080,
    "logLevel": "info"
  },
  "agents": {         // Agent默认配置
    "default": {
      "model": "gpt-4",
      "timeoutSeconds": 120
    }
  },
  "channels": {       // 消息渠道配置
    "slack": {...},
    "discord": {...}
  },
  "cron": {           // 定时任务配置
    "enabled": true
  }
}

环境特定配置

// 开发环境 - 详细日志
gateway({
  action: "config.patch",
  path: "gateway",
  raw: JSON.stringify({ logLevel: "debug" })
})

// 生产环境 - 精简日志
gateway({
  action: "config.patch", 
  path: "gateway",
  raw: JSON.stringify({ logLevel: "warn" })
})

📊 监控和诊断

查看Gateway状态

// 完整的Gateway诊断
async function gatewayHealthCheck() {
  // 1. 获取配置
  const config = await gateway({ action: "config.get" });
  
  // 2. 列出定时任务
  const jobs = await cron({ action: "list" });
  
  // 3. 检查会话
  const sessions = await sessions_list();
  
  return {
    config: config,
    activeJobs: jobs.length,
    activeSessions: sessions.length,
    timestamp: new Date().toISOString()
  };
}

📚 相关链接