概念

OpenClaw 是一個 AI Agent 框架，讓你可以在本地跑一個 AI 助理，連接多個通訊平台（WhatsApp、Telegram、Discord 等）。

核心架構由三層組成：

Plugins（外部世界） - 接收訊息（WhatsApp/Telegram/Discord）
Gateway（中央路由） - 決定誰來處理這則訊息
Agents（AI 大腦） - 用 LLM 處理訊息 + 執行工具

訊息流程

用戶發訊息
    ↓
Plugin (Telegram/WhatsApp)
    ↓
Gateway (路由到正確的 agent)
    ↓
Agent (LLM 處理 + 工具執行)
    ↓
回覆

核心代碼

1. Gateway 啟動（`src/daemon/start.ts`）

export async function startGateway(config: OpencClawConfig) {
  // 1. 載入設定
  const agents = config.agents.list;
  
  // 2. 啟動 HTTP server（接收 plugin 訊息）
  const server = await startHttpServer({
    port: config.gateway.port,
    auth: config.gateway.auth
  });
  
  // 3. 啟動所有 plugins（Telegram/WhatsApp 等）
  for (const plugin of config.plugins.entries) {
    await startPlugin(plugin);
  }
  
  // 4. 啟動 agents（每個 agent 一個 session pool）
  for (const agent of agents) {
    await initAgent(agent);
  }
  
  return server;
}

關鍵點：

Gateway 只是一個 HTTP server，不做 AI 決策
真正的智能在 Agent 層
Plugins 透過 HTTP API 把訊息送給 Gateway

2. 訊息路由（`src/gateway/server-channels.ts`）

export async function handleIncomingMessage(req, res) {
  const { channel, from, text } = req.body;
  
  // 1. 根據 channel + from 找到對應的 agent
  const binding = findBinding(config.bindings, { channel, from });
  const agent = config.agents.list.find(a => a.id === binding.agentId);
  
  // 2. 建立或恢復 session
  const sessionKey = deriveSessionKey(agent.id, channel, from);
  const session = await loadSession(sessionKey);
  
  // 3. 送給 agent 處理
  const reply = await agent.processMessage(session, text);
  
  // 4. 回傳給 plugin
  return res.json({ reply });
}

關鍵點：

bindings 定義「這個 channel 的這個人 → 用哪個 agent」
每個對話有一個 sessionKey（儲存歷史訊息）
Agent 接收 session + message，回傳 reply

💡 關鍵洞察

Gateway 是笨的
- 只做路由（誰應該處理這則訊息？）
- 不做 AI 判斷
Agent 是聰明的
- 用 LLM 理解訊息
- 決定要執行哪些工具（exec, browser, message）
- 產生回覆
Session 是記憶
- 每個對話有獨立的 session
- 儲存歷史訊息（context）
- 讓 agent 能記得之前說過什麼

Binding 是配對規則

{
  "agentId": "my-assistant",
  "match": {
    "channel": "whatsapp",
    "from": "+1234567890"
  }
}

意思：WhatsApp 來自 +1234567890 的訊息 → 給 my-assistant 處理

🔗 核心檔案

/Users/alice/.openclaw/repos/openclaw/src/daemon/start.ts - Gateway 啟動
/Users/alice/.openclaw/repos/openclaw/src/gateway/server-channels.ts - 訊息路由
/Users/alice/.openclaw/repos/openclaw/src/agents/agent.ts - Agent 核心
/Users/alice/.openclaw/repos/openclaw/openclaw.json - 你的設定檔

明天： Agent 如何處理訊息（processMessage 內部邏輯）

概念

Day 1: OpenClaw 整體架構