Start

一个关于龙虾、蜕壳和太多 token 的故事。 起源故事 最初，有一个叫 Warelay 的东西——一个作为 WhatsApp Gateway 网关的合理名字。它完成了它的工作。还不错。 但后来来了一只太空龙虾。 有一段时间，这只龙虾叫做 Clawd，住在 OpenClaw 里。但在 2026 年 1 月，Anthropic 发了一封礼貌的邮件要求更名（商标问题）。于是龙虾做了龙虾最擅长的事： 它蜕壳了。 褪去旧壳，这只生物以 Molty 的新身份出现，住在 Moltbot 里。但这个名字说起来也不太顺口…… 于是在 2026 年 1 月 30 日，龙虾又蜕了一次壳，变成了最终形态：OpenClaw。 新壳，同一个龙虾灵魂。事不过三。 第一次蜕壳（2026 年 1 月 27 日） 凌晨 5 点，社区成员聚集在 Discord。数百个名字被提议：Shelldon、Pinchy、Thermidor、Crusty、Lobstar、Nacre、Scuttlebot…… 最终，OpenClaw 胜出。因为蜕壳是龙虾成长的方式。而成长正是正在发生的事情。 这只被称为 Clawd 的甲壳类动物正式蜕壳了。 名字的含义 OpenClaw = OPEN + CLAW = 开源，向所有人开放 = 我们的龙虾传承，我们从何而来 = 钳即是法 🦞 = 你的助手。你的机器。你的规则。 Dalek 与龙虾 Dalek 说：“EXTERMINATE!”（消灭！） 龙虾说：“EXFOLIATE!”（去角质！） 一个毁灭文明。另一个提倡良好的皮肤护理。 明智选择。 ...

OpenClaw 是 Pi 智能体的 WhatsApp + Telegram + Discord + iMessage Gateway 网关。插件可添加 Mattermost。本指南是"个人助手"设置：一个专用的 WhatsApp 号码，表现得像你的常驻智能体。 ⚠️ 安全第一 你正在让智能体处于可以： 在你的机器上运行命令（取决于你的 Pi 工具设置） 在你的工作区读/写文件 通过 WhatsApp/Telegram/Discord/Mattermost（插件）发送消息 从保守开始： 始终设置 channels.whatsapp.allowFrom（永远不要在你的个人 Mac 上对全世界开放）。 为助手使用专用的 WhatsApp 号码。 心跳现在默认每 30 分钟一次。在你信任设置之前，通过设置 agents.defaults.heartbeat.every: "0m" 来禁用。 先决条件 Node 22+ OpenClaw 在 PATH 中可用（推荐：全局安装） 助手的第二个手机号码（SIM/eSIM/预付费） npm install -g openclaw@latest # 或：pnpm add -g openclaw@latest 从源代码（开发）： git clone https://github.com/openclaw/openclaw.git cd openclaw pnpm install pnpm ui:build # 首次运行时自动安装 UI 依赖 pnpm build pnpm link --global 双手机设置（推荐） 你需要这样： ...

什么是 OpenClaw OpenClaw 是一款运行在你自己设备上的个人 AI 助理，由 Peter Steinberger 及社区共同开发，完全开源免费。它可以在你日常使用的所有通讯渠道上响应你的需求，支持语音交互，还能渲染可交互的实时画布，是真正属于你的、完全可控的 AI 生产力工具。 核心特性 本地优先的 Gateway 控制平面：所有数据默认保存在本地，最大程度保证数据隐私和安全 全渠道消息支持：WhatsApp、Telegram、Discord、Slack、飞书、钉钉等 20+ 平台 多智能体架构：支持多个独立智能体，每个拥有独立的工作区和权限配置 Skills 技能系统：通过安装技能扩展功能，如邮件管理、日历、浏览器控制等 目标：尽快从零到第一个可用聊天（使用合理的默认值）。 最快聊天：打开 Control UI（无需渠道设置）。运行 openclaw dashboard 并在浏览器中聊天，或在 Gateway 网关主机上打开 http://127.0.0.1:18789/。文档：Dashboard 和 Control UI。 推荐路径：使用 CLI 新手引导向导（openclaw onboard）。它设置： 模型/认证（推荐 OAuth） Gateway 网关设置 渠道（WhatsApp/Telegram/Discord/Mattermost（插件）/…） 配对默认值（安全私信） 工作区引导 + Skills 可选的后台服务 如果你想要更深入的参考页面，跳转到：向导、设置、配对、安全。 沙箱注意事项：agents.defaults.sandbox.mode: "non-main" 使用 session.mainKey（默认 "main"），因此群组/渠道会话会被沙箱隔离。如果你想要主智能体始终在主机上运行，设置显式的每智能体覆盖： { "routing": { "agents": { "main": { "workspace": "~/.openclaw/workspace", "sandbox": { "mode": "off" } } } } } 0) 前置条件 Node >=22 pnpm（可选；如果从源代码构建则推荐） **推荐：**Brave Search API 密钥用于网页搜索。最简单的方式：openclaw configure --section web（存储 tools.web.search.apiKey）。参见 Web 工具。 macOS：如果你计划构建应用，安装 Xcode / CLT。仅用于 CLI + Gateway 网关的话，Node 就足够了。 Windows：使用 WSL2（推荐 Ubuntu）。强烈推荐 WSL2；原生 Windows 未经测试，问题更多，工具兼容性更差。先安装 WSL2，然后在 WSL 内运行 Linux 步骤。参见 Windows (WSL2)。 ...

