🦞 OpenClaw — 个人AI助手 EXFOLIATE! EXFOLIATE! OpenClaw 是一款可在你自己设备上运行的个人AI助手。它通过你已在使用的渠道与你交互，支持在macOS/iOS/Android上进行语音交互，并能渲染一个由你控制的实时Canvas。网关（Gateway）只是控制平面，核心产品是助手本身。 如果你需要一个个人化、单用户、本地运行、响应迅速且始终在线的助手，这就是你的选择。 支持的渠道包括：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 onboard。 OpenClaw Onboard 会逐步引导你完成网关、工作区、渠道和技能的设置。这是推荐的CLI设置路径，适用于macOS、Linux和Windows。 Windows桌面用户可通过原生Windows Hub companion应用开始设置，该应用提供托盘状态、聊天、节点模式和本地MCP模式功能。 支持npm、pnpm或bun。 赞助商 订阅（OAuth）： OpenAI（ChatGPT/Codex） 模型说明：虽然支持多种提供商和模型，但建议优先选择你信任且已在使用的提供商的当前旗舰模型。参见Onboarding。 安装（推荐） 运行时：Node 24（推荐）或 Node 22.19+。 OpenClaw Onboard 会安装网关守护进程（launchd/systemd 用户服务），确保其持续运行。 快速开始（TL;DR） 运行时：Node 24（推荐）或 Node 22.19+。 完整新手指南（认证、配对、渠道）：入门指南 推荐守护进程模式： 前台/调试模式： 任一启动模式运行后，发送测试消息或向助手提问： 升级？更新指南（并运行 openclaw doctor）。 模型配置 + CLI：模型。认证配置文件轮换 + 回退：模型故障转移。 安全默认值（私信访问） OpenClaw 连接到真实的消息界面。请将入站私信视为不可信输入。 完整安全指南：安全。 远程暴露前，请使用网关暴露运行手册。 Telegram/WhatsApp/Signal/iMessage/Microsoft Teams/Discord/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 以发现风险/配置错误的私信策略。 功能亮点 本地优先网关 — 用于会话、渠道、工具和事件的单一控制平面。 多渠道收件箱 — 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、macOS、iOS/Android。 多代理路由 — 将入站渠道/账户/对等方路由到隔离的代理（工作区 + 每代理会话）。 语音唤醒 + 对话模式 — macOS/iOS上的唤醒词和Android上的连续语音（ElevenLabs + 系统TTS回退）。 实时画布 — 具有A2UI的代理驱动视觉工作区。 一流工具 — 浏览器、画布、节点、定时任务、会话以及Discord/Slack操作。 Companion应用 — Windows Hub、macOS菜单栏应用以及iOS/Android节点。 Onboarding + 技能 — 基于引导式设置，包含捆绑/托管/工作区技能。 安全模型（重要） [!IMPORTANT] - 默认：main会话的工具在主机上运行，因此当仅你使用时，代理拥有完全访问权限。 - 群组/渠道安全：设置 agents.defaults.sandbox.mode: "non-main" 可在沙箱中运行非main会话。Docker是默认沙箱后端；也支持SSH和OpenShell后端。 - 典型沙箱默认值：允许 bash、process、read、write、edit、sessionslist、sessionshistory、sessionssend、sessionsspawn；拒绝 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 会话工具：sessionslist、sessionshistory、sessions_send 技能注册表：ClawHub 架构概览：架构 按目标分类的文档 应用（可选） 仅网关即可提供出色体验。所有应用均为可选，用于添加额外功能。 如果计划构建/运行companion应用，请遵循以下平台运行手册。 macOS（OpenClaw.app）（可选） 网关和健康状态的菜单栏控制。 语音唤醒 + 按键通话覆盖层。 WebChat + 调试工具。 通过SSH进行远程网关控制。 注意：macOS权限需要签名构建才能在重建后保持（参见macOS权限）。 iOS节点（可选） 通过网关WebSocket配对为节点（设备配对）。 语音触发转发 + Canvas界面。 通过 openclaw nodes … 控制。 运行手册：iOS连接。 Android节点（可选） 通过设备配对作为WS节点（openclaw devices ...）。 提供连接/聊天/语音选项卡，以及Canvas、相机、屏幕捕获和Android设备命令系列。 运行手册：Android连接。 从源码构建（开发） 源码检出使用 pnpm。仓库是pnpm工作区，开发期间捆绑插件从 extensions/ 加载，因此会直接使用其包本地依赖和你的编辑内容。在仓库根目录执行普通 npm install 不是受支持的源码设置方式。 开发循环： 如果需要从检出内容构建 dist/（用于Node、打包或发布验证），运行： pnpm openclaw setup 会写入 pnpm gateway:watch 所需的本地配置/工作区。可以安全地重新运行，但通常仅在首次设置或重置本地状态后需要。pnpm gateway:watch 不会重建 dist/control-ui，因此在 ui/ 更改后需重新运行 pnpm ui:build，或在迭代Control UI时使用 pnpm ui:dev。如果希望此检出直接运行onboarding，使用 pnpm openclaw onboard --install-daemon。 注意：pnpm openclaw ... 直接运行TypeScript（通过 tsx）。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（模型 + 默认值）： 完整配置参考（所有键 + 示例）。 Star History Molty OpenClaw 是为 Molty 构建的，这是一个太空龙虾AI助手。🦞 由 Peter Steinberger 和社区开发。 openclaw.ai soul.md steipete.me @openclaw 社区 有关指南、维护者以及如何提交PR，请参见 CONTRIBUTING.md。 欢迎AI/氛围编码的PR！🤖 特别感谢 Mario Zechner 的支持以及pi-mono。 特别感谢 Adam Doppelt 提供 lobster.bot 域名。 感谢所有clawtributors：

