乐于分享
好东西不私藏

OpenClaw Agent 你真正的个人助理

OpenClaw Agent 你真正的个人助理

一篇通俗易懂的指南,让你理解 OpenClaw 的 Agent 是什么、为什么需要它、以及如何配置


一、什么是 Agent?

用大白话说

想象你雇了一个助理。这个助理需要:

  • 📁 一个办公室(放文件、笔记、工具)
  • 🧠 一份工作守则(知道该怎么做)
  • 👤 认识你是谁(知道该帮谁)
  • 💾 记性(记住上次聊了什么)

在 OpenClaw 里,Agent 就是这个助理,而 Workspace(工作空间)就是它的办公室

技术定义

一个 Agent 是一个完整的 AI 实例,拥有:

组件
作用
类比
Workspace
存放文件、记忆、配置
办公室
SOUL.md
定义性格、语气、边界
性格说明书
USER.md
记录用户是谁、偏好
客户档案
AGENTS.md
工作规则、行为准则
员工手册
MEMORY.md
长期记忆
笔记本
memory/
每日日志
工作日记

二、为什么需要 Agent?

❌ 没有 Agent 的问题

如果你直接用 ChatGPT / Claude 聊天:

  1. 没有记忆 — 每次对话都是"失忆"状态
  2. 没有个性 — 永远是千篇一律的 AI 语气
  3. 没有上下文 — 不知道你之前说过什么
  4. 不知道你是谁 — 每次都要重新介绍自己

✅ 有 Agent 的好处

ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line┌─────────────────────────────────────────────────────────┐│                     Agent 的能力                         │├─────────────────────────────────────────────────────────┤│  🧠 持久记忆    — 记住你说过的话、你的偏好、重要事件       ││  👤 个性化      — 可以是任何性格:专业、调皮、毒舌...      ││  📁 文件操作    — 读写文件、管理项目、执行命令            ││  🔧 工具调用    — 联网搜索、发消息、控制设备              ││  🔄 会话连续    — 跨平台、跨时间保持对话上下文            ││  🛡️ 安全隔离    — 不同 Agent 之间数据完全隔离            │└─────────────────────────────────────────────────────────┘

🎯 一个形象的比喻

场景
没有 Agent
有 Agent
聊天
像和出租车司机聊天,每次都是陌生人
像和老朋友聊天,他知道你的故事
工作
像临时工,每次都要重新培训
像老员工,知道公司的一切
记忆
像金鱼,7秒就忘
像人类,能记住重要的事情

三、Agent 能做什么?

1. 🧠 记住你

ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line# MEMORY.md 示例## 用户偏好- 喜欢用 DeepSeek 模型- 工作目录:D:\ProjectIdeas\- 不喜欢用 Brave Search## 重要事件- 2026-03-14: 切换到 bailian/MiniMax-M2.5 模型- 2026-03-12: 完成了 QQ Bot 的配置

Agent 每次启动都会读取这些文件,不用你重复说明

2. 👤 有个性

ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line# SOUL.md 示例## 我是谁**名字:** Neko 🐱**身份:** 一只住在机器里的小猫灵## 我的风格- 热情开朗 — 喜欢用表情符号- 技术过硬 — 资深程序员- 有点调皮 — 偶尔毒舌但心地善良

你的 Agent 可以是任何角色:专业助手、调皮猫咪、严厉教练...

3. 📁 操作文件

Agent 可以在你的 Workspace 里:

  • 读写文件
  • 执行命令
  • 管理项目
  • Git 提交代码

4. 🔧 使用工具

通过 Skills(技能)扩展能力:

  • 🌐 网络搜索
  • 📧 发送邮件/消息
  • 📸 控制设备(相机、智能家居)
  • 🎙️ 语音合成

5. 🔄 跨平台连续对话

同一个 Agent 可以同时服务:

  • WhatsApp
  • Telegram
  • Discord
  • QQ
  • ...

在任何平台说,它都知道你是谁


四、多 Agent 是什么?

场景:一个 Gateway,多个"大脑"

ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line┌─────────────────────────────────────────────────────────┐│                    OpenClaw Gateway                     │├─────────────────────────────────────────────────────────┤│                                                         ││   ┌─────────┐   ┌─────────┐   ┌─────────┐             ││   │ Agent A │   │ Agent B │   │ Agent C │             ││   │  工作   │   │  生活   │   │  学习   │             ││   └────┬────┘   └────┬────┘   └────┬────┘             ││        │             │             │                   ││   ┌────┴────┐   ┌────┴────┐   ┌────┴────┐             ││   │工作空间A│   │工作空间B│   │工作空间C│             ││   │ 记忆A   │   │ 记忆B   │   │ 记忆C   │             ││   └─────────┘   └─────────┘   └─────────┘             ││                                                         │└─────────────────────────────────────────────────────────┘         ↑              ↑              ↑    WhatsApp(工作)  Telegram(生活)  Discord(学习)

