ghcr.io/openclaw/openclaw-cache:arm64

🦞 OpenClaw — 个人AI助手

EXFOLIATE! EXFOLIATE!

OpenClaw 是一款可在您自己设备上运行的个人 AI 助手。它通过您日常使用的渠道与您交互。它可在 macOS/iOS/Android 上实现语音交互，并能渲染您可控制的实时 Canvas。Gateway 只是控制平面——产品核心是助手本身。

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

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

网站 · 文档 · 愿景 · DeepWiki · 快速开始 · 更新 · 展示 · 常见问题 · 引导设置 · Nix · Docker · ***

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

推荐设置：在终端中运行 openclaw onboard。OpenClaw Onboard 会逐步引导您完成网关、工作区、渠道和技能的设置。这是推荐的 CLI 设置路径，适用于 macOS、Linux 和 Windows（通过 WSL2；强烈推荐）。支持 npm、pnpm 或 bun。

openclaw onboard

赞助商

订阅（OAuth）：

• OpenAI（***/Codex）

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

安装（推荐）

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

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

快速开始（TL;DR）

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

完整新手指南（认证、配对、渠道）：快速开始

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

openclaw doctor

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

安全默认设置（私信访问）

OpenClaw 连接到实际消息平台。请将入站私信视为不可信输入。

完整安全指南：安全

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

• 私信配对（dmPolicy="pairing" / channels.***.dmPolicy="pairing" / channels.slack.dmPolicy="pairing"；旧版：channels.***.dm.policy、channels.slack.dm.policy）：未知发送者会收到一个短配对码，机器人不会处理他们的消息。

dmPolicy="pairing"

channels.***.dmPolicy="pairing"

channels.slack.dmPolicy="pairing"

channels.***.dm.policy

channels.slack.dm.policy

• 批准方式：openclaw pairing approve <channel> <code>（发送者将被添加到本地允许列表存储中）。

openclaw pairing approve <channel> <code>

• 公开入站私信需要显式选择启用：设置 dmPolicy="open" 并在渠道允许列表中包含 "*"（allowFrom / channels.***.allowFrom / channels.slack.allowFrom；旧版：channels.***.dm.allowFrom、channels.slack.dm.allowFrom）。

dmPolicy="open"

"*"

allowFrom

channels.***.allowFrom

channels.slack.allowFrom

channels.***.dm.allowFrom

channels.slack.dm.allowFrom

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

openclaw doctor

主要特性

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

[!IMPORTANT] 安全模型

• 默认：主会话（main）的工具在主机上运行，因此当只有您使用时，助手拥有完全访问权限。
• 群组/渠道安全：设置 agents.defaults.sandbox.mode: "non-main"，使非主会话在每个会话的 Docker 沙箱中运行。
• 典型沙箱默认值：允许 bash、process、read、write、edit、sessions_list、sessions_history、sessions_send、sessions_spawn；拒绝 browser、canvas、nodes、cron、***、gateway。
• 在远程暴露任何内容之前，请阅读安全、Docker 沙箱和配置。

操作快速参考

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

按目标分类的文档

• 新用户：快速开始、引导设置、更新
• 渠道设置：渠道索引、、、***、Slack
• 应用 + 节点：macOS、iOS、Android、节点
• 配置 + 安全：配置、安全、Docker 沙箱
• 远程 + 网络：Gateway、远程访问、Tailscale、Web 界面