个人助手设置
本页介绍如何将 OpenClaw 打造成你的全天候个人助手——通过 WhatsApp、Telegram 等渠道随时随地与 Agent（智能体）交流，管理日程、处理邮件、执行自动化任务。
安全第一
在开始之前，请务必理解以下安全要点：
allowFrom白名单 — 务必配置允许发送消息的号码白名单，防止陌生人操控你的 Agent- 专用号码 — 强烈建议使用专用手机号而非个人主号
- Heartbeat（心跳）检查 — 启用定期健康检查，确保 Agent 持续在线
双手机方案（推荐）
为了安全和稳定性，推荐使用两部手机的方案：
| 手机 | 用途 | 说明 |
|---|---|---|
| 主手机 | 日常使用 | 你的个人主号，用于给 Agent 发消息 |
| Agent 手机 | 运行 Agent | 专用号码，配对到 OpenClaw Gateway |
这样做的好处：
- 🔒 Agent 号码与个人号码隔离，避免安全风险
- 📱 Agent 号码可以 24/7 在线，不影响个人手机使用
- 🛡️ 即使 Agent 出问题，也不会影响你的个人通讯
五分钟快速启动
第一步：配对 WhatsApp
在 Agent 手机上打开 WhatsApp，然后在 Gateway 主机上运行：
openclaw channels pair whatsapp用 Agent 手机扫描终端中显示的二维码完成配对。
第二步：启动 Gateway（网关）
openclaw gateway --port 18789或者如果你已经安装了守护服务：
openclaw gateway status
# 确认 Gateway 正在运行第三步：最小配置
确保你的 ~/.openclaw/openclaw.json 中包含以下最小配置：
{
"gateway": {
"port": 18789
},
"models": {
"default": "openai:gpt-4o"
},
"channels": {
"whatsapp": {
"enabled": true,
"allowFrom": ["+86138xxxx0001"]
}
}
}第四步：发送第一条消息
从你的主手机给 Agent 手机号发一条 WhatsApp 消息，验证 Agent 是否正常回复。
✅ 验证
如果 Agent 正常回复，恭喜！你的个人助手已经就绪。
工作空间与 AGENTS.md
Agent 的工作空间是它的"大脑"所在。工作空间中的 AGENTS.md 文件定义了 Agent 的角色和行为：
# Agents
## assistant
- Model: openai:gpt-4o
- Role: Personal assistant
- Skills: calendar, email, reminders, web-search
- Language: zh-CN
- Timezone: Asia/Shanghai
### Instructions
- 优先使用中文回复
- 每天早上 8:00 发送日程提醒
- 收到邮件摘要后自动分类
- 重要事项需要确认后才执行你可以通过编辑 AGENTS.md 来自定义 Agent 的行为，修改后无需重启 Gateway 即可生效。
助手模式配置
在 openclaw.json 中配置助手模式的完整选项：
{
"assistant": {
"mode": "personal",
"language": "zh-CN",
"timezone": "Asia/Shanghai",
"allowFrom": ["+86138xxxx0001", "+86139xxxx0002"],
"autoApprove": ["calendar.read", "email.read"],
"requireApproval": ["email.send", "file.delete", "system.exec"]
}
}| 配置项 | 说明 |
|---|---|
mode | 助手模式：personal（个人）/ team（团队） |
language | 默认回复语言 |
timezone | 时区，影响定时任务 |
allowFrom | 白名单号码列表 |
autoApprove | 自动批准的操作类型 |
requireApproval | 需要人工确认的操作类型 |
会话与记忆（Sessions & Memory）
OpenClaw 支持会话管理，让你与 Agent 的对话更有条理：
常用会话命令
| 命令 | 说明 |
|---|---|
/new | 开始一个全新的会话，清除当前对话上下文 |
/reset | 重置 Agent 状态，清除所有会话和临时记忆 |
/compact | 压缩当前会话的上下文，保留关键信息，释放 Token 空间 |
你: /new
Agent: ✨ 新会话已开始。有什么需要帮忙的吗？
你: /compact
Agent: 📦 会话已压缩。保留了 3 个关键上下文点，释放了 12,000 tokens。
你: /reset
Agent: 🔄 状态已重置。所有临时记忆已清除。关于记忆
/reset 只清除临时会话记忆，不会删除工作空间中的身份文件和长期记忆。如果你需要完全重置 Agent，请参阅 Agent 引导。
Heartbeat（心跳模式）
Heartbeat（心跳）是 OpenClaw 的主动模式——Agent 不仅被动回复消息，还能主动发起对话和执行任务。
启用 Heartbeat
在工作空间中创建 HEARTBEAT.md 文件：
# Heartbeat
## Schedule
- Every day at 08:00: Morning briefing (日程、天气、重要邮件摘要)
- Every day at 22:00: Daily summary (今日完成事项、明日待办)
- Every 4 hours: Check email for urgent items
## Triggers
- New calendar event: Send reminder 15 minutes before
- Unread email from VIP list: Notify immediately
- System health alert: Notify on gateway issuesHeartbeat 配置
在 openclaw.json 中启用：
{
"heartbeat": {
"enabled": true,
"configFile": "HEARTBEAT.md",
"defaultInterval": "4h",
"quietHours": {
"start": "23:00",
"end": "07:00"
}
}
}注意
启用 Heartbeat 后，Agent 会主动给你发消息。请合理设置 quietHours（免打扰时段），避免半夜收到 Agent 的消息。
媒体输入与输出（Media I/O）
OpenClaw 支持通过消息渠道收发媒体文件：
输入（接收）
- 📸 图片 — Agent 可以理解你发送的图片内容（需要多模态模型支持）
- 🎤 语音 — 语音消息会自动转文字后处理
- 📄 文档 — PDF、Word 等文档可以被读取和分析
- 📍 位置 — 接收位置信息用于基于地理位置的任务
输出（发送）
- 📝 文字 — 默认回复格式
- 🖼️ 图片 — 生成的图表、截图等
- 📎 文件 — 导出的文档、报告等
- 🎵 语音 — 文字转语音回复（需要 TTS 技能）
运维检查清单
上线个人助手前，请确认以下事项：
- [ ]
allowFrom白名单已配置 — 只有白名单中的号码可以控制 Agent - [ ] 专用号码已配对 — 不要使用个人主号
- [ ] Gateway 后台运行 — 使用守护服务或 systemd 确保 24/7 在线
- [ ] Heartbeat 免打扰时段 — 设置合理的 quiet hours
- [ ] 操作审批策略 — 敏感操作（如发送邮件、删除文件）需要人工确认
- [ ] 备份工作空间 — 定期备份
~/.openclaw/workspace/ - [ ] 监控日志 — 定期检查 Gateway 日志确认运行正常
# 检查 Gateway 状态
openclaw gateway status
# 查看最近日志
openclaw logs --tail 50
# 验证渠道连接
openclaw channels status