使用这些导航中心发现每一个页面，包括深入解析和参考文档——它们不一定出现在左侧导航栏中。 从这里开始 索引 入门指南 快速开始 新手引导 向导 安装配置 仪表盘（本地 Gateway 网关） 帮助 文档目录 配置 配置示例 OpenClaw 助手 展示 背景故事 安装 + 更新 Docker Nix 更新 / 回滚 Bun 工作流（实验性） 核心概念 架构 功能 网络中心 智能体运行时 智能体工作区 记忆 智能体循环 流式传输 + 分块 多智能体路由 压缩 会话 会话修剪 会话工具 队列 斜杠命令 RPC 适配器 TypeBox 模式 时区处理 在线状态 设备发现 + 传输协议 Bonjour 渠道路由 群组 群组消息 模型故障转移 OAuth 提供商 + 入口 聊天渠道中心 模型提供商中心 WhatsApp Telegram Telegram（grammY 注意事项） Slack Discord Mattermost（插件） Signal BlueBubbles (iMessage) iMessage（旧版） 位置解析 WebChat Webhooks Gmail Pub/Sub Gateway 网关 + 运维 Gateway 网关运维手册 网络模型 Gateway 网关配对 Gateway 网关锁 后台进程 健康检查 心跳 Doctor 日志 沙箱隔离 仪表盘 控制界面 远程访问 远程 Gateway 网关 README Tailscale 安全 故障排除 工具 + 自动化 工具概览 OpenProse CLI 参考 Exec 工具 提权模式 定时任务 定时任务 vs 心跳 思考 + 详细输出 模型 子智能体 Agent send CLI 终端界面 浏览器控制 浏览器（Linux 故障排除） 轮询 节点、媒体、语音 节点概览 摄像头 图片 音频 位置命令 语音唤醒 对话模式 平台 平台概览 macOS iOS Android Windows (WSL2) Linux Web 界面 macOS 配套应用（高级） macOS 开发环境配置 macOS 菜单栏 macOS 语音唤醒 macOS 语音悬浮窗 macOS WebChat macOS Canvas macOS 子进程 macOS 健康检查 macOS 图标 macOS 日志 macOS 权限 macOS 远程 macOS 签名 macOS 发布 macOS Gateway 网关 (launchd) macOS XPC macOS Skills macOS Peekaboo 工作区 + 模板 Skills ClawHub Skills 配置 默认 AGENTS 模板：AGENTS 模板：BOOTSTRAP 模板：HEARTBEAT 模板：IDENTITY 模板：SOUL 模板：TOOLS 模板：USER 实验（探索性） 新手引导配置协议 定时任务加固笔记 群组策略加固笔记 研究：记忆 模型配置探索 项目 致谢 测试 + 发布 测试 发布检查清单 设备型号

本文档描述当前的首次运行新手引导流程。目标是流畅的"第 0 天"体验：选择 Gateway 网关运行位置、连接认证、运行向导，然后让智能体自行引导。 页面顺序（当前） 欢迎 + 安全提示 Gateway 网关选择（本地 / 远程 / 稍后配置） 认证（Anthropic OAuth） — 仅限本地 设置向导（Gateway 网关驱动） 权限（TCC 提示） CLI（可选） 新手引导聊天（专用会话） 就绪 1) 欢迎 + 安全提示 阅读显示的安全提示并相应决定。 2) 本地 vs 远程 Gateway 网关在哪里运行？ 本地（此 Mac）： 新手引导可以在本地运行 OAuth 流程并写入凭证。 远程（通过 SSH/Tailnet）： 新手引导不会在本地运行 OAuth；凭证必须存在于 Gateway 网关主机上。 稍后配置： 跳过设置并保持应用未配置状态。 Gateway 网关认证提示： 向导现在即使对于 loopback 也会生成令牌，因此本地 WS 客户端必须认证。 如果你禁用认证，任何本地进程都可以连接；仅在完全受信任的机器上使用。 对于多机器访问或非 loopback 绑定，使用令牌。 3) 仅限本地的认证（Anthropic OAuth） macOS 应用支持 Anthropic OAuth（Claude Pro/Max）。流程： 打开浏览器进行 OAuth（PKCE） 要求用户粘贴 code#state 值 将凭证写入 ~/.openclaw/credentials/oauth.json 其他提供商（OpenAI、自定义 API）目前通过环境变量或配置文件配置。 ...

