docs: typography hygiene + 2 in-body H1 removals across 6 pages

Replaced 60 typography characters (curly quotes, apostrophes, em/en
dashes, non-breaking hyphens) with ASCII equivalents per
docs/CLAUDE.md heading and content hygiene rules.

- docs/start/openclaw.md: 10 chars; removed the duplicate '# Building
  a personal assistant with OpenClaw' H1 (Mintlify renders title from
  frontmatter).
- docs/platforms/mac/remote.md: 10 chars; removed the duplicate
  '# Remote OpenClaw (macOS ⇄ remote host)' H1 (the U+21C4 codepoint
  and parens both produced brittle anchors).
- docs/tools/thinking.md: 10 chars
- docs/reference/templates/BOOTSTRAP.md: 10 chars (kept the in-body
  '# BOOTSTRAP.md - Hello, World' heading because the page is a
  template whose content is meant to be copied verbatim into a
  workspace BOOTSTRAP.md).
- docs/plugins/sdk-provider-plugins.md: 10 chars
- docs/platforms/macos.md: 10 chars
This commit is contained in:
Vincent Koc
2026-05-05 20:55:18 -07:00
parent 3afc902f3d
commit 68a82cb2e2
6 changed files with 46 additions and 50 deletions

View File

@@ -6,13 +6,11 @@ read_when:
title: "Personal assistant setup"
---
# Building a personal assistant with OpenClaw
OpenClaw is a self-hosted gateway that connects Discord, Google Chat, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo, and more to AI agents. This guide covers the "personal assistant" setup: a dedicated WhatsApp number that behaves like your always-on AI assistant.
## ⚠️ Safety first
Youre putting an agent in a position to:
You're putting an agent in a position to:
- run commands on your machine (depending on your tool policy)
- read/write files in your workspace
@@ -26,7 +24,7 @@ Start conservative:
## Prerequisites
- OpenClaw installed and onboarded see [Getting Started](/start/getting-started) if you haven't done this yet
- OpenClaw installed and onboarded - see [Getting Started](/start/getting-started) if you haven't done this yet
- A second phone number (SIM/eSIM/prepaid) for the assistant
## The two-phone setup (recommended)
@@ -39,7 +37,7 @@ flowchart TB
B -- linked via QR --> C["<b>Your Mac (openclaw)<br></b><br>AI agent"]
```
If you link your personal WhatsApp to OpenClaw, every message to you becomes agent input. Thats rarely what you want.
If you link your personal WhatsApp to OpenClaw, every message to you becomes "agent input". That's rarely what you want.
## 5-minute quick start
@@ -70,7 +68,7 @@ When onboarding finishes, OpenClaw auto-opens the dashboard and prints a clean (
## Give the agent a workspace (AGENTS)
OpenClaw reads operating instructions and memory from its workspace directory.
OpenClaw reads operating instructions and "memory" from its workspace directory.
By default, OpenClaw uses `~/.openclaw/workspace` as the agent workspace, and will create it (plus starter `AGENTS.md`, `SOUL.md`, `TOOLS.md`, `IDENTITY.md`, `USER.md`, `HEARTBEAT.md`) automatically on setup/first agent run. `BOOTSTRAP.md` is only created when the workspace is brand new (it should not come back after you delete it). `MEMORY.md` is optional (not auto-created); when present, it is loaded for normal sessions. Subagent sessions only inject `AGENTS.md` and `TOOLS.md`.
@@ -111,7 +109,7 @@ If you already ship your own workspace files from a repo, you can disable bootst
## The config that turns it into "an assistant"
OpenClaw defaults to a good assistant setup, but youll usually want to tune:
OpenClaw defaults to a good assistant setup, but you'll usually want to tune:
- persona/instructions in [`SOUL.md`](/concepts/soul)
- thinking defaults (if desired)
@@ -172,7 +170,7 @@ Set `agents.defaults.heartbeat.every: "0m"` to disable.
- If the file is missing, the heartbeat still runs and the model decides what to do.
- If the agent replies with `HEARTBEAT_OK` (optionally with short padding; see `agents.defaults.heartbeat.ackMaxChars`), OpenClaw suppresses outbound delivery for that heartbeat.
- By default, heartbeat delivery to DM-style `user:<id>` targets is allowed. Set `agents.defaults.heartbeat.directPolicy: "block"` to suppress direct-target delivery while keeping heartbeat runs active.
- Heartbeats run full agent turns shorter intervals burn more tokens.
- Heartbeats run full agent turns - shorter intervals burn more tokens.
```json5
{
@@ -193,7 +191,7 @@ Inbound attachments (images/audio/docs) can be surfaced to your command via temp
Outbound attachments from the agent: include `MEDIA:<path-or-url>` on its own line (no spaces). Example:
```
Heres the screenshot.
Here's the screenshot.
MEDIA:https://example.com/screenshot.png
```