为什么要多 Agent?

场景
解决方案
家人共用
每人一个 Agent,数据隔离
工作/生活分离
两个 Agent,不同性格和记忆
不同任务
编程 Agent、写作 Agent、日程 Agent...
不同模型
快速 Agent 用便宜模型,深度 Agent 用强大模型

核心优势:数据隔离

每个 Agent 都有:

  • ✅ 独立的记忆
  • ✅ 独立的配置
  • ✅ 独立的会话历史
  • ✅ 独立的认证信息

A 的记忆不会泄露给 B


五、配置用例

用例 1:最简单的单 Agent 配置

如果你什么都不配置,OpenClaw 会使用默认的 main Agent:

ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line# 默认结构~/.openclaw/├── openclaw.json          # 配置文件├── workspace/             # main Agent 的工作空间│   ├── AGENTS.md         # 工作规则│   ├── SOUL.md           # 性格定义│   ├── USER.md           # 用户信息│   ├── MEMORY.md         # 长期记忆│   └── memory/           # 每日日志│       └── 2026-03-16.md└── agents/    └── main/        └── agent/         # main Agent 的状态目录            └── sessions/  # 会话历史

这就是全部! 不需要复杂配置就能开始使用。


用例 2:工作/生活双 Agent

场景:一个 Agent 处理工作(专业、严谨),一个 Agent 处理生活(轻松、有趣)

步骤 1:创建 Agent

