Agent之最新OpenClaw原理与实战大全

阳光宅猿

发布于 2026-03-05 18:55:49

2.4K0

一直忙着做公司的项目，难得过年放假有时间，赶紧实战一下OpenClaw，其自动化、可执行等颠覆性的智能体功能，近期内在科技圈大火，其公布两个月就在Github上收到150k的Star。我用了三天时间详细分析了OpenClaw到底是个啥？能干什么？为什么这样设计？以及怎么部署一个本地自己的OpenClaw机器人，原理梳理和亲自实操了一遍，感觉效果确实不错。

01、OpenClaw是什么？

OpenClaw 的诞生源于一个激进的实验。项目创始人 Peter Steinberger（知名PDFSDK 提供商PSPDFKit的创始人）在退休后，试图验证“在不亲自编写代码的情况下，仅凭自然语言交互能否构建复杂系统”。其希望能够创建一个能够深度访问本地文件系统、管理个人账号、且数据完全受控的“私人数字管家”，以此回应日益封闭的 AI 生态。本着这个初衷，期间项目经历了三次关键更名：最初为致敬Claude大模型取名Clawdbot，因收到Anthropic商标异议邮件于2026年1月底改为Moltbot，后又因发音不顺和社交媒体账号问题，最终定名OpenClaw。这段命名波折，看得出来Anthropic也太没有格局，但也顺便助推了一把OpenClaw。

在改名过程中，Peter遭遇了加密货币黄牛的狙击——在两个浏览器窗口之间操作，仅5秒钟的间隔，旧账号就被黄牛抢走，用于推广代币和散布恶意软件。他一度想过直接删掉整个项目，最后靠着GitHub、Twitter的朋友们全力帮忙，花费10K美金买下Twitter商业账号，才把OpenClaw这个名字稳住。

大佬本人

Peter Steinberger是一位来自奥地利的资深软件工程师，同时也是一位连续创业者，他的技术生涯特别有亮点，实现了从移动端底层专家，到AI Agent领域先锋的巨大跨越，一步步走到现在，全靠扎实的技术功底。

他早期的时候，主要靠iOS和C++开发出名，算是这个领域的顶尖高手。后来他白手起家，创办了PSPDFKit——这家公司在PDF SDK领域是行业领先的，最后也成功出售了，算是非常成功的创业经历。在Objective-C/Swift运行时架构，还有高性能渲染引擎这些专业领域，他的造诣特别深厚，不是普通开发者能比的，底子打得极其扎实。

直到2025年，他复出之后，就彻底转型了，全身心投入到AI开源领域，还积极倡导两个核心理念：“Agentic Engineering”（也就是代理工程）和“Vibe Coding”。之后他就开发了Moltbot这类本地AI助理工具，核心就是探索一种新的生产力模式——从以前咱们程序员“手写每一行代码”，变成“指挥AI去编程”，大大提升开发效率。现在的他，已经是AI辅助开发领域里标志性的人物了，很多开发者都跟着他的思路探索新方向。

这里补充一点，这也是最近Mac Mini特别火爆的原因之一。因为最开始的Moltbot（也就是现在的OpenClaw）的许多底层依赖，都是基于Swift开发的，而且开发时主要聚焦在Apple生态，所以用Mac Mini部署Moltbot，能最大程度释放它的全部能力，不用额外适配，用起来也更顺畅，真的是太省心了，也不用浪费时间在兼容调试上。关注公众号【阳光宅猿】回复【AIGC】领取最新AI人工智能学习资料，包含RAG、Agent、深度学习、模型微调等多种最新技术文档等你来选！！关注公众号【阳光宅猿】回复【加群】进入大模型技术交流群一起学习成长!!!

OpenClaw 最具破坏力的创新，在于它不仅拥有独立的 Web UI，直接寄生于用户最常用的社交软件（Telegram, WhatsApp, WeCom）之中。这不仅是 UI 的改变，更是交互逻辑的革命

从 “访问网站” 到 “随时待命”：传统的 Agent（如 ChatGPT 网页版）是一个 “目的地”，你需要主动去访问它。而 OpenClaw 是一个 “随行者”。它存在于你的联系人列表中，就像你的同事或助理一样。这种 Always-on 的状态，完美契合了用户对 “贾维斯” 的想象 —— 无处不在，随叫随到。
无限对话流（Infinite Conversation）：OpenClaw 打破了 “Session”（会话）的概念。它不再是一次性的问答，而是一场永不结束的对话。通过对历史记录的智能摘要和检索，它能在一个持续数月的对话流中，不断累积对用户的认知。这种形态极大地降低了用户的使用心理负担，让交互变得像发微信一样自然。
OS 级别的权限下放：OpenClaw 敢于触碰传统 SaaS 不敢触碰的禁区 ——本地文件系统读写权限。它运行在用户的私有环境（或私有云）中，直接操作真实文件。这种 “高风险、高回报” 的设计，直击开发者痛点。用户不再需要把代码复制粘贴到对话框里，而是直接对 OpenClaw 说：“帮我把 src 目录下的所有 Python 脚本重构一遍”，它就能直接修改文件。这种侵入式的交互，带来了前所未有的效率提升。

02、OpenClaw原理结构

图片源于网络（侵删）

OpenClaw这么神奇，那他底层究竟是什么结构，底层架构是怎样的？

OpenClaw核心目标很简单，就是把强大的推理模型和本地执行环境深度融合，让普通用户也能拥有 7×24 小时在线、有长期记忆、能自主操作电脑的数字员工，不用再盯着电脑做那些繁琐的事。

