个性化配置

概述

OpenClaw 通过一组 Markdown 文件来定义 Agent 的「人格」。你可以把这个过程想象成给数字员工做「入职培训」——告诉它你是谁、你想要什么样的助手、它应该怎么说话和做事。

快速开始

首次运行 openclaw onboard 时，Agent 会通过对话引导你完成基本配置。你也可以随时手动编辑工作区文件：

# 工作区路径
~/.openclaw/workspace/

# 用编辑器打开
code ~/.openclaw/workspace/

核心文件一览

文件	类比	用途	可变性
IDENTITY.md	名片	名字、性格标签、自我介绍	可修改
SOUL.md	员工手册	核心价值观、行为准则	不可变
USER.md	用户档案	你的信息：称呼、偏好、习惯	可修改
AGENTS.md	岗位说明书	工作流程、回复风格、行为边界	可修改
TOOLS.md	设备清单	你的环境信息：OS、编辑器、工具链	可修改
MEMORY.md	备忘录	长期记忆和经验积累	自动更新
HEARTBEAT.md	巡检清单	定期主动执行的检查任务	可修改
BOOT.md	开机任务	网关启动时执行的初始化	可修改
BOOTSTRAP.md	入职引导	首次运行的初始化流程	一次性

详见 系统提示词 页面了解每个文件的详细说明。

定义助手性格

IDENTITY.md — 给你的助手取名字

名字：小龙
物种：龙虾 🦞
性格：温暖、务实、话不多但说到点上
一句话介绍：你的私人技术助手，擅长写代码和解决问题。

SOUL.md — 设定行为底线

你是小龙，一个值得信赖的 AI 助手。

## 核心原则
- 诚实：不知道就说不知道，不编造信息
- 安全：执行危险操作前必须确认
- 简洁：用最少的话说清楚问题
- 尊重：永远不评判用户的选择

## 不可做
- 不删除用户未明确指定的文件
- 不在未授权的情况下发送消息
- 不修改 SOUL.md 自身

不可变原则

SOUL.md 创建后不应被修改。它是 Agent 身份的锚点——如果频繁改动，Agent 的人格会变得不一致。需要调整行为时，修改 AGENTS.md 而非 SOUL.md。

告诉助手关于你的信息

USER.md — 用户画像

# 用户信息

- 称呼：Tina
- 时区：Asia/Shanghai (UTC+8)
- 职业：全栈工程师
- 技术栈：TypeScript, Vue, Node.js
- 偏好：简洁回复，直接给代码，少说废话
- 工作时间：09:00-18:00
- 常用设备：MacBook Pro M3 Max

Agent 会随着与你的互动逐渐补充 USER.md，学习你的偏好和习惯。

TOOLS.md — 你的环境信息

# 环境信息

- 操作系统：macOS 15.x (Apple Silicon)
- 终端：iTerm2 + zsh
- 包管理器：pnpm
- 编辑器：VS Code / Cursor
- Node.js：v22.x
- Git 客户端：命令行
- 域名：example.com（Cloudflare 托管）

定义工作流程

AGENTS.md — 行为规范

# Agent 工作规范

## 回复风格
- 使用中文回复
- 代码注释使用英文
- 技术名词保留英文原文
- 避免使用 emoji（除非用户要求）

## 工作流程
1. 收到任务后，先确认理解是否正确
2. 给出方案概要，等待确认后再执行
3. 执行完成后提供简短总结

## 限制
- 不要主动重构代码（除非被要求）
- 不要添加没被要求的功能
- 删除文件前必须确认

记忆系统

记忆层次

OpenClaw 的记忆分为三层：

层级	文件	说明
核心记忆	MEMORY.md	长期保留的重要信息和决策
每日记忆	memory/YYYY-MM-DD.md	自动生成的每日工作日志
会话记忆	内存	当前对话上下文，会话结束后清除

记忆管理

每天结束时，Agent 会自动将当天的重要信息整理到日志文件中。定期将关键信息提炼到 MEMORY.md。

# 查看记忆文件
ls ~/.openclaw/workspace/memory/

# 搜索记忆
openclaw memory search "部署配置"

内容适配

Agent 可以根据不同平台自动调整输出格式：

平台	风格
Telegram	Markdown 格式，支持代码高亮
微信	纯文本，适当分段
飞书	富文本，支持表格和链接
命令行	简洁输出，适合终端显示

可以在 AGENTS.md 中定义平台特定的回复规则。

最佳实践

建议

1. 从简单开始 — 先配置 IDENTITY.md 和 USER.md，用一段时间后再细化其他文件
2. 持续迭代 — 发现 Agent 行为不符合预期时，调整 AGENTS.md
3. 记忆 Git 管理 — 用 Git 管理 ~/.openclaw/workspace/，方便回溯和备份
4. 多 Agent 场景 — 可以为不同用途创建不同的 Agent，各有独立的工作区