OpenClaw文档官方

从 Clawdbot 到 OpenClaw：一个开源智能体的蜕变

如果你追踪过 2026 年初 GitHub 的热榜，一定注意到过一个叫做 “OpenClaw” 的项目——它用不到 100 天的时间突破 25 万颗 Star，超越了 React 这类积累了十余年的顶级项目，成为 GitHub 有史以来增速最快的开源项目之一。这个项目的前身叫做 Clawdbot，中途曾短暂更名为 Moltbot，最终以 OpenClaw 的名字正式确立身份,更多查看玩龙虾导航: https://wanlongxia.com。

OpenClaw 的核心定位，用官方文档最简洁的一段话来概括：“一个运行在你自己设备上的个人 AI 助手，通过你日常使用的通讯软件与你交互，能够真正执行任务——而不只是生成文字”。它并非一个”ChatGPT 包装器”，而是一个本地优先的控制平面，将强大的 AI 推理能力与系统级执行权限结合，让 AI 成为真正意义上的数字操作员。

官方文档的组织架构

OpenClaw 官方文档位于 docs.openclaw.ai，支持英文与中文双语（docs.openclaw.ai/zh-CN），内容涵盖从入门安装到企业级多智能体编排的完整链路。文档整体分为以下模块：

• Getting Started（快速上手）：安装流程、Onboarding 向导、首次配置

• Channels（通讯渠道）：WhatsApp、Telegram、Discord、飞书、钉钉、QQ、Signal、iMessage 等全平台接入指南

• Skills & ClawHub（技能体系）：Skills 编写规范、ClawHub 社区市场、本地技能加载

• Models（模型管理）：多模型提供商配置、OAuth 认证、故障切换

• Multi-Agent Routing（多智能体路由）：多 Agent 架构设计与路由规则

• Security（安全）：沙盒机制、权限审批、提示注入防护

• CLI Reference（命令行参考）：完整的 openclaw 子命令速查手册

• Configuration Reference（配置参考）：openclaw.json 全字段索引

• Troubleshooting & FAQ（故障排查与常见问题）：90% 常见问题的标准解法

对于国内用户来说，若直接访问 docs.openclaw.ai 遇到 SSL 错误，官方文档明确指出，可访问 GitHub 镜像站获取完整内容：https://github.com/openclaw/openclaw/tree/main/docs。

核心架构：微核 + 网关 + 插件三层体系

Gateway：永远在线的控制核心

OpenClaw 的整个运行时围绕 Gateway（网关） 构建。Gateway 是一个运行在用户自有设备（本地 Mac/Linux、VPS、树莓派，甚至 Mac mini）上的守护进程，默认监听 18789 端口，作为 AI 模型调用、通讯渠道接入、工具执行的统一枢纽。

Gateway 的运行要求极为轻量：

树莓派 4 可以稳定运行 OpenClaw Gateway，这意味着大多数家庭和个人用户都能以极低成本搭建一个永远在线的私有 AI 助手。

Gateway 支持多种访问方式：

• localhost 直接访问：http://127.0.0.1:18789/

• Tailscale Serve（官方推荐的远程访问方案，内置身份认证，无需手动管理 Token）

• SSH 隧道：ssh -N -L 18789:127.0.0.1:18789 user@host

• Tailnet 绑定：通过 Tailscale 专有 IP 访问

Node：扩展本地能力的卫星节点

Node 是 OpenClaw 架构中的”卫星”概念。Gateway 在远程服务器运行时，本地设备（笔记本、手机、Mac）可以作为 Node 接入，为 Gateway 提供屏幕捕获、摄像头、本地文件访问、命令执行等能力，实现”云端大脑 + 本地手臂”的分布式架构。

Runtime：Node.js ≥ 22，TypeScript 原生

