AI-Wiki

文档概览

本教程为从入门到进阶的全链路多智能体系统搭建指南，从单Agent基础配置切入，逐步扩展至多Agent团队构建、跨Agent通信规则、动态任务编排等高阶能力，同时配套全流程安全规范与可落地的实战操作步骤，面向个人开发者与技术团队两类用户群体。

关键事实

适配版本：仅适配OpenClaw 2026.2.26版本，不同版本配置规则存在差异
核心覆盖模块：共4个核心模块，分别为单Agent配置、多Agent部署、通信机制、高级编排
配套资源：包含所有核心配置代码示例、全链路安全规范、常用运维管理命令、完整多Agent协作实战步骤
适用范围：支持个人开发者快速搭建个人智能助手集群、技术团队落地企业级多智能体协作系统两类需求

重要细节

1. OpenClaw配置文件体系

OpenClaw采用分层配置设计，核心文件目录如下：

文件/目录	作用
~/.openclaw/openclaw.json	主配置文件，定义智能体、模型、渠道、工具等核心模块
~/.openclaw/workspace/	默认Agent的工作目录，包含记忆文件、技能等
~/.openclaw/agents/<agent-id>/	每个Agent的专属配置目录，存放认证信息和会话历史
~/.openclaw/agents/<agent-id>/sessions/	按日期存储的对话记录，独立隔离

配置优先级从高到低为：命令行参数 > 环境变量 > Agent特有配置（agents.list） > 全局默认配置（agents.defaults） > 内置默认值

2. 单Agent配置与安全

核心配置参数

参数	说明	推荐取值
workspace	Agent工作目录，存放记忆、文件等	自定义绝对路径
model.primary	主模型ID，格式为`提供商/模型ID`	示例：`dashscope/kimi-k2.5`
temperature	控制输出随机性，0.2~0.5区间token消耗较低	推荐0.3
compaction.reserveTokensFloor	上下文压缩保留的最低token数	20000
heartbeat.every	空闲重置时间，防止长期占用token	30m
memorySearch.enabled	记忆搜索开关，学习阶段建议禁用	false
skills.allow	工具权限白名单	仅开启必需工具

单Agent人格定制

可在Agent工作目录下创建3类配置文件定制行为：

SOUL.md：定义Agent核心人格和职责，每次对话都会读取
MEMORY.md：Agent自动更新的长期记忆，支持手动编辑
USER.md：存储特定用户的信息，用于个性化回应

OpenClaw安全实践规范（单Agent）

工具权限最小化：使用skills.allow白名单，高危工具如shell.execute非必要绝不开启
网关安全：gateway.bind设置为loopback确保服务仅本地访问，认证令牌至少为32位随机字符串
定期审计：运行openclaw security audit --deep检查风险，及时删除来源不明的第三方技能

3. 多Agent部署要点

多Agent模式可实现角色分离、任务并行、专业分工、复杂流程拆解四类核心价值。核心配置为agents.list数组，每个Agent需独立配置：

每个Agent必须设置独立工作区，避免文件冲突
可单独覆盖全局的model和skills配置，实现精细权限控制
id为Agent唯一标识，用于路由和通信

4. OpenClaw多Agent协作机制：跨Agent通信

通信功能通过agentToAgent工具开启，配置示例如下：

"tools": {
 "agentToAgent": {
 "enabled": true,
 "allow": ["writer", "coder"]
 }
}

仅allow列表内的Agent可主动发起通信，通信方式为在对话中使用@目标ID直接发送请求，内部通信过程对用户透明。可通过openclaw sessions list --agent <id>查看包含内部消息的完整会话历史。

5. 高级动态编排（subagents模式）

支持主Agent动态创建子Agent执行子任务，核心配置参数：

参数	说明	推荐取值
maxSpawnDepth	子Agent可继续创建子Agent的深度	2
maxChildrenPerAgent	单个Agent最多同时拥有的子Agent数量	5
maxConcurrent	全局并发子Agent上限	8

工作流程为：主Agent接收复杂任务 → 拆分子任务并动态创建对应子Agent → 子Agent并行执行返回结果 → 主Agent汇总生成最终回复，适合处理多领域复杂问题。

多Agent场景安全升级要求：严格落实工作区隔离、通信白名单仅开放必要权限、每个Agent单独配置最小化技能权限、定期执行深度安全审计。

6. OpenClaw常用管理命令

命令	作用
`openclaw gateway start`	启动网关（前置必需操作）
`openclaw agents list`	查看所有Agent状态
`openclaw msg --agent <id> "消息"`	向指定Agent发送消息
`openclaw sessions list --agent <id>`	查看Agent的会话列表
`openclaw agentToAgent status`	查看跨Agent通信状态
`openclaw doctor --fix`	自动检查和修复配置问题
`openclaw security audit --deep`	深度安全审计

7. 完整实战步骤（写作助手与代码助手协作）

按前文配置分别创建id为writer的写作助手、id为coder的代码助手
开启agentToAgent通信，将两个Agent加入allow列表
向writer发送任务："我想写一篇关于贪吃蛇游戏的技术文章，需要Python代码。请先写大纲，然后让@coder提供完整代码。"
等待writer自动完成大纲规划、请求coder生成代码、整合内容的全流程
运行openclaw sessions list --agent writer查看完整协作过程

OpenClaw深度教程：多Agent协作、通信与高级编排摘要

文档概览

关键事实

重要细节

1. OpenClaw配置文件体系

2. 单Agent配置与安全

核心配置参数

单Agent人格定制

OpenClaw安全实践规范（单Agent）

3. 多Agent部署要点

4. OpenClaw多Agent协作机制：跨Agent通信

5. 高级动态编排（subagents模式）

6. OpenClaw常用管理命令

7. 完整实战步骤（写作助手与代码助手协作）

相关条目

OpenClaw深度教程：多Agent协作、通信与高级编排 摘要

文档概览

关键事实

重要细节

1. OpenClaw配置文件体系

2. 单Agent配置与安全

核心配置参数

单Agent人格定制

OpenClaw安全实践规范（单Agent）

3. 多Agent部署要点

4. OpenClaw多Agent协作机制：跨Agent通信

5. 高级动态编排（subagents模式）

6. OpenClaw常用管理命令

7. 完整实战步骤（写作助手与代码助手协作）

相关条目

OpenClaw深度教程：多Agent协作、通信与高级编排摘要