其底层主要有网关（Gateway）、智能体（Agent）、技能（Skills）、记忆(Memory)、渠道(Channel/Bridge)、节点(Nodes)、基建（插件、工具、CORN、UI等）六大核心模块，每个模块各有作用。接下来咱就逐一分析一下。

图片源于网络（侵删）2.1、OpenClaw 的网关（Gateway）

网关是整个系统的中枢神经。无论有多少个客户端设备（节点），它们都必须连接到这个唯一的 “大脑” 才能工作。同时也是整个系统的控制核心，主要负责对接WhatsApp、Telegram等多渠道消息接入，还管会话管理、路由分发、鉴权和状态监控，全程以后台服务常驻运行，保证消息和指令流转不中断、不卡顿，不用手动启动。作为一个长时运行的进程部署在用户可控的服务器或个人电脑上。其主要职责包括：

连接与路由：作为所有通信的入口，负责连接WhatsApp、Telegram、Discord等多种聊天平台，接收用户指令。同时，它内部的路由引擎（Routing Engine）会根据预设规则决定将消息分发给哪个智能体进行处理。

会话管理：维护与不同用户和平台的会话状态，确保上下文的连续性。

指令分发与状态同步：将解析后的指令分发给相应的智能体或节点执行，并负责同步任务的执行状态，将结果反馈给用户。

我给你一个更通俗、好记、一听就懂的生活化例子，完全对应 OpenClaw Gateway 的逻辑：

把OpenClaw网关比作「小区物业中控室」。

你家小区里有很多户人家、很多设备、很多入口，但所有事情都必须先经过中控室。

1、Gateway = 小区中控室

所有消息、指令、请求，第一个到达的地方都是中控室。
中控室是唯一权威中心（Single Source of Truth），谁在干嘛、状态是什么，只有它最清楚。

2. 各种聊天软件 = 小区的不同大门

WhatsApp、Telegram、Discord、iMessage……就像小区正门、侧门、后门、行人通道、车库入口
不管你从哪个门进来，都要先报到中控室，不能直接冲进住户家里。

3. Pi 智能体 = 小区里的住户（AI 助理）

每个 Agent 住在自己的 “房间” 里。
中控室知道：谁在、谁休息、谁能干活、谁负责什么。
有任务来了 → 中控室通知对应住户去处理。

4. 你关了控制台 / UI = 你关掉了「监控屏幕」

你不看中控屏幕，中控室照样在运行。
住户照样干活、自动任务照样执行、消息照样处理。

5. 部署规则：一台主机一个 Gateway

= 一个小区只配一个中控室安全、好维护、不混乱、不出错。

OpenClaw 的 Gateway 就是整个系统的「总调度中心」。所有消息先到它这里，它再派 AI 去干活；你关了界面，中心还在运转，AI 也还在工作。

2.2、OpenClaw的智能体（Pi Agent）

PiAgent智能体是OpenClaw的 “大脑”，主推理、主执行。核心是对接大模型，解析用户真实意图，制定具体任务计划，调用各类技能和工具完成操作。同时搭配沙箱隔离机制，能有效保障执行安全，避免误操作损坏电脑里的文件或系统。

为啥这里采用PiAgent呢？它与其他AI Agent（如Claude Code、Cursor、Cline等）最大的不同，在于其独树一帜的极简主义设计哲学。为了更直观地理解，我把Pi Agent和其他主流Agent的特点整理成了一个对比表格：

对比维度	🦞 OpenClaw的Pi Agent	🧠 其他主流AI Agent (如 Claude Code, Cline, Cursor 等)
核心设计	极简主义：拥有极小的核心，坚持“让代码写代码”的理念，功能由Agent在运行中动态生长。	功能集成主义：通常内置大量预设功能，如Plan模式、MCP服务器、TODO列表等，开箱即用。
工具扩展	基础工具极少：默认只有Read, Write, Edit, Bash四个基础工具。通过扩展和技能来动态增加能力，甚至可以让Agent自己编写扩展。	工具丰富多样：通常自带大量预定义工具，如网页搜索、数据库查询、API调用等。许多Agent支持MCP协议来统一接入外部工具。
上下文	创新的会话树：会话可以像代码分支一样进行分支、导航和合并，并能在分支间总结信息，有效管理复杂任务。	线性或简单分支：大多为线性对话历史，或仅支持简单的会话切换，难以在同一任务中进行复杂的上下文分支探索。
与系统集成	SDK级深度嵌入：核心推理组件（Pi）以SDK形式深度嵌入OpenClaw，实现会话持久化、事件流优化和细粒度权限控制。	进程外调度：通常作为独立进程或RPC服务运行，通过IPC或网络与宿主程序交互，存在一定的性能开销和状态管理挑战。
对用户价值	透明、可控、可塑性强：你清楚它在做什么（执行命令），可以像捏粘土一样引导它自己进化出新功能，适合喜欢探索和深度定制的技术用户。	强大、便捷、开箱即用：功能全面，上手快，能直接完成复杂任务，适合追求效率和一站式解决方案的用户。

Pi Agent的工具定义是“即时加载”的——这意味着系统提示词中只放工具目录，模型选中后才加载具体定义。这种设计与OpenClaw的技能按需加载机制一脉相承，大幅节省Token开销。

Flask/Jinja的作者Armin Ronacher在一篇推荐Pi agent的文章中提出了一个核心观点：只要有智能（模型），软件就像粘土一样是可塑的。没有必要事先配置好各种确定的Skills，需要的时候让Agent自己开发，开发出来有问题可以修改，直到可用。只要给智能核心包一个薄薄的壳，Agent就能成为一种动态生长的软件。Pi agent正是这一理念的完美体现——它把核心做得极小，但允许能力“长出来”。这种“核心极小，但能长出来”的设计哲学，与OpenClaw的Skill系统天然契合。

