本文说明:OpenClaw 的会话(Session)和记忆(Memory)系统是它区别于普通 AI 聊天工具的核心能力——AI 能记住你是谁、你喜欢什么、之前发生了什么。本文深度解析 sessions、memory、agent、agents、system、directory 等命令,覆盖所有实际使用场景。
一、OpenClaw会话与记忆架构概览
💡 理解三者关系
Session 是一次对话的「工作空间」(短期);Memory 是 AI 对你的长期了解(永久);Agent 是执行任务的「AI 员工」实例,每个 Agent 有自己的 Session,共享 Memory。重置 Session 不丢 Memory;删除 Memory 才是真正忘记。
二、openclaw sessions 命令详解
openclaw sessions [list|show|delete|prune|export]
会话管理
Q:sessions list 显示什么?如何识别不同会话?
显示所有存储的会话列表,每条显示:会话 ID、发件人(平台+用户ID)、创建时间、最后活跃时间、消息数量。DM 会话以「main」命名,群聊会话包含群 ID,斜杠命令会话以「slash:」前缀开头。
Q:sessions show <id> 能看到什么?
显示指定会话的详细信息:完整消息历史(含工具调用记录)、Token 使用量、当前 System Prompt、活跃的 Skills 列表。适合审查 AI 做了哪些操作。
Q:sessions prune 是做什么的?什么时候用?
自动清理过期/空的会话(Session Pruning)。当 sessions list 显示几十上百个废弃会话占用磁盘时,运行 openclaw sessions prune 进行清理。可以设置 --older-than 30d 只清理30天以上的。
Q:sessions delete 会同时删除 Memory 吗?
不会。sessions delete <id> 只删除该会话的上下文历史,Memory 文件(~/.openclaw/memory/)完全不受影响。AI 下次对话仍然记得你。
Q:sessions export 导出的数据能用来做什么?
导出为 HTML 格式,可作为对话存档(交接给他人、审计留存)。包含完整的消息历史、工具调用记录和 System Prompt,便于回溯 AI 做了什么决策。
三、openclaw memory 命令详解
openclaw memory [list|show|edit|delete|search]
记忆管理
Q:OpenClaw 的记忆是存在哪里的?怎么看?
记忆存储为本地 Markdown 文件(~/.openclaw/memory/),完全可读可编辑。运行 openclaw memory list 查看所有记忆文件列表;openclaw memory show <文件名> 查看具体内容。
Q:memory edit 如何手动修改 AI 的记忆?
执行 openclaw memory edit 用默认编辑器打开记忆文件(可通过 EDITOR 环境变量指定编辑器)。直接修改 Markdown 内容即可,AI 下次对话会读取更新后的记忆。适合纠正 AI 记错的信息。
Q:memory search 能搜索什么?
在所有记忆文件中全文搜索关键词,例如 openclaw memory search "项目名",快速找到 AI 曾经记录的相关内容。
⚠️ Q:memory delete 后能恢复吗?
不能。openclaw memory delete 永久删除记忆文件,AI 会「忘记」相关内容。建议先用 memory edit 修改而非删除。如需完全重置,建议先备份 ~/.openclaw/memory/ 目录。
四、openclaw agent / agents 命令详解
openclaw agents [list|status|kill|log]
代理列表管理
Q:openclaw agents list 和 sessions list 有什么区别?
agents list 显示正在运行的 Agent 实例(活跃进程),包含 PID、运行时长、正在处理的任务;sessions list 显示所有会话记录(包括历史的、已结束的)。agents 是「正在工作的人」,sessions 是「所有工作记录」。
Q:openclaw agents kill <id> 是强制终止吗?会影响数据吗?
是的,立即强制终止 Agent 进程。正在进行的工具调用(文件写入等)可能不完整。日常使用建议先通过聊天发送 /stop 命令优雅停止,CLI 的 kill 用于 /stop 不响应的情况。
Q:如何同时运行多个 Agent 处理不同任务?
OpenClaw 支持多 Agent 路由:不同聊天平台/群聊会自动分配独立 Agent。通过配置 agents.routing 可实现更细粒度的隔离(例如按发件人、按任务类型)。openclaw agents list 可以看到所有并发运行的 Agent。
openclaw agent [send|steer|info|log]
单代理控制
Q:agent send 和 message send 有什么区别?
openclaw agent send <agent-id> <消息> 直接向特定 Agent 实例发送消息(绕过频道);openclaw message send 通过频道(WhatsApp/Telegram等)发送消息(走正常用户流程)。前者适合 Agent 间通信或 CLI 直接控制。
Q:agent steer 如何中途改变 AI 的任务方向?
类似聊天里的 /steer 命令,openclaw agent steer <agent-id> "新指令" 向正在运行中的 Agent 注入引导消息,Agent 会在当前工具调用完成后处理新指令,无需重启整个任务。
五、openclaw system 命令详解
openclaw system [info|prompt|reload]
系统信息
Q:openclaw system info 显示什么?
显示系统级信息:OpenClaw 版本、Node.js 版本、操作系统、配置文件路径、状态目录路径、当前使用的 AI 模型、已启用的频道列表、已安装的 Skills 数量等。相当于 OpenClaw 的「关于」信息面板。
Q:system prompt 命令是做什么的?
查看当前 AI 使用的完整 System Prompt(系统提示词),包括自动注入的记忆内容、Skill 描述、用户自定义的 AGENTS.md 内容等。Token 占用多时,用这个命令分析哪部分最耗 Token。
Q:system reload 有什么用?
热重载系统配置,无需重启 Gateway。修改了 Skills 文件或 Memory 文件后,执行 reload 立即生效(等同于编辑后保存的热更新)。
六、directory / docs / dns / models 命令详解
openclaw directory [list|add|remove]Q:directory 命令有什么用?
管理 OpenClaw 可访问的文件目录白名单。directory list 查看已授权目录;directory add /path/to/project 授权 AI 访问新目录;directory remove 撤销授权。是沙盒安全的重要控制点。
openclaw docs [open|search]Q:docs 命令能搜索文档吗?
openclaw docs open 在浏览器打开官方文档(docs.openclaw.ai);openclaw docs search "关键词" 在本地缓存的文档中快速搜索。访问在线文档需要国际网络支持。
openclaw dns [check|flush]Q:dns 命令有什么用?
openclaw dns check 检查 OpenClaw 能否正常解析 AI API 域名(如 api.anthropic.com);openclaw dns flush 清除 DNS 缓存。排查「域名解析失败」类错误时使用。
openclaw models [list|test|set]Q:CLI 的 models 命令和聊天里的 /model 有什么区别?
CLI openclaw models list 显示所有配置的模型及其状态(是否可用、API Key 是否有效);聊天里的 /model 是在已可用模型中切换。建议排查模型问题时先用 CLI models list 确认。
七、pairing / nodes 命令详解
openclaw pairing [list|add|remove|qr]
配对管理
Q:pairing 命令是什么?什么时候需要配对?
配对(Pairing)是安全机制——新设备或新用户通过扫码/令牌向 Gateway 证明身份,之后才能使用命令功能。openclaw pairing qr 生成 QR 码让用户扫描完成配对;pairing list 查看已配对设备;pairing remove <id> 撤销配对(踢出用户)。
openclaw nodes [list|pair|unpair|log]
节点管理
Q:nodes 和 pairing 有什么区别?
nodes 专指 iOS/Android 移动端节点(OpenClaw 的手机 App),它们有更丰富的功能:摄像头拍照、语音唤醒、Canvas 画布等。openclaw nodes list 查看已配对的手机节点;nodes log <id> 查看节点日志排查连接问题。
八、Memory同步与Agent响应需要稳定网络
📊 网络对Agent性能的影响
VPN07 1000Mbps:延迟最低,响应最快
千兆带宽支持多个Agent同时调用API