跳到主要内容

1.2 核心概念

理解 OpenClaw 的核心组件：Gateway、Node、Agent

在开始使用之前，我们需要先理解 OpenClaw 的核心架构。这有助于你更好地配置和调试系统。

1.2.1 整体架构图​

OpenClaw 采用网关-节点架构，由三个核心组件组成：

┌─────────────────────────────────────────────────────────────────┐
│                         OpenClaw 系统                           │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│   ┌─────────────┐                    ┌─────────────┐          │
│   │   Gateway   │◄──────────────────►│    Node     │          │
│   │    网关      │    WebSocket      │    节点      │          │
│   │  (主服务)   │                    │  (客户端)   │          │
│   └─────────────┘                    └─────────────┘          │
│         │                                   │                  │
│         ▼                                   ▼                  │
│   ┌─────────────┐                    ┌─────────────┐          │
│   │   Channel   │                    │    Tools    │          │
│   │  消息渠道   │                    │    工具     │          │
│   │ 飞书/TG    │                    │ 文件/命令   │          │
│   └─────────────┘                    └─────────────┘          │
│                                                                 │
│   ┌─────────────┐                    ┌─────────────┐          │
│   │    Agent    │                    │   Memory    │          │
│   │    代理     │                    │    记忆     │          │
│   │  AI 大脑    │                    │  记忆系统   │          │
│   └─────────────┘                    └─────────────┘          │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

1.2.2 Gateway（网关）​

Gateway 是 OpenClaw 的核心服务，相当于整个系统的大脑。

主要职责​

功能说明
📨 消息路由接收来自各个渠道的消息，转发给对应的 Agent
🤖 AI 对话管理与 AI 模型的对话，维护上下文
🔐 认证授权验证用户身份，控制访问权限
💾 数据存储保存配置、会话历史、记忆等
🔌 插件管理加载和管理各种插件

运行方式​

# 启动 Gateway
openclaw gateway start

# 查看 Gateway 状态
openclaw gateway status

# 重启 Gateway
openclaw gateway restart

配置文件​

Gateway 的主要配置在 config.json 中：

{
  "gateway": {
    "host": "0.0.0.0",
    "port": 8080,
    "auth": {
      "mode": "token",
      "token": "xxx"
    }
  }
}

1.2.3 Node（节点）​

Node 是连接到 Gateway 的客户端设备，负责执行实际的任务。

什么是 Node？​

你可以把 Node 理解为干活的人：

  • Gateway 负责思考（处理消息、做决策）
  • Node 负责执行（读写文件、执行命令、调用 API）

Node 的类型​

类型说明示例
🖥️ 本地 Node运行在本机电脑上的 Node你的 MacBook
☁️ 云端 Node运行在服务器上的 NodeVPS、云服务器
📱 移动 Node通过手机 App 连接的 NodeiOS/Android

场景选择​

场景推荐 Node
个人日常使用本地 Node（Mac/PC）
24小时运行云端 Node（VPS）
随时随地使用移动 Node（手机）

连接 Node​

# 在 Node 设备上启动
openclaw node start

# 或指定 Gateway 地址
openclaw node start --gateway http://your-gateway:8080

# 查看已连接的 Node
openclaw node list

1.2.4 Agent（代理）​

Agent 是 AI 助手的"人格"，负责理解用户意图并规划任务。

Agent 的工作流程​

用户消息 → 理解意图 → 规划步骤 → 调用工具 → 执行任务 → 返回结果

Agent 的组成​

组件说明
🧠 模型AI 大脑（GPT-4、Claude 等）
🛠️ 工具Agent 能使用的工具（文件、搜索等）
📝 提示词System Prompt，定义 Agent 的行为
💾 记忆短期记忆（会话）+ 长期记忆（MEMORY.md）

多 Agent 配置​

OpenClaw 支持配置多个 Agent：

{
  "agents": {
    "default": {
      "name": "助手",
      "model": "gpt-4"
    },
    "coder": {
      "name": "程序员",
      "model": "gpt-4",
      "tools": ["read", "write", "exec", "search"]
    },
    "writer": {
      "name": "作家",
      "model": "claude-3",
      "tools": ["read", "write"]
    }
  }
}

1.2.5 Channel（消息渠道）​

Channel 是用户与 OpenClaw 交互的通道。

支持的渠道​

渠道说明推荐场景
🦁 飞书国内企业协作企业使用
✈️ Telegram国际即时通讯个人/开发者
🎮 Discord游戏社区社区运营
📱 WhatsApp国际社交国际化产品
💬 Slack企业协作国外企业

消息流程​

用户 → Channel → Gateway → Agent → 处理 → Gateway → Channel → 用户

1.2.6 Tools（工具）​

Tools 是 Agent 可以调用的能力，让 AI 能够执行实际操作。

内置工具​

工具功能
📖 read读取文件内容
📝 write写入/创建文件
🔍 search搜索文件
💻 exec执行 Shell 命令
🌐 web_fetch获取网页内容
🔎 web_search搜索互联网

工具权限（Profile）​

OpenClaw 通过 Profile 控制工具权限：

Profile说明包含工具
messaging纯聊天仅消息收发
default默认文件读写、搜索
coding编程+ 代码执行
full完整+ Shell 命令（推荐）
all全部所有工具
{
  "agent": {
    "tools": {
      "profile": "full"
    }
  }
}

1.2.7 Memory（记忆系统）​

OpenClaw 有两层记忆系统：

短期记忆（会话历史）​

  • 只在当前会话中有效
  • 记录对话上下文
  • 会话结束后清除

长期记忆（MEMORY.md）​

  • 永久保存
  • 存储重要信息、偏好、习惯
  • 通过 memory/ 目录管理
// 目录结构示例
{
  "workspace": {
    "MEMORY.md": "长期记忆（重要信息）",
    "memory": {
      "2026-03-20.md": "今日记忆",
      "2026-03-19.md": "昨日记忆"
    }
  }
}

1.2.8 总结​

本章我们详细介绍了 OpenClaw 的核心概念：

组件作用
Gateway网关，主服务，负责消息路由和 AI 对话
Node节点，客户端，负责执行实际任务
Agent代理，AI 人格，负责理解和规划任务
Channel渠道，用户交互的入口
Tools工具，Agent 的能力扩展
Memory记忆，存储对话和知识

理解这些概念后，你就可以开始安装和配置 OpenClaw 了！