关注公众号【阳光宅猿】回复【AIGC】领取最新AI人工智能学习资料，包含RAG、Agent、深度学习、模型微调等多种最新技术文档等你来选！！

关注公众号【阳光宅猿】回复【加群】进入大模型技术交流群一起学习成长!!!

2.3、工具（Tools）和技能（Skills）模块

工具（Tools）和技能（Skills）模块是Moltbot的能力扩展层，就像给手机装 APP，以插件和脚本形式存在，能提供文件操作、浏览器自动化、系统命令执行等基础原子能力。想加新功能直接扩展技能就行，不用改动核心架构，灵活度拉满，完全不浪费时间。

工具其整合了自动化与调度工具CronJob、Hooks，硬件感知工具Location定位工具、Voice Wake/Audio语音工具、Camera Capture摄像头工具，浏览器与网络工具Managed Browser自托管浏览器、Chrome Extension浏览器扩展插件，系统执行与编程工具ExecTool、BackgroundExec后台进程管理工具、apply_patch Tool。

在OpenClaw的架构，如果说Tools(工具)是AI的“手和眼”(如浏览器、摄像头)，那么Plugins(插件)和Skills(技能)就分别代表了它的“耳朵/嘴巴"和”职业专长”。这两者共同扩展了OpenClaw的边界，但侧重点完全不同：插件主要用于扩展网关的连接能力，而技能主要用于扩展Agent的任务逻辑。

插件运行在 Gateway（网关）层，主要用于增加 OpenClaw 支持的新通信协议或底层功能。它解决的是“OpenClaw 能在哪里说话”以及“能处理什么样的新信号”的问题。

技能运行在Agent（智能体）层，通常是一组预设的逻辑、提示词（Prompts）或特定工作流的集合。它解决的是“OpenClaw 擅长做什么工作”的问题。

Skill 是对基础 Tools 的高级封装。OpenClaw为我们提供了ClawHubSkill集合网站。

https://clawhub.ai/

这是 OpenClaw 的技能市场或中央仓库，用户可以在这里下载或分享社区构建的技能。

在OpenClaw的世界里，技能（Skill）可以理解为AI的“双手”——它是一套封装了专业知识、工作流程和执行逻辑的模块化能力包。如果把OpenClaw本体比作“操作系统内核”，那么大模型是“大脑”，而技能就是安装在系统上的各类“应用程序”。没有技能，OpenClaw只能聊天；装上技能，它才能真正“干活”——比如发邮件、查天气、操作浏览器、处理文件。

技能的载体：就是一个文件夹，文件夹里必须包含一个“SKILL.md”文件。这个文件用Markdown格式（普通人能读懂的文本格式）告诉AI：这个技能是做什么的、什么时候该用它、具体怎么操作。如果需要执行具体代码，还可以在同目录下放“agent.py”（Python脚本）或“index.ts”（TypeScript脚本）。

技能（Skill）规范由Anthropic公司于2025年12月18日正式发布为开放标准。需要明确的是，技能与MCP（模型上下文协议）是两个独立且互补的技术——MCP解决的是“AI可以访问什么外部资源”（连接数据库、API等），而技能解决的是“AI应该怎么用这些资源”（操作流程、最佳实践）。两者可以协同工作。

OpenClaw对技能规范进行了深度工程化实现，形成了一套完整的“技能生命周期”管理体系。

1. 技能存在哪里？——发现机制

OpenClaw会在多个目录中扫描技能，并按优先级从低到高合并（同名技能高优先级覆盖低优先级）：

2. 哪些技能能用？——过滤机制

发现技能后，系统会进行严格筛选：

检查用户是否启用了该技能
检查是否在当前平台兼容（如Windows技能不在macOS显示）
检查依赖是否齐全（如需要“ffmpeg”可执行文件、特定环境变量等）

只有通过过滤的技能才会进入最终可用列表。

3. 怎么告诉AI有哪些技能？——按需加载

这是OpenClaw最聪明的设计。系统提示词中只放入技能的目录信息（名称+简短描述+文件路径），而不放入完整的“SKILL.md”内容。这就像给AI一个“菜单”而不是“菜谱”——先看菜名决定想吃什么，选中后再看具体做法。

模型在判断需要使用某个技能时，会调用“read”工具读取对应的“SKILL.md”文件，再按其中说明执行。这种按需加载机制避免了将所有技能文档一次性塞入上下文，大幅节省Token开销。

4. 技能长什么样？——SKILL.md规范

一个典型的“SKILL.md”包含两部分：

第一部分：元数据头（YAML格式）

第二部分：自然语言描述

Description：技能详细说明
When to use：触发场景（多举具体示例，帮助AI精准判断）
How to use：步骤化执行流程
Edge cases：边界情况处理

5. 怎么调用技能？——两种触发方式

方式一：AI自主调用（模型侧）

模型在系统提示中看到技能列表，根据用户请求判断是否需要调用某个技能，然后读取对应的SKILL.md并按说明执行。

方式二：用户直接触发（斜杠命令）

在Telegram、Discord、Slack等渠道，用户可以直接输入“/技能名”来触发技能，无需经过模型推理。如果技能配置了“command-dispatch: tool”，斜杠命令会直接调用对应工具执行；否则系统会将用户输入改写为“使用某技能”的提示，走正常回复流程。

