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（通义千问）：
# 方式 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 - 扩展能力
TOOLS.md 记录你的本地工具配置。
示例配置：
# TOOLS.md
### TTS 语音
- 首选声音：Nova（温暖女声）
- 默认语速：1.0
### SSH 主机
- home-server → 192.168.1.100, 用户：admin
第七步：设置 HEARTBEAT.md - 主动服务
HEARTBEAT.md 定义助手定期检查的任务。
示例配置：
# HEARTBEAT.md
## 每日检查（9:00 AM）
- [ ] 查看未读邮件
- [ ] 检查日历事件
- [ ] 查看天气
配置验证
完成配置后，运行以下命令验证：
# 检查 Gateway 状态
openclaw gateway status
# 查看所有配置
openclaw status
# 测试对话
openclaw chat "你好，测试一下"
常见问题
Q1: 修改配置文件后需要重启吗？
大部分配置修改后立即生效，无需重启。
但 API Key 配置需要重启 Gateway：
openclaw gateway restart
Q2: 如何备份配置？
# 备份整个工作空间
cp -r ~/openclaw-workspace ~/openclaw-backup-$(date +%Y%m%d)
# 或者使用 git 版本控制
cd ~/openclaw-workspace
git init
git add .
git commit -m "Initial config"
Q3: 配置错了如何恢复？
# 重新初始化
openclaw init --reset
配置最佳实践
✅ 推荐做法：
- 循序渐进 - 先配置基础功能，再逐步扩展
- 版本控制 - 用 git 管理配置文件
- 定期备份 - 重要配置定期备份
- 文档化 - 在配置文件中添加注释
- 测试验证 - 每次修改后测试功能
❌ 避免做法：
- 不要硬编码敏感信息
- 不要一次性配置太多
- 不要忽略错误提示
下一步
配置完成后，你可以：
- 开始和助手日常对话
- 安装技能扩展功能
- 连接更多聊天平台
- 尝试高级功能