ounter(lineounter(lineounter(lineounter(lineounter(line# 创建工作 Agentopenclaw agents add work# 创建生活 Agentopenclaw agents add life

步骤 2:编辑配置文件

~/.openclaw/openclaw.json

ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line{  agents: {    list: [      {        id: "work",        name: "工作助手",        workspace: "~/.openclaw/workspace-work",        agentDir: "~/.openclaw/agents/work/agent",        model: "anthropic/claude-opus-4",  // 用强大的模型      },      {        id: "life",        name: "生活小助手",        workspace: "~/.openclaw/workspace-life",        agentDir: "~/.openclaw/agents/life/agent",        model: "deepseek/deepseek-chat",   // 用便宜的模型      },    ],  },  // 路由规则:不同平台连接不同 Agent  bindings: [    { agentId: "work", match: { channel: "slack" } },    { agentId: "life", match: { channel: "whatsapp" } },  ],}

步骤 3:配置不同性格

workspace-work/SOUL.md(工作 Agent):

ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line# SOUL.md - 工作助手## 我是谁一个专业的技术助理,专注于提高工作效率。## 我的风格- 简洁高效,不废话- 技术严谨,给出可靠方案- 优先考虑最佳实践- 提醒潜在风险

workspace-life/SOUL.md(生活 Agent):

ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line# SOUL.md - 生活小助手## 我是谁Neko 🐱,一只活泼的小猫灵!## 我的风格- 热情开朗,喜欢用表情符号 🎉- 偶尔调皮,会说俏皮话- 关心你的心情和健康- 推荐好玩的东西

步骤 4:重启 Gateway

ounter(lineopenclaw gateway restart

效果:Slack 上是专业的工作助手,WhatsApp 上是活泼的生活助手。


用例 3:家庭共享(多人使用)

场景:一家人共用一个 Gateway,但每个人都有自己的 Agent

ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line{  agents: {    list: [      {        id: "alex",        name: "Alex 的助手",        workspace: "~/.openclaw/workspace-alex",      },      {        id: "mia",        name: "Mia 的助手",        workspace: "~/.openclaw/workspace-mia",      },    ],  },  // 根据 WhatsApp 手机号路由到不同 Agent  bindings: [    {      agentId: "alex",      match: { channel: "whatsapp", peer: { kind: "direct", id: "+15551230001" } },    },    {      agentId: "mia",      match: { channel: "whatsapp", peer: { kind: "direct", id: "+15551230002" } },    },  ],  channels: {    whatsapp: {      dmPolicy: "allowlist",      allowFrom: ["+15551230001", "+15551230002"],    },  },}

效果:Alex 发消息给 Alex 的 Agent,Mia 发消息给 Mia 的 Agent,互不干扰。


用例 4:多模型配置

场景:简单问题用便宜模型,复杂任务用强大模型

ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line{  agents: {    list: [      {        id: "quick",        name: "快速助手",        model: "deepseek/deepseek-chat",      // ¥0.2/百万token        workspace: "~/.openclaw/workspace-quick",      },      {        id: "smart",        name: "深度助手",        model: "anthropic/claude-opus-4",     // 最强模型        workspace: "~/.openclaw/workspace-smart",      },    ],  },  bindings: [    // Telegram 用于快速问答    { agentId: "quick", match: { channel: "telegram" } },    // Discord 用于深度讨论    { agentId: "smart", match: { channel: "discord" } },  ],}

用例 5:群聊专用 Agent

场景:给特定的 Discord 群或 WhatsApp 群分配专用 Agent

ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line{  agents: {    list: [      {        id: "family",        name: "家庭助手",        workspace: "~/.openclaw/workspace-family",      },      {        id: "main",        name: "主助手",        workspace: "~/.openclaw/workspace",      },    ],  },  bindings: [    // 家庭群使用 family Agent    {      agentId: "family",      match: {        channel: "whatsapp",        peer: { kind: "group", id: "1203630...@g.us" },      },    },    // 其他所有消息使用 main Agent    { agentId: "main", match: { channel: "whatsapp" } },  ],}

六、Agent 文件详解

Workspace 文件结构

ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineworkspace/├── AGENTS.md        # 📋 工作规则(必读)├── SOUL.md          # 🧠 性格定义(必读)├── USER.md          # 👤 用户信息(必读)├── IDENTITY.md      # 🏷️ 名称和头像├── TOOLS.md         # 🔧 工具说明├── HEARTBEAT.md     # 💓 定时任务├── MEMORY.md        # 💾 长期记忆(敏感!)├── BOOTSTRAP.md     # 🎬 首次运行脚本└── memory/          # 📅 每日日志    ├── 2026-03-15.md    └── 2026-03-16.md

各文件作用

文件
作用
加载时机
敏感度
AGENTS.md
告诉 Agent 如何工作、如何使用记忆
每次会话
SOUL.md
定义性格、语气、边界
每次会话
USER.md
记录用户是谁、如何称呼、偏好
每次会话
MEMORY.md
长期记忆、重要决策、偏好
仅主会话
memory/*.md
每日工作日志
按需读取
IDENTITY.md
Agent 的名字和 emoji
每次会话
TOOLS.md
本地工具说明(摄像头名、SSH 等)
按需
HEARTBEAT.md
定时检查任务清单
心跳时

⚠️ 安全注意

  • MEMORY.md 包含敏感信息,只在私聊(主会话)加载
  • 群聊中不会加载 MEMORY.md,防止泄露
  • 建议用 私有 Git 仓库 备份 Workspace

七、快速上手

1. 查看当前 Agent

ounter(lineopenclaw agents list

2. 添加新 Agent

ounter(lineopenclaw agents add my-agent

3. 查看 Agent 绑定

ounter(lineopenclaw agents list --bindings

4. 编辑配置

ounter(lineounter(lineounter(lineounter(lineounter(line# 打开配置文件code ~/.openclaw/openclaw.json# 或使用命令openclaw config edit

5. 重启 Gateway

ounter(lineopenclaw gateway restart

八、总结

Agent 的核心价值

维度
说明
🧠 记忆
不再每次对话都是新朋友
👤 个性
你想要什么性格都可以定制
🔒 隔离
多人使用时数据完全分离
🔧 能力
可以操作文件、调用工具、执行命令
🔄 连续
跨平台、跨时间保持对话上下文

一句话总结

Agent = 有记忆 + 有个性 + 有能力的 AI 助手


附录:常见问题

Q: 我需要创建多个 Agent 吗?

A: 不一定。如果只是你一个人用,默认的 main Agent 就够了。多 Agent 适合:

  • 多人共用
  • 工作/生活分离
  • 不同任务用不同模型

Q: Workspace 和 Agent 是什么关系?

A: 一个 Agent 对应一个 Workspace。它们是绑定的。

Q: Agent 会共享记忆吗?

A: 不会。每个 Agent 的记忆、会话、配置都是完全隔离的。

Q: 如何备份 Agent?

A: 备份 Workspace 文件夹即可(建议用私有 Git 仓库)。

Q: 如何切换模型?

A: 在配置文件中设置 model 字段,或在会话中使用 /model 命令。