ghcr.io/openclaw/openclaw-docker-e2e:94c1e10643ea8f3140924572539df72438a8352c

🦞 OpenClaw — 个人AI助手

EXFOLIATE! EXFOLIATE!

OpenClaw 是一款可在您自己设备上运行的 个人AI助手。 它通过您已在使用的渠道回复您。它可在 macOS/iOS/Android 上进行语音交互，并能渲染您控制的实时画布（Canvas）。网关（Gateway）只是控制平面，产品核心是助手本身。

如果您需要一款个人化、单用户、本地运行、响应迅速且始终在线的助手，这就是您的选择。

支持的渠道包括：、、Slack、、Google Chat、Signal、iMessage、IRC、Microsoft Teams、Matrix、飞书（Feishu）、LINE、Mattermost、Nextcloud Talk、Nostr、Synology Chat、Tlon、、Zalo、Zalo Personal、微信（WeChat）、QQ、WebChat。

首次安装？从这里开始：快速入门

推荐设置：在终端中运行 openclaw onboard。 OpenClaw Onboard 会逐步引导您完成网关、工作区、渠道和技能的设置。这是推荐的 CLI 设置路径，适用于 macOS、Linux 和 Windows。 Windows 桌面用户可从原生 Windows Hub 配套应用开始，进行设置、托盘状态监控、聊天、节点模式和本地 MCP 模式。 支持 npm、pnpm 或 bun。

赞助商

订阅（OAuth）：

• OpenAI（***/Codex）

模型说明：虽然支持多种提供商和模型，但建议优先使用您信任且已在使用的提供商的当前旗舰模型。参见 Onboarding。

安装（推荐）

运行时：Node 24（推荐）或 Node 22.19+。

npm install -g openclaw@latest
# 或：pnpm add -g openclaw@latest

openclaw onboard --install-daemon

OpenClaw Onboard 会安装 Gateway 守护进程（launchd/systemd 用户服务），使其保持运行状态。

快速入门（TL;DR）

运行时：Node 24（推荐）或 Node 22.19+。

完整初学者指南（身份验证、配对、渠道）：快速入门

推荐守护进程模式：

openclaw onboard --install-daemon
openclaw gateway status

前台/调试模式：

openclaw gateway stop
openclaw 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/Feishu/LINE/Mattermost/Nextcloud Talk/Nostr/Synology Chat/Tlon/Twitch/Zalo/Zalo Personal/WeChat/QQ/WebChat）
openclaw agent --message "Ship checklist" --thinking high

升级？更新指南（并运行 openclaw doctor）。

模型配置 + CLI：模型。身份验证配置文件轮换 + 回退：模型故障转移。

安全默认值（私信访问）

OpenClaw 连接到真实的消息平台。请将入站私信（DM）视为不受信任的输入。

完整安全指南：安全性。 在远程暴露之前，请使用 网关暴露运行手册。

//Signal/iMessage/Microsoft Teams/***/Google Chat/Slack 上的默认行为：

• 私信配对（dmPolicy="pairing" / channels.discord.dmPolicy="pairing" / channels.slack.dmPolicy="pairing"；旧版：channels.discord.dm.policy、channels.slack.dm.policy）：未知发送者会收到一个短配对码，机器人不会处理他们的消息。
• 通过以下命令批准：openclaw pairing approve （然后发送者会被添加到本地允许列表存储中）。
• 公开入站私信需要明确选择加入：设置 dmPolicy="open" 并在渠道允许列表中包含 "*"（allowFrom / channels.discord.allowFrom / channels.slack.allowFrom；旧版：channels.discord.dm.allowFrom、channels.slack.dm.allowFrom）。

运行 openclaw doctor 以发现有风险/配置错误的私信策略。

主要特性

• 本地优先网关 — 用于会话、渠道、工具和事件的单一控制平面。
• 多渠道收件箱 — 、、Slack、、Google Chat、Signal、iMessage、IRC、Microsoft Teams、Matrix、飞书（Feishu）、LINE、Mattermost、Nextcloud Talk、Nostr、Synology Chat、Tlon、、Zalo、Zalo Personal、微信（WeChat）、QQ、WebChat、macOS、iOS/Android。
• 多代理路由 — 将入站渠道/账户/对等节点路由到隔离的代理（工作区 + 每代理会话）。
• 语音唤醒 + 通话模式 — macOS/iOS 上的唤醒词和 Android 上的连续语音（ElevenLabs + 系统 TTS 回退）。
• 实时画布 — 代理驱动的可视化工作区，支持 A2UI。
• 一流工具 — 浏览器、画布、节点、定时任务（cron）、会话，以及 ***/Slack 操作。
• 配套应用 — Windows Hub、macOS 菜单栏应用，以及 iOS/Android 节点。
• 引导设置 + 技能 — 引导式设置，包含捆绑/托管/工作区技能。

