OpenClaw 配置指南：打造个性化 AI 助手
安装完 OpenClaw 只是开始，真正的价值在于定制——让你的 AI 助手拥有独特的个性、记忆和工作方式。下面咱们一步步来梳理核心配置。
核心配置文件概览
OpenClaw 的配置主要依赖几个 Markdown 文件，它们分别定义了助手的不同维度：
| 文件 | 作用 |
|---|---|
| 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
接入大模型服务
OpenClaw 需要连接大模型才能运行。以阿里云 DashScope（通义千问）为例，可以通过环境变量或配置命令设置 API Key。
# 方式 1：使用配置命令
openclaw configure --section models
# 方式 2：设置环境变量
export DASHSCOPE_API_KEY="sk-xxxxxxxxxxxxxx"
常用模型选择参考：
| 模型 | 适用场景 | 成本 |
|---|---|---|
| qwen-plus | 日常对话、写作 | 中等 |
| qwen-max | 复杂推理、代码 | 较高 |
| qwen-turbo | 快速响应、简单任务 | 低 |
连接聊天平台
根据需求，你可以将助手连接到不同的即时通讯工具。
# Telegram
openclaw configure --section telegram
# WhatsApp
openclaw configure --section whatsapp
# Discord
openclaw configure --section discord
扩展能力与主动服务
除了基础对话，还可以配置本地工具和定时任务。
工具配置 (TOOLS.md)
记录 SSH 主机、TTS 语音偏好等。
# 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
常见问题
Q: 配置错了如何恢复？ 可以直接重新初始化：
openclaw init --reset
Q: 如何备份配置？ 建议使用 Git 管理，或者手动复制工作空间：
# 备份整个工作空间
cp -r ~/openclaw-workspace ~/openclaw-backup-$(date +%Y%m%d)
# 或者使用 git 版本控制
cd ~/openclaw-workspace
git init
git add .
git commit -m "Initial config"
最佳实践
- 循序渐进：先配基础功能，再逐步扩展。
- 版本控制：强烈建议用 Git 管理配置文件，方便回滚。
- 定期备份：重要配置定期备份，防止数据丢失。
- 文档化：在配置文件中添加注释，方便后续维护。
- 测试验证：每次修改后最好测试一下功能是否正常。
配置完成后，就可以开始和助手日常对话了。如果后续需要开发自定义技能，可以参考相关开发文档。
