🦞 OpenClaw — Personal AI Assistant（个人 AI 助手）

EXFOLIATE! EXFOLIATE!

OpenClaw 是一个在您自有设备上运行的 个人 AI 助手（Personal AI Assistant）。 它通过您已有使用的渠道（channels）回复您。它可以在 macOS/iOS/Android 上说话和聆听，并能渲染您控制的实时 Canvas（画布）。Gateway（网关）只是控制平面（control plane）—— 产品本身就是助手。

如果您需要一个感觉本地化、快速、始终在线的个人助手，就是它了。

支持的渠道（channels）包括：WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、BlueBubbles、IRC、Microsoft Teams、Matrix、Feishu（飞书）、LINE、Mattermost、Nextcloud Talk、Nostr、Synology Chat、Tlon、Twitch、Zalo、Zalo Personal、WeChat（微信）、QQ、WebChat。

官网 · 文档 · 愿景 · DeepWiki · 入门指南 · 更新指南 · 展示 · 常见问题 · 引导向导 · Nix · Docker · Discord

新安装？从这里开始：入门指南

推荐设置：在终端运行 openclaw onboard。OpenClaw Onboard 会逐步引导您设置 Gateway、工作区（workspace）、渠道（channels）和技能（skills）。这是推荐的 CLI 设置路径，适用于 macOS、Linux 和 Windows（通过 WSL2；强烈推荐）。 支持 npm、pnpm 或 bun。

Sponsors（赞助商）

Subscriptions（订阅，OAuth）：

• OpenAI (ChatGPT/Codex)

Model note（模型说明）：虽然支持许多提供商和模型，但请优先选择您信任且已在使用的提供商的当前旗舰模型。请参阅引导向导。

Install（安装，推荐）

Runtime（运行时）：Node 24（推荐）或 Node 22.14+。

npm install -g openclaw@latest
# 或：pnpm add -g openclaw@latest

openclaw onboard --install-daemon

OpenClaw Onboard 会安装 Gateway daemon（网关守护进程，launchd/systemd 用户服务）以保持运行。

Quick start（快速开始，TL;DR）

Runtime（运行时）：Node 24（推荐）或 Node 22.14+。

完整的初学者指南（认证、配对、渠道）：入门指南

openclaw onboard --install-daemon

openclaw gateway --port 18789 --verbose

# 发送消息
openclaw message send --target +1234567890 --message "Hello from OpenClaw"

# 与助手对话（可选地将回复投递到任何已连接的渠道：WhatsApp/Telegram/Slack/Discord/Google Chat/Signal/iMessage/BlueBubbles/IRC/Microsoft Teams/Matrix/Feishu/LINE/Mattermost/Nextcloud Talk/Nostr/Synology Chat/Tlon/Twitch/Zalo/Zalo Personal/WeChat/QQ/WebChat）
openclaw agent --message "Ship checklist" --thinking high

升级？更新指南（并运行 openclaw doctor）。

模型配置 + CLI：Models（模型）。认证配置轮换 + 备选方案：Model failover（模型故障转移）。

Security defaults（安全默认设置，DM 访问）

OpenClaw 连接到真实的消息界面。请将入站 DM 视为不可信输入（untrusted input）。

完整安全指南：Security（安全）

Telegram/WhatsApp/Signal/iMessage/Microsoft Teams/Discord/Google Chat/Slack 的默认行为：

• DM pairing（DM 配对）（dmPolicy="pairing" / channels.discord.dmPolicy="pairing" / channels.slack.dmPolicy="pairing"；旧版：channels.discord.dm.policy，channels.slack.dm.policy）：未知发送者会收到一个简短的配对码，机器人不会处理他们的消息。
• 批准：openclaw pairing approve <channel> <code>（然后发送者被添加到本地允许列表存储）。
• 公共入站 DM 需要明确选择加入：设置 dmPolicy="open" 并在渠道允许列表中包含 "*"（allowFrom / channels.discord.allowFrom / channels.slack.allowFrom；旧版：channels.discord.dm.allowFrom，channels.slack.dm.allowFrom）。

