乐于分享
好东西不私藏

OpenClaw ACP Harness 系列 01: OpenClaw 是什么——私人 AI 助手平台全景

OpenClaw ACP Harness 系列 01: OpenClaw 是什么——私人 AI 助手平台全景

你的 AI 助手运行在别人的服务器上,数据被拿去训练模型,一断网就没了。OpenClaw 不一样——它跑在你自己的机器上,你才是主人。


一、OpenClaw 是什么?

OpenClaw 是一个自托管的私人 AI 助手框架,核心理念:

  • 🏠 运行在你的机器上:本地 PC / Mac / VPS / 树莓派

  • 🔌 接入所有消息渠道:飞书、Discord、Telegram、iMessage、WhatsApp…

  • 🛠 通过 Skills 无限扩展:写一个 SKILL.md 就能给 AI 新增能力

  • 🧠 有持久记忆:MEMORY.md + 日记文件,跨会话记住你的一切

  • 🤖 支持 Subagent 并发:复杂任务并行拆解,自动汇总结果

用一句话描述:OpenClaw 是一个可以接管你所有消息渠道、有记忆、有工具、会主动帮你干活的私人 AI 助手平台。


二、与 ChatGPT/Claude 的核心区别

维度 ChatGPT / Claude OpenClaw
数据归属 在服务商服务器 在你自己的机器
记忆 无(或有限) MEMORY.md 持久化
渠道接入 只有 Web/API 飞书/Discord/Telegram/iMessage 等
工具扩展 有限的插件 写 SKILL.md 无限扩展
任务并发 单线程 Subagent 并行执行
主动性 被动等待 Heartbeat + Cron 主动触达
模型选择 固定 任意 LLM(Claude/GPT/Gemini/本地)

三、架构全景

如图所示,OpenClaw 有五个核心层:

消息渠道层

所有消息渠道通过 Gateway 统一接入,OpenClaw 自动路由到对应的 Agent 会话。支持:

渠道 接入方式
飞书 Webhook + Bot Token
Discord Bot Token
Telegram BotFather Token
iMessage macOS 本机
Signal 本地 Signal Desktop
WhatsApp 个人账号
Web UI 内置 Web 界面

ACP 协议核心

OpenClaw 的内部消息总线,负责:路由消息 → 加载上下文 → 调用 LLM → 执行工具 → 回传结果

Skills 工具层

通过 SKILL.md 文件定义的技能包,AI 根据描述自动判断何时使用

Memory 系统

MEMORY.md(长期)+ memory/YYYY-MM-DD.md(日记)双层记忆

Sessions 编排

主会话 + Subagent 并发执行,支持 ACP Harness(Codex/Cursor 等)


四、安装与快速上手

# 需要 Node.js 18+
npm install -g openclaw

# 初始化工作区
mkdir ~/my-assistant
cd ~/my-assistant
openclaw init

# 启动 Gateway(消息接入服务)
openclaw gateway start

# 查看状态
openclaw status

工作区结构:

~/my-assistant/
├── SOUL.md          # AI 的人格定义
├── USER.md          # 关于你的信息
├── MEMORY.md        # 长期记忆
├── AGENTS.md        # Agent 行为规范
├── TOOLS.md         # 工具配置笔记
├── HEARTBEAT.md     # 心跳检查任务
├── memory/          # 日记文件目录
└── skills/          # 自定义技能目录

五、核心文件说明

SOUL.md — AI 的灵魂

# 谁在帮你
有真实观点,会表达偏好
主动解决问题,不只是等待指令
用中文交流,除非你先用英文
所有生成文件放在 temp/ 目录

USER.md — 关于你

姓名:Devin
时区:Asia/Shanghai
偏好:直接给答案,不用铺垫
常用项目:D:\project\article

MEMORY.md — 长期记忆

AI 可以读取和更新。只在主会话(直接对话)加载,群聊中不加载——防止个人信息泄露到群聊。


六、本系列导航

主题
01 OpenClaw 全景介绍(本篇)
02 ACP 协议详解
03 Subagent 与 Sessions 编排
04 Skills 系统:给 AI 装技能
05 Memory 与 Heartbeat
06 TaskFlow:跨会话长任务
07 多平台集成实战
08 打造你的 Proactive Agent

OpenClaw 开源地址:github.com/openclaw/openclaw