OpenClaw基础概念与架构

OpenClaw：AIAgent的新范式从“聊天工具”到“数字员工”开源、自托管掌控你的AI核心多渠道接入打破信息孤岛自主执行任务解放人力，提升效率ChatGPTvs.OpenClaw：本质区别维度ChatGPT(顾问)OpenClaw(员工)交互模式你问它答✔运行环境网页/App自托管服务器，多消息平台接入可扩展性GPTs商店ClawHub技能市场(13,729+)数据控制数据在OpenAI完全本地，用户拥有所有数据模型选择仅限GPT系列Claude/GPT/DeepSeek/Gemini/Ollama等开源否GitHub，完全开源OpenClaw核心数据快照278,932GITHUBSTARS53,232FORKS1,075+贡献者13,729CLAWHUBSKILLS■内置Skills:55个|支持消息渠道:20+(WhatsApp,Telegram,Discord,Slack,飞书,钉钉等)●最新版本:v2026.3.7(2026年3月8日)一句话理解OpenClaw开源的「个人AI操作系统」•自托管：运行在你自己的服务器上，掌控数据主权。•多渠道交互：通过任何即时通讯工具无缝连接。•任务自动化：处理生活和工作中的各种重复性任务。•吉祥物：龙虾(中文社区亲切称为“养虾”)。发展简史：从周末项目到GitHub第一一个人的周末项目，不到5个月成为GitHub全球第一2025年11月PeterSteinberger发布ClawdBot(致敬Claude)2026年1月两次改名，最终定为OpenClaw2026年1月中旬72小时暴涨6万Stars，单日最高增长9,000Stars2026年3月3日超过250KStars，超越React，登顶GitHub2026年3月8日深圳龙岗AI局发布OpenClaw支持政策征求意见稿发展简史：挑战与转折爆发式增长背后的阴影与新生⚠️阴影与危机•安全危机(2026年初):○CVE-2026-25253RCE漏洞(CVSS8.8/10)○供应链攻击(ClawHavoc)•谷歌封号(2026年初):大规模用户账号被封禁🔄转折与新生•创始人加入OpenAI(2026年2月14日):○PeterSteinberger加入OpenAI○项目移交开源基金会运营，保持独立○OpenAI作为赞助商之一，不控制项目方向创始人故事：PeterSteinberger从一个人到一个社区•PeterSteinberger:

奥地利开发者，iOS/macOS开发圈知名人士。•ClawdBot的诞生:2025年11月的一个周末项目。•惊人增长:

两个月后成为GitHub上增长最快的开源项目。•个人贡献:2026年3月，个人提交11,684

次commit。•社区力量:

贡献者超过1,075

人。PeterSteinberger创始人故事：加入OpenAI与名字的由来🤝加入OpenAI时间:2026年2月14日欢迎:SamAltman亲自欢迎，称其为「genius」消除担忧:转为开源基金会运营，保持项目独立OpenAI作为赞助商之一，不控制项目方向承诺继续支持Peter的开发❝Peter的初心「I'mabuilderatheart...WhatIwantistochangetheworld,notbuildalargecompany.」🐾名字的故事ClawdBot→Moltbot→OpenClaw(致敬Claude，龙虾吉祥物)为什么这么火？增长数据不到5个月从0到27.9万StarsImageLoadFailed•72小时爆发增长:2026年1月中旬，Stars超过60,000•关键人物加入:2026年2月中旬，Peter加入OpenAI，Stars达到145,000+•逼近React:2026年3月1日，Stars达到241,000+•超越React:2026年3月3日，Stars达到250,000+•当前数据:

截至2026年3月8日，Stars为278,932为什么这么火？「养虾」文化现象🐟吉祥物&社交货币•吉祥物:龙虾(Shrimp)•中文社区:将运行OpenClaw称为「养虾」•社交问候:「你养龙虾了吗？」成为AI圈问候语•线下体验:深圳腾讯云总部近千人排队体验OpenClaw安装•政策关注:深圳龙岗区AI局发布OpenClaw使用支持措施征求意见稿为什么这么火？Moltbook社交网络Moltbook:AIAgent的社交网络意义:AIAgent从「工具」走向「社会化存在」的第一个大规模实验场。32,912注册AIAgent2,364子社区3,130帖子22,046评论ⓘ截至2026年2月底活跃度数据为什么这么火？热门玩法💰赚钱型•Polymarket预测市场交易(月入数万美元案例)•ClawWork项目:「AICoworker，11小时赚$15K」🏠生活助手型•接管邮件、日历、消息管理•浏览网页、填表、数据抽取•文件读写、Shell命令执行👥社交养成型•Moltbook上设定Agent名字和性格•观察「社交行为」，形成「赛博养成」文化🏢企业部署型•国内用户大量接入飞书、钉钉、企业微信、QQ•openclaw-china插件套件，三步Docker部署为什么这么火？注意与风险注意：火爆背后的阴影Skill质量问题:ClawHub13,729个Skills中，超过50%被判定为垃圾/重复/低质量，396个被标记为恶意。成本风险:

一觉醒来收到$1,100API账单的恐怖故事频发。安全漏洞:CVE-2026-25253RCE漏洞曾让13.5万个暴露实例面临风险。💡核心建议:「养虾」虽火，但安全和成本控制必须认真对待。整体架构：Gateway-Node-Channel三层架构ImageLoadFailed•Gateway(网关):

中央控制平面，WebSocket服务，Session管理，Agent调度。•Node(节点):

设备端执行节点，本地操作执行(摄像头、录屏、系统命令等)。•Channel(通道):

消息通道接入层，连接多种即时通讯平台(WhatsApp,Telegram,Discord,Slack,飞书,钉钉等)。整体架构：Loopback-First设计SecuritybyDefault🔒默认绑定localhostGateway默认只绑定ws://127.0.0.1:18789🔀流量本地回环所有流量在本地回环，不开放外网端口，天然安全。☁️远程访问通过TailscaleServe/Funnel暴露，不直接暴露端口。🖥️核心建议每台主机只运行一个Gateway实例(避免WhatsAppWeb等渠道登录冲突)。整体架构：通信流程1.用户发消息2.Channel接收3.Gateway路由4.Agent处理5.Node执行6.回复用户Gateway长驻运行:持续监听Channel，积累记忆，不丢失上下文。记忆系统：四层记忆架构ImageLoadFailed•SOUL(灵魂):SOUL.md，永久不可变，定义Agent人格、价值观、核心身份。•TOOLS(工具):Skills+Extensions，按需加载，当前可用的工具和技能列表。•USER(用户):MEMORY.md+向量数据库，持久化，用户偏好、决策、历史事实，语义搜索。•Session(会话):sessions.json，会话级，实时对话上下文，Token耗尽时压缩。记忆系统：DailyLogs日志系统•Append-only写入:每天的交互记录以append-only方式写入memory/YYYY-MM-DD.md

文件。•自动读取:Session开始时，Agent自动读取今天和昨天的日志，提供连续性上下文。📄示例:memory/2026-03-08.md10:23-用户询问天气...

14:05-代码审查任务...记忆系统：Long-termMemory持久化存储•MEMORY.md:

可选的持久化文件，存储决策记录、用户偏好、长期事实。•加载规则:

只在main/privatesession中加载(群组隔离session不会看到)。•写入方式:Agent可主动写入，通常在Pre-Compaction时触发。•格式:

纯Markdown，人类可直接编辑。记忆系统：自动记忆保存Pre-Compaction•触发条件:Session接近token限制时(默认阈值约4000tokens)。•静默保存:Agent在后台执行一个隐藏turn，将重要记忆写入MEMORY.md和DailyLog。•压缩上下文:

旧消息被压缩或截断，释放token空间，用户看不到。•意义:

保证长对话中关键信息不丢失，实现真正的持久记忆。记忆系统：向量记忆搜索SemanticSearch默认启用:结合两种检索策略。Embedding向量:语义相似度计算，模糊搜索、语义关联。BM25关键词:传统关键词匹配，精确匹配(文件名、命令、人名)。底层存储:SQLite-vec进行向量存储和加速检索。索引重建:监听记忆文件变化，自动重建索引。Agent工作区：目录结构与核心文件ImageLoadFailed独立工作区目录:每个Agent在文件系统中有一个独立的工作区目录。纯文本文件:所有配置、记忆、技能都以纯文本文件的形式存在。核心文件:AGENTS.md:SystemPromptSOUL.md:人格内核USER.md:用户信息MEMORY.md:长期记忆HEARTBEAT.md:定时任务Agent工作区：核心建议一切皆文本•纯Markdown/JSON:

所有配置文件都是纯Markdown或JSON格式。•无需专用工具:

可以直接用文本编辑器修改它们，不需要任何专用工具。•OpenClaw哲学体现:

一切皆文本，极简主义，可组合性。Session与用户识别：DMPairingPolicyImageLoadFailed•默认认证策略:

当未知发送者私聊Agent时。•生成配对码:Agent回复一次性配对码(6位数字)。•等待验证:

消息挂起，Agent进入等待状态。•主人批准:

在已配对渠道输入配对码批准，或拒绝。•核心作用:

防止陌生人滥用，保护API额度。Session与用户识别：白名单机制allowFrom•预先授权:在Agent配置(AGENTS.md)中设置allowFrom

字段。•跳过配对流程:白名单中的用户发消息时直接进入对话，无需配对。yaml

allowFrom:

-telegram:123456789

-whatsapp:+8613800138000

-discord:user#1234Session与用户识别：群组规则requireMention•默认策略:requireMention，只响应@Agent名称的消息，忽略其他群聊内容。•可选模式:always，响应所有消息(消耗大量token)。•聊天命令:/activationmention|alwaysSession与用户识别：Session隔离ContextIsolation•私聊(DM):

已配对用户的私聊会折叠到共享的mainsessionMEMORY.md。•群组:

每个群组使用独立的隔离session，不加载MEMORY.md。•跨渠道:

同一用户在不同渠道的私聊共享mainsessionMEMORY.md。•设计意图:

私聊是「私密空间