openclaw/openclaw 源代码: https://github.com/openclaw/openclaw

OpenClaw 🦞 — 您的助手，在您的设备上，在您的聊天中

OpenClaw 是一个在您设备上运行的个人AI助手，它出现在您已使用的频道中。它专为单一操作者设计，通过一个 Gateway 连接模型、工具、消息通道和可选的配套应用。 网站 (https://openclaw.ai) · 文档 (https://docs.openclaw.ai) · 快速入门 (https://docs.openclaw.ai/start/getting-started) · 展示 (https://docs.openclaw.ai/start/showcase) · 常见问题 (https://docs.openclaw.ai/help/faq) · 愿景 · DeepWiki (https://deepwiki.com/openclaw/openclaw)

安装

安装程序支持 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。请参阅安装指南 (https://docs.openclaw.ai/install) 了解生命周期脚本契约、Docker、Nix 和其他部署路径。

快速开始

全新安装后，安装程序脚本会自动启动入门流程。请完成它们打开的向导。 如果您直接使用 npm、pnpm 或 Bun 安装了该包，请运行：

openclaw onboard --install-daemon

入门完成后：

openclaw gateway status
openclaw dashboard

入门流程会验证模型访问、创建工作区并配置 Gateway。最后一个命令打开控制界面；在那里发送一条消息以确认助手正在工作。 有关频道设置和故障排除，请参阅入门指南 (https://docs.openclaw.ai/start/getting-started)。

整体架构

• Gateway (https://docs.openclaw.ai/gateway) 是会话、工具、事件和频道连接的本地控制平面。
• 控制界面 (https://docs.openclaw.ai/web/control-ui)、CLI 和 TUI (https://docs.openclaw.ai/web/tui) 连接到 Gateway。
• 频道 (https://docs.openclaw.ai/channels) 将助手带到 WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage 和其他消息服务。
• 配套应用和节点 (https://docs.openclaw.ai/platforms) 在支持的平台上添加语音、画布、摄像头、屏幕和设备本地操作。 OpenClaw 可与托管和本地模型提供商 (https://docs.openclaw.ai/concepts/model-providers) 协同工作。其工具 (https://docs.openclaw.ai/tools)、技能 (https://docs.openclaw.ai/tools/skills) 和插件 (https://docs.openclaw.ai/plugins) 扩展了助手的能力。

安全

将入站消息视为不受信任的输入。支持私信的频道默认会配对未知发送者；您可以使用 openclaw pairing approve 批准配对请求。 除非您配置了沙盒，否则工具在主机的主会话上运行。在连接其他用户或将 Gateway 暴露到远程之前，请阅读安全指南 (https://docs.openclaw.ai/gateway/security)、暴露运行手册 (https://docs.openclaw.ai/gateway/security/exposure-runbook) 和沙盒指南 (https://docs.openclaw.ai/gateway/sandboxing)。

文档

开发

该代码仓库是一个 pnpm 工作区。在仓库根目录使用普通的 npm install 不受支持。

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm ui:build

请参阅 CONTRIBUTING.md 了解贡献工作流，以及源代码设置指南 (https://docs.openclaw.ai/start/setup) 了解开发循环。

社区

OpenClaw 由非营利组织 OpenClaw Foundation (https://openclaw.org) 公开开发。请参阅 CONTRIBUTING.md 了解维护者和贡献指南；欢迎AI辅助的PR。 对于错误和功能请求，请使用问题选择器 (https://github.com/openclaw/openclaw/issues/new/choose)；在 Discord (https://discord.gg/clawd) 中询问设置问题；通过 SECURITY.md 报告漏洞。 新功能通常属于基于插件 SDK (https://docs.openclaw.ai/plugins/building-plugins) 构建的插件，并通过 ClawHub (https://clawhub.ai) 共享。 OpenClaw 是由 Peter Steinberger 和社区为 Molty（一个太空龙虾AI助手）构建的。探索项目传说 (https://docs.openclaw.ai/start/lore)、soul.md (https://soul.md)、Peter 的网站 (https://steipete.me)、星标历史 (https://www.star-history.com/#openclaw/openclaw&type=date&legend=top-left) 和 @openclaw (https://x.com/openclaw)。 特别感谢 Mario Zechner (https://mariozechner.at/) 的支持以及 pi (https://github.com/earendil-works/pi)，感谢 Adam Doppelt 提供的 lobster.bot 域名。

赞助商

贡献者

感谢所有 clawtributors：

许可证

MIT © OpenClaw Foundation。请参阅 THIRD_PARTY_NOTICES.md 了解已包含或改编的代码。