OpenClaw 配置指南 - 定制你的 AI 助手个性

📅 更新时间：2026 年 3 月
🎯 适合人群：已经安装 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

---

配置最佳实践

✅ 推荐做法：

1. 循序渐进 - 先配置基础功能，再逐步扩展
2. 版本控制 - 用 git 管理配置文件
3. 定期备份 - 重要配置定期备份
4. 文档化 - 在配置文件中添加注释
5. 测试验证 - 每次修改后测试功能

❌ 避免做法：

1. 不要硬编码敏感信息
2. 不要一次性配置太多
3. 不要忽略错误提示

---

下一步

配置完成后，你可以：

1. 📝 开始和助手日常对话
2. 🔧 安装技能扩展功能
3. 📱 连接更多聊天平台
4. 🧪 尝试高级功能

---

资源链接

• 📚 官方文档：https://docs.openclaw.ai
• 💬 社区 Discord：https://discord.com/invite/clawd
• 🐙 GitHub 源码：https://github.com/openclaw/openclaw
• 🔌 技能市场：https://clawhub.com
• 📖 上一篇：OpenClaw 安装教程

---

有问题？ 欢迎在评论区留言讨论！

觉得有帮助请点赞收藏支持～ 👍

下一篇预告：《OpenClaw 技能开发 - 创建第一个自定义技能》🚀