OpenClaw：运行在自有设备、接入你常用聊天渠道的开源 AI 助手
OpenClaw 是 OpenClaw Foundation（独立 501(c)(3)）主导的开源 AI 助手，运行在你自己的电脑上，并能接入 Discord、iMessage、Slack、Teams、Telegram、WhatsApp 等 20 多个渠道，另有 macOS、iOS、Android、Windows、Linux 原生应用。一个 Gateway 既能作为笔记本上的个人助手，也能作为团队共享部署，差别只在配置。状态、记忆与凭据保存在你自己的硬件上，模型与 agent harness（Claude、Codex、本地模型）都是可替换插件；采用 MIT 许可证。
社区作者 · zZz
它解决什么问题
OpenClaw 是一个开源 AI 助手，运行在你自己的计算机上，并出现在你已经在用的聊天渠道中：Discord、iMessage、Slack、Teams、Telegram、WhatsApp 等 20 多个渠道，同时提供 macOS、iOS、Android、Windows、Linux 原生应用。一个 Gateway 既可以把 OpenClaw 当作笔记本上的个人助手运行，也可以作为团队共享部署，二者只存在配置上的差异。
按照项目自述，状态、记忆与凭据都保存在你自己的硬件上；模型与 agent harness（Claude、Codex、本地模型）是可插拔的，替换它们不需要改动其他部分。你的提示词会发送到你配置的模型提供方和聊天平台，以及你自己启用的诊断导出；默认情况下 OpenClaw 本身只为每日版本检查联网，匿名功能统计为可选加入，设置 update.checkOnStart: false 可同时关闭这两项。项目由独立的 501(c)(3) 机构 OpenClaw Foundation 管理，没有付费层、托管服务或代币。
架构上分为：Gateway 作为会话、工具、事件与渠道连接的本地控制平面；Control UI、CLI 和 TUI 连接到 Gateway；Channels 把助手带入 WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage 等消息服务；Companion apps 与 nodes 在支持的平台上增加语音、Canvas、摄像头、屏幕和设备本地操作。OpenClaw 可搭配托管与本地模型提供方，其 tools、skills、plugins 用于扩展助手能力，并可通过 ClawHub 共享。
安全方面，官方要求把入站消息视为不可信输入：支持私聊的渠道默认对未知发送者进行配对，使用 openclaw pairing approve <channel> <code> 批准配对请求；除非配置沙箱，主会话的工具会在宿主机上运行，因此在连接其他用户或远程暴露 Gateway 之前应先阅读安全指南、暴露运行手册与沙箱指南。
项目仓库是 pnpm workspace，不支持在仓库根目录直接执行
npm install；贡献流程见 CONTRIBUTING.md，欢迎 AI 辅助的 PR，新能力通常以基于 plugin SDK 的插件形式实现并通过 ClawHub 分享。
— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
一、准备环境
- 官方安装脚本支持 macOS、Linux 和 Windows；当系统缺少受支持的 Node.js 运行时，脚本会自动配置一个。
- 若你已经自行管理 Node.js，可改为安装已发布的包，要求 Node 24.16+ 或 26.1+，推荐 Node 26。
步骤 3 · 该 npm 命令面向 npm 12 或
npm 11.16+；在 npm 11.15 及更早版本上需省略 --allow-scripts=openclaw。
- 安装指南中还提供生命周期脚本契约、Docker、Nix 及其他部署路径。
二、安装命令 macOS / Linux / WSL2：
curl -fsSL https://openclaw.ai/install.sh | bashWindows PowerShell：
iwr -useb https://openclaw.ai/install.ps1 | iex已自行管理 Node.js 时，安装已发布包：
npm install -g openclaw@latest --allow-scripts=openclaw三、首次运行（onboarding）
- 全新安装时，安装脚本会自动启动 onboarding，请完成它打开的向导。
步骤 2 · 如果你是用 npm、pnpm 或
Bun 直接安装包，则运行：
openclaw onboard --install-daemon
- Onboarding 会校验模型访问、创建工作区并配置 Gateway。
四、启动后验证 openclaw gateway status openclaw dashboard 最后一条命令会打开 Control UI，在其中发送一条消息即可确认助手正常工作（配图 1）。渠道配置与排错见 getting started 指南。
五、源码开发（仓库为 pnpm workspace，不支持在根目录执行
npm install）
git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm installpnpm buildpnpm ui:build贡献流程见 CONTRIBUTING.md，源码开发循环见 source setup guide。
六、常见问题与安全事项
- 支持私聊的渠道默认会对未知发送者进行配对，批准配对请求的命令为：openclaw pairing approve <channel> <code>
- 除非配置了沙箱，主会话的工具会在宿主机上运行；在连接其他用户或远程暴露 Gateway 之前，先阅读 security guide、exposure runbook 和 sandboxing guide。
- 默认情况下 OpenClaw 只为每日版本检查联网，匿名功能统计需主动加入，update.checkOnStart: false 可同时关闭两者。
- 在仓库根目录直接 npm install 不受支持，请使用 pnpm。
