---
title: "Gateway 运行时"
description: "OpenClaw Gateway 运行时学习地图：理解 Gateway、配置、Agent、Channel、安全远程访问和自动化边界。"
verifiedAt: "2026-05-05"
---

这一组进入 OpenClaw 的运行时核心：Gateway 为什么是长期进程，配置为什么必须严格校验，Agent 和 Channel 如何分层，远程访问怎样不暴露控制面，以及 cron、tasks、hooks、heartbeat 应该各自负责什么。

> [!NOTE]
> **适合从这里继续的人**：你已经能安装 OpenClaw、完成 onboarding、打开 Dashboard、发第一条消息。现在要理解它为什么能常驻、怎么接消息渠道、怎么控安全、怎么开始自动化。

## 1. 这一组包含什么

Gateway 运行时一共 6 章：

- Gateway 架构：理解长驻进程、WebSocket 控制面、nodes、pairing 和本机默认入口。
- Gateway 配置：理解 strict schema、reload mode、health、doctor、Config RPC 和重启边界。
- Agent 配置：理解 workspace、repoRoot、skills、bootstrap、模型目录、session 和多 Agent 路由。
- Channel 配置：理解 DM policy、group policy、mention gating、多账号和模型覆盖。
- 安全与远程访问：理解个人助手信任模型、security audit、Control UI、Tailscale 和 SSH tunnel。
- 自动化：理解 cron、tasks、task flow、standing orders、hooks 和 heartbeat 的选择边界。

```mermaid
flowchart TD
    Architecture["Gateway 架构"]
    Config["Gateway 配置"]
    Agent["Agent 配置"]
    Channel["Channel 配置"]
    Security["安全与远程访问"]
    Automation["自动化"]
    Next["渠道专项 / CLI reference"]

    Architecture --> Config
    Config --> Agent
    Agent --> Channel
    Channel --> Security
    Security --> Automation
    Automation --> Next

    style Architecture fill:#e0f2fe,stroke:#0284c7,stroke-width:2px
    style Agent fill:#dcfce7,stroke:#22c55e,stroke-width:2px
    style Security fill:#fee2e2,stroke:#ef4444,stroke-width:2px
    style Automation fill:#fef3c7,stroke:#f59e0b,stroke-width:2px
```

## 2. 章节入口

<Cards>
  <Card title="Gateway 架构" description="长驻 Gateway、WebSocket 控制面、nodes、pairing、远程访问和运行不变量。" href="/docs/openclaw/official/01-gateway-runtime/architecture" />
  <Card title="Gateway 配置" description="配置文件、schema、热加载、RPC 更新、health、doctor 和排障顺序。" href="/docs/openclaw/official/01-gateway-runtime/gateway-configuration" />
  <Card title="Agent 配置" description="workspace、repoRoot、skills、bootstrap、模型目录、session 和多 Agent 路由。" href="/docs/openclaw/official/01-gateway-runtime/agents" />
  <Card title="Channel 配置" description="Telegram、Discord、Slack、WhatsApp 等渠道的 DM、群组、mention 和模型覆盖。" href="/docs/openclaw/official/01-gateway-runtime/channels" />
  <Card title="安全与远程访问" description="个人助手信任模型、allowlist、pairing、security audit、Tailscale 和 SSH tunnel。" href="/docs/openclaw/official/01-gateway-runtime/security-remote" />
  <Card title="自动化" description="cron、tasks、task flow、standing orders、hooks 和 heartbeat 的选择边界。" href="/docs/openclaw/official/01-gateway-runtime/automation" />
</Cards>

## 3. 推荐阅读顺序

1. 先看 Gateway 架构，确认 OpenClaw 不是一次性 CLI，而是一个长期运行的控制面。
2. 再看 Gateway 配置，理解 `openclaw.json`、严格 schema、热加载和重启边界。
3. 接着看 Agent 配置，把 workspace、skills、模型、session 和多 Agent 路由分清。
4. 然后配置 Channel，先用 pairing 或 allowlist 小范围接入，再扩到群组和多账号。
5. 远程访问放在安全之后做，不要先把端口公开到公网。
6. 最后加自动化，把周期任务、事件 hooks 和长期授权分开。

如果你按问题跳读：

- Gateway 为什么必须常驻：看 Gateway 架构。
- 改配置后为什么没有生效：看 Gateway 配置。
- 同一个入口为什么会路由到不同 Agent：看 Agent 配置和 Channel 配置。
- 陌生人能不能给 Agent 发消息：看 Channel 配置和安全远程访问。
- 定时任务、事件触发、心跳老是混：看自动化。

> [!TIP]
> **跳读时先判断问题入口**：Gateway 不稳定先看架构和配置；回复错 Agent 先看 bindings；陌生输入能触发工具先看 Channel 和安全；定时任务混乱才看自动化。

## 4. 先不要做什么

运行时阶段最危险的不是“不会配置”，而是过早开放边界：

- 不要先把 Gateway 端口公开到公网。
- 不要把 `dmPolicy` 设成 `open` 后忘记访问控制。
- 不要让群聊默认所有消息都触发 Agent。
- 不要把个人 workspace 给 shared Agent 复用。
- 不要把 standing orders 当成一次性任务清单。
- 不要用 hooks 接未知来源请求后直接开放工具权限。

> [!WARNING]
> **安全顺序不要反过来**：先明确谁能进来、能触发哪个 Agent、能用哪些 tools，再考虑远程访问和自动化。

## 5. 完成后的验收标准

读完这一组，你应该能做到：

- 能解释 Gateway、Agent、Channel、Workspace 的分工。
- 能判断一个配置改动是热加载、自动重启，还是需要手动重启。
- 能为个人 DM、群聊、共享入口选择合适的访问策略。
- 能说明为什么 OpenClaw 是个人助手信任模型，不是多租户安全边界。
- 能安全选择 Control UI、Tailscale、SSH tunnel 或本机访问。
- 能分清 cron、tasks、task flow、standing orders、hooks、heartbeat。

> [!IMPORTANT]
> **这一组的结束状态**：你能解释每个入口如何进入 Gateway、如何选中 Agent、如何隔离 session，以及为什么远程访问不能绕过 auth 和 pairing。

## 6. 官方资料

- [Gateway architecture](https://docs.openclaw.ai/concepts/architecture)
- [Configuration](https://docs.openclaw.ai/gateway/configuration)
- [Configuration - agents](https://docs.openclaw.ai/gateway/config-agents)
- [Configuration - channels](https://docs.openclaw.ai/gateway/config-channels)
- [Security](https://docs.openclaw.ai/security)
- [Remote access](https://docs.openclaw.ai/gateway/remote)
- [Automation & Tasks](https://docs.openclaw.ai/automation)