🦞 OpenClaw — 个人AI助手 EXFOLIATE! EXFOLIATE! OpenClaw 是一款可在你自己设备上运行的个人AI助手。它通过你已在使用的渠道与你交互，支持在macOS/iOS/Android上进行语音交互，并能渲染一个由你控制的实时Canvas。网关（Gateway）只是控制平面，核心产品是助手本身。 如果你需要一个个人化、单用户、本地运行、响应迅速且始终在线的助手，这就是你的选择。 支持的渠道包括：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 onboard。 OpenClaw Onboard 会逐步引导你完成网关、工作区、渠道和技能的设置。这是推荐的CLI设置路径，适用于macOS、Linux和Windows。 Windows桌面用户可通过原生Windows Hub companion应用开始设置，该应用提供托盘状态、聊天、节点模式和本地MCP模式功能。 支持npm、pnpm或bun。 赞助商 订阅（OAuth）： OpenAI（ChatGPT/Codex） 模型说明：虽然支持多种提供商和模型，但建议优先选择你信任且已在使用的提供商的当前旗舰模型。参见Onboarding。 安装（推荐） 运行时：Node 24（推荐）或 Node 22.19+。 OpenClaw Onboard 会安装网关守护进程（launchd/systemd 用户服务），确保其持续运行。 快速开始（TL;DR） 运行时：Node 24（推荐）或 Node 22.19+。 完整新手指南（认证、配对、渠道）：入门指南 推荐守护进程模式： 前台/调试模式： 任一启动模式运行后，发送测试消息或向助手提问： 升级？更新指南（并运行 openclaw doctor）。 模型配置 + CLI：模型。认证配置文件轮换 + 回退：模型故障转移。 安全默认值（私信访问） OpenClaw 连接到真实的消息界面。请将入站私信视为不可信输入。 完整安全指南：安全。 远程暴露前，请使用网关暴露运行手册。 Telegram/WhatsApp/Signal/iMessage/Microsoft Teams/Discord/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 以发现风险/配置错误的私信策略。 功能亮点 本地优先网关 — 用于会话、渠道、工具和事件的单一控制平面。 多渠道收件箱 — 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、macOS、iOS/Android。 多代理路由 — 将入站渠道/账户/对等方路由到隔离的代理（工作区 + 每代理会话）。 语音唤醒 + 对话模式 — macOS/iOS上的唤醒词和Android上的连续语音（ElevenLabs + 系统TTS回退）。 实时画布 — 具有A2UI的代理驱动视觉工作区。 一流工具 — 浏览器、画布、节点、定时任务、会话以及Discord/Slack操作。 Companion应用 — Windows Hub、macOS菜单栏应用以及iOS/Android节点。 Onboarding + 技能 — 基于引导式设置，包含捆绑/托管/工作区技能。 安全模型（重要） [!IMPORTANT] - 默认：main会话的工具在主机上运行，因此当仅你使用时，代理拥有完全访问权限。 - 群组/渠道安全：设置 agents.defaults.sandbox.mode: "non-main" 可在沙箱中运行非main会话。Docker是默认沙箱后端；也支持SSH和OpenShell后端。 - 典型沙箱默认值：允许 bash、process、read、write、edit、sessionslist、sessionshistory、sessionssend、sessionsspawn；拒绝 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 会话工具：sessionslist、sessionshistory、sessions_send 技能注册表：ClawHub 架构概览：架构 按目标分类的文档 应用（可选） 仅网关即可提供出色体验。所有应用均为可选，用于添加额外功能。 如果计划构建/运行companion应用，请遵循以下平台运行手册。 macOS（OpenClaw.app）（可选） 网关和健康状态的菜单栏控制。 语音唤醒 + 按键通话覆盖层。 WebChat + 调试工具。 通过SSH进行远程网关控制。 注意：macOS权限需要签名构建才能在重建后保持（参见macOS权限）。 iOS节点（可选） 通过网关WebSocket配对为节点（设备配对）。 语音触发转发 + Canvas界面。 通过 openclaw nodes … 控制。 运行手册：iOS连接。 Android节点（可选） 通过设备配对作为WS节点（openclaw devices ...）。 提供连接/聊天/语音选项卡，以及Canvas、相机、屏幕捕获和Android设备命令系列。 运行手册：Android连接。 从源码构建（开发） 源码检出使用 pnpm。仓库是pnpm工作区，开发期间捆绑插件从 extensions/ 加载，因此会直接使用其包本地依赖和你的编辑内容。在仓库根目录执行普通 npm install 不是受支持的源码设置方式。 开发循环： 如果需要从检出内容构建 dist/（用于Node、打包或发布验证），运行： pnpm openclaw setup 会写入 pnpm gateway:watch 所需的本地配置/工作区。可以安全地重新运行，但通常仅在首次设置或重置本地状态后需要。pnpm gateway:watch 不会重建 dist/control-ui，因此在 ui/ 更改后需重新运行 pnpm ui:build，或在迭代Control UI时使用 pnpm ui:dev。如果希望此检出直接运行onboarding，使用 pnpm openclaw onboard --install-daemon。 注意：pnpm openclaw ... 直接运行TypeScript（通过 tsx）。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（模型 + 默认值）： 完整配置参考（所有键 + 示例）。 Star History Molty OpenClaw 是为 Molty 构建的，这是一个太空龙虾AI助手。🦞 由 Peter Steinberger 和社区开发。 openclaw.ai soul.md steipete.me @openclaw 社区 有关指南、维护者以及如何提交PR，请参见 CONTRIBUTING.md。 欢迎AI/氛围编码的PR！🤖 特别感谢 Mario Zechner 的支持以及pi-mono。 特别感谢 Adam Doppelt 提供 lobster.bot 域名。 感谢所有clawtributors：