6. 怎么安装新技能？

- 从ClawHub安装：clawhub install 技能名称（ClawHub是官方技能市场，收录3000+技能）

- 手动创建：在“~/.openclaw/skills/”下新建文件夹，编写“SKILL.md”

OpenClaw并非技能规范的创造者，但其工程实现有三个核心创新点：

按需加载机制：系统提示中只放目录不放内容，模型选中后才加载具体描述，大幅节省Token。
动态语义装配：Agent可在运行时根据用户意图动态发现、下载、调用新技能，实现“即用即装”。
优先级与过滤体系：多来源技能合并、依赖检查、平台兼容性过滤，确保技能稳定可用。

2.4 OpenClaw的记忆模块

记忆模块是本地持久化存储层，采用简单的文件格式，如JSONL和Markdown，来持久化存储会话记录、用户偏好、长期知识等记忆内容。这种设计的优点是透明、易于人类理解和编辑，并且便于版本控制和备份并结合时间戳、关键词和向量检索，支持向量检索和关键词匹配等多种方式，使得智能体能够根据当前上下文快速、准确地从记忆库中找到相关信息。实现跨会话的长期记忆。最关键的是所有数据都不上云，全存在自己的电脑里，隐私完全自主掌控，不用怕数据泄露。

将长期记忆存储为本地文件系统中的Markdown文档（即MoltBook）。Agent的记忆不是隐藏在向量空间里的抽象表示，而是一组清晰可见的Markdown文件：摘要、日志、用户画像都以结构化文本形式存储在磁盘上。

通俗理解：其他AI的记6忆像是一个“黑箱笔记本”——你只能问它还记得什么，但看不到笔记本上具体写了什么。OpenClaw的记忆则像是一个“透明文件夹”——里面全是txt文件，你可以随时打开看，甚至用记事本修改。

OpenClaw的设计哲学：这种“白盒记忆”为人机协作提供了一个最低但关键的信任基础。用户可以直接查看Agent（智能体）记录了什么、是如何描述自己的需求，也可以在发现偏差时手动修正，而不必理解数据库结构或检索逻辑。向量索引最多只是检索加速层，而不是记忆本体。为了解决本地多任务并发可能导致的文件写入冲突，OpenClaw引入了 “泳道队列”（Lane Queue）系统，强制任务串行执行，确保记忆写入的准确性。

2.5 OpenClaw的节点模块

节点是OpenClaw 执行能力的物理延伸，它们是分布在各种终端设备（如个人电脑、手机等）上的代理程序。节点的作用是提供硬件能力和本地执行环境，使得OpenClaw能够超越云端API的限制，与用户的物理世界和本地数字环境进行交互。

节点提供的能力包括：

硬件访问：调用设备的摄像头、麦克风、GPS定位等硬件资源；
本地执行：直接在设备上执行脚本、操作文件系统、控制桌面应用等高权限操作

03、OpenClaw应用场景

OpenClaw最区别于传统Agent的地方就是它能真正自我决策，自我执行、自我判断并不受平台限制的解放双手的智能体。像豆包只会给你方案，OpenClaw会直接用你电脑上的系统、文件、软件自己操作，比如打包你图片家里的图片，发送邮件，打开编程软件进行编程，用你的作图工具帮你作图，不是给你答案，而是进化到了帮你做，重点在做这一步，你自己不用亲身再去打开工具之类操作之类的了，而且做只需要你给他指令，不需要复杂的代码开发和工具引入。

OpenClaw中的用户不再只是与一个机器人对话，而是将OpenClaw作为“指挥官”，可以调度一个由“多个专门Agent”组成的团队，使其操控多个Agent一起自动化流水线形式执行。同时还可以整合智能家居并与硬件深度集成，实现软硬件互通可控。有网友分享了其通过配置OpenClaw来操控小区门开关的例子。

OpenClaw还可以构建全能型移动开发与运维中心，这是目前最硬核且高价值的用法。用户不再依赖电脑，而是通过手机上的聊天软件指挥 OpenClaw 完成复杂的软件需求开发和运维任务。

国内很多云厂商已将OpenClaw部署在服务器上，自主检查构建失败的日志，识别错误（如构建命令错误），修复代码，并重新部署，甚至在用户遛狗时通过语音完成这一切。有厂商已经给OpenClaw整合了1000多个垂直领域数据库，能够实现金融数据分析、股票行情监控。

目前的OpenClaw已经从单一的聊天机器人进化为个人生活的操作系统。其核心价值在于“连接”——它连接了代码库、日历、笔记软件、智能家居、浏览器等。

04、Linux Unbuntu LTS部署OpenClaw

WSL2 是 Windows Subsystem for Linux 2 的缩写，顾名思义，它是一个允许你在 Windows 系统中直接运行完整的 Linux 操作系统环境（比如Ubuntu系统）的工具，而无需传统的虚拟机。出于系统架构与兼容性考虑，以及方便安装后台守护进程，Windows的同学需要提前安装好WSL2。

理解OpenClaw的最好方式，是亲手跑一遍。本节将详细拆解从环境准备、安装部署、Skill扩展，到真实用例的全流程。

部署前的核心准备

硬件配置建议

OpenClaw对硬件有一定要求：

推荐机型：MacMini（M1/M2/M4芯片）是社区公认的最佳宿主，能效比高，适合24小时挂机。有网友分析，M4芯片版MacMini正是为低功耗、高性能、安静运行而生的“AI服务器”。
其他选项：高性能WindowsPC（需通过WSL2运行，兼容性并不好）、Linux服务器、树莓派
内存：建议16GB或以上（8GB环境下复杂任务易超时）
磁盘空间：预留20GB以上（含Docker镜像、依赖包、任务文件）