OpenClaw 基于 Node.js 构建，要求 Node 22 或以上版本，官方推荐使用 pnpm 作为包管理器。值得注意的是，官方文档明确警告：Bun 不被推荐用于 Gateway 生产环境，实测中存在 WhatsApp 和 Telegram 通道的运行时 Bug。

安装与 Onboarding：五分钟从零到可用

一键安装命令

官方推荐的标准安装方式（macOS / Linux）：

Windows 用户使用 PowerShell 安装脚本：

Windows 用户如遇到 git not found 错误，需先安装 Git for Windows 并将其加入 PATH。对于追求最佳兼容性的 Windows 用户，官方建议优先使用 WSL2 运行 OpenClaw。

安装时间参考：安装约 2-5 分钟，Onboarding 配置向导约 5-15 分钟（取决于接入渠道数量）。

Onboarding 向导做了什么？

执行 openclaw onboard 会逐步引导用户完成：

1. 模型认证：配置 Anthropic / OpenAI / MiniMax / DeepSeek / 本地模型 API Key 或 OAuth

2. 工作区设置：指定 workspace 路径及引导文件

3. Gateway 参数：绑定端口、认证 Token、Tailscale 集成

4. 通讯渠道：接入 WhatsApp、Telegram、Discord、Mattermost、Signal、iMessage 等

5. 守护进程安装：macOS 使用 LaunchAgent；Linux/WSL2 使用 systemd user unit

6. 健康检查与 Skills 选择：验证配置并安装初始技能包

更新方式

日常更新只需执行：

如需切换到 Beta 版本体验最新特性：

若出现任何配置异常，openclaw doctor 是官方推荐的”万能修复命令”，能够自动诊断并修复大多数常见问题，包括缺失的 allowFrom 条目、混合账户配置错误、损坏的会话记录等。

通讯渠道生态：50+ 平台一网打尽

OpenClaw 的通讯渠道体系是它区别于所有同类产品的核心壁垒之一。官方文档记录的渠道接入分为两类：

原生内置渠道

• WhatsApp（通过 whatsapp-web.js）

• Telegram（Bot API + Webhook）

• Discord

• Slack

• Signal（通过 signal-cli）

• iMessage（通过 BlueBubbles，支持 macOS 以外的 Gateway 部署）

• Google Chat

• Mattermost

• Microsoft Teams

• WebChat（内置 Web UI）

• LINE

• Nextcloud Talk

最新新增：QQ 机器人原生支持

2026 年 3 月 31 日发布的 v2026.3.31 版本中，QQ 机器人作为内置渠道插件正式原生集成，无需额外安装第三方依赖。新插件 channels.qq-bot 支持多账号配置、使用 SecretRef 安全管理凭证、支持斜杠命令，中国用户可以直接通过 QQ 消息驱动 OpenClaw 执行任务。

国内平台接入重点说明

飞书（Feishu/Lark）：官方飞书插件于 2026 年 3 月 24 日上线，最新版本为 2026.3.31。版本要求：Linux/macOS 需 OpenClaw 2026.2.26 及以上，Windows 需 2026.3.2 及以上。安装方式：通过飞书 Bot 渠道配置后，执行 openclaw skills install feishu-official。

企业微信：支持通过文档 MCP 创建文档和智能表格（2026.3.13 版本更新），长连接机器人支持 MCP 文档操作。

Skills 技能系统：让 OpenClaw 真正”会干活”

Skills 是什么

Skills 是 OpenClaw 扩展能力的核心机制，本质上是一份 Markdown + YAML Front Matter 格式的结构化任务说明书，告诉 AI 如何稳定、可复现地执行特定类型的任务。这与传统”工具调用”的本质区别在于：Skills 将 SOP（标准操作程序）写入提示词，把不确定的”AI 自由发挥”变成有迹可循的”按图施工”。

加载优先级（从高到低）

核心 CLI 命令

安全使用原则（官方强制要求）