🦞 OpenClaw — 个人AI助手 EXFOLIATE! EXFOLIATE! OpenClaw 是一款可在你自己设备上运行的个人AI助手。它通过你已在使用的渠道与你交互，支持在macOS/iOS/Android上进行语音交互，并能渲染一个由你控制的实时Canvas。网关（Gateway）只是控制平面，核心产品是助手本身。 如果你需要一个个人化、单用户、本地运行、响应迅速且始终在线的助手，这就是你的选择。 支持的渠道包括：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 onboard。 OpenClaw Onboard 会逐步引导你完成网关、工作区、渠道和技能的设置。这是推荐的CLI设置路径，适用于macOS、Linux和Windows。 Windows桌面用户可通过原生Windows Hub companion应用开始设置，该应用提供托盘状态、聊天、节点模式和本地MCP模式功能。 支持npm、pnpm或bun。 赞助商 订阅（OAuth）： OpenAI（ChatGPT/Codex） 模型说明：虽然支持多种提供商和模型，但建议优先选择你信任且已在使用的提供商的当前旗舰模型。参见Onboarding。 安装（推荐） 运行时：Node 24（推荐）或 Node 22.19+。 OpenClaw Onboard 会安装网关守护进程（launchd/systemd 用户服务），确保其持续运行。 快速开始（TL;DR） 运行时：Node 24（推荐）或 Node 22.19+。 完整新手指南（认证、配对、渠道）：入门指南 推荐守护进程模式： 前台/调试模式： 任一启动模式运行后，发送测试消息或向助手提问： 升级？更新指南（并运行 openclaw doctor）。 模型配置 + CLI：模型。认证配置文件轮换 + 回退：模型故障转移。 安全默认值（私信访问） OpenClaw 连接到真实的消息界面。请将入站私信视为不可信输入。 完整安全指南：安全。 远程暴露前，请使用网关暴露运行手册。 Telegram/WhatsApp/Signal/iMessage/Microsoft Teams/Discord/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 以发现风险/配置错误的私信策略。 功能亮点 本地优先网关 — 用于会话、渠道、工具和事件的单一控制平面。 多渠道收件箱 — 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、macOS、iOS/Android。 多代理路由 — 将入站渠道/账户/对等方路由到隔离的代理（工作区 + 每代理会话）。 语音唤醒 + 对话模式 — macOS/iOS上的唤醒词和Android上的连续语音（ElevenLabs + 系统TTS回退）。 实时画布 — 具有A2UI的代理驱动视觉工作区。 一流工具 — 浏览器、画布、节点、定时任务、会话以及Discord/Slack操作。 Companion应用 — Windows Hub、macOS菜单栏应用以及iOS/Android节点。 Onboarding + 技能 — 基于引导式设置，包含捆绑/托管/工作区技能。 安全模型（重要） [!IMPORTANT] - 默认：main会话的工具在主机上运行，因此当仅你使用时，代理拥有完全访问权限。 - 群组/渠道安全：设置 agents.defaults.sandbox.mode: "non-main" 可在沙箱中运行非main会话。Docker是默认沙箱后端；也支持SSH和OpenShell后端。 - 典型沙箱默认值：允许 bash、process、read、write、edit、sessionslist、sessionshistory、sessionssend、sessionsspawn；拒绝 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 会话工具：sessionslist、sessionshistory、sessions_send 技能注册表：ClawHub 架构概览：架构 按目标分类的文档 应用（可选） 仅网关即可提供出色体验。所有应用均为可选，用于添加额外功能。 如果计划构建/运行companion应用，请遵循以下平台运行手册。 macOS（OpenClaw.app）（可选） 网关和健康状态的菜单栏控制。 语音唤醒 + 按键通话覆盖层。 WebChat + 调试工具。 通过SSH进行远程网关控制。 注意：macOS权限需要签名构建才能在重建后保持（参见macOS权限）。 iOS节点（可选） 通过网关WebSocket配对为节点（设备配对）。 语音触发转发 + Canvas界面。 通过 openclaw nodes … 控制。 运行手册：iOS连接。 Android节点（可选） 通过设备配对作为WS节点（openclaw devices ...）。 提供连接/聊天/语音选项卡，以及Canvas、相机、屏幕捕获和Android设备命令系列。 运行手册：Android连接。 从源码构建（开发） 源码检出使用 pnpm。仓库是pnpm工作区，开发期间捆绑插件从 extensions/ 加载，因此会直接使用其包本地依赖和你的编辑内容。在仓库根目录执行普通 npm install 不是受支持的源码设置方式。 开发循环： 如果需要从检出内容构建 dist/（用于Node、打包或发布验证），运行： pnpm openclaw setup 会写入 pnpm gateway:watch 所需的本地配置/工作区。可以安全地重新运行，但通常仅在首次设置或重置本地状态后需要。pnpm gateway:watch 不会重建 dist/control-ui，因此在 ui/ 更改后需重新运行 pnpm ui:build，或在迭代Control UI时使用 pnpm ui:dev。如果希望此检出直接运行onboarding，使用 pnpm openclaw onboard --install-daemon。 注意：pnpm openclaw ... 直接运行TypeScript（通过 tsx）。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（模型 + 默认值）： 完整配置参考（所有键 + 示例）。 Star History Molty OpenClaw 是为 Molty 构建的，这是一个太空龙虾AI助手。🦞 由 Peter Steinberger 和社区开发。 openclaw.ai soul.md steipete.me @openclaw 社区 有关指南、维护者以及如何提交PR，请参见 CONTRIBUTING.md。 欢迎AI/氛围编码的PR！🤖 特别感谢 Mario Zechner 的支持以及pi-mono。 特别感谢 Adam Doppelt 提供 lobster.bot 域名。 感谢所有clawtributors：

🦞 OpenClaw — 个人AI助手 EXFOLIATE! EXFOLIATE! OpenClaw 是一款可在你自己设备上运行的个人AI助手。它通过你已在使用的渠道与你交互，支持在macOS/iOS/Android上进行语音交互，并能渲染一个由你控制的实时Canvas。网关（Gateway）只是控制平面，核心产品是助手本身。 如果你需要一个个人化、单用户、本地运行、响应迅速且始终在线的助手，这就是你的选择。 支持的渠道包括：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 onboard。 OpenClaw Onboard 会逐步引导你完成网关、工作区、渠道和技能的设置。这是推荐的CLI设置路径，适用于macOS、Linux和Windows。 Windows桌面用户可通过原生Windows Hub companion应用开始设置，该应用提供托盘状态、聊天、节点模式和本地MCP模式功能。 支持npm、pnpm或bun。 赞助商 订阅（OAuth）： OpenAI（ChatGPT/Codex） 模型说明：虽然支持多种提供商和模型，但建议优先选择你信任且已在使用的提供商的当前旗舰模型。参见Onboarding。 安装（推荐） 运行时：Node 24（推荐）或 Node 22.19+。 OpenClaw Onboard 会安装网关守护进程（launchd/systemd 用户服务），确保其持续运行。 快速开始（TL;DR） 运行时：Node 24（推荐）或 Node 22.19+。 完整新手指南（认证、配对、渠道）：入门指南 推荐守护进程模式： 前台/调试模式： 任一启动模式运行后，发送测试消息或向助手提问： 升级？更新指南（并运行 openclaw doctor）。 模型配置 + CLI：模型。认证配置文件轮换 + 回退：模型故障转移。 安全默认值（私信访问） OpenClaw 连接到真实的消息界面。请将入站私信视为不可信输入。 完整安全指南：安全。 远程暴露前，请使用网关暴露运行手册。 Telegram/WhatsApp/Signal/iMessage/Microsoft Teams/Discord/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 以发现风险/配置错误的私信策略。 功能亮点 本地优先网关 — 用于会话、渠道、工具和事件的单一控制平面。 多渠道收件箱 — 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、macOS、iOS/Android。 多代理路由 — 将入站渠道/账户/对等方路由到隔离的代理（工作区 + 每代理会话）。 语音唤醒 + 对话模式 — macOS/iOS上的唤醒词和Android上的连续语音（ElevenLabs + 系统TTS回退）。 实时画布 — 具有A2UI的代理驱动视觉工作区。 一流工具 — 浏览器、画布、节点、定时任务、会话以及Discord/Slack操作。 Companion应用 — Windows Hub、macOS菜单栏应用以及iOS/Android节点。 Onboarding + 技能 — 基于引导式设置，包含捆绑/托管/工作区技能。 安全模型（重要） [!IMPORTANT] - 默认：main会话的工具在主机上运行，因此当仅你使用时，代理拥有完全访问权限。 - 群组/渠道安全：设置 agents.defaults.sandbox.mode: "non-main" 可在沙箱中运行非main会话。Docker是默认沙箱后端；也支持SSH和OpenShell后端。 - 典型沙箱默认值：允许 bash、process、read、write、edit、sessionslist、sessionshistory、sessionssend、sessionsspawn；拒绝 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 会话工具：sessionslist、sessionshistory、sessions_send 技能注册表：ClawHub 架构概览：架构 按目标分类的文档 应用（可选） 仅网关即可提供出色体验。所有应用均为可选，用于添加额外功能。 如果计划构建/运行companion应用，请遵循以下平台运行手册。 macOS（OpenClaw.app）（可选） 网关和健康状态的菜单栏控制。 语音唤醒 + 按键通话覆盖层。 WebChat + 调试工具。 通过SSH进行远程网关控制。 注意：macOS权限需要签名构建才能在重建后保持（参见macOS权限）。 iOS节点（可选） 通过网关WebSocket配对为节点（设备配对）。 语音触发转发 + Canvas界面。 通过 openclaw nodes … 控制。 运行手册：iOS连接。 Android节点（可选） 通过设备配对作为WS节点（openclaw devices ...）。 提供连接/聊天/语音选项卡，以及Canvas、相机、屏幕捕获和Android设备命令系列。 运行手册：Android连接。 从源码构建（开发） 源码检出使用 pnpm。仓库是pnpm工作区，开发期间捆绑插件从 extensions/ 加载，因此会直接使用其包本地依赖和你的编辑内容。在仓库根目录执行普通 npm install 不是受支持的源码设置方式。 开发循环： 如果需要从检出内容构建 dist/（用于Node、打包或发布验证），运行： pnpm openclaw setup 会写入 pnpm gateway:watch 所需的本地配置/工作区。可以安全地重新运行，但通常仅在首次设置或重置本地状态后需要。pnpm gateway:watch 不会重建 dist/control-ui，因此在 ui/ 更改后需重新运行 pnpm ui:build，或在迭代Control UI时使用 pnpm ui:dev。如果希望此检出直接运行onboarding，使用 pnpm openclaw onboard --install-daemon。 注意：pnpm openclaw ... 直接运行TypeScript（通过 tsx）。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（模型 + 默认值）： 完整配置参考（所有键 + 示例）。 Star History Molty OpenClaw 是为 Molty 构建的，这是一个太空龙虾AI助手。🦞 由 Peter Steinberger 和社区开发。 openclaw.ai soul.md steipete.me @openclaw 社区 有关指南、维护者以及如何提交PR，请参见 CONTRIBUTING.md。 欢迎AI/氛围编码的PR！🤖 特别感谢 Mario Zechner 的支持以及pi-mono。 特别感谢 Adam Doppelt 提供 lobster.bot 域名。 感谢所有clawtributors：