软件环境依赖

LinuxUbuntu搭建Docker环境可以参考如下链接： https://blog.csdn.net/xubass/article/details/154577167 LinuxUbuntu搭建Node.js环境可以参考如下链接： https://blog.csdn.net/weixin_42512282/article/details/139771724

OpenClaw最新版本OpenClaw 2026.2.19-2安装，快速安装命令：

# Linux/macOS
curl https://openclaw.ai/install.sh | bash
# Windows PowerShell (WSL2)
iwr -useb https://openclaw.ai/install.ps1 | iex

如果不存在curl则执行以下命令安装curl。

## curl -fsSL: command not found
sudo apt update
sudo apt install curl

具体操作步骤和日志

这里如果没有安装以上环境OpenClow会自动安装其匹配的node\git等所需环境组件。

root@WIN-20230826EQZ:/data/openclow# curl https://openclaw.ai/install.sh | bash
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100 67324  100 67324    0     0  76376      0 --:--:-- --:--:-- --:--:-- 76331
╭─────────────────────────────────────────────────────────────────╮
│                                                                 │
│  🦞 OpenClaw Installer                                          │
│  Claws out, commit in—let's ship something mildly responsible.  │
│  modern installer mode                                          │
│                                                                 │
╰─────────────────────────────────────────────────────────────────╯

✓ gum bootstrapped (temp, verified, v0.17.0)
✓ Detected: linux

Install plan

OS                  linux
Install method      npm
Requested version   latest

[1/3] Preparing environment

INFO Node.js not found, installing it now
INFO Installing Node.js via NodeSource
INFO Installing Linux build tools (make/g++/cmake/python3)
✓ Build tools installed
✓ Node.js v22 installed

[2/3] Installing OpenClaw

✓ Git already installed
INFO Installing OpenClaw v2026.2.19-2
✓ OpenClaw npm package installed
✓ OpenClaw installed

[3/3] Finalizing setup


🦞 OpenClaw installed successfully (2026.2.19-2)!
I'm in. Let's cause some responsible chaos.

INFO Starting setup


🦞 OpenClaw 2026.2.19-2 (45d9b20) — Greetings, Professor Falken

▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
██░▄▄▄░██░▄▄░██░▄▄▄██░▀██░██░▄▄▀██░████░▄▄▀██░███░██
██░███░██░▀▀░██░▄▄▄██░█░█░██░█████░████░▀▀░██░█░█░██
██░▀▀▀░██░█████░▀▀▀██░██▄░██░▀▀▄██░▀▀░█░██░██▄▀▄▀▄██
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
                  🦞 OPENCLAW 🦞

关注公众号【阳光宅猿】回复【AIGC】领取最新AI人工智能学习资料，包含RAG、Agent、深度学习、模型微调等多种最新技术文档等你来选！！
关注公众号【阳光宅猿】回复【加群】进入大模型技术交流群一起学习成长!!!
┌  OpenClaw onboarding
│
◇  Security ──────────────────────────────────────────────────────────────────────────────╮
│                                                                                         │
│  Security warning — please read.                                                        │
│                                                                                         │
│  OpenClaw is a hobby project and still in beta. Expect sharp edges.                     │
│  This bot can read files and run actions if tools are enabled.                          │
│  A bad prompt can trick it into doing unsafe things.                                    │
│                                                                                         │
│  If you’re not comfortable with basic security and access control, don’t run OpenClaw.  │
│  Ask someone experienced to help before enabling tools or exposing it to the internet.  │
│                                                                                         │
│  Recommended baseline:                                                                  │
│  - Pairing/allowlists + mention gating.                                                 │
│  - Sandbox + least-privilege tools.                                                     │
│  - Keep secrets out of the agent’s reachable filesystem.                                │
│  - Use the strongest available model for any bot with tools or untrusted inboxes.       │
│                                                                                         │
│  Run regularly:                                                                         │
│  openclaw security audit --deep                                                         │
│  openclaw security audit --fix                                                          │
│                                                                                         │
│  Must read: https://docs.openclaw.ai/gateway/security                                   │
│                                                                                         │
├─────────────────────────────────────────────────────────────────────────────────────────╯
│
◆  I understand this is powerful and inherently risky. Continue?
│  ○ Yes / ● No
|  ## 选择YES
 Onboarding mode
│  ## 选择QuickStart
│
◇  QuickStart ─────────────────────────╮
│                                      │
│  Gateway port: 18789                 │
│  Gateway bind: Loopback (127.0.0.1)  │
│  Gateway auth: Token (default)       │
│  Tailscale exposure: Off             │
│  Direct to chat channels.            │
│                                      │
├──────────────────────────────────────╯
│
 Model/auth provider
│  ○ OpenAI
│  ○ Anthropic
│  ○ Chutes
│  ○ vLLM
│  ● MiniMax
│  ○ Moonshot AI (Kimi K2.5)
│  ○ Google
│  ○ xAI (Grok)
│  ○ OpenRouter
│  ○ Qwen (OAuth)
│  ○ Z.AI
│  ○ Qianfan
│  ○ Copilot
│  ○ Vercel AI Gateway
│  ○ OpenCode Zen
│  ○ Xiaomi
│  ○ Synthetic
│  ○ Together AI
│  ○ Hugging Face
│  ○ Venice AI
│  ○ LiteLLM
│  ○ Cloudflare AI Gateway
│  ○ Custom Provider
│  ○ Skip for now

