跳到主要内容 OpenClaw 101:本地优先 AI 智能体部署与实操指南 | 极客日志
Python
OpenClaw 101:本地优先 AI 智能体部署与实操指南 近期,OpenClaw(原 Clawd、Moltbot)迅速获得大量 GitHub Stars,如今星标数已突破 18 万+。不同于 ChatGPT 等'只说不做'的聊天机器人,OpenClaw 是一款开源的个人 AI 助手平台,核心定位是'真会动手办事'的数字员工——它能接管电脑操作权限,通过自然语言指令主动执行各类任务,真正实现'聊天框里办大事'。 迅速获得大量 GitHub Stars,如今星标数已突破 18 万+。不同于 ChatGPT 等'只说不做'的聊天机器人,OpenClaw 是一款开源的个人 AI 助手平台,核心定位是'真会动手办事'的数字员工——它能接管电脑操作权限,通过自然语言指令主动执行各类任务,真正实现'聊天框里办大事'。
本文作为 OpenClaw 101 入门指南,将从'是什么→怎么装→怎么用→核心原理→进阶技巧'逐步拆解,逻辑清晰、实操性强,无论是零基础新手还是有一定技术基础的开发者,都能快速上手,解锁这款 AI 工具的核心价值。
一、基础认知:OpenClaw 到底是什么?
1.1 核心定位:不止是聊天,更是'能执行的 AI 助理' OpenClaw 的核心理念是'本地优先'(Local-first)和'执行优先'(Action-oriented),它被定义为一个'自托管的 AI 智能体框架',区别于传统聊天机器人的核心优势的是:拥有'眼睛'和'手'——能操作浏览器、读写文件、执行脚本命令、模拟鼠标键盘,甚至管理邮箱、预订服务、填写表单,真正充当用户的贴身数字员工。
简单来说:ChatGPT 能告诉你'如何清理邮箱',而 OpenClaw 能直接帮你清理邮箱;ChatGPT 能给出'预订餐厅的步骤',而 OpenClaw 能直接完成预订并反馈结果,这就是'信息生成者'与'任务执行者'的本质区别。
1.2 核心特性:为什么 OpenClaw 能快速出圈?
本地优先,隐私可控:默认运行在用户本地设备(Windows、macOS、Linux,甚至树莓派),所有数据、对话历史和任务执行记录都保存在本地,不上传云端,彻底保障数据主权,尤其适合对隐私敏感的用户。
寄生式交互,零门槛使用:无需安装额外 App,可嵌入 WhatsApp、Telegram、Discord、飞书、钉钉等 20+ 主流通讯软件,用户在熟悉的聊天界面就能发送指令,后台自动执行并反馈结果,极大降低使用门槛。
持续记忆,越用越懂你:采用'文件即状态'的记忆机制,能持久保存用户偏好、历史指令和关键信息(如配偶生日、工作习惯),不同于 ChatGPT 的上下文重置模式,OpenClaw 能实现长期记忆,主动给出提醒和个性化建议,真正'越用越懂你'。
高度可扩展,技能自由:支持通过'技能(Skills)'扩展能力,既能安装社区开发的 3000+ 插件,也能自定义编写脚本,甚至能自动生成新技能来满足用户的个性化需求,实现'自我进化'。
多模型兼容,灵活切换:可对接 Anthropic Claude、OpenAI GPT、Gemini 等云端模型,也支持 Ollama 等本地私有模型,用户可根据需求自由切换,兼顾性能与隐私。
1.3 适用人群:谁该学习 OpenClaw? 无论是零基础的普通用户,还是有技术基础的开发者,都能从 OpenClaw 中获益:
普通用户:用它自动化处理重复任务(清理邮箱、管理日程、预订服务),提升日常效率;
开发者:基于其框架二次开发,自定义技能插件,或搭建专属 AI 助手;
企业用户:部署在私有服务器,实现内部流程自动化,保障数据安全。
二、实操入门:从零部署 OpenClaw(新手友好) 部署 OpenClaw 有两种主流方式:本地部署(适合新手体验)和云端部署(适合长期稳定使用),本文重点讲解本地部署(Windows/WSL2、macOS 通用),并补充阿里云云端部署的核心步骤,全程附可直接复制的命令,零基础也能轻松完成。
2.1 前置条件(必看)
系统要求:macOS 10.15+、Linux(推荐 Ubuntu)、Windows(需安装 WSL2,原生 Windows 未经充分测试,不推荐);
软件依赖:Node.js ≥ 22(核心依赖)、pnpm(可选,从源代码构建时推荐);
其他准备:AI 模型 API Key(Claude/OpenAI/KIMI 均可,推荐 Claude Sonnet 4.5,性价比高)、聊天渠道账号(Telegram/WhatsApp/飞书任选,Telegram 功能最完善);
可选准备:Brave Search API 密钥(用于网页搜索功能,提升 AI 的实时信息获取能力)。
2.2 本地部署步骤(3 步搞定) 步骤 1:安装 OpenClaw CLI(命令行工具)
CLI 是操作 OpenClaw 的核心工具,不同系统的安装命令如下,复制粘贴到终端/命令行即可:
curl -fsSL https://openclaw.ai/install.sh | bash
iwr -useb https://openclaw.ai/install.ps1 | iex
npm install -g openclaw@latest
pnpm add -g openclaw@latest
安装完成后,输入 openclaw --version,若显示版本号,说明安装成功。
OpenClaw 提供了新手引导向导,能自动配置模型认证、网关设置、聊天渠道等,无需手动修改配置文件,新手优先选择此方式:
openclaw onboard --install-daemon
运行后,按照提示完成以下配置(全程中文引导,耐心操作即可):
选择部署方式:本地 Gateway(新手选这个)或远程 Gateway;
认证配置:输入 AI 模型 API Key(如 Claude),或选择 OAuth 认证;
聊天渠道配置:选择你常用的渠道(如 Telegram/WhatsApp),按提示完成登录(如 WhatsApp 扫描 QR 码、Telegram 输入机器人令牌);
守护进程安装:选择安装后台服务(launchd/systemd),让 OpenClaw 持续在后台运行,无需每次手动启动。
如果在引导向导中安装了后台服务,Gateway 会自动启动,可通过以下命令查看状态:
若显示'Up',说明 Gateway 运行正常;若未自动启动,手动启动命令:
openclaw gateway --port 18789 --verbose
启动后,可通过 Web 控制台验证:浏览器输入 http://127.0.0.1:18789/,粘贴引导向导生成的 Token 登录,能正常加载控制台即部署成功。
最后,在你配置的聊天渠道(如 Telegram)发送指令'你好,帮我查看当前目录的文件',若 AI 返回文件列表,说明整个部署流程无误,可正常使用。
2.3 云端部署简化版(阿里云,长期稳定) 如果想让 OpenClaw 24 小时不间断运行,推荐阿里云轻量应用服务器部署(成本低、操作简单),核心步骤如下:
购买阿里云轻量应用服务器,选择'应用镜像→OpenClaw 2026 新手版'(预置所有依赖),最低配置 2vCPU+2GiB 内存即可;
放通 18789 端口,在阿里云控制台配置 API Key(粘贴你的 Claude/OpenAI Key);
远程连接服务器,执行 docker ps | grep openclaw,查看容器运行状态;
对接聊天渠道,执行 openclaw channels login,按提示配置 Telegram/飞书等,完成测试。
三、核心操作:OpenClaw 常用指令与场景实操 部署完成后,核心使用方式是'在聊天渠道发送自然语言指令',OpenClaw 会自动拆解任务、执行操作并反馈结果。以下是新手必学的常用指令和典型场景,直接复制发送即可体验。
3.1 基础指令(快速上手)
查看系统状态:帮我查看 OpenClaw 的运行状态,以及当前连接的模型;
文件操作:帮我创建一个名为 openclaw_test 的文件夹,然后在里面新建一个 txt 文件,写入'Hello OpenClaw';
网页操作:帮我打开百度,搜索'OpenClaw 最新技能',并把搜索结果总结给我;
日程管理:帮我添加一个明天下午 3 点的会议,主题是'OpenClaw 学习',提醒我提前 10 分钟;
技能管理:帮我安装 tavily-search 技能(用于联网搜索)。
3.2 典型场景实操(解锁核心价值) 指令:帮我清理收件箱,删除所有来自广告邮箱的邮件,把标题包含'工作'的邮件标记为已读,并整理一份未读邮件清单发给我。
原理:OpenClaw 调用邮箱技能,读取邮箱内容,根据关键词筛选邮件,执行删除、标记操作,最后生成清单反馈,全程无需手动操作。
指令:帮我远程打开电脑上的微信,发送一条消息给'张三',内容是'明天的会议推迟到下午 4 点'。
原理:通过 Gateway 的实时通信能力,远程调用电脑的鼠标键盘模拟功能,打开应用、发送消息,适合不在电脑前但需要紧急操作的场景。
指令:记住我配偶的生日是 10 月 1 日,到 9 月 30 日的时候主动提醒我准备礼物。
原理:利用 OpenClaw 的长期记忆机制,将关键信息存储为本地文件,通过调度层的定时任务,到指定时间主动推送提醒,体现'贴身助理'的价值。
3.3 技能管理(扩展 OpenClaw 能力) 技能是 OpenClaw 的核心扩展方式,新手必装 3 个基础技能,装上后能解决 80% 的使用场景:
tavily-search:联网搜索技能,打破 AI 的知识局限,获取实时资讯和数据,安装命令:clawhub install tavily-search;
agent-browser:浏览器自动化技能,控制浏览器打开网页、填写表单、点击操作,默认已安装;
shell-skills:系统命令执行技能,允许 OpenClaw 执行 Shell 命令,实现更灵活的本地操作,安装命令:clawhub install shell-skills。
查看已安装技能:openclaw skills list;卸载技能:clawhub uninstall 技能名称。
四、深度解析:OpenClaw 核心架构与工作原理 掌握了基础部署和操作后,我们深入拆解 OpenClaw 的核心架构——它之所以能实现'思考 - 执行 - 反馈'的闭环,得益于模块化的分层设计和独特的智能体循环机制。
4.1 六大核心子系统架构(从下到上) OpenClaw 采用模块化设计,分为六大核心子系统,各司其职、解耦独立,修改某一层不会影响其他层,便于扩展和维护,具体分工如下:
Gateway(网关层) :系统的'神经中枢',是一个常驻后台的 Node.js 进程,负责监听聊天渠道的消息、标准化处理指令、会话路由和安全认证,通过 WebSocket 实现实时双向通信,是用户远程控制的核心。
Router(路由层) :负责'分发任务',根据路由规则(如 Peer ID、群组 ID),将用户指令分配给对应的 Agent 实例,支持一个设备运行多个 Agent,服务于不同场景。
Agent Loop(智能体循环) :OpenClaw 的'心脏',遵循 Lobster 智能体循环模式,实现'思考 - 执行 - 观察 - 反馈'的闭环,也是它能完成复杂任务的核心:
思考(Think):加载 Agent 的身份(Soul)、记忆(Memory)和技能(Skills),将用户指令拆解为可执行的子任务;
执行(Act):调用底层工具或技能,执行具体操作(如打开浏览器、运行 Shell 命令);
观察(Observe):获取执行结果(成功/失败信息);
反馈(Reflect):将结果反馈给大模型,更新上下文,决定下一步行动或结束任务。
Brain(推理层) :负责与大语言模型交互,支持多模型热切换,负责 Prompt 构建、模型调用和输出解析,是 OpenClaw'理解指令'的核心。
Memory(记忆层) :采用'文件即状态'的设计,将所有记忆存储为本地 Markdown/YAML 文件,而非复杂数据库,分为 4 类:
Soul(灵魂):存储 Agent 的身份、价值观和个性,定义'我是谁';
Memory(记忆):存储用户长期偏好和关键信息,即长时记忆;
Session(会话):存储当前任务的上下文和短期记忆;
State(状态):用于多 Agent 协作,记录项目进度,实现协同工作。
Scheduler(调度层) :实现主动式服务,支持心跳模式和定时模式,Agent 可定期唤醒自己,主动执行任务(如每日早报、待办提醒),无需用户指令触发。
4.2 核心工作流程(以'预订餐厅'为例) 结合架构,我们拆解一个完整的任务执行流程,理解 OpenClaw 的工作逻辑:
用户在 Telegram 发送指令:'帮我预订今晚 7 点附近的餐厅,偏好中餐,人均 100 元以内';
Gateway 接收消息,标准化处理后,通过 Router 分配给主 Agent;
Agent Loop(思考阶段):拆解任务为'1. 搜索附近中餐餐厅;2. 筛选人均 100 元以内的选项;3. 打开订餐网站预订;4. 反馈预订结果';
Agent Loop(执行阶段):调用 tavily-search 技能搜索餐厅,调用 agent-browser 技能打开订餐网站,填写预订信息;
Agent Loop(观察阶段):获取预订结果(成功/失败),若失败(如无空位),调整策略(更换餐厅)重新尝试;
Agent Loop(反馈阶段):将预订成功的信息(餐厅名称、地址、预订时间)反馈给 Gateway,再由 Gateway 推送至用户 Telegram;
Memory 层更新:将用户的餐饮偏好(中餐、人均 100 元)保存为长期记忆,后续预订时自动匹配。
五、进阶技巧:自定义技能与安全优化 对于有一定开发基础的用户,可通过自定义技能和优化配置,让 OpenClaw 更贴合自身需求;同时,由于 OpenClaw 能控制本地设备,安全设置也至关重要。
5.1 自定义技能(简单脚本示例) OpenClaw 的技能本质是脚本文件,支持 JavaScript/Python 等语言,以下是一个简单的'每日天气提醒'技能示例(核心逻辑):
module .exports = {
name : "daily-weather" ,
description : "每日天气提醒" ,
schedule : "0 8 * * *" ,
async run (agent ) {
const weather = await agent.tools .web .search ("今日本地天气" );
await agent.channels .send ("telegram" , `今日天气:${weather} ,记得增减衣物哦~` );
agent.memory .set ("weather_preference" , "每日 8 点提醒" );
},
};
将脚本保存至 ~/.openclaw/skills/daily-weather 目录,执行 openclaw skills reload,即可启用该技能。
5.2 安全优化(必做,避免风险) 由于 OpenClaw 拥有设备操作权限,不当配置可能导致安全风险,推荐以下 3 个安全设置:
渐进式授权:初次使用时,仅给予 AI 只读权限,大部分操作(如发送邮件、删除文件)需用户确认,熟悉后再逐步开放权限;
开启操作日志:执行 openclaw security audit --deep,开启操作日志,所有 AI 执行的任务都可追溯,若出现错误可及时排查;
沙箱隔离:在配置文件中开启沙箱模式,隔离群组/渠道会话,避免恶意指令影响本地设备,配置示例:
{
"routing" : {
"agents" : {
"main" : {
"workspace" : "~/.openclaw/workspace" ,
"sandbox" : { "mode" : "non-main" }
}
}
}
}
六、常见问题排查(新手避坑) 部署和使用过程中,新手容易遇到以下问题,整理了对应的解决方案,快速排查无需踩坑:
问题 1:Gateway 启动失败,提示端口 18789 被占用
解决方案:修改配置文件 ~/.openclaw/openclaw.json,将端口改为 18790,重启服务:openclaw gateway restart。
问题 2:聊天渠道无响应,发送指令没有反馈
解决方案:检查网络连通性,重启渠道服务:openclaw channels restart 渠道名称(如 telegram),或重新配对:openclaw pairing approve 渠道名称 配对码。
问题 3:API Key 无效,模型调用失败
解决方案:检查 API Key 是否完整(无空格/字符遗漏),重新生成并配置,执行 openclaw configure --section brain 重新设置模型参数。
问题 4:Windows 系统部署后无法正常运行
解决方案:卸载原生 Windows 部署,安装 WSL2(推荐 Ubuntu),在 WSL2 内重新部署,避免原生 Windows 的兼容性问题。
七、总结与后续学习方向 本文从基础认知、部署实操、核心操作、架构解析到进阶技巧,完整覆盖了 OpenClaw 101 的核心内容,总结下来:OpenClaw 的核心价值是'将 AI 从聊天工具升级为执行工具',通过本地优先、持续记忆、高度可扩展的特点,真正成为用户的贴身数字员工。
深入学习 Lobster 智能体循环机制,理解 AI 的任务拆解逻辑;
开发复杂自定义技能,实现更个性化的自动化需求;
探索多 Agent 协作,搭建多个 AI 助理协同工作的场景;
研究 OpenClaw 的商业化与生态构建,了解技能商城、云端代管等模式。
随着 AI Agent 技术的发展,OpenClaw 作为开源领域的标杆项目,未来还会持续迭代升级。希望本文能帮助你快速入门 OpenClaw,解锁 AI 自动化的核心能力,让技术为效率赋能。
微信扫一扫,关注极客日志 微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
相关免费在线工具 curl 转代码 解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online
Base64 字符串编码/解码 将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
Base64 文件转换器 将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
Markdown 转 HTML 将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML 转 Markdown 互为补充。 在线工具,Markdown 转 HTML在线工具,online
HTML 转 Markdown 将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML 转 Markdown在线工具,online
JSON 压缩 通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online