🦞 OpenClaw — 个人AI助手 EXFOLIATE! EXFOLIATE! OpenClaw 是一款可在你自己设备上运行的个人AI助手。它通过你已在使用的渠道与你交互，支持在macOS/iOS/Android上进行语音交互，并能渲染一个由你控制的实时Canvas。网关（Gateway）只是控制平面，核心产品是助手本身。 如果你需要一个个人化、单用户、本地运行、响应迅速且始终在线的助手，这就是你的选择。 支持的渠道包括：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 onboard。 OpenClaw Onboard 会逐步引导你完成网关、工作区、渠道和技能的设置。这是推荐的CLI设置路径，适用于macOS、Linux和Windows。 Windows桌面用户可通过原生Windows Hub companion应用开始设置，该应用提供托盘状态、聊天、节点模式和本地MCP模式功能。 支持npm、pnpm或bun。 赞助商 订阅（OAuth）： OpenAI（ChatGPT/Codex） 模型说明：虽然支持多种提供商和模型，但建议优先选择你信任且已在使用的提供商的当前旗舰模型。参见Onboarding。 安装（推荐） 运行时：Node 24（推荐）或 Node 22.19+。 OpenClaw Onboard 会安装网关守护进程（launchd/systemd 用户服务），确保其持续运行。 快速开始（TL;DR） 运行时：Node 24（推荐）或 Node 22.19+。 完整新手指南（认证、配对、渠道）：入门指南 推荐守护进程模式： 前台/调试模式： 任一启动模式运行后，发送测试消息或向助手提问： 升级？更新指南（并运行 openclaw doctor）。 模型配置 + CLI：模型。认证配置文件轮换 + 回退：模型故障转移。 安全默认值（私信访问） OpenClaw 连接到真实的消息界面。请将入站私信视为不可信输入。 完整安全指南：安全。 远程暴露前，请使用网关暴露运行手册。 Telegram/WhatsApp/Signal/iMessage/Microsoft Teams/Discord/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 以发现风险/配置错误的私信策略。 功能亮点 本地优先网关 — 用于会话、渠道、工具和事件的单一控制平面。 多渠道收件箱 — 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、macOS、iOS/Android。 多代理路由 — 将入站渠道/账户/对等方路由到隔离的代理（工作区 + 每代理会话）。 语音唤醒 + 对话模式 — macOS/iOS上的唤醒词和Android上的连续语音（ElevenLabs + 系统TTS回退）。 实时画布 — 具有A2UI的代理驱动视觉工作区。 一流工具 — 浏览器、画布、节点、定时任务、会话以及Discord/Slack操作。 Companion应用 — Windows Hub、macOS菜单栏应用以及iOS/Android节点。 Onboarding + 技能 — 基于引导式设置，包含捆绑/托管/工作区技能。 安全模型（重要） [!IMPORTANT] - 默认：main会话的工具在主机上运行，因此当仅你使用时，代理拥有完全访问权限。 - 群组/渠道安全：设置 agents.defaults.sandbox.mode: "non-main" 可在沙箱中运行非main会话。Docker是默认沙箱后端；也支持SSH和OpenShell后端。 - 典型沙箱默认值：允许 bash、process、read、write、edit、sessionslist、sessionshistory、sessionssend、sessionsspawn；拒绝 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 会话工具：sessionslist、sessionshistory、sessions_send 技能注册表：ClawHub 架构概览：架构 按目标分类的文档 应用（可选） 仅网关即可提供出色体验。所有应用均为可选，用于添加额外功能。 如果计划构建/运行companion应用，请遵循以下平台运行手册。 macOS（OpenClaw.app）（可选） 网关和健康状态的菜单栏控制。 语音唤醒 + 按键通话覆盖层。 WebChat + 调试工具。 通过SSH进行远程网关控制。 注意：macOS权限需要签名构建才能在重建后保持（参见macOS权限）。 iOS节点（可选） 通过网关WebSocket配对为节点（设备配对）。 语音触发转发 + Canvas界面。 通过 openclaw nodes … 控制。 运行手册：iOS连接。 Android节点（可选） 通过设备配对作为WS节点（openclaw devices ...）。 提供连接/聊天/语音选项卡，以及Canvas、相机、屏幕捕获和Android设备命令系列。 运行手册：Android连接。 从源码构建（开发） 源码检出使用 pnpm。仓库是pnpm工作区，开发期间捆绑插件从 extensions/ 加载，因此会直接使用其包本地依赖和你的编辑内容。在仓库根目录执行普通 npm install 不是受支持的源码设置方式。 开发循环： 如果需要从检出内容构建 dist/（用于Node、打包或发布验证），运行： pnpm openclaw setup 会写入 pnpm gateway:watch 所需的本地配置/工作区。可以安全地重新运行，但通常仅在首次设置或重置本地状态后需要。pnpm gateway:watch 不会重建 dist/control-ui，因此在 ui/ 更改后需重新运行 pnpm ui:build，或在迭代Control UI时使用 pnpm ui:dev。如果希望此检出直接运行onboarding，使用 pnpm openclaw onboard --install-daemon。 注意：pnpm openclaw ... 直接运行TypeScript（通过 tsx）。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（模型 + 默认值）： 完整配置参考（所有键 + 示例）。 Star History Molty OpenClaw 是为 Molty 构建的，这是一个太空龙虾AI助手。🦞 由 Peter Steinberger 和社区开发。 openclaw.ai soul.md steipete.me @openclaw 社区 有关指南、维护者以及如何提交PR，请参见 CONTRIBUTING.md。 欢迎AI/氛围编码的PR！🤖 特别感谢 Mario Zechner 的支持以及pi-mono。 特别感谢 Adam Doppelt 提供 lobster.bot 域名。 感谢所有clawtributors：

