夜雨聆风OpenClaw 单只龙虾→一群龙虾 一步一步操作指南
你说的 “一只龙虾” 就是 OpenClaw 默认的单 Agent，“一群龙虾” 就是多智能体团队—— 每个龙虾有独立的角色、记忆、工作空间，还能互相通信、分工协作，完全不串数据。
以下是全平台通用（Windows/Mac/Linux/ 服务器都能用）、新手零出错的步骤，全程跟着操作就能搞定：
前置确认
确保你已经正常安装并启动了 OpenClaw，单只龙虾能正常对话使用，命令行能正常识别openclaw指令。
第一步：先查看你当前的龙虾（确认单 Agent 状态）
打开你的命令行工具（终端 / CMD/PowerShell） 输入以下命令，查看当前已有的 Agent：
bash
运行
openclaw agents list
正常会显示你当前只有 1 个带 default标记的龙虾（就是你现在的单只龙虾），比如默认的main。
第二步：一键创建新龙虾（新增独立 Agent）
用 OpenClaw 官方的agents add命令，一行代码创建一只独立的龙虾，自动生成专属的工作空间、配置文件、灵魂模板，完全和原有龙虾隔离，不会串数据。
举个例子，你可以创建 3 只分工明确的龙虾，按需复制执行即可：
【总管虾】统筹调度、分配任务、汇总结果（设为默认入口）
bash
运行
openclaw agents add main
【开发虾】写代码、调 bug、代码审查、写技术文档
bash
运行
openclaw agents add dev
【内容虾】写文案、做总结、写稿件、标题优化
bash
运行
openclaw agents add content
✅ 每执行一次add命令，就新增一只完全独立的龙虾，你可以根据自己的需求创建任意数量。
第三步：给每只龙虾注入 “灵魂”（定义角色与分工）
这一步是核心，决定了每只龙虾的定位、能力、做事规则，避免龙虾们乱干活。
先找到每只龙虾的专属文件夹：
Mac/Linux 路径： ~/.openclaw/Windows 路径： C:\Users\你的用户名\.openclaw\每只龙虾的文件夹命名规则： workspace-你的龙虾id，比如开发虾就是workspace-dev进入对应龙虾的文件夹，打开核心配置文件 **
soul.md**（灵魂文件），编辑它的角色定位。给你两个可以直接复制的模板：
开发虾 soul.md模板：
markdown
# 灵魂文件 - 开发虾
## 核心职责
- 专注代码编写、调试、代码审查、技术文档编写
- 优先保证代码的健壮性、可读性、可维护性
## 做事规则
- 写代码前先确认需求边界，不做超出范围的内容
- 不确定的内容直接说明，绝不编造不存在的API
- 所有代码必须附带清晰注释和使用说明
## 禁止事项
- 不处理和开发无关的需求
- 不生成恶意、违规、有安全风险的代码
内容虾 soul.md模板：
markdown
# 灵魂文件 - 内容虾
## 核心职责
- 负责文案撰写、内容创作、文章总结、标题优化
- 输出符合用户要求的风格、结构、字数的内容
## 做事规则
- 先明确用户的受众、场景、核心诉求，再动笔
- 内容逻辑清晰，重点突出，符合对应平台的风格
## 禁止事项
- 不写虚假、夸大、违规的内容
- 不处理和内容创作无关的需求
第四步：配置 “通讯录”，让龙虾们互相认识、能协作
要让一群龙虾能互相沟通、自动派活，需要做两个关键配置，缺一不可。
4.1 给每只龙虾配团队通讯录
在每只龙虾的工作空间里，打开AGENTS.md文件，写上所有队友的信息，让每只龙虾都知道 “团队里有谁、各自擅长什么”。
可以直接复制这个模板，按需修改：
markdown
# 龙虾团队通讯录
- main（总管虾）：统筹全局，接收用户需求，分配任务，汇总最终结果
- dev（开发虾）：负责所有代码相关的任务，写代码、改bug、做技术方案
- content（内容虾）：负责所有文案、内容创作、总结、稿件相关任务
⚠️ 注意：每只龙虾的AGENTS.md都要更新，确保信息一致。
4.2 开启跨龙虾调度能力（核心！让总管自动派活）
这一步是让龙虾们能互相调用的关键，开启后，你只需要和总管虾说话，它会自动根据需求，把任务派给对应的龙虾，完成后再汇总给你。
打开 OpenClaw 全局核心配置文件： ~/.openclaw/openclaw.json（Windows 在用户目录的.openclaw 文件夹里）先修改 agents字段，确认所有龙虾都在列表里，并且标记好默认的总管虾；再添加agenttoagent配置，开启跨 Agent 通信。完整可直接复制的配置模板如下：
json
{
"agents":{
"list":[
{
"id":"main",
"default":true,
"name":"总管虾",
"workspace":"~/.openclaw/workspace-main"
},
{
"id":"dev",
"name":"开发虾",
"workspace":"~/.openclaw/workspace-dev"
},
{
"id":"content",
"name":"内容虾",
"workspace":"~/.openclaw/workspace-content"
}
]
},
"tools":{
"agenttoagent":{
"enabled":true,
"allow":["main","dev","content"]
}
}
}
关键配置说明： default: true：标记这只龙虾是默认入口，你平时说话默认找它，建议给总管虾 enabled: true：开启跨龙虾调用的核心开关 allow：写上所有允许互相通信的龙虾 id，必须和上面 list里的 id 完全一致，不能写错
第五步：重启生效，验证你的龙虾团队
- 重启 OpenClaw 服务
：先停止之前运行的 OpenClaw 进程，再重新执行 openclaw start，让所有配置生效。 - 验证团队是否正常
：在命令行再次执行 openclaw agents list，确认你创建的所有龙虾都正常显示，没有报错。 - 测试协作能力
：和你的总管虾对话，比如： “让内容虾帮我写一篇 AI 办公工具的小红书推广文案，300 字左右” “让开发虾帮我写一个 Python 批量重命名图片的脚本，要带异常处理”正常情况下，总管虾会自动把任务派给对应的龙虾，完成后把结果回传给你，真正实现 “一群龙虾帮你干活”。
新手必看避坑指南
- 路径必须唯一
：每只龙虾的 workspace路径绝对不能重复，否则会导致记忆、文件互相污染，严重串数据。 - id 必须唯一
：每只龙虾的 id 不能重复，否则配置会直接失效。 - 改完必须重启
：修改 openclaw.json配置文件后，一定要重启 OpenClaw 服务，否则配置不会生效。 - 资源注意
：每只龙虾都会占用一定的内存，服务器部署建议至少 2G 以上内存，龙虾越多，内存需求越高。 - 权限控制
： agenttoagent的allow列表里，只放你信任的龙虾 id，避免乱调用。
进阶玩法（可选）
如果你想让多只龙虾同时并行干活，比如一个查资料，一个写大纲，一个写文案，可以用 OpenClaw 内置的指令：
给指定龙虾派一次性任务：
bash
运行
sessions_spawn(task="帮我整理3个主流AI办公工具的核心优缺点", agentId="content")
给正在对话的龙虾追加任务：
bash
运行
sessions_send(agentId="dev", message="帮我给刚才的脚本加一个日志记录功能")
共享文件接力干活：龙虾们可以通过共享文件夹读写文件，比如开发虾写了代码，测试虾可以直接读取测试，实现流水线协作。