这里OpenClow官方给出了安全警告内容：

安全警告——请阅读。
OpenClaw 是一个个人爱好项目，目前仍处于测试阶段，可能存在一些未完善之处。该机器人在启用工具后可以读取文件并执行操作。不当的提示可能会诱导其执行不安全的操作。
如果您对基本安全和访问控制不熟悉，请不要运行 OpenClaw。在启用工具或将其暴露于互联网之前，请寻求有经验人士的帮助。
推荐的基础配置：
- 配对/允许列表 + 提及权限控制。
- 沙盒环境 + 最小权限工具。
- 将密钥等敏感信息保留在机器人可访问的文件系统之外。
- 对于启用了工具或处理不可信收件箱的任何机器人，使用可用的最强模型。
定期执行：
openclaw security audit --deep
openclaw security audit --fix
必须阅读：https://docs.openclaw.ai/gateway/security

并且新增了很多模型厂商，国内完全免费且较为稳定的是Qwen App的接口，即调用千问的App来进行对话。这里我们选择MiniMax，因为Qwen没有弹出授权页面，因此不得不选择其他模型。

这里需要说明的是，如果要选择其他免费模型，就需要在选择模型供应商部分先选择Skip for now，这里我们暂时选择Skip for now。因为我们选择Qwen模型，应该会自动弹出授权页面，如果没有注册，还会提示先进行注册再授权，然后点击确认即可完成授权，但是其并没有弹出授权页面。

注意如果这步你选择了Qwen但是没有弹出授权页面，会导致网关GateWay授权失败。

关注公众号【阳光宅猿】回复【AIGC】领取最新AI人工智能学习资料，包含RAG、Agent、深度学习、模型微调等多种最新技术文档等你来选！！

关注公众号【阳光宅猿】回复【加群】进入大模型技术交流群一起学习成长!!!

◇  Gateway ──────────────────────────────────────────────────────────╮
│                                                                    │
│  gateway.mode is unset; gateway start will be blocked.             │
│  Fix: run openclaw configure and set Gateway mode (local/remote).  │
│  Or set directly: openclaw config set gateway.mode local           │
│  Missing config: run openclaw setup first.                         │
│                                                                    │
├────────────────────────────────────────────────────────────────────╯
│
◇  Gateway auth ──────────────────────────────────────────────────────────────────────╮
│                                                                                     │
│  Gateway auth is off or missing a token. Token auth is now the recommended default  │
│  (including loopback).                                                              │
│                                                                                     │
├─────────────────────────────────────────────────────────────────────────────────────╯
│

我们可以执行后面的卸载命令进行卸载重装。

继续上一步，我们选择MiniMax中的MiniMax M2.5作为默认模型。MiniMax也是OpenClaw作者推荐的适合国内小伙伴使用的，填入我们申请的APIKEY（目前MiniMax新用户注册赠送15元代金券）。

如果前面选择Skip for now，然后就能看到现在OpenClaw各免费模型的名字，大家可以任意选择，也可以选择比如kimi-coding模型，然后选择kimi-2.5模型作为默认模型。

◇  QuickStart ─────────────────────────╮
│                                      │
│  Gateway port: 18789                 │
│  Gateway bind: Loopback (127.0.0.1)  │
│  Gateway auth: Token (default)       │
│  Tailscale exposure: Off             │
│  Direct to chat channels.            │
│                                      │
├──────────────────────────────────────╯
│
◇  Model/auth provider
│  MiniMax
│
◇  MiniMax auth method
│  MiniMax M2.5 (CN)
│
◇  Enter MiniMax China API key
|
│
◇  Default model
│  Keep current (minimax-cn/MiniMax-M2.5)
|

不管怎样，选择完模型之后，即可进一步选择channel，也就是选择允许接入的即时通信软件。目前国内支持的比较好的只有iMessage，但应用面不广，下一步我们通过插件直接接入企微和飞书，因此这里我们先选择跳过。

◆  Select channel (QuickStart)
│  ○ Telegram (Bot API)
│  ○ WhatsApp (QR link)
│  ○ Discord (Bot API)
│  ○ IRC (Server + Nick)
│  ○ Google Chat (Chat API)
│  ○ Slack (Socket Mode)
│  ○ Signal (signal-cli)
│  ○ iMessage (imsg)
│  ○ Feishu/Lark (飞书)
│  ○ Nostr (NIP-04 DMs)
│  ○ Microsoft Teams (Bot Framework)
│  ○ Mattermost (plugin)
│  ○ Nextcloud Talk (self-hosted)
│  ○ Matrix (plugin)
│  ○ BlueBubbles (macOS app)
│  ○ LINE (Messaging API)
│  ○ Zalo (Bot API)
│  ○ Zalo (Personal Account)
│  ○ Tlon (Urbit)
│  ● Skip for now (You can add channels later via `openclaw channels add`)
└

Skills选择我们也先跳过。

◇  Configure skills now? (recommended)
│  Yes
│
◆  Install missing skill dependencies
│  ◻ Skip for now (Continue without installing dependencies)
│  ◻ 🔐 1password
│  ◻ 📰 blogwatcher
│  ◻ 🫐 blucli
│  ◻ 📸 camsnap
│  ◻ 🧩 clawhub
│  ◻ 🎛️ eightctl
│  ◻ ♊️ gemini
│  ◻ 🧲 gifgrep
│  ◻ 🐙 github
│  ◻ 🎮 gog
│  ◻ 📍 goplaces
│  ◻ 📧 himalaya
│  ◻ 📦 mcporter
│  ◻ 🍌 nano-banana-pro
│  ◻ 📄 nano-pdf
│  ◻ 💎 obsidian
│  ◻ 🎙️ openai-whisper
│  ◻ 💡 openhue
│  ◻ 🧿 oracle
│  ◻ 🛵 ordercli

