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 |
| 个人账号 | |
| 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

夜雨聆风