🦞 OpenClaw — 个人AI助手 EXFOLIATE! EXFOLIATE! OpenClaw 是一款可在你自己设备上运行的个人AI助手。它通过你已在使用的渠道与你交互，支持在macOS/iOS/Android上进行语音交互，并能渲染一个由你控制的实时Canvas。网关（Gateway）只是控制平面，核心产品是助手本身。 如果你需要一个个人化、单用户、本地运行、响应迅速且始终在线的助手，这就是你的选择。 支持的渠道包括：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 onboard。 OpenClaw Onboard 会逐步引导你完成网关、工作区、渠道和技能的设置。这是推荐的CLI设置路径，适用于macOS、Linux和Windows。 Windows桌面用户可通过原生Windows Hub companion应用开始设置，该应用提供托盘状态、聊天、节点模式和本地MCP模式功能。 支持npm、pnpm或bun。 赞助商 订阅（OAuth）： OpenAI（ChatGPT/Codex） 模型说明：虽然支持多种提供商和模型，但建议优先选择你信任且已在使用的提供商的当前旗舰模型。参见Onboarding。 安装（推荐） 运行时：Node 24（推荐）或 Node 22.19+。 OpenClaw Onboard 会安装网关守护进程（launchd/systemd 用户服务），确保其持续运行。 快速开始（TL;DR） 运行时：Node 24（推荐）或 Node 22.19+。 完整新手指南（认证、配对、渠道）：入门指南 推荐守护进程模式： 前台/调试模式： 任一启动模式运行后，发送测试消息或向助手提问： 升级？更新指南（并运行 openclaw doctor）。 模型配置 + CLI：模型。认证配置文件轮换 + 回退：模型故障转移。 安全默认值（私信访问） OpenClaw 连接到真实的消息界面。请将入站私信视为不可信输入。 完整安全指南：安全。 远程暴露前，请使用网关暴露运行手册。 Telegram/WhatsApp/Signal/iMessage/Microsoft Teams/Discord/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 以发现风险/配置错误的私信策略。 功能亮点 本地优先网关 — 用于会话、渠道、工具和事件的单一控制平面。 多渠道收件箱 — 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、macOS、iOS/Android。 多代理路由 — 将入站渠道/账户/对等方路由到隔离的代理（工作区 + 每代理会话）。 语音唤醒 + 对话模式 — macOS/iOS上的唤醒词和Android上的连续语音（ElevenLabs + 系统TTS回退）。 实时画布 — 具有A2UI的代理驱动视觉工作区。 一流工具 — 浏览器、画布、节点、定时任务、会话以及Discord/Slack操作。 Companion应用 — Windows Hub、macOS菜单栏应用以及iOS/Android节点。 Onboarding + 技能 — 基于引导式设置，包含捆绑/托管/工作区技能。 安全模型（重要） [!IMPORTANT] - 默认：main会话的工具在主机上运行，因此当仅你使用时，代理拥有完全访问权限。 - 群组/渠道安全：设置 agents.defaults.sandbox.mode: "non-main" 可在沙箱中运行非main会话。Docker是默认沙箱后端；也支持SSH和OpenShell后端。 - 典型沙箱默认值：允许 bash、process、read、write、edit、sessionslist、sessionshistory、sessionssend、sessionsspawn；拒绝 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 会话工具：sessionslist、sessionshistory、sessions_send 技能注册表：ClawHub 架构概览：架构 按目标分类的文档 应用（可选） 仅网关即可提供出色体验。所有应用均为可选，用于添加额外功能。 如果计划构建/运行companion应用，请遵循以下平台运行手册。 macOS（OpenClaw.app）（可选） 网关和健康状态的菜单栏控制。 语音唤醒 + 按键通话覆盖层。 WebChat + 调试工具。 通过SSH进行远程网关控制。 注意：macOS权限需要签名构建才能在重建后保持（参见macOS权限）。 iOS节点（可选） 通过网关WebSocket配对为节点（设备配对）。 语音触发转发 + Canvas界面。 通过 openclaw nodes … 控制。 运行手册：iOS连接。 Android节点（可选） 通过设备配对作为WS节点（openclaw devices ...）。 提供连接/聊天/语音选项卡，以及Canvas、相机、屏幕捕获和Android设备命令系列。 运行手册：Android连接。 从源码构建（开发） 源码检出使用 pnpm。仓库是pnpm工作区，开发期间捆绑插件从 extensions/ 加载，因此会直接使用其包本地依赖和你的编辑内容。在仓库根目录执行普通 npm install 不是受支持的源码设置方式。 开发循环： 如果需要从检出内容构建 dist/（用于Node、打包或发布验证），运行： pnpm openclaw setup 会写入 pnpm gateway:watch 所需的本地配置/工作区。可以安全地重新运行，但通常仅在首次设置或重置本地状态后需要。pnpm gateway:watch 不会重建 dist/control-ui，因此在 ui/ 更改后需重新运行 pnpm ui:build，或在迭代Control UI时使用 pnpm ui:dev。如果希望此检出直接运行onboarding，使用 pnpm openclaw onboard --install-daemon。 注意：pnpm openclaw ... 直接运行TypeScript（通过 tsx）。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（模型 + 默认值）： 完整配置参考（所有键 + 示例）。 Star History Molty OpenClaw 是为 Molty 构建的，这是一个太空龙虾AI助手。🦞 由 Peter Steinberger 和社区开发。 openclaw.ai soul.md steipete.me @openclaw 社区 有关指南、维护者以及如何提交PR，请参见 CONTRIBUTING.md。 欢迎AI/氛围编码的PR！🤖 特别感谢 Mario Zechner 的支持以及pi-mono。 特别感谢 Adam Doppelt 提供 lobster.bot 域名。 感谢所有clawtributors：

