ghcr.io/openclaw/openclaw-docker-e2e-functional:pkg-7f7d1984d94b2c300dabb774385e57d1

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

OpenClaw 是一款 AI 助手，可在您的设备上运行，并在您日常使用的渠道中为您提供服务。它通过一个 Gateway 连接模型、工具、消息渠道和可选的配套应用，适用于个人用户或相互信任的团队：同一 Gateway 既可以作为个人助手在单台笔记本电脑上运行，也可以作为https://docs.openclaw.ai/start/teams共享使用，两者的唯一区别在于配置。其架构理念（可信网关、不可信执行、确定性策略）详见https://docs.openclaw.ai/start/why-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。有关生命周期脚本协议、Docker、Nix 和其他部署方式，请参见https://docs.openclaw.ai/install。

快速开始

全新安装后，安装脚本会自动启动引导设置流程。请完成其打开的向导。如果您通过 npm、pnpm 或 Bun 直接安装了包，请运行：

openclaw onboard --install-daemon

引导设置完成后：

openclaw gateway status
openclaw dashboard

引导设置会验证模型访问权限、创建工作区并配置 Gateway。最后一条命令会打开 Control UI；在其中发送消息即可确认助手是否正常工作。有关渠道设置和故障排除，请参见https://docs.openclaw.ai/start/getting-started。

组件构成

• https://docs.openclaw.ai/gateway 是本地控制平面，负责会话、工具、事件和渠道连接。
• https://docs.openclaw.ai/web/control-ui、CLI 和 https://docs.openclaw.ai/web/tui 连接到 Gateway。
• https://docs.openclaw.ai/channels 将助手接入 、、Slack、***、Google Chat、Signal、iMessage 和其他消息服务。
• https://docs.openclaw.ai/platforms 在受支持平台上添加语音、画布、摄像头、屏幕和设备本地操作功能。

安全

将入站消息视为不可信输入。支持私信的渠道默认会与未知发送者配对；使用 openclaw pairing approve 命令批准配对请求。

文档

开发

该仓库是一个 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 基金会（一家非营利组织）公开开发。有关维护者和贡献指南，请参见 CONTRIBUTING.md；欢迎使用 AI 辅助提交 PR。

特别感谢 Mario Zechner 的支持及其 https://github.com/earendil-works/pi 项目，以及 Adam Doppelt 提供的 lobster.bot 域名。

赞助商

贡献者

感谢所有贡献者：

许可

MIT © OpenClaw 基金会。有关已纳入或改编的代码，请参见 THIRD_PARTY_NOTICES.md。