[!IMPORTANT]

• 默认：工具在 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。

操作员快速参考

• 聊天命令：/status、/new、/reset、/compact、/think 、/verbose on|off、/trace on|off、/usage off|tokens|full、/restart、/activation mention|always
• 会话工具：sessions_list、sessions_history、sessions_send
• 技能注册表：ClawHub
• 架构概览：架构

按目标分类的文档

应用（可选）

仅 Gateway 即可提供出色体验。所有应用均为可选，可添加额外功能。

如果您计划构建/运行配套应用，请遵循以下平台运行手册。

macOS（OpenClaw.app）（可选）

• 菜单栏控制 Gateway 和健康状态。
• 语音唤醒（Voice Wake）+ 按键通话（push-to-talk）覆盖层。
• WebChat + 调试工具。
• 通过 SSH 进行远程网关控制。

注意：需要签名构建才能使 macOS 权限在重建后保持有效（参见 macOS 权限）。

iOS 节点（可选）

• 通过 Gateway WebSocket 配对为节点（设备配对）。
• 语音触发转发 + Canvas 界面。
• 通过 openclaw nodes … 控制。

运行手册：iOS 连接。

Android 节点（可选）

• 通过设备配对（openclaw devices ...）配对为 WS 节点。
• 提供连接/聊天/语音选项卡，以及 Canvas、相机、屏幕捕获和 Android 设备命令系列。
• 运行手册：Android 连接。

从源代码构建（开发）

源代码检出使用 pnpm。仓库是 pnpm 工作区，开发期间捆绑插件从 extensions/* 加载，因此会直接使用其包本地依赖和您的编辑。在仓库根目录执行普通 npm install 不是受支持的源代码设置。

开发循环：

git clone https://github.com/openclaw/openclaw.git
cd openclaw

pnpm install

# 首次运行（或重置本地 OpenClaw 配置/工作区后）
pnpm openclaw setup

# 可选：在首次启动前预构建 Control UI
pnpm ui:build

# 开发循环（源代码/配置更改时自动重载）
pnpm gateway:watch

如果需要从检出构建 dist/（用于 Node、打包或发布验证），运行：

pnpm build
pnpm ui:build

pnpm openclaw setup 会写入 pnpm gateway:watch 所需的本地配置/工作区。可以安全地重新运行，但通常只需在首次设置或重置本地状态后运行。pnpm gateway:watch 不会重建 dist/control-ui，因此在 ui/ 更改后需重新运行 pnpm ui:build，或在迭代 Control UI 时使用 pnpm ui:dev。如果希望此检出直接运行引导设置，使用 pnpm openclaw onboard --install-daemon。

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

开发渠道

• stable：标记版本（vYYYY.M.D 或 vYYYY.M.D- ），npm 分发标签 latest。
• beta：预发布标签（vYYYY.M.D-beta.N），npm 分发标签 beta（可能缺少 macOS 应用）。
• dev：main 分支的移动 HEAD，npm 分发标签 dev（发布时）。

切换渠道（git + npm）：openclaw update --channel stable|beta|dev。 详情：开发渠道。

代理工作区 + 技能

• 工作区根目录：~/.openclaw/workspace（可通过 agents.defaults.workspace 配置）。
• 注入的提示文件：AGENTS.md、SOUL.md、TOOLS.md。
• 技能：~/.openclaw/workspace/skills/ /SKILL.md。

配置

最小化 ~/.openclaw/openclaw.json（模型 + 默认值）：

{
agent: {
model: " / ",
},
}

完整配置参考（所有键 + 示例）。

星级历史

Molty

OpenClaw 是为 Molty 构建的，这是一款太空龙虾 AI 助手。🦞 由 Peter Steinberger 和社区开发。

• openclaw.ai
• soul.md
• steipete.me
• @openclaw

社区

有关指南、维护者和提交 PR 的方法，请参见 CONTRIBUTING.md。 欢迎 AI/氛围编码的 PR！🤖

特别感谢 Mario Zechner 的支持以及 https://github.com/earendil-works/pi-mono%E3%80%82 特别感谢 Adam Doppelt 提供 lobster.bot 域名。

感谢所有 clawtributors：