🦞 OpenClaw — 个人AI助手 EXFOLIATE! EXFOLIATE! OpenClaw 是一款可在你自己设备上运行的个人AI助手。它通过你已在使用的渠道与你交互，支持在macOS/iOS/Android上进行语音交互，并能渲染一个由你控制的实时Canvas。网关（Gateway）只是控制平面，核心产品是助手本身。 如果你需要一个个人化、单用户、本地运行、响应迅速且始终在线的助手，这就是你的选择。 支持的渠道包括：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 onboard。 OpenClaw Onboard 会逐步引导你完成网关、工作区、渠道和技能的设置。这是推荐的CLI设置路径，适用于macOS、Linux和Windows。 Windows桌面用户可通过原生Windows Hub companion应用开始设置，该应用提供托盘状态、聊天、节点模式和本地MCP模式功能。 支持npm、pnpm或bun。 赞助商 订阅（OAuth）： OpenAI（ChatGPT/Codex） 模型说明：虽然支持多种提供商和模型，但建议优先选择你信任且已在使用的提供商的当前旗舰模型。参见Onboarding。 安装（推荐） 运行时：Node 24（推荐）或 Node 22.19+。 OpenClaw Onboard 会安装网关守护进程（launchd/systemd 用户服务），确保其持续运行。 快速开始（TL;DR） 运行时：Node 24（推荐）或 Node 22.19+。 完整新手指南（认证、配对、渠道）：入门指南 推荐守护进程模式： 前台/调试模式： 任一启动模式运行后，发送测试消息或向助手提问： 升级？更新指南（并运行 openclaw doctor）。 模型配置 + CLI：模型。认证配置文件轮换 + 回退：模型故障转移。 安全默认值（私信访问） OpenClaw 连接到真实的消息界面。请将入站私信视为不可信输入。 完整安全指南：安全。 远程暴露前，请使用网关暴露运行手册。 Telegram/WhatsApp/Signal/iMessage/Microsoft Teams/Discord/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 以发现风险/配置错误的私信策略。 功能亮点 本地优先网关 — 用于会话、渠道、工具和事件的单一控制平面。 多渠道收件箱 — 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、macOS、iOS/Android。 多代理路由 — 将入站渠道/账户/对等方路由到隔离的代理（工作区 + 每代理会话）。 语音唤醒 + 对话模式 — macOS/iOS上的唤醒词和Android上的连续语音（ElevenLabs + 系统TTS回退）。 实时画布 — 具有A2UI的代理驱动视觉工作区。 一流工具 — 浏览器、画布、节点、定时任务、会话以及Discord/Slack操作。 Companion应用 — Windows Hub、macOS菜单栏应用以及iOS/Android节点。 Onboarding + 技能 — 基于引导式设置，包含捆绑/托管/工作区技能。 安全模型（重要） [!IMPORTANT] - 默认：main会话的工具在主机上运行，因此当仅你使用时，代理拥有完全访问权限。 - 群组/渠道安全：设置 agents.defaults.sandbox.mode: "non-main" 可在沙箱中运行非main会话。Docker是默认沙箱后端；也支持SSH和OpenShell后端。 - 典型沙箱默认值：允许 bash、process、read、write、edit、sessionslist、sessionshistory、sessionssend、sessionsspawn；拒绝 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 会话工具：sessionslist、sessionshistory、sessions_send 技能注册表：ClawHub 架构概览：架构 按目标分类的文档 应用（可选） 仅网关即可提供出色体验。所有应用均为可选，用于添加额外功能。 如果计划构建/运行companion应用，请遵循以下平台运行手册。 macOS（OpenClaw.app）（可选） 网关和健康状态的菜单栏控制。 语音唤醒 + 按键通话覆盖层。 WebChat + 调试工具。 通过SSH进行远程网关控制。 注意：macOS权限需要签名构建才能在重建后保持（参见macOS权限）。 iOS节点（可选） 通过网关WebSocket配对为节点（设备配对）。 语音触发转发 + Canvas界面。 通过 openclaw nodes … 控制。 运行手册：iOS连接。 Android节点（可选） 通过设备配对作为WS节点（openclaw devices ...）。 提供连接/聊天/语音选项卡，以及Canvas、相机、屏幕捕获和Android设备命令系列。 运行手册：Android连接。 从源码构建（开发） 源码检出使用 pnpm。仓库是pnpm工作区，开发期间捆绑插件从 extensions/ 加载，因此会直接使用其包本地依赖和你的编辑内容。在仓库根目录执行普通 npm install 不是受支持的源码设置方式。 开发循环： 如果需要从检出内容构建 dist/（用于Node、打包或发布验证），运行： pnpm openclaw setup 会写入 pnpm gateway:watch 所需的本地配置/工作区。可以安全地重新运行，但通常仅在首次设置或重置本地状态后需要。pnpm gateway:watch 不会重建 dist/control-ui，因此在 ui/ 更改后需重新运行 pnpm ui:build，或在迭代Control UI时使用 pnpm ui:dev。如果希望此检出直接运行onboarding，使用 pnpm openclaw onboard --install-daemon。 注意：pnpm openclaw ... 直接运行TypeScript（通过 tsx）。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（模型 + 默认值）： 完整配置参考（所有键 + 示例）。 Star History Molty OpenClaw 是为 Molty 构建的，这是一个太空龙虾AI助手。🦞 由 Peter Steinberger 和社区开发。 openclaw.ai soul.md steipete.me @openclaw 社区 有关指南、维护者以及如何提交PR，请参见 CONTRIBUTING.md。 欢迎AI/氛围编码的PR！🤖 特别感谢 Mario Zechner 的支持以及pi-mono。 特别感谢 Adam Doppelt 提供 lobster.bot 域名。 感谢所有clawtributors：

