OpenClaw：本地运行的个人AI助手，支持多平台与多频道

EXFOLIATE!EXFOLIATE!OpenClaw 是一款您在自己的设备上运行的个人 AI 助手。它能在您已使用的频道上回答您的问题。它可以在 macOS/iOS/Android 上说话和收听，并能渲染您控制的实时画布。

Gateway 只是控制平面——产品本身是助手。如果您想要一个感觉本地化、快速且始终在线的个人单用户助手，这就是它。

支持的频道包括：WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、IRC、Microsoft Teams、Matrix、飞书、LINE、Mattermost、Nextcloud Talk、Nostr、

Synology Chat、Tlon、Twitch、Zalo、Zalo Personal、微信、QQ、WebChat。

网站 · 文档 · 愿景 · 第三方通知 · DeepWiki · 入门 · 更新 · 展示 · 常见问题 · 入职 · Nix · Docker · Discord新安装？从这里开始：入门首选设置：在终端中运行 openclaw onboard。

OpenClaw Onboard 会逐步引导您设置网关、工作空间、频道和技能。这是推荐的 CLI 设置路径，适用于 macOS、Linux 和 Windows（通过 WSL2，强烈推荐）。可与 npm、pnpm 或 bun 配合使用。

订阅（OAuth）：- OpenAI（ChatGPT/Codex）模型说明：虽然支持许多提供商和模型，但建议选择您信任并已使用的当前旗舰模型。请参阅入职指南。运行时：Node 24（推荐）或 Node 22。

19+。

npm install -g openclaw@latest# 或：

pnpm add -g openclaw@latestopenclaw onboard --install-daemonOpenClaw Onboard 会安装 Gateway 守护进程（launchd/systemd 用户服务），

使其保持运行。运行时：Node 24（推荐）或 Node 22。19+。完整初学者指南（认证、配对、频道）：入门推荐守护进程模式：openclaw onboard --install-daemonopenclaw gateway status前台/调试模式：

openclaw gateway stopopenclaw gateway --port 18789 --verbose在任一启动模式运行后，

发送测试消息或询问助手：# 发送消息openclaw message send --target +1234567890 --message "Hello from OpenClaw"# 与助手交谈（可选地返回至任何连接的频道：

WhatsApp/Telegram/Slack/Discord/Google Chat/Signal/iMessage/IRC/Microsoft Teams/Matrix/飞书/LINE/Mattermost/Nextcloud Talk/Nostr/Synology

Chat/Tlon/Twitch/Zalo/Zalo Personal/微信/QQ/WebChat）openclaw agent --message "Ship checklist" --thinking high升级？

更新指南（并运行 openclaw doctor）。模型配置 + CLI：Models。认证配置文件轮换 + 回退：Model failover。OpenClaw 连接到真实的消息表面。将入站 DM 视为不受信任的输入。

完整安全指南：Security。在远程暴露之前，请使用 Gateway exposure runbook。Telegram/WhatsApp/Signal/iMessage/Microsoft Teams/Discord/Google Chat/Slack 上的默认行为：

- 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 策略。

- 本地优先的 Gateway——用于会话、频道、工具和事件的单一控制平面。

- 多渠道收件箱——WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、IRC、Microsoft Teams、Matrix、飞书、LINE、Mattermost、Nextcloud Talk、

Nostr、Synology Chat、Tlon、Twitch、Zalo、Zalo Personal、微信、QQ、WebChat、macOS、iOS/Android。- 多代理路由——将入站频道/账户/对等点路由到隔离的代理（工作空间 + 每个代理的会话）。

- 语音唤醒 + 通话模式——macOS/iOS 上的唤醒词和 Android 上的连续语音（ElevenLabs + 系统 TTS 回退）。- Live Canvas——使用 A2UI 的代理驱动的可视化工作空间。

- 一流的工具——浏览器、画布、节点、cron、会话和 Discord/Slack 操作。- 配套应用——macOS 菜单栏应用 + iOS/Android 节点。- 入职 + 技能——入职驱动的设置，包含捆绑/管理/工作空间技能。

- 默认：工具在主机上为 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、Gateway exposure runbook、Sandboxing 和 Configuration。

- 聊天命令：/status、/new、/reset、/compact、/think <level>、/verbose on|off、/trace on|off、/usage off|tokens|full、/restart、

/activation mention|always- 会话工具：

sessions_list、sessions_history、sessions_send- 技能注册表：ClawHub- 架构概述：Architecture- 新手入门：Getting started、Onboarding、Updating- 频道设置：

Channels index、

WhatsApp、Telegram、Discord、Slack- 应用 + 节点：macOS、iOS、Android、Nodes- 配置 + 安全：Configuration、Security、Exposure runbook、Sandboxing- 远程 + 网络：

Gateway、

Remote access、Tailscale、Web surfaces- 工具 + 自动化：Tools、Skills、Cron jobs、Webhooks、Gmail Pub/Sub- 内部机制：Architecture、Agent、Session model、

Gateway protocol- 故障排除：Channel troubleshooting、Logging、Docs home仅 Gateway 就能提供出色的体验。所有应用都是可选的，并增加额外功能。

如果您计划构建/运行配套应用，请遵循下面的平台运行手册。- 菜单栏控制 Gateway 和健康状态。- 语音唤醒 + 即按即说覆盖层。- WebChat + 调试工具。- 通过 SSH 进行远程网关控制。

注意：macOS 权限需要签名构建才能在重建后保留（参见 macOS Permissions）。- 通过 Gateway WebSocket 作为节点配对（设备配对）。- 语音触发转发 + Canvas 表面。

- 通过 openclaw nodes … 控制。运行手册：iOS connect。- 通过设备配对作为 WS 节点配对（openclaw devices ...）。

- 公开 Connect/Chat/Voice 选项卡以及 Canvas、Camera、Screen capture 和 Android 设备命令系列。- 运行手册：Android connect。

使用 pnpm 进行源码检出。该仓库是一个 pnpm 工作空间，开发期间捆绑的插件从 extensions/* 加载，因此会直接使用它们包内的依赖和您的编辑。在仓库根目录下直接使用 npm install 不是受支持的源码设置。

对于开发循环：git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm install# 仅首次运行（或重置本地 OpenClaw 配置/工作空间后）pnpm openclaw setup# 可选：

首次启动前预构建 Control UIpnpm ui:build# 开发循环（源码/配置更改时自动重新加载）pnpm gateway:watch如果您需要从检出中构建 dist/（用于 Node、打包或发布验证），运行：pnpm buildpnpm ui:

buildpnpm openclaw setup 会写入 pnpm gateway:watch 所需的本地配置/工作空间。

重新运行是安全的，但通常只需要在首次设置或重置本地状态后运行。pnpm gateway:watch 不会重建 dist/control-ui，因此请在 ui/ 更改后重新运行 pnpm ui:build，或在迭代 Control UI 时使用 pnpm ui:dev。

如果您希望此检出直接运行 onboarding，请使用 pnpm openclaw onboard --install-daemon。注意：pnpm openclaw ... 会直接运行 TypeScript（通过 tsx）。

pnpm build 生成 dist/ 用于通过 Node / 打包的 openclaw 二进制文件运行，而 pnpm gateway:watch 在开发循环期间按需重建运行时。

- stable：标签发布（vYYYY.M.D 或 vYYYY.M.D-<patch>），npm dist-tag latest。- beta：预发布标签（vYYYY.M.D-beta.N），npm dist-tag beta（macOS 应用可能缺失）。

-