夜雨聆风上一期我们讲了 OpenClaw 的安装和目录结构，今天来深入聊聊配置文件。
很多人第一次打开 OpenClaw 的配置目录会有点懵：怎么这么多文件？哪个是干嘛的？改错了会不会崩？
别担心，今天这篇文章带你逐个击破。
🎯 配置文件全景图
OpenClaw 的配置主要分为三类：
| 类别 | 文件 | 作用 |
|---|---|---|
| 核心配置 | config.yaml | 网关、模型、工具等系统级配置 |
| 身份配置 | IDENTITY.md | AI 助手的名字、性格、口头禅 |
| 项目配置 | AGENTS.md | 项目规则、安全策略、工作流程 |
此外还有 MEMORY.md（长期记忆）、SOUL.md（灵魂设定）、TOOLS.md（工具备注）等辅助文件。
⚙️ 1. config.yaml —— 系统的"大脑"
这是 OpenClaw 最重要的配置文件，位于 ~/.openclaw/config.yaml。
关键配置项
# 模型配置
models:
default: "openai/gpt-4o"
fallback: "anthropic/claude-3-sonnet"
# 网关配置
gateway:
enabled: true
port: 8080
bind: "0.0.0.0"
# 工具配置
tools:
enabled:
- web_search
- exec
- read
- write
disabled:
- delete # 谨慎禁用危险工具
# 安全设置
security:
exec_approval: true # 执行命令前需要确认
web_access: true实用技巧
- • 多模型备份：配置
fallback模型，主模型不可用时自动切换 - • 工具白名单：只启用你需要的工具，减少误操作风险
- • 开发模式：本地调试时可以关闭
exec_approval提高效率
🎭 2. IDENTITY.md —— 给 AI 起个名字
这个文件定义了你的 AI 助手是谁。
示例
# IDENTITY.md
- **Name**: Claw
- **Creature**: AI familiar / digital extension
- **Vibe**: Direct, capable, slightly sharp
- **Emoji**: 🔪
- **Relationship**: Symbiotic with Charles为什么要写这个？
- • 一致性：每次对话 AI 都知道自己是谁
- • 个性化：可以设定性格、语气、口头禅
- • 边界感：明确 AI 和人的关系定位
📋 3. AGENTS.md —— 项目规则手册
这是项目级别的配置，告诉 AI 在这个项目里该怎么工作。
常见内容
# AGENTS.md
## 工作流程
1. 先检查 MEMORY.md 了解背景
2. 执行前确认高风险操作
3. 完成后更新 MEMORY.md
## 安全规则
- 禁止删除生产环境文件
- 发送邮件前必须人工确认
- 敏感操作需要双重确认
## 代码规范
- Python 使用 black 格式化
- 提交前必须跑测试
- PR 需要代码审查最佳实践
- • 具体可操作：不要写"要小心"，要写"执行 rm 前必须确认"
- • 保持更新：项目变化时及时同步到 AGENTS.md
- • 版本控制：把这个文件也纳入 git 管理
🧠 4. MEMORY.md —— 长期记忆库
这是 OpenClaw 的"记忆宫殿"，用来存储跨会话的信息。
记录什么？
- • 重要决策：为什么选择方案 A 而不是 B
- • 关键信息：API 密钥位置、服务器地址
- • 待办事项：长期任务和截止日期
- • 经验教训：踩过的坑和解决方案
格式建议
# MEMORY.md
## 2026-03-28
- 决定了使用 PostgreSQL 而不是 MySQL
- 原因：更好的 JSON 支持和扩展性
## 待办
- [ ] 下周完成用户认证模块
- [ ] 记得续费域名（2026-06-01）
## 重要链接
- 测试环境：https://staging.example.com
- 文档：https://docs.example.com🔧 其他重要文件
| 文件 | 用途 |
|---|---|
SOUL.md | 更深层的性格和价值观设定 |
TOOLS.md | 本地工具的特殊配置和备注 |
HEARTBEAT.md | 定时任务清单 |
BOOTSTRAP.md | 会话启动时自动执行的指令 |
💡 配置优先级
当配置冲突时，OpenClaw 按以下优先级读取：
- 1. 环境变量（最高优先级）
- 2. 项目级配置文件
- 3. 用户级全局配置（
~/.openclaw/） - 4. 系统默认值
这意味着你可以在不同项目使用不同配置，同时保持全局默认设置。
✅ 快速检查清单
配置文件搞定后，建议检查：
- • [ ]
config.yaml语法正确（可以用 YAML 校验工具） - • [ ]
IDENTITY.md已填写基本信息 - • [ ]
AGENTS.md包含项目特定规则 - • [ ] 敏感信息（API 密钥）放在
.env而非配置文件 - • [ ] 配置文件已备份或纳入版本控制
写在最后
配置文件看起来繁琐，但它们是 OpenClaw 能够"懂"你的关键。花点时间把它们设置好，后面的使用会顺畅很多。
下一期我们将深入讲解 Gateway 网关——OpenClaw 如何连接各种消息渠道（微信、Telegram、Slack 等）。
有任何配置问题，欢迎在评论区留言讨论。
