OpenClaw 核心配置文件详解:一篇文章搞懂所有配置

上一期我们讲了 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 等）。

有任何配置问题，欢迎在评论区留言讨论。