🦞 OpenClaw — 个人AI助手 EXFOLIATE! EXFOLIATE! OpenClaw 是一款可在你自己设备上运行的个人AI助手。它通过你已在使用的渠道与你交互，支持在macOS/iOS/Android上进行语音交互，并能渲染一个由你控制的实时Canvas。网关（Gateway）只是控制平面，核心产品是助手本身。 如果你需要一个个人化、单用户、本地运行、响应迅速且始终在线的助手，这就是你的选择。 支持的渠道包括：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 onboard。 OpenClaw Onboard 会逐步引导你完成网关、工作区、渠道和技能的设置。这是推荐的CLI设置路径，适用于macOS、Linux和Windows。 Windows桌面用户可通过原生Windows Hub companion应用开始设置，该应用提供托盘状态、聊天、节点模式和本地MCP模式功能。 支持npm、pnpm或bun。 赞助商 订阅（OAuth）： OpenAI（ChatGPT/Codex） 模型说明：虽然支持多种提供商和模型，但建议优先选择你信任且已在使用的提供商的当前旗舰模型。参见Onboarding。 安装（推荐） 运行时：Node 24（推荐）或 Node 22.19+。 OpenClaw Onboard 会安装网关守护进程（launchd/systemd 用户服务），确保其持续运行。 快速开始（TL;DR） 运行时：Node 24（推荐）或 Node 22.19+。 完整新手指南（认证、配对、渠道）：入门指南 推荐守护进程模式： 前台/调试模式： 任一启动模式运行后，发送测试消息或向助手提问： 升级？更新指南（并运行 openclaw doctor）。 模型配置 + CLI：模型。认证配置文件轮换 + 回退：模型故障转移。 安全默认值（私信访问） OpenClaw 连接到真实的消息界面。请将入站私信视为不可信输入。 完整安全指南：安全。 远程暴露前，请使用网关暴露运行手册。 Telegram/WhatsApp/Signal/iMessage/Microsoft Teams/Discord/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 以发现风险/配置错误的私信策略。 功能亮点 本地优先网关 — 用于会话、渠道、工具和事件的单一控制平面。 多渠道收件箱 — 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、macOS、iOS/Android。 多代理路由 — 将入站渠道/账户/对等方路由到隔离的代理（工作区 + 每代理会话）。 语音唤醒 + 对话模式 — macOS/iOS上的唤醒词和Android上的连续语音（ElevenLabs + 系统TTS回退）。 实时画布 — 具有A2UI的代理驱动视觉工作区。 一流工具 — 浏览器、画布、节点、定时任务、会话以及Discord/Slack操作。 Companion应用 — Windows Hub、macOS菜单栏应用以及iOS/Android节点。 Onboarding + 技能 — 基于引导式设置，包含捆绑/托管/工作区技能。 安全模型（重要） [!IMPORTANT] - 默认：main会话的工具在主机上运行，因此当仅你使用时，代理拥有完全访问权限。 - 群组/渠道安全：设置 agents.defaults.sandbox.mode: "non-main" 可在沙箱中运行非main会话。Docker是默认沙箱后端；也支持SSH和OpenShell后端。 - 典型沙箱默认值：允许 bash、process、read、write、edit、sessionslist、sessionshistory、sessionssend、sessionsspawn；拒绝 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 会话工具：sessionslist、sessionshistory、sessions_send 技能注册表：ClawHub 架构概览：架构 按目标分类的文档 应用（可选） 仅网关即可提供出色体验。所有应用均为可选，用于添加额外功能。 如果计划构建/运行companion应用，请遵循以下平台运行手册。 macOS（OpenClaw.app）（可选） 网关和健康状态的菜单栏控制。 语音唤醒 + 按键通话覆盖层。 WebChat + 调试工具。 通过SSH进行远程网关控制。 注意：macOS权限需要签名构建才能在重建后保持（参见macOS权限）。 iOS节点（可选） 通过网关WebSocket配对为节点（设备配对）。 语音触发转发 + Canvas界面。 通过 openclaw nodes … 控制。 运行手册：iOS连接。 Android节点（可选） 通过设备配对作为WS节点（openclaw devices ...）。 提供连接/聊天/语音选项卡，以及Canvas、相机、屏幕捕获和Android设备命令系列。 运行手册：Android连接。 从源码构建（开发） 源码检出使用 pnpm。仓库是pnpm工作区，开发期间捆绑插件从 extensions/ 加载，因此会直接使用其包本地依赖和你的编辑内容。在仓库根目录执行普通 npm install 不是受支持的源码设置方式。 开发循环： 如果需要从检出内容构建 dist/（用于Node、打包或发布验证），运行： pnpm openclaw setup 会写入 pnpm gateway:watch 所需的本地配置/工作区。可以安全地重新运行，但通常仅在首次设置或重置本地状态后需要。pnpm gateway:watch 不会重建 dist/control-ui，因此在 ui/ 更改后需重新运行 pnpm ui:build，或在迭代Control UI时使用 pnpm ui:dev。如果希望此检出直接运行onboarding，使用 pnpm openclaw onboard --install-daemon。 注意：pnpm openclaw ... 直接运行TypeScript（通过 tsx）。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（模型 + 默认值）： 完整配置参考（所有键 + 示例）。 Star History Molty OpenClaw 是为 Molty 构建的，这是一个太空龙虾AI助手。🦞 由 Peter Steinberger 和社区开发。 openclaw.ai soul.md steipete.me @openclaw 社区 有关指南、维护者以及如何提交PR，请参见 CONTRIBUTING.md。 欢迎AI/氛围编码的PR！🤖 特别感谢 Mario Zechner 的支持以及pi-mono。 特别感谢 Adam Doppelt 提供 lobster.bot 域名。 感谢所有clawtributors：

GitHub Actions Runner runner 是运行 GitHub Actions 工作流中作业的应用程序。它由 GitHub Actions 在托管虚拟环境中使用，或者您也可以在自己的环境中自托管 runner。 快速开始 有关安装和使用自托管 runner 的更多信息，请参阅添加自托管 runner和在工作流中使用自托管 runner。 Runner 版本： [!NOTE] 感谢您对本 GitHub 仓库的关注，但目前我们不接受贡献。 我们继续将资源集中在战略领域，以帮助客户取得成功，同时让开发人员的工作更轻松。虽然 GitHub Actions 仍是这一愿景的关键部分，但我们正将资源分配到 Actions 的其他领域，目前不接受对本仓库的贡献。GitHub 公开路线图是了解我们正在开发的功能及其所处阶段的最佳途径。 我们正在采取以下措施来更好地引导与 GitHub Actions 相关的请求，包括： 1. 我们将把问题和支持请求引导至我们的社区讨论区 2. 高优先级漏洞可通过社区讨论区报告，或您也可以向我们的支持团队报告：https://support.github.com/contact/bug-report。 3. 安全问题应按照我们的SECURITY.md处理 在此期间，我们仍将为该项目提供安全更新并修复重大破坏性变更。 欢迎您继续在本仓库中提交漏洞报告。

GitHub Actions Runner runner 是运行 GitHub Actions 工作流中作业的应用程序。它由 GitHub Actions 在托管虚拟环境中使用，或者您也可以在自己的环境中自托管 runner。 快速开始 有关安装和使用自托管 runner 的更多信息，请参阅添加自托管 runner和在工作流中使用自托管 runner。 Runner 版本： [!NOTE] 感谢您对本 GitHub 仓库的关注，但目前我们不接受贡献。 我们继续将资源集中在战略领域，以帮助客户取得成功，同时让开发人员的工作更轻松。虽然 GitHub Actions 仍是这一愿景的关键部分，但我们正将资源分配到 Actions 的其他领域，目前不接受对本仓库的贡献。GitHub 公开路线图是了解我们正在开发的功能及其所处阶段的最佳途径。 我们正在采取以下措施来更好地引导与 GitHub Actions 相关的请求，包括： 1. 我们将把问题和支持请求引导至我们的社区讨论区 2. 高优先级漏洞可通过社区讨论区报告，或您也可以向我们的支持团队报告：https://support.github.com/contact/bug-report。 3. 安全问题应按照我们的SECURITY.md处理 在此期间，我们仍将为该项目提供安全更新并修复重大破坏性变更。 欢迎您继续在本仓库中提交漏洞报告。

