AI-Wiki

基本定义

OpenClaw是开源的通用多智能体协作开发框架，支持开发者自定义不同角色、大模型、权限规则的AI智能体（Agent），通过内置的跨Agent通信、动态任务编排机制实现多智能体像真实团队一样分工协作，完成单Agent无法高效处理的复杂任务。

本页面所有配置规则、管理命令均适配 OpenClaw 2026.2.26 版本，其他版本可能存在参数逻辑差异。

核心能力

1. 单/多Agent灵活配置

OpenClaw采用分层配置体系，配置优先级从高到低为：命令行参数 > 环境变量 > Agent特有配置 > 全局默认配置 > 内置默认值。

单Agent模式下所有配置集中在全局默认配置段，核心参数包括工作目录、主模型ID、输出随机性参数temperature、[[上下文压缩策略]]、空闲心跳重置规则、记忆搜索开关、工具权限白名单等，可通过工作目录下的SOUL.md（核心人格与职责定义）、MEMORY.md（自动更新的长期记忆）、USER.md（用户专属信息）定制Agent行为。
多Agent模式下通过agents.list数组为每个Agent配置独立唯一ID、专属工作区、调用模型、权限范围，实现角色分离、任务并行、专业能力差异化分配。

2. agentToAgent跨Agent通信

内置原生跨Agent通信能力，开启后仅白名单内的Agent可通过@目标Agent ID的格式主动向其他Agent发送任务请求，协作过程对用户透明，可通过会话查询命令查看全量内部通信日志。

3. subagents动态编排

支持编排器工作模式，主Agent可根据任务复杂度自动分解任务并动态创建子Agent执行子任务，可配置的编排参数包括：子Agent可继续创建子Agent的深度上限、单个Agent最多同时拥有的子Agent数量、全局并发子Agent上限、子Agent默认调用模型、思考强度（影响token消耗）等，尤其适合处理多领域知识交叉的复杂任务。

4. 内置全链路安全管控体系

覆盖从单Agent到多Agent全场景的安全防护能力：

单Agent层面要求工具权限最小化（仅用白名单开放必需工具，高危工具如shell.execute非必要绝不开启）、网关绑定本地回环地址避免外部访问、采用32位以上随机字符串作为认证令牌、定期执行深度安全审计。
多Agent层面要求每个Agent配置独立物理隔离工作区防止恶意操作扩散、通信白名单仅放行必要协作Agent、每个Agent单独配置最小权限集合、定期巡检异常通信与权限溢出风险。

配置文件体系

OpenClaw核心配置文件与目录结构如下：

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

适用场景

个人智能助手搭建：可快速配置单Agent实现知识查询、日程管理、资料整理等个人效率需求，也可扩展多Agent实现写作、代码、学习辅导等多角色专属助手协同工作。
企业级多Agent协同任务系统开发：可基于其安全管控、动态编排能力搭建复杂业务流程的自动化系统，如内容生产流水线、代码开发协同平台、全渠道智能客服体系等。

常用管理命令

命令	作用
`openclaw gateway start`	启动网关服务（框架运行必需前置操作）
`openclaw agents list`	查看所有Agent运行状态与基础配置
`openclaw msg --agent <id> "消息"`	向指定ID的Agent发送任务消息
`openclaw sessions list --agent <id>`	查看指定Agent的会话列表（含内部跨Agent通信记录）
`openclaw agentToAgent status`	查看跨Agent通信模块运行状态与白名单列表
`openclaw doctor --fix`	自动检查配置逻辑错误并尝试修复
`openclaw security audit --deep`	执行全链路深度安全审计，输出风险报告
更多命令说明可参考OpenClaw常用管理命令。

OpenClaw