OpenClaw is a personal AI assistant you run on your own devices. It answers you on the channels you already use (WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, iMessage, Microsoft Teams, WebChat), plus extension channels like BlueBubbles, Matrix, Zalo, and Zalo Personal. It can speak and listen on macOS/iOS/Android, and can render a live Canvas you control. The Gateway is just the control plane — the product is the assistant. OpenClaw 是一个在你自己设备上运行的个人 AI 助手。也是一个网关，它在你已经使用的频道上回答你（WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、Microsoft Teams、WebChat），还包括像 BlueBubbles、Matrix、Zalo 和 Zalo Personal 这样的扩展频道。它可以在 macOS/iOS/Android 上说话和聆听，并且可以渲染你控制的实时 Canvas。网关只是控制平面——产品是助手。
Preferred setup: run the onboarding wizard (openclaw onboard) in your terminal. The wizard guides you step by step through setting up the gateway, workspace, channels, and skills. The CLI wizard is the recommended path and works on macOS, Linux, and Windows (via WSL2; strongly recommended). Works with npm, pnpm, or bun. 推荐设置：在您的终端中运行入门向导（ openclaw onboard ）。向导将逐步指导您设置网关、工作区、频道和技能。CLI 向导是推荐路径，适用于 macOS、Linux 和 Windows（通过 WSL2；强烈推荐）。兼容 npm、pnpm 或 bun。
Install (recommended) 安装（推荐）
Runtime: Node ≥22.
npm install -g openclaw@latest
# or: pnpm add -g openclaw@latest
# or macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash
# or Windows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iex
安装脚本是推荐的方式。它将节点检测、安装和引导集成在一个步骤中。
openclaw onboard --install-daemon 新手引导并安装服务
验证
openclaw doctor # check for config issues
openclaw status # gateway status
openclaw dashboard # open the browser UI
The wizard installs the Gateway daemon (launchd/systemd user service) so it stays running. 向导会安装网关守护进程（launchd/systemd 用户服务），以便它保持运行。
快速开始
openclaw onboard --install-daemon
# 配对 WhatsApp 并启动 Gateway 网关
openclaw channels login
openclaw gateway --port 18789 --verbose
# Send a message 在新终端发送一条消息
openclaw message send --to +1234567890 --message "Hello from OpenClaw"
# Talk to the assistant (optionally deliver back to any connected channel: WhatsApp/Telegram/Slack/Discord/Google Chat/Signal/iMessage/BlueBubbles/Microsoft Teams/Matrix/Zalo/Zalo Personal/WebChat)
# 与助手交谈（可选：回传至任何已连接的频道）
openclaw agent --message "Ship checklist" --thinking high
Gateway 网关启动后，打开浏览器控制界面。
本地默认地址：http://127.0.0.1:18789/
远程访问：Web 界面和 Tailscale
From source (development) 从源代码 (开发)
Prefer pnpm for builds from source. Bun is optional for running TypeScript directly. 优先使用 pnpm 进行从源代码构建。Bun 是直接运行 TypeScript 的可选工具。
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # auto-installs UI deps on first run
pnpm build
pnpm openclaw onboard --install-daemon
# Dev loop (auto-reload on TS changes)
pnpm gateway:watch
Note: pnpm openclaw ... runs TypeScript directly (via tsx). pnpm build produces dist/ for running via Node / the packaged openclaw binary. 注意： pnpm openclaw ... 直接运行 TypeScript（通过 tsx ）。 pnpm build 生成 dist/ 以通过 Node / 打包的 openclaw 二进制文件运行。
工作原理
WhatsApp / Telegram / Slack / Discord / iMessage / Microsoft Teams / WebChat
│
▼
┌───────────────────────────────┐
│ Gateway │
│ (control plane) │
│ ws://127.0.0.1:18789 │
└──────────────┬────────────────┘
│
├─ Pi agent (RPC)
├─ CLI (openclaw …)
├─ WebChat UI
├─ macOS app
└─ iOS / Android nodes
Skills registry (ClawHub) 技能注册中心（ClawHub）
ClawHub is a minimal skill registry. With ClawHub enabled, the agent can search for skills automatically and pull in new ones as needed. ClawHub 是一个极简的技能注册中心。启用 ClawHub 后，代理可以自动搜索技能，并根据需要拉取新技能。
Chat commands 聊天指令
Send these in WhatsApp/Telegram/Slack/Google Chat/Microsoft Teams/WebChat (group commands are owner-only): 发送至 WhatsApp/Telegram/Slack/Google Chat/Microsoft Teams/WebChat（群组指令仅限所有者使用）：
/status — compact session status (model + tokens, cost when available)简洁会话状态（模型+令牌，有成本时显示）
/new or /reset — reset the session 重置会话
/compact — compact session context (summary) 紧凑会话上下文（摘要）
/think — off|minimal|low|medium|high|xhigh (GPT-5.2 + Codex models only)
/verbose on|off
/usage off|tokens|full — per-response usage footer 每次响应的使用情况页脚
/restart — restart the gateway (owner-only in groups) 重启网关（仅群组所有者可操作）
/activation mention|always — group activation toggle (groups only) 群组激活开关（仅限群组）
Agent workspace + skills 代理工作区 + 技能
Workspace root: ~/.openclaw/workspace (configurable via agents.defaults.workspace). 工作区根目录: ~/.openclaw/workspace (可通过 agents.defaults.workspace 进行配置).
Injected prompt files: AGENTS.md, SOUL.md, TOOLS.md. 注入的提示文件: AGENTS.md , SOUL.md , TOOLS.md .
Skills: ~/.openclaw/workspace/skills//SKILL.md
配置文件位于 ~/.openclaw/openclaw.json
Does it run on Raspberry Pi 它能在树莓派上运行吗
Yes. The Gateway is lightweight - docs list 512MB-1GB RAM, 1 core, and about 500MB disk as enough for personal use, and note that a Raspberry Pi 4 can run it. 是的。网关非常轻量级——文档列出了 512MB-1GB RAM、1 核和约 500MB 磁盘空间足以满足个人使用需求，并请注意 Raspberry Pi 4 可以运行它。
If you want extra headroom (logs, media, other services), 2GB is recommended, but it’s not a hard minimum. 如果你需要额外的空间（日志、媒体、其他服务），建议使用 2GB，但这并非硬性最低要求。
Tip: a small Pi/VPS can host the Gateway, and you can pair nodes on your laptop/phone for local screen/camera/canvas or command execution. 提示：小型 Pi/VPS 可以托管网关，你可以在你的笔记本电脑/手机上配对节点，用于本地屏幕/摄像头/画布或命令执行。
Do I have to buy a Mac Mini to install this 我需要购买 Mac Mini 来安装这个吗
No. OpenClaw runs on macOS or Linux (Windows via WSL2). A Mac mini is optional - some people buy one as an always-on host, but a small VPS, home server, or Raspberry Pi-class box works too. 不。OpenClaw 在 macOS 或 Linux 上运行（通过 WSL2 在 Windows 上）。Mac mini 是可选的——有些人会购买一个作为始终开启的主机，但一个小型 VPS、家庭服务器或树莓派级别的盒子也可以。
If I buy a Mac mini to run OpenClaw can I connect it to my MacBook Pro 如果我购买 Mac mini 来运行 OpenClaw，我可以将它连接到我的 MacBook Pro 吗
Yes. The Mac mini can run the Gateway, and your MacBook Pro can connect as a node (companion device). Nodes don’t run the Gateway - they provide extra capabilities like screen/camera/canvas and system.run on that device. 是的。Mac mini 可以运行网关，而你的 MacBook Pro 可以作为节点（辅助设备）连接。节点不会运行网关——它们提供额外的功能，如屏幕/摄像头/画布以及该设备上的 system.run
Common pattern: 常见模式：
Gateway on the Mac mini (always-on). Mac mini 上运行网关（始终开启）。
MacBook Pro runs the macOS app or a node host and pairs to the Gateway. MacBook Pro 运行 macOS 应用程序或节点主机，并与网关配对。
I just set it up what should I do first我刚设置好，应该先做什么
Good first projects: 好的入门项目：
Build a website (WordPress, Shopify, or a simple static site). 构建一个网站（WordPress、Shopify 或一个简单的静态网站）。
Prototype a mobile app (outline, screens, API plan). 设计一款移动应用（框架、界面、API 计划）。
Organize files and folders (cleanup, naming, tagging). 整理文件和文件夹（清理、命名、标记）。
Connect Gmail and automate summaries or follow ups. 连接 Gmail 并自动生成摘要或跟进提醒。
It can handle large tasks, but it works best when you split them into phases and use sub agents for parallel work. 它可以处理大型任务，但当你将它们分解为阶段并使用子代理进行并行工作时，效果最佳。
What are the top five everyday use cases for OpenClaw OpenClaw 的五大日常使用场景是什么
Personal briefings: summaries of inbox, calendar, and news you care about. 个人简报：收件箱、日历和您关心的新闻的摘要。
Research and drafting: quick research, summaries, and first drafts for emails or docs. 研究和起草：为电子邮件或文档进行快速研究、摘要和初稿。
Reminders and follow ups: cron or heartbeat driven nudges and checklists. 提醒和跟进：使用 cron 或心跳驱动的提示和清单。
Browser automation: filling forms, collecting data, and repeating web tasks. 浏览器自动化：填写表单、收集数据、重复网页任务。
Cross device coordination: send a task from your phone, let the Gateway run it on a server, and get the result back in chat. 跨设备协调：从你的手机发送任务，让网关在服务器上运行它，并在聊天中获取结果。
What are the advantages vs Claude Code for web development 与 Claude Code 的网页开发的优势是什么
OpenClaw is a personal assistant and coordination layer, not an IDE replacement. Use Claude Code or Codex for the fastest direct coding loop inside a repo. Use OpenClaw when you want durable memory, cross-device access, and tool orchestration. OpenClaw 是一个个人助手和协调层，不是 IDE 的替代品。在仓库内使用 Claude Code 或 Codex 以实现最快的直接编码循环。当你需要持久化内存、跨设备访问和工具编排时，使用 OpenClaw。
Advantages: 优点： Persistent memory + workspace across sessions 跨会话的持久化内存+工作空间
Multi-platform access (WhatsApp, Telegram, TUI, WebChat) 多平台访问（WhatsApp、Telegram、TUI、WebChat）
Tool orchestration (browser, files, scheduling, hooks) 工具编排（浏览器、文件、调度、钩子）
Always-on Gateway (run on a VPS, interact from anywhere) 常驻网关（在 VPS 上运行，随时随地交互）
Nodes for local browser/screen/camera/exec 本地浏览器/屏幕/摄像头/执行器节点
Is there a way to make a team of OpenClaw instances one CEO and many agents 有没有办法让 OpenClaw 实例组成一个 CEO 和多个代理的团队？
Yes, via multi-agent routing and sub-agents. You can create one coordinator agent and several worker agents with their own workspaces and models. 是的，通过多代理路由和子代理。你可以创建一个协调代理和多个拥有自己工作空间和模型的工人代理。
That said, this is best seen as a fun experiment. It is token heavy and often less efficient than using one bot with separate sessions. The typical model we envision is one bot you talk to, with different sessions for parallel work. That bot can also spawn sub-agents when needed. 话虽如此，这最好被视为一个有趣的实验。它token消耗量大，并且通常不如使用一个拥有独立会话的机器人高效。我们设想中的典型模型是一个你可以与之交谈的机器人，使用不同的会话进行并行工作。这个机器人也可以在需要时生成子代理。
What model do you recommend 推荐用哪个模型
Recommended default: anthropic/claude-opus-4-6. Good alternative: anthropic/claude-sonnet-4-5. Reliable (less character): openai/gpt-5.2 - nearly as good as Opus, just less personality. Budget: zai/glm-4.7. 推荐默认值： anthropic/claude-opus-4-6 。良好替代方案： anthropic/claude-sonnet-4-5 。可靠（字符较少）： openai/gpt-5.2 - 几乎与 Opus 一样好，只是个性稍弱。考虑预算： zai/glm-4.7 。
不同子代理可以使用不同的模型，最后可以通过/agent切换
How do I add models from other providers like OpenRouter or ZAI 如何添加来自 OpenRouter 或 ZAI 等其他提供者的模型
OpenRouter
{
agents: {
defaults: {
model: { primary: "openrouter/anthropic/claude-sonnet-4-5" },
models: { "openrouter/anthropic/claude-sonnet-4-5": {} },
},
},
env: { OPENROUTER_API_KEY: "sk-or-..." },
}
Z.AI
{
agents: {
defaults: {
model: { primary: "zai/glm-4.7" },
models: { "zai/glm-4.7": {} },
},
},
env: { ZAI_API_KEY: "..." },
}
Where are logs 日志在哪里
/tmp/openclaw/openclaw-YYYY-MM-DD.log
Fastest log tail: 最快的日志尾追：
openclaw logs --follow
Service/supervisor logs (when the gateway runs via launchd/systemd): 服务/管理器日志（当网关通过 launchd/systemd 运行时）：
macOS: $OPENCLAW_STATE_DIR/logs/gateway.log and gateway.err.log (default: ~/.openclaw/logs/...; profiles use ~/.openclaw-/logs/...)
Linux: journalctl --user -u openclaw-gateway[-].service -n 200 --no-pager
Windows: schtasks /Query /TN "OpenClaw Gateway ()" /V /FO LIST
