OpenClaw从入门到应用——基础知识:快速构建个人助手

OpenClaw从入门到应用——基础知识:快速构建个人助手 通过OpenClaw实现副业收入《OpenClaw赚钱实录从“养龙虾“到可持续变现的实践指南》概述OpenClaw 是一个面向Pi代理的 WhatsApp Telegram Discord iMessage 网关。通过插件还可支持 Mattermost。本指南将引导你完成“个人助手”的设置使用一个专用的 WhatsApp 号码使其成为你全天候在线的智能代理。通过 OpenClaw你可以将即时通讯平台与本地机器上的代理连接起来实现消息响应、文件操作、命令执行等自动化任务。⚠️ 安全第一你即将赋予一个代理以下权限在你的机器上运行命令取决于你的 Pi 工具设置在您的工作空间中读写文件通过 WhatsApp/Telegram/Discord/Mattermost插件发送消息回传因此初始设置请务必保持保守遵循以下原则始终设置访问白名单在配置文件中通过channels.whatsapp.allowFrom明确指定允许与代理通信的手机号码。切勿在个人电脑上开放对全世界的访问权限。使用专用号码为助手准备一个独立的 WhatsApp 号码通过 SIM 卡、eSIM 或预付费卡获得避免将个人号码直接关联到 OpenClaw否则你收到的每条消息都会成为“代理的输入”这通常不是你期望的行为。心跳检测默认启用OpenClaw 默认每 30 分钟运行一次心跳检测主动模式在你完全信任代理行为之前可以通过设置agents.defaults.heartbeat.every: 0m来禁用它。前置要求已安装并完成初始化的 OpenClaw —— 如果尚未完成请参阅 入门指南本文档所有链接均已统一指向该地址下同。为助手准备第二个手机号SIM/eSIM/预付费卡用于注册专用的 WhatsApp 账号。双手机设置推荐推荐的架构是将个人手机与运行 OpenClaw 的 Mac 通过一部专用的“助手手机”连接起来结构如下发送消息通过二维码连接您的手机个人您的 WhatsApp 1-555-您第二部手机助手助手 WhatsApp 1-555-助手您的 MacopenclawPi 代理这样你从个人手机发送给助手号码的消息才会被 OpenClaw 处理而其他发给个人号码的消息则不会干扰代理。5分钟快速入门配对 WhatsApp 网页版执行以下命令OpenClaw 会显示一个二维码。用助手的手机扫描该二维码完成登录openclaw channels login启动网关网关是 OpenClaw 的核心服务需要保持运行openclaw gateway--port18789放置最小配置文件在~/.openclaw/openclaw.json中写入以下内容将15555550123替换为你自己的手机号白名单{ channels: { whatsapp: { allowFrom: [15555550123] } }, }现在从你列入白名单的手机向助手号码发送任意消息OpenClaw 就会响应。访问仪表盘初始化完成后OpenClaw 会自动打开仪表盘并打印一个干净的链接非令牌化。如果提示需要身份验证请将gateway.auth.token中的令牌粘贴到 Control UI 的设置中。之后如需重新打开仪表盘可执行openclaw dashboard。为代理分配工作空间OpenClaw 从工作空间目录读取操作指令和“记忆”。工作空间是一个包含多个 Markdown 文件的文件夹这些文件定义了代理的行为、身份、可用工具以及长期记忆。默认工作空间路径为~/.openclaw/workspace。首次设置或首次运行代理时OpenClaw 会自动创建该目录并生成以下启动文件AGENTS.md代理的核心指令。SOUL.md代理的角色设定和人格描述。TOOLS.md可用的工具列表。IDENTITY.md代理的身份信息。USER.md关于用户的信息。HEARTBEAT.md心跳检测时读取的指令可选。BOOTSTRAP.md仅在工作空间全新创建时生成用于初次引导删除后不会再生。MEMORY.md可选文件用于存储长期记忆存在时会在常规会话中加载。提示建议将此文件夹初始化为 Git 仓库最好是私有的以便备份AGENTS.md和其他记忆文件。如果系统已安装 Git全新工作空间会自动初始化。openclaw setup完整的工作空间布局及备份指南请参考代理工作空间。记忆工作流详情请参考记忆机制。你也可以通过配置指定不同的工作空间路径支持~展开{ agent: { workspace: ~/.openclaw/workspace, }, }如果你已经手动准备好了工作空间文件例如从仓库克隆可以禁用自动生成引导文件{ agent: { skipBootstrap: true, }, }配置为“助手”OpenClaw 默认提供了一个不错的助手预设但你可能需要根据实际需求调整以下内容SOUL.md编写代理的角色、性格和指令。思考默认值如thinkingDefault可设置为high以允许更深入的思考。超时时间timeoutSeconds控制代理单次响应的最大时长。心跳在完全信任代理后启用。以下是一个典型的配置文件示例{ logging: { level: info }, agent: { model: anthropic/claude-opus-4-6, // 选择适合的模型 workspace: ~/.openclaw/workspace, thinkingDefault: high, timeoutSeconds: 1800, // 初始设为 0后续再启用 heartbeat: { every: 0m }, }, channels: { whatsapp: { allowFrom: [15555550123], // 白名单 groups: { *: { requireMention: true }, // 群聊中需要 提及才响应 }, }, }, routing: { groupChat: { mentionPatterns: [openclaw, openclaw], // 识别 的规则 }, }, session: { scope: per-sender, // 每个发送者独立会话 resetTriggers: [/new, /reset], // 手动重置会话的命令 reset: { mode: daily, // 每天自动重置 atHour: 4, // 凌晨4点 idleMinutes: 10080, // 空闲7天后重置 }, }, }会话与记忆会话文件每个会话的对话历史以 JSONL 格式存储在~/.openclaw/agents/agent-id/sessions/{{SessionId}}.jsonl。会话元数据包含令牌使用量、最后路由等信息位于~/.openclaw/agents/agent-id/sessions/sessions.json旧版路径为~/.openclaw/sessions/sessions.json。重置会话发送/new或/reset可通过resetTriggers自定义可以启动一个全新的会话。如果单独发送此命令代理会回复简短的问候以确认重置。压缩会话发送/compact [指令]可以压缩会话上下文并报告剩余的上下文预算有助于在长对话中控制令牌使用。心跳检测主动模式心跳是 OpenClaw 的主动运行机制在没有用户消息时代理可以按照固定间隔自动运行执行HEARTBEAT.md中的指令或进行自我检查。默认心跳间隔为 30 分钟提示词为如果 HEARTBEAT.md 存在则读取它工作空间上下文。严格遵守。不要从前面的聊天中推断或重复旧任务。如果无事需要关注回复 HEARTBEAT_OK。配置示例{ agent: { heartbeat: { every: 30m }, }, }重要行为如果HEARTBEAT.md存在但实质上为空仅包含空行或 Markdown 标题OpenClaw 会跳过此次心跳运行以节省 API 调用。如果文件缺失心跳仍会运行由模型自行决定做什么。如果代理回复HEARTBEAT_OK可附带少量填充文本长度由agents.defaults.heartbeat.ackMaxChars控制OpenClaw 将抑制该次心跳的消息外发避免向用户发送无意义的确认。默认允许向类似 DM 的user:目标发送心跳消息。设置agents.defaults.heartbeat.directPolicy: block可禁止直接目标发送同时保留心跳运行。心跳会执行完整的代理轮次间隔越短消耗的令牌越多。在不信任代理前建议设置为0m完全禁用。媒体输入与输出OpenClaw 支持通过模板将入站附件图片、音频、文档提供给命令使用{{MediaPath}}本地临时文件路径。{{MediaUrl}}伪 URL可用于工具调用。{{Transcript}}如果启用了音频转录则为转写的文本。出站附件代理可以在消息中通过单独一行前后无空格包含MEDIA:指令来发送附件。例如这是截图。 MEDIA:https://example.com/screenshot.pngOpenClaw 会提取这些内容并将其作为媒体与文本一同发送给用户。操作清单以下命令可用于检查 OpenClaw 的运行状态openclaw status# 本地状态凭证、会话、排队事件openclaw status--all# 完整诊断只读可粘贴分享openclaw status--deep# 添加网关健康探测Telegram Discordopenclaw health--json# 网关健康状态快照WebSocket日志文件默认存储在/tmp/openclaw/目录下命名格式为openclaw-YYYY-MM-DD.log。后续步骤Web 聊天界面WebChat网关运维手册网关运行手册定时任务与唤醒Cron 作业macOS 菜单栏伴侣OpenClaw macOS 应用iOS 节点应用iOS 应用Android 节点应用Android 应用Windows 支持Windows (WSL2)Linux 支持Linux 应用安全指南安全