开源个人AI助手项目,支持 macOS/Linux/Windows,一键安装,自动配置 Node.js 运行时,可接入多种模型和消息渠道,适合希望数据本地运行、不依赖云服务商的开发者。

OpenClaw 是一个运行在本地设备上的个人 AI 助手,在你已有的聊天渠道中与你相遇。它专为单一操作者设计,通过一个 Gateway 将模型、工具、消息渠道和可选的配套应用连接在一起。
Website · Docs · Getting started · Showcase · FAQ · Vision · DeepWiki
安装器支持 macOS、Linux 和 Windows,必要时会自动安装支持的 Node.js 运行时。
# macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash
# Windows PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex
已自行管理 Node.js?改为安装发布的包(Node 22.22.3+、24.15+ 或 25.9+):
npm install -g openclaw@latest --allow-scripts=openclaw
该命令适用于 npm 12 或 npm 11.16+。npm 11.15 及更早版本需省略 --allow-scripts=openclaw。参见安装指南了解生命周期脚本合约、Docker、Nix 及其他部署方式。
全新安装时,安装脚本会自动启动 onboarding。完成它们打开的向导。如果你直接用 npm、pnpm 或 Bun 安装了包,运行:
openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard
Onboarding 会验证模型访问权限、创建工作区并配置 Gateway。最后一条命令会打开 Control UI,在那里发一条消息以确认助手正常工作。参见入门指南了解渠道设置和故障排查。
Gateway 是会话、工具、事件和渠道连接在本地层面的控制平面。
Control UI、CLI 和 TUI 都连接到 Gateway。
渠道将助手带到 WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage 等消息服务。
配套应用和节点在支持的平台上添加语音、Canvas、摄像头、屏幕以及设备本地的操作。
OpenClaw 支持托管和本地模型提供商。它的工具、技能和插件扩展了助手的能力。
将收到的消息视为不可信输入。支持 DM 的渠道默认会配对未知发送者;用 openclaw pairing approve <channel> <code> 批准配对请求。
工具默认在宿主机上为主会话运行,除非你配置了沙箱。在连接其他用户或远程暴露 Gateway 之前,请阅读安全指南、暴露运行手册和沙箱指南。
该仓库是一个 pnpm workspace。不支持在仓库根目录执行普通的 npm install。
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm ui:build
参与工作流程和开发循环参见 CONTRIBUTING.md。
OpenClaw 由非营利组织 OpenClaw Foundation 公开开发。参见 CONTRIBUTING.md 了解维护者和贡献指南;欢迎 AI 辅助的 PR。
用 issue chooser 提交 bug 和功能请求,在 Discord 提问设置问题,通过 SECURITY.md 报告安全漏洞。新功能通常适合构建在插件 SDK 之上并通过 ClawHub 分享。
OpenClaw 是为 Molty(一个太空龙虾 AI 助手)而构建,由 Peter Steinberger 和社区共同开发。探索项目 lore、soul.md、Peter 的网站、Star History 和 @openclaw。
特别感谢 Mario Zechner 的支持和圆周率,以及 Adam Doppelt 提供的 lobster.bot 域名。
感谢所有 clawtributors:
MIT © OpenClaw Foundation。已合并或改编的代码参见 THIRD_PARTY_NOTICES.md。