OpenClaw 是 Pi<\/strong> 智能体的 WhatsApp + Telegram + Discord + iMessage Gateway 网关。插件可添加 Mattermost。本指南是”个人助手”设置：一个专用的 WhatsApp 号码，表现得像你的常驻智能体。<\/p>\n 你正在让智能体处于可以：<\/p>\n 从保守开始：<\/p>\n “`bash theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}} 你需要这样：<\/p>\n 如果你将个人 WhatsApp 关联到 OpenClaw，发给你的每条消息都会变成”智能体输入”。这通常不是你想要的。<\/p>\n “`bash theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}} “`json5 theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}} 完整工作区布局 + 备份指南：智能体工作区<\/a> 可选：使用 “`json5 theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}} OpenClaw 默认为良好的助手设置，但你通常需要调整：<\/p>\n 示例：<\/p>\n “`json5 theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}} 入站附件（图片\/音频\/文档）可以通过模板暴露给你的命令：<\/p>\n 来自智能体的出站附件：在单独一行包含 OpenClaw 会提取这些并将它们作为媒体与文本一起发送。<\/p>\n 日志位于 个人助手设置 ߳ […]<\/p>\n","protected":false},"author":0,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"class_list":["post-268","post","type-post","status-publish","format-standard","hentry","category-docs"],"_links":{"self":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/268","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/comments?post=268"}],"version-history":[{"count":2,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/268\/revisions"}],"predecessor-version":[{"id":781,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/268\/revisions\/781"}],"wp:attachment":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/media?parent=268"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/categories?post=268"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/tags?post=268"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}⚠️ 安全第一<\/h2>\n
\n
\n
channels.whatsapp.allowFrom<\/code>（永远不要在你的个人 Mac 上对全世界开放）。<\/li>\nagents.defaults.heartbeat.every: \"0m\"<\/code> 来禁用。<\/li>\n<\/ul>\n先决条件<\/h2>\n
\n
\nnpm install -g openclaw@latest<\/p>\n或：pnpm add -g openclaw@latest<\/h1>\n
\n从源代码（开发）：\n\n```bash theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\ngit clone https:\/\/github.com\/openclaw\/openclaw.git\ncd openclaw\npnpm install\npnpm ui:build # 首次运行时自动安装 UI 依赖\npnpm build\npnpm link --global\n<\/code><\/pre>\n双手机设置（推荐）<\/h2>\n
你的手机（个人） 第二部手机（助手）\n┌─────────────────┐ ┌─────────────────┐\n│ 你的 WhatsApp │ ──────▶ │ 助手 WA │\n│ +1-555-YOU │ 消息 │ +1-555-ASSIST │\n└─────────────────┘ └────────┬────────┘\n │ 通过二维码关联\n ▼\n ┌─────────────────┐\n │ 你的 Mac │\n │ (openclaw) │\n │ Pi 智能体 │\n └─────────────────┘\n<\/code><\/pre>\n5 分钟快速开始<\/h2>\n
\n
\nopenclaw channels login<\/p>\n\n2. 启动 Gateway 网关（保持运行）：\n\n```bash theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\nopenclaw gateway --port 18789\n<\/code><\/pre>\n\n
~\/.openclaw\/openclaw.json<\/code> 中放置最小配置：<\/li>\n<\/ol>\n
\n{
\n channels: { whatsapp: { allowFrom: [“+15555550123”] } },
\n}<\/p>\n\n现在从你允许列表中的手机向助手号码发消息。\n\n新手引导完成后，我们会自动打开带有 Gateway 网关令牌的仪表板并打印带令牌的链接。稍后重新打开：`openclaw dashboard`。\n\n## 给智能体一个工作区（AGENTS）\n\nOpenClaw 从其工作区目录读取操作指令和\"记忆\"。\n\n默认情况下，OpenClaw 使用 `~\/.openclaw\/workspace` 作为智能体工作区，并会在设置\/首次智能体运行时自动创建它（加上起始的 `AGENTS.md`、`SOUL.md`、`TOOLS.md`、`IDENTITY.md`、`USER.md`）。`BOOTSTRAP.md` 仅在工作区是全新的时候创建（删除后不应再出现）。\n\n提示：将此文件夹视为 OpenClaw 的\"记忆\"，并将其设为 git 仓库（最好是私有的），这样你的 `AGENTS.md` + 记忆文件就有了备份。如果安装了 git，全新的工作区会自动初始化。\n\n```bash theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\nopenclaw setup\n<\/code><\/pre>\n
\n记忆工作流：记忆<\/a><\/p>\nagents.defaults.workspace<\/code> 选择不同的工作区（支持 ~<\/code>）。<\/p>\n
\n{
\n agent: {
\n workspace: “~\/.openclaw\/workspace”,
\n },
\n}<\/p>\n\n如果你已经从仓库提供了自己的工作区文件，可以完全禁用引导文件创建：\n\n```json5 theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\n{\n agent: {\n skipBootstrap: true,\n },\n}\n<\/code><\/pre>\n将其变成”助手”的配置<\/h2>\n
\n
SOUL.md<\/code> 中的人设\/指令<\/li>\n
\n{
\n logging: { level: “info” },
\n agent: {
\n model: “anthropic\/claude-opus-4-5”,
\n workspace: “~\/.openclaw\/workspace”,
\n thinkingDefault: “high”,
\n timeoutSeconds: 1800,
\n \/\/ 从 0 开始；稍后启用。
\n heartbeat: { every: “0m” },
\n },
\n channels: {
\n whatsapp: {
\n allowFrom: [“+15555550123”],
\n groups: {
\n “*”: { requireMention: true },
\n },
\n },
\n },
\n routing: {
\n groupChat: {
\n mentionPatterns: [“@openclaw”, “openclaw”],
\n },
\n },
\n session: {
\n scope: “per-sender”,
\n resetTriggers: [“\/new”, “\/reset”],
\n reset: {
\n mode: “daily”,
\n atHour: 4,
\n idleMinutes: 10080,
\n },
\n },
\n}<\/p>\n\n## 会话和记忆\n\n* 会话文件：`~\/.openclaw\/agents\/<agentId>\/sessions\/{{SessionId}}.jsonl`\n* 会话元数据（token 使用量、最后路由等）：`~\/.openclaw\/agents\/<agentId>\/sessions\/sessions.json`（旧版：`~\/.openclaw\/sessions\/sessions.json`）\n* `\/new` 或 `\/reset` 为该聊天启动新会话（可通过 `resetTriggers` 配置）。如果单独发送，智能体会回复一个简短的问候来确认重置。\n* `\/compact [instructions]` 压缩会话上下文并报告剩余的上下文预算。\n\n## 心跳（主动模式）\n\n默认情况下，OpenClaw 每 30 分钟运行一次心跳，提示词为：\n`Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.`\n设置 `agents.defaults.heartbeat.every: \"0m\"` 来禁用。\n\n* 如果 `HEARTBEAT.md` 存在但实际上是空的（只有空行和 markdown 标题如 `# Heading`），OpenClaw 会跳过心跳运行以节省 API 调用。\n* 如果文件不存在，心跳仍然运行，模型决定做什么。\n* 如果智能体回复 `HEARTBEAT_OK`（可选带有短填充；参见 `agents.defaults.heartbeat.ackMaxChars`），OpenClaw 会为该心跳抑制出站投递。\n* 心跳运行完整的智能体轮次 — 更短的间隔会消耗更多 token。\n\n```json5 theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\n{\n agent: {\n heartbeat: { every: \"30m\" },\n },\n}\n<\/code><\/pre>\n媒体输入和输出<\/h2>\n
\n
{{MediaPath}}<\/code>（本地临时文件路径）<\/li>\n{{MediaUrl}}<\/code>（伪 URL）<\/li>\n{{Transcript}}<\/code>（如果启用了音频转录）<\/li>\n<\/ul>\nMEDIA:<path-or-url><\/code>（无空格）。示例：<\/p>\n这是截图。\nMEDIA:https:\/\/example.com\/screenshot.png\n<\/code><\/pre>\n运维检查清单<\/h2>\n
bash theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}
\nopenclaw status # 本地状态（凭证、会话、排队事件）
\nopenclaw status --all # 完整诊断（只读，可粘贴）
\nopenclaw status --deep # 添加 Gateway 网关健康探测（Telegram + Discord）
\nopenclaw health --json # Gateway 网关健康快照（WS）<\/code><\/p>\n\/tmp\/openclaw\/<\/code>（默认：openclaw-YYYY-MM-DD.log<\/code>）。<\/p>\n下一步<\/h2>\n
\n