GitHub Actions Runner runner 是运行 GitHub Actions 工作流中作业的应用程序。它由 GitHub Actions 在托管虚拟环境中使用，或者您也可以在自己的环境中自托管 runner。 快速开始 有关安装和使用自托管 runner 的更多信息，请参阅添加自托管 runner和在工作流中使用自托管 runner。 Runner 版本： [!NOTE] 感谢您对本 GitHub 仓库的关注，但目前我们不接受贡献。 我们继续将资源集中在战略领域，以帮助客户取得成功，同时让开发人员的工作更轻松。虽然 GitHub Actions 仍是这一愿景的关键部分，但我们正将资源分配到 Actions 的其他领域，目前不接受对本仓库的贡献。GitHub 公开路线图是了解我们正在开发的功能及其所处阶段的最佳途径。 我们正在采取以下措施来更好地引导与 GitHub Actions 相关的请求，包括： 1. 我们将把问题和支持请求引导至我们的社区讨论区 2. 高优先级漏洞可通过社区讨论区报告，或您也可以向我们的支持团队报告：https://support.github.com/contact/bug-report。 3. 安全问题应按照我们的SECURITY.md处理 在此期间，我们仍将为该项目提供安全更新并修复重大破坏性变更。 欢迎您继续在本仓库中提交漏洞报告。

GitHub Actions Runner runner 是运行 GitHub Actions 工作流中作业的应用程序。它由 GitHub Actions 在托管虚拟环境中使用，或者您也可以在自己的环境中自托管 runner。 快速开始 有关安装和使用自托管 runner 的更多信息，请参阅添加自托管 runner和在工作流中使用自托管 runner。 Runner 版本： [!NOTE] 感谢您对本 GitHub 仓库的关注，但目前我们不接受贡献。 我们继续将资源集中在战略领域，以帮助客户取得成功，同时让开发人员的工作更轻松。虽然 GitHub Actions 仍是这一愿景的关键部分，但我们正将资源分配到 Actions 的其他领域，目前不接受对本仓库的贡献。GitHub 公开路线图是了解我们正在开发的功能及其所处阶段的最佳途径。 我们正在采取以下措施来更好地引导与 GitHub Actions 相关的请求，包括： 1. 我们将把问题和支持请求引导至我们的社区讨论区 2. 高优先级漏洞可通过社区讨论区报告，或您也可以向我们的支持团队报告：https://support.github.com/contact/bug-report。 3. 安全问题应按照我们的SECURITY.md处理 在此期间，我们仍将为该项目提供安全更新并修复重大破坏性变更。 欢迎您继续在本仓库中提交漏洞报告。

GitHub Actions Runner runner 是运行 GitHub Actions 工作流中作业的应用程序。它由 GitHub Actions 在托管虚拟环境中使用，或者您也可以在自己的环境中自托管 runner。 快速开始 有关安装和使用自托管 runner 的更多信息，请参阅添加自托管 runner和在工作流中使用自托管 runner。 Runner 版本： [!NOTE] 感谢您对本 GitHub 仓库的关注，但目前我们不接受贡献。 我们继续将资源集中在战略领域，以帮助客户取得成功，同时让开发人员的工作更轻松。虽然 GitHub Actions 仍是这一愿景的关键部分，但我们正将资源分配到 Actions 的其他领域，目前不接受对本仓库的贡献。GitHub 公开路线图是了解我们正在开发的功能及其所处阶段的最佳途径。 我们正在采取以下措施来更好地引导与 GitHub Actions 相关的请求，包括： 1. 我们将把问题和支持请求引导至我们的社区讨论区 2. 高优先级漏洞可通过社区讨论区报告，或您也可以向我们的支持团队报告：https://support.github.com/contact/bug-report。 3. 安全问题应按照我们的SECURITY.md处理 在此期间，我们仍将为该项目提供安全更新并修复重大破坏性变更。 欢迎您继续在本仓库中提交漏洞报告。

GitHub Actions Runner runner 是运行 GitHub Actions 工作流中作业的应用程序。它由 GitHub Actions 在托管虚拟环境中使用，或者您也可以在自己的环境中自托管 runner。 快速开始 有关安装和使用自托管 runner 的更多信息，请参阅添加自托管 runner和在工作流中使用自托管 runner。 Runner 版本： [!NOTE] 感谢您对本 GitHub 仓库的关注，但目前我们不接受贡献。 我们继续将资源集中在战略领域，以帮助客户取得成功，同时让开发人员的工作更轻松。虽然 GitHub Actions 仍是这一愿景的关键部分，但我们正将资源分配到 Actions 的其他领域，目前不接受对本仓库的贡献。GitHub 公开路线图是了解我们正在开发的功能及其所处阶段的最佳途径。 我们正在采取以下措施来更好地引导与 GitHub Actions 相关的请求，包括： 1. 我们将把问题和支持请求引导至我们的社区讨论区 2. 高优先级漏洞可通过社区讨论区报告，或您也可以向我们的支持团队报告：https://support.github.com/contact/bug-report。 3. 安全问题应按照我们的SECURITY.md处理 在此期间，我们仍将为该项目提供安全更新并修复重大破坏性变更。 欢迎您继续在本仓库中提交漏洞报告。

GitHub Actions Runner runner 是运行 GitHub Actions 工作流中作业的应用程序。它由 GitHub Actions 在托管虚拟环境中使用，或者您也可以在自己的环境中自托管 runner。 快速开始 有关安装和使用自托管 runner 的更多信息，请参阅添加自托管 runner和在工作流中使用自托管 runner。 Runner 版本： [!NOTE] 感谢您对本 GitHub 仓库的关注，但目前我们不接受贡献。 我们继续将资源集中在战略领域，以帮助客户取得成功，同时让开发人员的工作更轻松。虽然 GitHub Actions 仍是这一愿景的关键部分，但我们正将资源分配到 Actions 的其他领域，目前不接受对本仓库的贡献。GitHub 公开路线图是了解我们正在开发的功能及其所处阶段的最佳途径。 我们正在采取以下措施来更好地引导与 GitHub Actions 相关的请求，包括： 1. 我们将把问题和支持请求引导至我们的社区讨论区 2. 高优先级漏洞可通过社区讨论区报告，或您也可以向我们的支持团队报告：https://support.github.com/contact/bug-report。 3. 安全问题应按照我们的SECURITY.md处理 在此期间，我们仍将为该项目提供安全更新并修复重大破坏性变更。 欢迎您继续在本仓库中提交漏洞报告。