然后我们选择让模型能够进行会话级的长期记忆。

◇  Set GOOGLE_PLACES_API_KEY for goplaces?
│  No
│
◇  Set GEMINI_API_KEY for nano-banana-pro?
│  No
│
◇  Set NOTION_API_KEY for notion?
│  No
│
◇  Set OPENAI_API_KEY for openai-image-gen?
│  No
│
◇  Set OPENAI_API_KEY for openai-whisper-api?
│  No
│
◇  Set ELEVENLABS_API_KEY for sag?
│  No
│
◇  Hooks ──────────────────────────────────────────────────────────╮
│                                                                  │
│  Hooks let you automate actions when agent commands are issued.  │
│  Example: Save session context to memory when you issue /new.    │
│                                                                  │
│  Learn more: https://docs.openclaw.ai/automation/hooks           │
│                                                                  │
├──────────────────────────────────────────────────────────────────╯
│
◆  Enable hooks?
│  ◻ Skip for now
│  ◻ 🚀 boot-md
│  ◻ 📎 bootstrap-extra-files
│  ◻ 📝 command-logger
│  ◼ 💾 session-memory (Save session context to memory when /new command is issued)
└
  Hooks Configured ─────────────────╮
│                                    │
│  Enabled 1 hook: session-memory    │
│                                    │
│  You can manage hooks later with:  │
│    openclaw hooks list             │
│    openclaw hooks enable <name>    │
│    openclaw hooks disable <name>   │
│                                    │
├────────────────────────────────────╯
Config overwrite: /root/.openclaw/openclaw.json (sha256 bbcc1fb6b4ea087b34a787c28141376321b2ac63f413e914b1bb84cd81c9bf81 -> 7cccb4bd6790ebf65903a19fdf94a958ad37c866116c76af16e8008bc32cd912, backup=/root/.openclaw/openclaw.json.bak)
│
◇  Gateway service runtime ────────────────────────────────────────────╮
│                                                                      │
│  QuickStart uses Node for the Gateway service (stable + supported).  │
│                                                                      │
├──────────────────────────────────────────────────────────────────────╯
│
◇  Gateway service already installed
│  Restart
│
◑  Restarting Gateway service…Restarted systemd service: openclaw-gateway.service
◇  Gateway service restarted.
│
◇
Agents: main (default)
Heartbeat interval: 30m (main)
Session store (main): /root/.openclaw/agents/main/sessions/sessions.json (0 entries)
│
◇  Optional apps ────────────────────────╮
│                                        │
│  Add nodes for extra features:         │
│  - macOS app (system + notifications)  │ 这里就是上文所说的Node节点
│  - iOS app (camera/canvas)             │
│  - Android app (camera/canvas)         │
│                                        │
├────────────────────────────────────────╯
│
◇  Control UI ─────────────────────────────────────────────────────────────────────╮
│                                                                                  │
│  Web UI: http://127.0.0.1:18789/                                                 │
│  Web UI (with token):                                                            │
│  http://127.0.0.1:18789/#token=0b80ccb72689e41e2fe4d11520f91638b6f02dbc6871a8f5  │
│  Gateway WS: ws://127.0.0.1:18789                                                │
│  Gateway: reachable                                                              │
│  Docs: https://docs.openclaw.ai/web/control-ui                                   │
│                                                                                  │
├──────────────────────────────────────────────────────────────────────────────────╯
│
◇  Start TUI (best option!) ─────────────────────────────────╮
│                                                            │
│  This is the defining action that makes your agent you.    │
│  Please take your time.                                    │
│  The more you tell it, the better the experience will be.  │
│  We will send: "Wake up, my friend!"                       │
│                                                            │
├────────────────────────────────────────────────────────────╯
│
关注公众号【阳光宅猿】回复【AIGC】领取最新AI人工智能学习资料，包含RAG、Agent、深度学习、模型微调等多种最新技术文档等你来选！！
关注公众号【阳光宅猿】回复【加群】进入大模型技术交流群一起学习成长!!!
◇  Token ─────────────────────────────────────────────────────────────────────────────────╮
│                                                                                         │
│  Gateway token: shared auth for the Gateway + Control UI.                               │
│  Stored in: ~/.openclaw/openclaw.json (gateway.auth.token) or OPENCLAW_GATEWAY_TOKEN.   │
│  View token: openclaw config get gateway.auth.token                                     │
│  Generate token: openclaw doctor --generate-gateway-token                               │
│  Web UI stores a copy in this browser's localStorage (openclaw.control.settings.v1).    │
│  Open the dashboard anytime: openclaw dashboard --no-open                               │
│  If prompted: paste the token into Control UI settings (or use the tokenized dashboard  │
│  URL).                                                                                  │
│                                                                                         │
├─────────────────────────────────────────────────────────────────────────────────────────╯
│
│
◇  How do you want to hatch your bot?
│  Hatch in TUI (recommended)
 openclaw tui - ws://127.0.0.1:18789 - agent main - session main
 connecting | idle
 gateway disconnected: pairing required | idle
──────────────────────────────────────────────────────────────────────────────────────────────────────────────
gateway connect failed: Error: pairing required
gateway connect failed: Error: pairing required───────────────────────────────────────────────────────────────
gateway connect failed: Error: pairing required
gateway connect failed: Error: pairing required
gateway connect failed: Error: pairing required
gateway connect failed: Error: pairing required
gateway connect failed: Error: pairing required