新手引导向导是在 macOS、Linux 或 Windows（通过 WSL2；强烈推荐）上设置 OpenClaw 的推荐方式。 它可以在一个引导式流程中配置本地 Gateway 网关或远程 Gateway 网关连接，以及渠道、Skills 和工作区默认值。 主要入口： openclaw onboard 最快开始聊天的方式：打开控制界面（无需设置渠道）。运行 openclaw dashboard 并在浏览器中聊天。文档：控制面板。 后续重新配置： openclaw configure 推荐：设置 Brave Search API 密钥，以便智能体可以使用 web_search（web_fetch 无需密钥即可使用）。最简单的方式：openclaw configure --section web，它会存储 tools.web.search.apiKey。文档：Web 工具。 快速开始 vs 高级 向导从快速开始（默认值）vs 高级（完全控制）开始。 快速开始保持默认值： 本地 Gateway 网关（loopback） 默认工作区（或现有工作区） Gateway 网关端口 18789 Gateway 网关认证 Token（自动生成，即使在 loopback 上） Tailscale 暴露 关闭 Telegram + WhatsApp 私信默认使用允许列表（系统会提示你输入电话号码） 高级暴露每个步骤（模式、工作区、Gateway 网关、渠道、守护进程、Skills）。 向导做了什么 **本地模式（默认）**引导你完成： 模型/认证（OpenAI Code (Codex) 订阅 OAuth、Anthropic API 密钥（推荐）或 setup-token（粘贴），以及 MiniMax/GLM/Moonshot/AI Gateway 选项） 工作区位置 + 引导文件 Gateway 网关设置（端口/绑定/认证/tailscale） 提供商（Telegram、WhatsApp、Discord、Google Chat、Mattermost（插件）、Signal） 守护进程安装（LaunchAgent / systemd 用户单元） 健康检查 Skills（推荐） 远程模式仅配置本地客户端连接到其他位置的 Gateway 网关。 它不会在远程主机上安装或更改任何内容。 ...

该页面是英文文档的中文占位版本，完整内容请先参考英文版：Agent Bootstrapping。

如需查看完整的文档地图，请参阅[文档中心](/start/hubs)。 从这里开始 文档中心（所有页面链接） 帮助 配置 配置示例 斜杠命令 多智能体路由 更新与回滚 配对（私信和节点） Nix 模式 OpenClaw 助手设置 Skills Skills 配置 工作区模板 RPC 适配器 Gateway 网关运维手册 节点（iOS 和 Android） Web 界面（控制面板 UI） 设备发现与传输协议 远程访问 提供商与用户体验 WebChat 控制面板 UI（浏览器） Telegram Discord Mattermost（插件） BlueBubbles (iMessage) iMessage（旧版） 群组 WhatsApp 群消息 媒体图片 媒体音频 配套应用 macOS 应用 iOS 应用 Android 应用 Windows (WSL2) Linux 应用 运维与安全 会话 定时任务 Webhooks Gmail 钩子（Pub/Sub） 安全 故障排除

OpenClaw 需要 Node 22 或更新版本。 安装 ```bash npm install -g openclaw@latest ``` ```bash pnpm add -g openclaw@latest ``` 新手引导并运行 Gateway 网关 ```bash openclaw onboard --install-daemon ``` ```bash openclaw channels login ``` ```bash openclaw gateway --port 18789 ``` 完成新手引导后，Gateway 网关将通过用户服务运行。你也可以使用 openclaw gateway 手动启动。 之后在 npm 安装和 git 安装之间切换非常简单。安装另一种方式后，运行 `openclaw doctor` 即可更新 Gateway 网关服务入口点。 从源码安装（开发） git clone https://github.com/openclaw/openclaw.git cd openclaw pnpm install pnpm ui:build # 首次运行时会自动安装 UI 依赖 pnpm build openclaw onboard --install-daemon 如果你还没有全局安装，可以在仓库目录中通过 pnpm openclaw ... 运行新手引导。 ...

来自社区的真实项目。看看大家正在用 OpenClaw 构建什么。 **想要展示你的项目？** 在 [Discord 的 #showcase 频道](https://discord.gg/clawd) 分享或在 [X 上 @openclaw](https://x.com/openclaw)。 🎥 OpenClaw 实战演示 VelvetShark 的完整设置演练（28 分钟）。 ...