OpenClaw 单只龙虾→一群龙虾 一步一步操作指南

你说的 “一只龙虾” 就是 OpenClaw 默认的单 Agent，“一群龙虾” 就是多智能体团队—— 每个龙虾有独立的角色、记忆、工作空间，还能互相通信、分工协作，完全不串数据。

以下是全平台通用（Windows/Mac/Linux/ 服务器都能用）、新手零出错的步骤，全程跟着操作就能搞定：

前置确认

确保你已经正常安装并启动了 OpenClaw，单只龙虾能正常对话使用，命令行能正常识别openclaw指令。

第一步：先查看你当前的龙虾（确认单 Agent 状态）

1. 打开你的命令行工具（终端 / CMD/PowerShell）
2. 输入以下命令，查看当前已有的 Agent：

bash

运行

openclaw agents list

1. 正常会显示你当前只有 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命令，就新增一只完全独立的龙虾，你可以根据自己的需求创建任意数量。

第三步：给每只龙虾注入 “灵魂”（定义角色与分工）

这一步是核心，决定了每只龙虾的定位、能力、做事规则，避免龙虾们乱干活。

1. 先找到每只龙虾的专属文件夹：

• Mac/Linux 路径：~/.openclaw/
• Windows 路径：C:\Users\你的用户名\.openclaw\
• 每只龙虾的文件夹命名规则：workspace-你的龙虾id，比如开发虾就是workspace-dev

2. 进入对应龙虾的文件夹，打开核心配置文件 **soul.md**（灵魂文件），编辑它的角色定位。给你两个可以直接复制的模板：

• 开发虾soul.md模板：

markdown

# 灵魂文件 - 开发虾
## 核心职责
- 专注代码编写、调试、代码审查、技术文档编写
- 优先保证代码的健壮性、可读性、可维护性
## 做事规则
- 写代码前先确认需求边界，不做超出范围的内容
- 不确定的内容直接说明，绝不编造不存在的API
- 所有代码必须附带清晰注释和使用说明
## 禁止事项
- 不处理和开发无关的需求
- 不生成恶意、违规、有安全风险的代码

• 内容虾soul.md模板：

markdown

# 灵魂文件 - 内容虾
## 核心职责
- 负责文案撰写、内容创作、文章总结、标题优化
- 输出符合用户要求的风格、结构、字数的内容
## 做事规则
- 先明确用户的受众、场景、核心诉求，再动笔
- 内容逻辑清晰，重点突出，符合对应平台的风格
## 禁止事项
- 不写虚假、夸大、违规的内容
- 不处理和内容创作无关的需求

第四步：配置 “通讯录”，让龙虾们互相认识、能协作

要让一群龙虾能互相沟通、自动派活，需要做两个关键配置，缺一不可。

4.1 给每只龙虾配团队通讯录

在每只龙虾的工作空间里，打开AGENTS.md文件，写上所有队友的信息，让每只龙虾都知道 “团队里有谁、各自擅长什么”。

可以直接复制这个模板，按需修改：

markdown

# 龙虾团队通讯录
- main（总管虾）：统筹全局，接收用户需求，分配任务，汇总最终结果
- dev（开发虾）：负责所有代码相关的任务，写代码、改bug、做技术方案
- content（内容虾）：负责所有文案、内容创作、总结、稿件相关任务

⚠️ 注意：每只龙虾的AGENTS.md都要更新，确保信息一致。

4.2 开启跨龙虾调度能力（核心！让总管自动派活）

这一步是让龙虾们能互相调用的关键，开启后，你只需要和总管虾说话，它会自动根据需求，把任务派给对应的龙虾，完成后再汇总给你。

1. 打开 OpenClaw 全局核心配置文件：~/.openclaw/openclaw.json（Windows 在用户目录的.openclaw 文件夹里）
2. 先修改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"]
}
}
}

1. 关键配置说明：
• default: true
  ：标记这只龙虾是默认入口，你平时说话默认找它，建议给总管虾
• enabled: true
  ：开启跨龙虾调用的核心开关
• allow
  ：写上所有允许互相通信的龙虾 id，必须和上面list里的 id 完全一致，不能写错

第五步：重启生效，验证你的龙虾团队

1. 重启 OpenClaw 服务
   ：先停止之前运行的 OpenClaw 进程，再重新执行openclaw start，让所有配置生效。
2. 验证团队是否正常
   ：在命令行再次执行openclaw agents list，确认你创建的所有龙虾都正常显示，没有报错。
3. 测试协作能力
   ：和你的总管虾对话，比如：
• “让内容虾帮我写一篇 AI 办公工具的小红书推广文案，300 字左右”
• “让开发虾帮我写一个 Python 批量重命名图片的脚本，要带异常处理”正常情况下，总管虾会自动把任务派给对应的龙虾，完成后把结果回传给你，真正实现 “一群龙虾帮你干活”。

新手必看避坑指南

1. 路径必须唯一
   ：每只龙虾的workspace路径绝对不能重复，否则会导致记忆、文件互相污染，严重串数据。
2. id 必须唯一
   ：每只龙虾的 id 不能重复，否则配置会直接失效。
3. 改完必须重启
   ：修改openclaw.json配置文件后，一定要重启 OpenClaw 服务，否则配置不会生效。
4. 资源注意
   ：每只龙虾都会占用一定的内存，服务器部署建议至少 2G 以上内存，龙虾越多，内存需求越高。
5. 权限控制
   ：agenttoagent的allow列表里，只放你信任的龙虾 id，避免乱调用。

进阶玩法（可选）

如果你想让多只龙虾同时并行干活，比如一个查资料，一个写大纲，一个写文案，可以用 OpenClaw 内置的指令：

• 给指定龙虾派一次性任务：

bash

运行

sessions_spawn(task="帮我整理3个主流AI办公工具的核心优缺点", agentId="content")

• 给正在对话的龙虾追加任务：

bash

运行

sessions_send(agentId="dev", message="帮我给刚才的脚本加一个日志记录功能")

• 共享文件接力干活：龙虾们可以通过共享文件夹读写文件，比如开发虾写了代码，测试虾可以直接读取测试，实现流水线协作。