运行 openclaw doctor 以显示有风险/配置错误的 DM 策略。

Highlights（亮点）

• Local-first Gateway（本地优先网关） — 会话（sessions）、渠道（channels）、工具（tools）和事件的单一控制平面。
• Multi-channel inbox（多渠道收件箱） — WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、BlueBubbles (iMessage)、iMessage（旧版）、IRC、Microsoft Teams、Matrix、Feishu、LINE、Mattermost、Nextcloud Talk、Nostr、Synology Chat、Tlon、Twitch、Zalo、Zalo Personal、WeChat、QQ、WebChat、macOS、iOS/Android。
• Multi-agent routing（多智能体路由） — 将入站渠道/账户/对等端路由到隔离的智能体（工作区 + per-agent 会话）。
• Voice Wake（语音唤醒） + Talk Mode（对话模式） — macOS/iOS 上的唤醒词和 Android 上的连续语音（ElevenLabs + 系统 TTS 备选）。
• Live Canvas（实时画布） — 智能体驱动的可视化工作区，支持 A2UI。
• First-class tools（一级工具） — 浏览器、画布、节点（nodes）、定时任务（cron）、会话（sessions）和 Discord/Slack 操作。
• Companion apps（配套应用） — macOS 菜单栏应用 + iOS/Android 节点（nodes）。
• Onboarding（引导） + skills（技能） — 通过引导驱动的设置，配备捆绑/管理/工作区技能。

Security model（安全模型，重要）

• 默认：工具在主机上为 main 会话运行，因此当只是您一个人时，智能体具有完全访问权限。
• 群组/渠道安全：设置 agents.defaults.sandbox.mode: "non-main" 以在沙箱中运行非 main 会话。Docker 是默认的沙箱后端；SSH 和 OpenShell 后端也可用。
• 典型沙箱默认：允许 bash、process、read、write、edit、sessions_list、sessions_history、sessions_send、sessions_spawn；拒绝 browser、canvas、nodes、cron、discord、gateway。
• 在远程暴露任何内容之前，请阅读 Security（安全）、Sandboxing（沙箱） 和 Configuration（配置）。

Operator quick refs（操作员快速参考）

• 聊天命令：/status、/new、/reset、/compact、/think <level>、/verbose on|off、/trace on|off、/usage off|tokens|full、/restart、/activation mention|always
• Session tools（会话工具）：sessions_list、sessions_history、sessions_send
• Skills registry（技能注册表）：ClawHub
• Architecture overview（架构概览）：Architecture（架构）

Docs by goal（按目标分类的文档）

• 新手请看：入门指南、引导向导、更新指南
• 渠道设置：渠道索引、WhatsApp、Telegram、Discord、Slack
• 应用 + 节点：macOS、iOS、Android、Nodes（节点）
• 配置 + 安全：Configuration（配置）、Security（安全）、Sandboxing（沙箱）
• 远程 + Web：Gateway（网关）、Remote access（远程访问）、Tailscale、Web surfaces（Web 界面）
• 工具 + 自动化：Tools（工具）、Skills（技能）、Cron jobs（定时任务）、Webhooks、Gmail Pub/Sub
• 内部原理：Architecture（架构）、Agent（智能体）、Session model（会话模型）、Gateway protocol（网关协议）
• 故障排除：渠道故障排除、Logging（日志）、文档首页

Apps（应用，可选）

仅 Gateway 就能提供出色的体验。所有应用都是可选的，会增加额外功能。

如果您计划构建/运行配套应用，请遵循下面的平台手册。

macOS（OpenClaw.app）（可选）

• Gateway 和健康状况的菜单栏控制。
• Voice Wake（语音唤醒）+ 按下说话覆盖层。
• WebChat + 调试工具。
• 通过 SSH 远程控制 Gateway。

注意：macOS 权限需要在重新构建后保持，需要签名构建（请参阅 macOS Permissions（macOS 权限））。

iOS node（iOS 节点，可选）

• 通过 Gateway WebSocket 配对为节点（设备配对）。
• 语音触发转发 + Canvas 界面。