OpenClaw 入门 03|一张图搞懂「虾测」的五脏六腑

大家好，我是一名测试，主打陪伴、踩坑、做笔记。

前面两篇我们搞懂了 OpenClaw 是什么、以及 5 个核心名词。我给 OpenClaw 取了个可爱小名，叫虾测。今天我用一张架构流程图，带你完整看懂虾测从接收指令到输出回复的全链路，看懂这张图，后续配置、排错至少少走 90% 弯路。

一、用户输入：所有流程的起点

通俗理解你在对话框发的每一句话、上传文件、截图、长文本、特殊字符，都是整套系统运转的开端。

核心作用作为第一道入口关卡，承接所有用户请求，同时做非法指令、乱码、超长内容的拦截与容错，也是我日常重点测试的边界场景。

二、网关：平台总调度中心

通俗理解你的消息不会直接发给大模型，先要经过网关统一调度分发。

• 本地访问地址：ws://127.0.0.1:18789
• 运行规则配置：openclaw.json
• 运行日志目录：logs/gateway/

核心作用判断用户意图，区分只是单纯闲聊，还是要调用技能执行任务。实测强行关闭网关，系统不会卡死，会友好提示网关失联，异常容错做得很成熟。

三、智能大脑：会话理解层

通俗理解网关分发任务后，交由 AI 大脑做语义理解和多轮对话记忆。

• 当前默认模型：qwen/qwen-plus (当前我用的是“千问”模型)
• 会话日志路径：logs/agent/

核心作用自带上下文记忆，能连贯理解多轮对话；支持模型可插拔替换，像换发动机一样随时切换不同能力大模型。测试重点关注换模型后记忆是否丢失、上下文是否错乱。

四、技能工具箱：AI 真正落地干活的核心

通俗理解普通闲聊大脑自己就能搞定，但凡要查数据、查本地状态、联网操作，都要调用技能工具箱。

核心常用技能

• 天气技能：双气象源拉取数据，双重校验不胡乱编造
• 系统体检技能：本地电脑状态、进程自检巡检
• 设备互联技能：支持组网配对、跨设备联动
• 自定义技能：按规范自行开发新技能，自带 SKILL.md 说明文档

这也是我测试工作量最大的板块，单技能稳定性、多技能并发、接口降级、非法自定义技能校验都是日常重点。

五、本地工作区：你的私人地盘

通俗理解所有对话记录、人设配置、使用偏好，全部本地化存储，不上云、不担心数据泄露。

核心文件说明

• USER.md
  
  ：个人身份配置，虾测专属认识你
• SOUL.md
  
  ：定义虾测的性格和说话风格
• HEARTBEAT.md
  
  ：系统心跳运行记录
• memory/
  
  ：按日期自动归档每日对话日志

测试会重点验证文件生成、归档、乱码、丢失等场景，保证数据安全可控。

六、一句话完整串联记忆

用户输入 → 网关调度 → 大脑理解 → 按需调用技能 → 本地数据落地 → 虾测给出回复

✅ 全链路正常：虾测秒回❌ 任意一环异常：无响应、报错、功能失效