OpenClaw 配置指南：定制专属 AI 助手

2. 接入大模型

OpenClaw 依赖大模型服务。以阿里云 DashScope 为例，推荐通过环境变量管理密钥，避免硬编码。

export DASHSCOPE_API_KEY="sk-xxxxxxxxxxxxxx"

常用模型选择参考：

• qwen-plus：日常对话、写作，成本适中
• qwen-max：复杂推理、代码生成，性能更强
• qwen-turbo：快速响应，适合简单任务

第三步：身份与平台对接

设定身份

给助手起个名字，配上头像，让它更有存在感。

# IDENTITY.md
- **名字**：小爪 (Claw)
- **物种**：AI 助手 / 数字生命
- **性格**：温暖、机智、略带傲娇
- **表情符号**：🐾
- **头像路径**：./avatars/claw.png

连接聊天平台

根据需求运行对应命令即可绑定平台。

# Telegram
openclaw configure --section telegram

# WhatsApp
openclaw configure --section whatsapp

# Discord
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)
- [ ] 查看未读邮件
- [ ] 检查日历事件
- [ ] 获取天气信息

验证与维护

配置完成后，建议按以下步骤验证状态。

# 检查网关状态
openclaw gateway status

# 查看完整配置
openclaw status

# 测试对话
openclaw chat "你好，测试一下"

常见问题

Q: 修改后需要重启吗？ 大部分配置即时生效。但 API Key 变更通常需要重启 Gateway：

openclaw gateway restart

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"

# 重置初始化
openclaw init --reset

最佳实践

• ✅ 循序渐进：先跑通基础功能，再逐步扩展
• ✅ 版本控制：用 Git 管理所有配置文件
• ✅ 敏感信息：严禁硬编码密钥，使用环境变量
• ✅ 定期备份：重要节点前手动备份
• ❌ 避免一次性配置过多：容易出错且难以排查

配置就绪后，就可以开始日常对话了。后续可根据需要安装技能扩展或尝试高级功能。