OpenClaw：是什么，需要安装吗？ ?
OpenClaw 是什么？它是一款自由软件，安装在您自己的机器上，将您的即时通讯工具（WhatsApp、Telegram、Discord 等）连接到能够执行操作的语言模型：读取文件、运行命令、操控浏览器。本指南介绍项目的由来、工作原理、运行要求和风险，帮助您决定是否要在自己的机器上安装它。文中既没有本站自行开展的测试，也没有排名：只介绍项目文档记载的内容，以及安全研究人员已发表的相关研究。
#OpenClaw 是什么？简短回答
OpenClaw 是一个由您自行托管的开源个人 AI 助手。您可以像给联系人发消息一样，通过已经在使用的通讯工具给它发消息；它会借助语言模型回复您，模型可以来自在线服务提供商，也可以是本地模型。它不只是一个聊天机器人，而是一个智能体：它可以使用所在机器上的工具，并连续执行多项操作来完成您的请求。
- 是什么？
- 一个持续运行在您本地的程序，用于连接您的通讯工具与具备工具调用能力的语言模型。
- 谁开发的？
- 该项目由奥地利开发者 Peter Steinberger 发起。代码在 GitHub 上以 MIT 许可证发布，并接受来自庞大社区的贡献。
- 多少钱？
- 软件是免费的。模型则不一定免费：使用在线服务提供商的模型需要按用量付费，在本地运行则需要承担硬件和电力成本。
- 它在哪儿运行？
- 在您自己的、持续开机的机器上运行：PC、Mac、迷你电脑或租用的服务器。项目开发方不托管任何部分。
- 主要风险？
- 一个读取外部内容、并能在您的计算机上执行命令的智能体。如果隔离不当，它会使您的文件和账户面临暴露风险。
- 需要安装吗？
- 如果您熟悉终端，并愿意将其隔离在一台专用机器上，可以安装。如果您只是想与 AI 聊天，则不应安装。
为避免混淆，需要说明一点：OpenClaw这个名称也指另一个完全无关的项目，即以自由软件形式重新实现1997年发行的平台游戏Claw。本页面只介绍AI助手。
#从Clawdbot到OpenClaw：三个月内出现三个名称
在你的机器上执行操作的智能体：具备智能体能力的 Cline、MCP、n8n + Ollama、本地自动化。
- 在线空间，终身可用
- PDF + 文件
- 30 天内退款
该项目于 2025 年底以 Clawdbot 的名称出现，吉祥物是一只名叫 Clawd 的龙虾。这个名称利用了它与 Claude 名称的相似之处；Claude 是 Anthropic 的模型，当时许多用户将其接入该项目。2026 年 1 月底，应 Anthropic 的要求，出于商标方面的原因，项目更名为 Moltbot（意指龙虾蜕壳），几天后又更名为 OpenClaw。最终沿用的是 OpenClaw 这个名称。
- 2025年11月
- Peter Steinberger 首次发布该项目，当时的名称是 Clawdbot。
- 2026 年 1 月底
- 更名为 Moltbot，几天后又改名为 OpenClaw。项目迅速走红，其 GitHub 仓库成为当时最受关注的仓库之一。
- 2026年2月
- 彼得·施泰因伯格宣布加入OpenAI。他表示该项目将交由基金会管理，并保持开源。
这段历史有两个实际影响。首先，2026 年 2 月之前发布的教程提到的是 Clawdbot 或 Moltbot，并使用旧的命令名称：它们指的是同一个软件，但这些教程的操作说明已经过时。其次，同一时期备受关注的 AI 智能体社交网络 Moltbook 是另一项独立服务，由另一个人推出。使用 OpenClaw 并不需要 Moltbook。
#工作原理：连接即时通讯应用与模型的网关
OpenClaw 的核心称为网关（文档中称为 Gateway）。它是一个为 Node.js 编写的单一进程，在后台运行。它维持与您的即时通讯服务之间的连接，接收每条消息，将其传递给智能体，然后把回复发回对应的会话。其他所有部分都围绕它组织起来。
- 通道
- 通过网关连接的消息服务：WhatsApp、Telegram、Discord、Slack、Signal 或 iMessage 等。最新列表请参见文档。
- 网关
- 中央进程。默认情况下，它仅监听本地机器（地址127.0.0.1，端口18789），并提供一个网页控制界面。
- L'agent
- 驱动模型与工具交互的循环：命令行、文件读写、浏览器控制、定时任务。
- 该模型
- 由您选择。OpenClaw 本身不提供模型：它使用您的密钥调用在线供应商，或调用通过 Ollama 或兼容服务器提供服务的本地模型。
- 工作空间
- 一个存放 Markdown 格式文本文件的文件夹，包含助手的指令、个性和记忆。您可以手动阅读并修改这些文件。
- 技能
- 这些技能以文件夹的形式提供，每个文件夹包含一个SKILL.md文件，用于教会智能体执行特定流程。ClawHub是一个公开的技能注册库，可用于安装更多技能。
OpenClaw 与传统聊天界面有两个不同之处。第一：您可以从任何地方联系它，因为您使用的是平时的即时通讯应用，而实际处理是在留在您家中的电脑上完成的。第二：它可以主动行动。计划任务和周期性唤醒使它能够主动给您发消息，例如每天早晨向您汇报一次情况。
如果您还不清楚智能体的概念，我们的《AI 智能体是什么？》指南介绍了基础：一个模型、工具和一个循环。OpenClaw 应用这一原理，并加入了消息通信层。它也可以连接外部工具，我们的 MCP 协议指南对此有详细介绍。
#OpenClaw 在日常中能做什么
文档和社区描述的使用场景都围绕一个理念：通过消息委托通常需要打开电脑才能完成的任务。这些用途都不保证能实现。结果很大程度上取决于接入的模型，以及编写指令时是否用心。
- 每日简报
- 每天早上收到助手主动发送的个人日程、笔记或所关注信息的摘要，无需向助手提出请求。
- 远程任务
- 通过手机请求在留在家中的电脑上运行脚本、检查文件或重启服务。
- 笔记与提醒
- 在聊天应用中口述一个想法或一项任务，让助手将其整理到文件中，并在合适的时候提醒您。
- 搜索与总结
- 让模型浏览几页网页并获取摘要，同时对模型在线读取内容的可靠性保持通常应有的保留态度。
- 自建自动化
- 通过技能在多个个人工具之间串联操作，无需编写完整程序。
还需要说明 OpenClaw 不是什么。它不是语言模型：没有接入模型，它就无法回答任何问题。它不是在线服务：没有人替您托管或监控它。它也不是面向大众的成熟成品：安装需要通过终端完成，维护工作也由您负责。
#运行所需条件
网关本身很轻量：它只负责转发消息和调用模型。相关要求主要取决于机器是否可用以及所选模型。
- 持续运行的设备
- 可通过即时消息联系的助手必须持续运行。只要通过网络调用模型，迷你 PC、旧电脑或租用的小型服务器都可以胜任。
- 需兼容的系统
- macOS 和 Linux 可直接使用。在 Windows 上，文档建议使用 WSL2，即 Windows 的 Linux 子系统。
- Node.js
- 需要较新的版本：据我们所知，最低要求是第 22 版。这项要求过去已经变动过，请在官方安装页面核实。
- 一个模型
- 可通过在线服务获取 API 密钥，或使用本地模型。公众订阅与第三方工具的使用条款因供应商而异：在使用前请务必仔细阅读相关条款。
- 一个通讯账号
- 建议使用专属于助手的账户或号码，与个人账户分开。
- 时间
- 需要花时间完成初始配置，之后还要进行更新。这个项目发布新版本的频率很高。
这里列出这两条命令，是为了说明需要投入多少精力，并非作为教程。随后，配置向导会询问有关模型、即时通讯服务和安全设置的问题：安装时请遵循官方文档，因为步骤会随版本变化。
#那么使用本地模型呢？
可以：OpenClaw 能调用由 Ollama 提供服务的模型，Ollama 默认监听 http://localhost:11434。但智能体比简单对话对模型的要求更高。模型必须能够可靠地调用工具，并拥有较大的上下文窗口，因为在您发送第一条消息之前，指令、工具描述和技能就已经占用了大量上下文空间。
实际使用中，30 亿至 70 亿参数的小模型（Q4 量化下约需 2 至 5 GB 显存）通常难以胜任这一角色。更适合选择 140 亿参数的模型（Q4_K_M 量化下约需 9 GB，RTX 3060 12GB 可以容纳），或 320 亿参数的模型（约需 19 GB，因此需要 RTX 4090 24GB 或配备统一内存的 Mac），同时为上下文留出余量。项目文档也建议使用您手头能力最强的模型，因为它更能抵御带有陷阱的指令。
#安装前需了解的风险
危险并非来自单一缺陷，而是源于多种因素的结合。OpenClaw会读取来自外部的内容（消息、网页、文件），能够访问私有数据，并可对设备进行操作。将这三个要素整合到同一程序中需要格外谨慎，项目文档对此也直言不讳。
- 提示注入
- 智能体读取的消息、邮件或网页可能包含隐藏指令，它会将这些指令当成您的指令。没有任何模型能对此完全免疫。我们的指南 https://quelllm.fr/guide/injection-de-prompt-llm-local 详细说明了这一机制。
- 暴露的网关
- 2026年初，研究人员盘点了数千个可通过互联网访问的部署实例。网关必须保持本地监听，远程访问需通过VPN或SSH隧道实现。
- 已修复漏洞
- 漏洞CVE-2026-25253可通过恶意链接窃取网关的访问令牌并获得控制权。该漏洞于2026年1月底被修复：旧版软件必须更新。
- 恶意技能
- 安全研究人员在 2026 年初报告称，公开技能库 ClawHub 上存在数百个暗藏恶意内容的技能。技能包含指令，有时还包含脚本，执行时会使用您的权限。
- 存储在磁盘上的敏感信息
- API 密钥、即时通讯会话和助手的记忆都存储在助手的配置文件夹中。任何能读取该文件夹的人都能获取您的访问凭据。
- 模型账单
- 陷入循环或频繁唤醒的智能体会在您察觉不到的情况下消耗 token。请在模型服务提供商处设置支出上限。
该项目提供了安全防护机制。默认情况下，陌生人向您的助手发送消息时，只会收到一个配对码；在您批准该配对码之前，智能体会忽略对方的消息。群聊可以在隔离的 Docker 容器中运行，而不是直接在本机上运行。最后，两个内置命令会检查安装情况，并指出危险的设置。
#是否需要安装 OpenClaw？分五步决策
关键问题不在于工具是否令人惊叹，而在于您是否有明确的用途，以及是否有办法将它控制在一定范围内。依次完成这五个步骤，就能在打开终端之前做出判断。
- 01明确具体用途用一句话写出助手每周会为你做什么。如果想不出具体的事情，本地聊天界面就足够了，还能省去维护智能体的工作。
- 02确认您能将其隔离你是否有专用机器、虚拟机或小型服务器？如果没有，请先等待。隔离是一项预防措施，能限制其他各种错误造成的影响。
- 03选择模型和预算在线运行：需要一个设有支出上限的 API 密钥。本地运行：需要一个能够调用工具的模型，以及一张能在较长上下文下加载该模型的显卡。如果不确定，请先使用设有支出上限的在线模型。
- 04从小规模开始仅有一个消息通道，配对功能保持开启，不启用任何第三方技能，也不访问您的个人账户。仅当助手行为变得可预测时才进行扩展。
- 05规划维护工作请定期更新，每次更改配置后重新进行安全审计，并不时重新阅读助手的记忆文件。
- 倾向于推荐
- 您熟悉命令行操作，有一台可以专门用于运行它的机器，也有一项可以交给它处理的重复性任务。
- 暂时不考虑
- 您主要想与本地模型对话。Ollama 配合 Open WebUI 或 LM Studio 可以满足这一需求，而且攻击面小得多。
- 不太建议
- 您打算在没有经过验证的安全框架的情况下，将其接入工作电脑或业务数据。风险大于收益。
#需要了解的替代方案
OpenClaw 并非唯一可自行托管的智能体。由于没有在相同条件下进行比较，我们不在此发布排名。下面仅介绍与它最接近的几个选项各有什么特点。
- Hermes Agent
- Nous Research 的开源智能体，同样可以通过即时通讯应用联系，并具备持久记忆。我们的指南介绍了如何将它连接到 Ollama。https://quelllm.fr/guide/hermes-agent-ollama-guide
- Agent Zero
- 一个通用型智能体，以 Docker 容器形式提供，配有网页界面和内置 Linux 环境。隔离机制是其设计的一部分。https://quelllm.fr/guide/agent-zero-ollama-docker
- n8n搭配Ollama
- 适用于每一步都预先确定的自动化流程。它不如智能体灵活，但可预测性要高得多。 https://quelllm.fr/guide/n8n-ollama-automatisation-workflow
- 带用户界面的 Ollama
- 如果需求仅限于与在自己电脑上运行的模型对话，不需要工具或即时通讯功能，这是最简单的方式。
#需查阅的官方来源
本指南并未以任何自行开展的测试为依据。该项目每周都在更新：命令、所需的 Node.js 版本以及支持的即时通讯平台列表，都可能自本指南撰写以来发生了变化。如与本指南存在出入，以官方文档为准。
#深入了解
本页帮助您了解 OpenClaw 并做出决定。若想深入了解其中涉及的概念，可以继续阅读本站的以下指南：
- 什么是 AI 智能体？
- 定义、可实际运行的示例，以及智能体失败的原因。https://quelllm.fr/guide/agent-ia-c-est-quoi-definition-exemples
- MCP 是什么？
- 将模型连接到工具和数据的协议，以及使用本地模型时这一协议带来的成本。https://quelllm.fr/guide/mcp-c-est-quoi-model-context-protocol
- Hermes Agent 搭配 Ollama
- 另一个连接本地模型的自托管智能体：配置、记忆功能与局限。https://quelllm.fr/guide/hermes-agent-ollama-guide
- Agent Zero配合Ollama
- 在 Docker 中安装一个从设计上就受隔离约束的智能体，并说明其实际局限。https://quelllm.fr/guide/agent-zero-ollama-docker
有反馈、发现了错误，或想补充说明？请告诉我们，让这份指南对每个人都更有帮助。