而当安装结束后，即可选择对话方式，这里我们选择TUI，即同步命令行和Web页面内容进行对话。但是这里提示网关连接异常。

根据官网给的方法

我们访问页面http://localhost:18789/chat，将openclaw config get gateway.auth.token 出来的token粘贴到Gateway Token输入框中，点击连接显示正常。

这样我们即可进入到对话页面，首次登陆时会自动给OpenClaw发送一条Wake up，my friend信息，能够看到模型即时回复的消息。

如果期间我们想要更改模型的APIKEY或者是更换模型，需执行一下命令：

 openclaw config #根据提示修改所需模块

我在这里修改了模型的APIKEY，改为直接读取配置文件~/.openclaw/openclaw.json中的APIKEY内容。

◇  MiniMax auth method
│  MiniMax M2.5 (CN)
│
◇  Use existing MINIMAX_API_KEY (env: MINIMAX_API_KEY, sk-a…NWOw)?
│  Yes
│

控制台输入/models，选择好minimax模型Minimax-M2.5。

/models

重启OpenClaw配置即可生效。

openclaw gateway 或 openclaw gateway restart

05、卸载OpenClaw

要卸载使用 pnpm 全局安装的 openclaw，可以使用以下命令：

pnpm remove -g openclaw
 npm remove -g openclaw

或者也可以使用更简短的写法：

pnpm rm -g openclaw

如果以上命令不行，可以尝试：

检查是否已卸载：

pnpm list -g | grep openclaw

手动删除全局包（如果标准方法无效）：

找到pnpm全局安装目录

pnpm root -g

然后进入该目录手动删除openclaw相关文件夹

清除缓存（可选）：

pnpm store prune

注意事项：

-g 参数表示全局（global），与安装时使用的 -g 对应

如果安装时使用了 --global 完整写法，卸载时也可以使用同样的完整写法

卸载完成后，可以通过以下命令验证是否成功：

which openclaw  # 检查命令是否存在
openclaw --version  # 尝试运行看是否报错

06、OpenClaw基础命令汇总

简单命令操作汇总：

openclaw gateway #启动主程序
openclaw tui #进入对话控制台页面
openclaw dashboard #进入网页版控制台
openclaw channels logout #退出openclaw中登录过的聊天软件
openclaw channels login #登录openclaw中登录过的聊天软件
systemctl --user start openclaw-gateway
systemctl --user status openclaw-gateway
npm remove -g openclaw #卸载openclaw
openclaw devices list #获取链接的设备
openclaw config get gateway.auth.token #获取网关Token
openclaw doctor --generate-gateway-token #重新生成网关Token

遇到4008、code1008也可以生成新的Token：
# 生成新的 gateway token
openclaw doctor --generate-gateway-token
# 重启服务
systemctl --user restart openclaw-gateway
# 打开带 token 的 dashboard
openclaw dashboard

关注公众号【阳光宅猿】回复【AIGC】领取最新AI人工智能学习资料，包含RAG、Agent、深度学习、模型微调等多种最新技术文档等你来选！！

关注公众号【阳光宅猿】回复【加群】进入大模型技术交流群一起学习成长!!!

07、OpenClaw工作流程

我们可以把 OpenClaw 比作一个公司员工：

特性	Tools (内置工具)	Plugins (插件)	Skills (技能)
比喻	手、眼、腿	手机、对讲机、电话	会计证、厨师证、驾驶证
作用	执行具体动作（如：点击网页、拍照）	建立新的连接通道（如：接入 Mattermost）	定义复杂的业务流程（如：监控博客、日报生成）
运行位置	核心沙箱 / 节点	网关 (Gateway) 进程	Agent 逻辑层 / 配置
例子	Managed Browser, Exec	Mattermost, Voice Call	Blogwatcher, ClawHub

一个典型的OpenClaw任务执行流程如下：

用户输入：用户通过一个已连接的通信平台（如微信）发送一条自然语言指令，例如“帮我总结一下昨天收到的关于“项目A”的邮件，并生成一份报告草稿”。
消息接收与归一化：该平台的通道适配器接收到消息，进行认证和格式归一化，然后将其传递给网关。
路由与分发：网关的路由引擎确定该消息应由哪个智能体处理，并将任务分发过去。
推理与规划：智能体接收到任务后，首先调用记忆系统，检索与“项目A”相关的历史上下文和知识。随后，它将用户指令、相关记忆和可用技能列表一起提交给大型语言模型（LLM）进行推理。LLM返回一个结构化的行动计划，例如：
- 步骤1：调用“邮件搜索”技能，搜索关键词为“项目A”且时间在昨天的邮件。

步骤2：调用“文本总结”技能，对搜索到的邮件内容进行摘要。
步骤3：调用“文件写入”技能，将总结内容以Markdown格式写入一个新文件项目A报告草稿.md。

技能调用与执行：智能体根据LLM的规划，依次调用相应的技能（Skills）。这些技能可能在网关所在的服务器上执行（如文本总结），也可能被分发到安装在用户电脑上的节点上执行（如邮件搜索和文件写入）。
结果反馈：任务执行完成后，执行结果通过节点和网关回传给用户。例如，Agent可能会在微信中回复：“任务已完成，报告草稿<项目A报告草稿.md>已保存在您的桌面”。
记忆更新：整个交互过程，包括用户的指令、Agent的思考步骤和最终结果，都会被记录到记忆系统中，供未来的任务参考。