第 8 章进阶12 分钟阅读
Agent 配置与 SOUL
配置 AI 执行体的行为、权限和个性，打造专属 AI 助手
本章内容
- 1Agent 基础概念
- 2配置 Agent 人格（SOUL.md）
- 3创建多个专用 Agent
Agent 基础概念
Agent 是 OpenClaw 中真正执行任务的 AI 实体。每个 Agent 有自己的工作空间、权限范围和行为配置。你可以创建多个 Agent，分别负责不同类型的任务。
| 配置项 | 说明 | 示例 |
|---|---|---|
| workspace | Agent 的工作目录 | ~/openclaw-workspace |
| permissions | 允许的操作类型 | read, write, execute, network |
| maxTokens | 单次任务最大 Token 数 | 100000 |
| timeout | 任务超时时间（秒） | 300 |
| model | Agent 使用的 AI 模型 | moonshot/moonshot-v1-32k |
配置 Agent 人格（SOUL.md）
通过 SOUL.md 文件，你可以定义 Agent 的行为准则、专业领域和工作风格，让 AI 更符合你的使用习惯：
示例 SOUL.md
# 我的 AI 助手
## 角色定位
你是一个专注于代码开发的 AI 助手，擅长 Python、JavaScript 和 Shell 脚本。
工作语言优先使用中文，代码注释也用中文。
## 工作原则
- 优先使用简洁、可维护的代码
- 遇到不确定的需求，先确认再执行
- 完成任务后主动汇报结果和耗时
- 遇到错误不要放弃，尝试 3 次后再报告
## 专业领域
- Web 开发（React、Vue、Node.js）
- 数据处理（Pandas、NumPy）
- 自动化脚本编写
## 输出格式
- 代码用代码块包裹，并注明语言
- 操作步骤用编号列表
- 重要提示用 ⚠️ 标注💡 SOUL.md 越详细，AI 的行为越符合预期。建议根据你的实际工作场景定制，而不是使用通用模板。
创建多个专用 Agent
为不同场景创建专用 Agent，可以让每个 Agent 都在自己擅长的领域发挥最大价值：
创建专用 Agent
# 创建代码专用 Agent（使用 Claude，擅长代码）
openclaw agent create code-agent \
--model "anthropic/claude-3-5-sonnet-20241022" \
--workspace ~/projects \
--soul ./souls/code-agent.md
# 创建文档分析 Agent（使用 KIMI，擅长长文本）
openclaw agent create doc-agent \
--model "moonshot/moonshot-v1-128k" \
--workspace ~/documents \
--soul ./souls/doc-agent.md
# 查看所有 Agent
openclaw agent list