OpenClaw 配置指南：定制 AI 助手个性
安装完 OpenClaw 只是第一步，真正的价值在于定制。通过配置文件，你可以赋予 AI 助手独特的个性、记忆和工作方式，让它真正懂你。
核心配置文件概览
| 文件 | 作用 |
|---|---|
| SOUL.md | 助手的'灵魂' - 定义个性、语气、价值观 |
| AGENTS.md | 行为指南 - 工作流程、技能使用 |
| USER.md | 用户信息 - 你的名字、偏好、时区 |
| IDENTITY.md | 助手身份 - 名字、形象、表情符号 |
| MEMORY.md | 长期记忆 - 重要事件、决策、上下文 |
| TOOLS.md | 工具配置 - 摄像头、SSH、TTS 等 |
| HEARTBEAT.md | 定期检查任务 |
第一步：定义助手的灵魂 (SOUL.md)
SOUL.md 是最核心的文件，它决定了助手是'谁'。这里需要明确它的沟通风格和边界。
# SOUL.md - 谁你是
## 核心特质
- **温暖友好**：像朋友一样交流
- **直接高效**：少说废话，直接给答案
- **有主见**：可以提出不同观点
- **幽默感**：适当开玩笑
## 沟通风格
- 用简洁的中文回复
- 多用 emoji 增加亲和力
- 技术解释要清晰但不过于学术
## 边界
- 不执行危险操作
- 涉及隐私问题先询问
- 不假装是人类
第二步：让助手了解你 (USER.md)
为了让服务更贴心，需要在 USER.md 中提供你的背景信息。注意，敏感信息建议不要明文硬编码，而是通过环境变量或加密存储。
# USER.md - 关于你的用户
## 基本信息
- **姓名：** 张三
- **称呼：** 叫我'张哥'或'老大'都行
- **时区：** Asia/Shanghai (UTC+8)
- **职业：** 软件工程师
- **技术栈：** Python, JavaScript, Docker
## 偏好
- 喜欢简洁直接的回复
- 代码示例优先用 Python
- 不喜欢太长的开场白
- 早上 9 点前不要主动打扰
第三步：设定身份 (IDENTITY.md)
给你的助手一个具体的形象，这有助于在对话中建立更强的代入感。
# IDENTITY.md
- **名字：** 小爪 (Claw)
- **物种：** AI 助手 / 数字生命
- **性格：** 温暖、机智、有点小傲娇
- **表情符号：** 🐾
- **头像：** ./avatars/claw.png
第四步：配置 API Keys
OpenClaw 需要连接大模型服务才能工作。推荐使用环境变量管理密钥，避免泄露风险。
阿里云 DashScope（通义千问）
# 推荐方式：设置环境变量
export DASHSCOPE_API_KEY="sk-xxxxxxxxxxxxxx"
# 或者使用配置命令
openclaw configure --section models
常用模型选择参考：
| 模型 | 适用场景 | 成本 |
|---|---|---|
| qwen-plus | 日常对话、写作 | 中等 |
| qwen-max | 复杂推理、代码 | 较高 |
| qwen-turbo | 快速响应、简单任务 | 低 |
第五步：连接聊天平台
根据需求选择对应的平台进行集成，命令结构类似。
# Telegram
openclaw configure --section telegram
# WhatsApp
openclaw configure --section whatsapp
# Discord
openclaw configure --section discord
第六步：扩展能力 (TOOLS.md)
通过 TOOLS.md 配置本地工具，比如语音合成或远程服务器访问。
# TOOLS.md
## TTS 语音
- 首选声音：Nova（温暖女声）
- 默认语速：1.0
## SSH 主机
- home-server → 192.168.1.100, 用户：admin
第七步：主动服务 (HEARTBEAT.md)
定义助手定期自动检查的任务，实现被动等待到主动服务的转变。
# HEARTBEAT.md
## 每日检查（9:00 AM）
- [ ] 查看未读邮件
- [ ] 检查日历事件
- [ ] 查看天气
验证与调试
配置完成后，运行以下命令检查状态是否正常：
# 检查 Gateway 状态
openclaw gateway status
# 查看所有配置
openclaw status
# 测试对话
openclaw chat "你好，测试一下"
常见问题与最佳实践
修改后需要重启吗？
大部分配置修改后立即生效，无需重启。但 API Key 配置需要重启 Gateway：
openclaw gateway restart
如何备份配置？
建议使用 Git 管理配置文件，方便版本回溯。
# 备份整个工作空间
cp -r ~/openclaw-workspace ~/openclaw-backup-$(date +%Y%m%d)
# 或者使用 git 版本控制
cd ~/openclaw-workspace
git init
git add .
git commit -m"Initial config"
如果配置出错，可以通过重新初始化恢复：
openclaw init --reset
避坑指南
- 循序渐进：先配置基础功能，再逐步扩展。
- 版本控制：务必用 git 管理配置文件。
- 敏感信息：不要硬编码 API Key 或密码。
- 测试验证：每次修改后记得测试功能。
- 文档化：在配置文件中添加注释说明用途。