v2026.3.31 起，Skills 安装默认采用**”失败关闭”**策略：安装时自动扫描”危险代码”特征，一旦检测到可疑代码段，安装立即中止，无法强制绕过。官方明确建议的安装顺序：

1. 先装安全类 Skills（skill-vetter/clawsec + exec-guard）

2. 再装基础能力类（文件操作、联网搜索）

3. 最后按需装场景化 Skills

模型支持体系：厂商中立，任意切换

OpenClaw 官方文档列出的支持模型提供商超过 20 家，真正做到”厂商中立”：

• Anthropic：Claude 3.5 / Claude 3 Opus/Sonnet/Haiku（支持 API Key 和 Claude Max 订阅 OAuth 双模式）

• OpenAI：GPT 系列 + Codex（明确支持 Codex WebSocket 传输，v2026.2.26 默认启用）

• Google：Gemini 1.5 / 2.0（支持 CLI OAuth 插件认证）

• 国内模型：DeepSeek、通义千问（Qwen）、智谱 GLM、MiniMax、Kimi

• 本地模型：Ollama、LM Studio 完整支持

• OpenRouter：接入数百款模型的统一网关

• Azure OpenAI：支持 Responses API（store=true 强制合规）

• AWS Bedrock：通过 Amazon Bedrock Converse 供应商手动配置

官方文档特别提醒：小型/量化本地模型在安全性上存在隐患——模型上下文越小、能力越弱，抵抗提示注入攻击的能力越差。对于生产环境，官方建议始终使用具备强大指令遵循能力的大型模型。

安全机制：从”极客玩具”到”生产工具”的关键转变

OpenClaw 的安全演进路径在官方文档中有详细记载，这也是 v2026 系列版本的核心主题：

requireApproval：人类守门员机制

v2026.3.28 引入 requireApproval 机制，对敏感操作（文件删除、Shell 命令执行、外部 API 调用）强制要求人工确认，Agent 在收到批准前不会执行。这一设计被社区称为”OpenClaw 从极客玩具走向生产工具的里程碑”。

沙盒路径保护

• 拒绝指向根目录外的悬空符号链接，防止 Workspace 逃逸

• $include 配置文件加载限制为只读验证，拒绝硬链接别名，实施大小限制

CSP 安全策略（v2026.3.23）

• 自动为 index.html 内联脚本计算 SHA-256 哈希

• 默认阻止未声明的内联脚本执行

• 仅允许明确列出的启动脚本运行

• CSP 行为完全可预测、可审计

外部密钥管理（External Secrets，v2026.2.26）

引入完整的密钥生命周期管理工作流：审计 → 配置 → 应用 → 重载 → 运行时快照激活，支持 SecretRef 模式让 API Key 不以明文出现在配置文件中。

节点配对加固

设备重连时强制锁定平台/设备家族元数据并签名，防止元数据欺骗导致攻击者通过伪造设备类型获取更高命令权限。

多智能体与高级自动化

Multi-Agent Routing

OpenClaw 支持将不同通讯渠道的消息路由到不同的 Agent 实例，每个 Agent 拥有独立的 workspace、会话历史、默认模型和工具集。典型场景：

• 同一个 WhatsApp 号码的不同联系人 DM 路由至不同 Agent

• “快速聊天 Agent”（使用轻量模型）vs “编码 Agent”（使用 Claude Opus）

• 工作渠道与个人渠道完全隔离

路由配置通过 openclaw.json 的 agents.routing 字段控制，也可通过 CLI 命令实时管理：

Cron 定时任务

OpenClaw Gateway 内置调度器，支持标准 Cron 表达式：

调试命令：

Sub-Agents：并行任务的利器

主 Agent 可以派生 Sub-Agent 处理耗时任务，主会话保持响应。Sub-Agent 完成后返回摘要，全程异步。通过 /subagents 命令查看当前子智能体状态，通过 agents.defaults.subagents.model 为子 Agent 配置更经济的模型，控制 Token 消耗。

五款同类产品详细对比

