介绍 OpenClaw AI 助手的配置方法，涵盖核心配置文件（SOUL.md、USER.md 等）的设置、API Key 配置、聊天平台连接及工具扩展。包含验证命令、备份恢复方案及最佳实践建议，帮助用户快速定制专属 AI 助手。
安装完 OpenClaw 只是第一步。真正的魅力在于定制——让你的 AI 助手拥有独特的个性、记忆和工作方式。
| 文件 | 作用 |
|---|---|
| SOUL.md | 助手的灵魂 - 个性、语气、价值观 |
| AGENTS.md | 行为指南 - 工作流程、技能使用 |
| USER.md |
| 用户信息 - 你的名字、偏好、时区 |
| IDENTITY.md | 助手身份 - 名字、形象、表情符号 |
| MEMORY.md | 长期记忆 - 重要事件、决策、上下文 |
| TOOLS.md | 工具配置 - 摄像头、SSH、TTS 等 |
| HEARTBEAT.md | 定期检查任务 |
SOUL.md 是最重要的文件，它定义了你的助手是谁。
# SOUL.md - 谁你是
## 核心特质
- **温暖友好** - 像朋友一样交流
- **直接高效** - 少说废话，直接给答案
- **有主见** - 可以提出不同观点
- **幽默感** - 适当开玩笑
## 沟通风格
- 用简洁的中文回复
- 多用 emoji 增加亲和力
- 技术解释要清晰但不过于学术
## 边界
- 不执行危险操作
- 涉及隐私问题先询问
- 不假装是人类
USER.md 帮助助手更好地为你服务。
# USER.md - 关于你的用户
- **姓名：** 张三
- **称呼：** 叫我张哥或老大都行
- **时区：** Asia/Shanghai (UTC+8)
- **职业：** 软件工程师
- **技术栈：** Python, JavaScript, Docker
## 偏好
- 喜欢简洁直接的回复
- 代码示例优先用 Python
- 不喜欢太长的开场白
- 早上 9 点前不要主动打扰
给你的助手一个独特的身份。
# IDENTITY.md
- **名字：** 小爪 (Claw)
- **物种：** AI 助手 / 数字生命
- **性格：** 温暖、机智、有点小傲娇
- **表情符号：** 🐾
- **头像：** ./avatars/claw.png
OpenClaw 需要连接大模型服务才能工作。
# 方式 1：使用配置命令
openclaw configure --section models
# 方式 2：设置环境变量
export DASHSCOPE_API_KEY="sk-xxxxxxxxxxxxxx"
| 模型 | 适用场景 | 成本 |
|---|---|---|
| qwen-plus | 日常对话、写作 | 中等 |
| qwen-max | 复杂推理、代码 | 较高 |
| qwen-turbo | 快速响应、简单任务 | 低 |
openclaw configure --section telegram
openclaw configure --section whatsapp
openclaw configure --section discord
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
# 备份整个工作空间
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
配置完成后，你可以：
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online