ghcr.io/openclaw/openclaw:latest

🦞 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。

Website · Docs · Vision · DeepWiki · Getting Started · Updating · Showcase · FAQ · Onboarding · Nix · Docker · ***

首次安装？从这里开始：入门指南

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

openclaw onboard

赞助商

订阅（OAuth）：

• OpenAI（***/Codex）

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

安装（推荐）

运行时：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.discord.dmPolicy="pairing"

channels.slack.dmPolicy="pairing"

channels.discord.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.discord.allowFrom

channels.slack.allowFrom

channels.discord.dm.allowFrom

channels.slack.dm.allowFrom

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

openclaw doctor

主要特性

• 本地优先的 Gateway — 用于会话、渠道、工具和事件的单一控制平面。
• 多渠道收件箱 — 、、Slack、、Google Chat、Signal、BlueBubbles（iMessage）、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 备选）。
• 实时 Canvas — 助手驱动的可视化工作区，支持 A2UI。
• 一流工具 — 浏览器、Canvas、节点、定时任务、会话，以及 ***/Slack 操作。
• 配套应用 — macOS 菜单栏应用 + iOS/Android 节点。
• 引导设置 + 技能 — 引导式设置，包含捆绑/托管/工作区技能。

[!IMPORTANT] 安全模型

• 默认：主会话（main）的工具在主机上运行，因此当只有您使用时，助手拥有完全访问权限。

main

• 群组/渠道安全：设置 agents.defaults.sandbox.mode: "non-main"，使非主会话在每个会话的 Docker 沙箱中运行。

agents.defaults.sandbox.mode: "non-main"

main

• 典型沙箱默认值：允许 bash、process、read、write、edit、sessions_list、sessions_history、sessions_send、sessions_spawn；拒绝 browser、canvas、nodes、cron、discord、gateway。

bash

process

read

write

edit

sessions_list

sessions_history

sessions_send

sessions_spawn

browser

canvas

nodes

cron

discord

gateway

• 在远程暴露任何内容之前，请阅读安全、Docker 沙箱和配置文档。

管理员快速参考

• 聊天命令：/status、/new、/reset、/compact、/think <level>、/verbose on|off、/trace on|off、/usage off|tokens|full、/restart、/activation mention|always

/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

sessions_list

sessions_history

sessions_send

• 技能注册表：ClawHub
• 架构概述：Architecture

按目标分类的文档

• 新用户：入门指南、Onboarding、更新
• 渠道设置：渠道索引、、、***、Slack
• 应用 + 节点：macOS、iOS、Android、Nodes
• 配置 + 安全：配置、安全、Docker 沙箱
• 远程 + 网络：Gateway、远程访问、Tailscale、Web 界面