OpenClaw 简介

OpenClaw 是 Pi 智能体的多平台消息网关，连接您的 AI 智能体与 WhatsApp、Telegram、Discord 和 iMessage，让您通过熟悉的即时通讯应用与智能体自然交互。

核心能力

多平台消息接入

• 飞书 - 企业协作平台，支持机器人私聊和群组（WebSocket 长连接）
• WhatsApp - 绑定 WhatsApp Web，通过个人或专用号码与智能体对话
• Telegram - Bot 模式集成，支持私聊和群组
• Discord - 服务器 Bot 集成，支持频道消息
• iMessage - macOS 原生消息支持
• Mattermost - 企业级协作平台（插件扩展）

智能体工作区

OpenClaw 使用工作区目录管理智能体的操作指令和记忆：

• AGENTS.md - 智能体行为配置
• SOUL.md - 智能体人设与性格定义
• TOOLS.md - 可用工具说明
• IDENTITY.md - 智能体身份信息
• USER.md - 用户偏好设置
• HEARTBEAT.md - 定时任务指令（可选）

默认工作区路径：~/.openclaw/workspace

会话管理

• 会话隔离 - 支持按发送者隔离会话（per-sender 模式）
• 上下文重置 - 通过 /new 或 /reset 指令开始新会话
• 上下文压缩 - /compact 指令压缩长会话，节省 Token
• 自动重置 - 支持按时间或空闲时长自动重置会话

心跳机制（主动模式）

智能体可按配置间隔主动运行检查（默认 30 分钟），执行 HEARTBEAT.md 中定义的维护任务。

典型使用场景

架构示意

您的手机（个人）               第二部手机（助手）
┌─────────────────┐           ┌─────────────────┐
│  您的 WhatsApp  │  ──────▶  │   助手 WA       │
│  +1-555-YOU     │   消息    │  +1-555-ASSIST  │
└─────────────────┘           └────────┬────────┘
                                       │ 二维码绑定
                                       ▼
                              ┌─────────────────┐
                              │  您的服务器/Mac  │
                              │  (openclaw)     │
                              │    Pi 智能体    │
                              └─────────────────┘

安全建议

OpenClaw 赋予智能体以下能力，请谨慎配置：

• 在您的机器上执行命令（取决于 Pi 工具配置）
• 读写工作区文件
• 通过绑定的聊天账号发送消息

推荐做法：

• 始终设置 channels.whatsapp.allowFrom，限制可访问的号码
• 为助手使用专用的 WhatsApp 号码，而非个人号码
• 初始部署时将心跳间隔设为 "0m" 禁用，熟悉后再启用

常用命令

openclaw setup              # 初始化工作区
openclaw status             # 查看本地状态
openclaw status --all       # 完整诊断信息
openclaw dashboard          # 打开 Web 仪表板
openclaw channels login     # 登录消息渠道
openclaw gateway            # 启动网关服务