竞品一：Manus AI（Meta 旗下）

Manus 是目前 OpenClaw 在”自主执行 AI 智能体”赛道最直接的竞争对手，以 Telegram 一条消息驱动复杂任务著称。核心差异：Manus 完全闭源，用户数据归 Meta 所有，定价体系以”积分制”不透明计费（订阅价 $39～$199/月），不支持本地模型，无法自定义执行逻辑。OpenClaw 在数据主权、可扩展性、成本透明度上全面占优；Manus 在移动端体验和零配置上手方面更胜一筹。

竞品二：Dify

Dify 是目前 Star 数最高的开源 LLM 应用开发平台，定位与 OpenClaw 有本质区别：Dify 是为开发者构建 AI 应用的”脚手架”，需要用户用可视化界面手动设计每一个工作流节点；OpenClaw 是为最终用户提供”自主执行”能力的 Agent 运行时，AI 自己规划执行路径。

竞品三：n8n

n8n 是欧美开发者社区口碑最好的通用自动化工作流平台，拥有 400+ 原生集成节点，在确定性业务流程自动化上有绝对优势。与 OpenClaw 的差异在于：n8n 是”规则驱动”的工具，每一步都由工程师事先定义；OpenClaw 是”意图驱动”的 Agent，用户只需说目标。n8n 在严格 SOP 场景更可靠，OpenClaw 在非结构化、需要即兴判断的任务上无可替代。另外 n8n 的 Fair-code 协议对商业用途有限制，OpenClaw 为纯 MIT 协议。

竞品四：AutoGPT

AutoGPT 是 OpenClaw 的精神前辈，2023 年以”自主 AI Agent”概念引爆全球，GitHub Star 一度排名第一。2026 年的 AutoGPT 已完成多轮架构重写，主打云端 SaaS 化，提供图形界面任务配置。然而与 OpenClaw 相比，AutoGPT 在即时通讯平台集成方面几乎是空白，且架构更重、本地部署复杂度更高。OpenClaw 的 Skills 生态在社区活跃度上也远超 AutoGPT 的插件体系。

竞品五：LangChain Agent

LangChain 是 AI 开发者最熟悉的 Agent 构建框架，提供丰富的 Chain/Agent 抽象、工具绑定和 RAG 管道。它与 OpenClaw 并不是同一层面的产品：LangChain 是框架层（面向工程师构建应用），OpenClaw 是运行时层（面向终端用户直接使用）。如果说 LangChain 是”发动机”，OpenClaw 是”整车”。LangChain 在灵活性和学术探索上无可超越，但它没有 Gateway、没有渠道接入、没有持久化记忆存储，终端用户无法直接使用。

CLI 速查手册

官方文档提供的核心命令行工具参考：

v2026.3.31：截至今日的最新版本全解析

2026 年 3 月 31 日，OpenClaw 发布最新稳定版 v2026.3.31，这是迄今为止涵盖范围最广的一次更新，核心变化集中在以下四个方向：

安全模型重构：所有插件与技能安装默认启用”失败关闭”策略，危险代码扫描阶段若触发告警，流程立即中止。requireApproval 机制进一步完善，对 Shell 执行、文件系统写操作等高权限操作统一要求人工审批。

QQ 机器人原生内置：channels.qq-bot 插件正式捆绑进入主发行版，支持多账号配置、SecretRef 凭证管理、斜杠命令，中国用户无需任何额外配置即可通过 QQ 与 OpenClaw 交互。

后台任务系统重塑：定时任务系统的超时保护、截止时间元数据、重启窗口消息处理逻辑均有结构性优化，大幅提升高并发场景下的任务可靠性。

底层可靠性提升：合并 v2026.3.22 和 v2026.3.23 的 200+ Bug 修复成果，涵盖模型供应商接入、CSP 安全策略、插件生态稳定性、OAuth 代理环境支持等各个方向，是目前生产环境最推荐的版本。