openClaw工作原理笔记

首先了解什么是 OpenClawOpenClaw 是一个跨平台、多通道聊天代理系统可让你用同一套 AI 机器人或智能助手在多个地方如 WhatsApp、Telegram、Discord运行。它不仅接收消息还能处理、组织对话内容甚至支持复杂任务执行。 架构概览三大核心组件1️⃣ Gateway中枢网关一句话总结它是整个系统的大脑与中枢管理所有连接的渠道。接收来自不同平台的消息如 Telegram、Discord。路由消息到对应的 AI Agent代理。统一控制会话状态与对话权限。 简单理解就像一个 HTTP 服务器或者路由器负责把信息从 A 平台送到底层 AI 系统去做处理。2️⃣ AgentAI代理一句话总结它才是执行AI任务的“主角”可以是一个语言模型比如 Qwen、ChatGPT 插件、或本地LLM。运行在一个 workspace 目录下。处理消息内容、调用工具、形成回复。支持多种插件和自定义功能实现灵活扩展。 比如配置一个 USER.md 来告诉 AI 你是谁、你的偏好、你希望它帮你做什么。3️⃣ Sessions会话管理一句话总结如何记住你说过的话每次对话会被记录成一个 JSONL 文件包括上下文对话历史。存放在 ~/.openclaw/agents//sessions/.jsonl。每个会话由 sessionKey 唯一标识。 举例当你在 Telegram 和 WhatsApp 同时与 OpenClaw 对话虽然角色是同一个但两个平台的对话是分开的互不影响。 核心机制详解高级概念 会话作用域dmScope问题 如果多个用户共用一个 OpenClaw 实例怎么办 解决方案dmScope 决定会话隔离级别dmScope 模式 含义解释main 所有用户共享一个 session不推荐per-peer 每个用户单独一个 sessionper-channel-peer 按频道用户区分推荐用于多人群聊per-account-channel-peer 按账号频道用户区分适合多账号环境 这个设计很有意思体现了对隐私和数据隔离的重视特别是在企业、多团队协作场景下非常实用。 工作流程动画说明简化你想和 OpenClaw 在 Telegram 上交流你发送消息到 Telegram。Telegram 的 webhook 被触发消息送入 Gateway。Gateway 假设有一个配置好的 agent如 pi-agent此时会去查这个 agent 所属的 workspace。Gateway 根据 dmScope 决定该次对话属于哪个 session。读取对应 session 的历史记录如果存在将全部对话历史传给 Agent。Agent 处理请求后生成回应。回应通过 Gateway 返回 Telegram。