大佬级OpenClaw教程小白能懂命令/代码可直接复制全程实战落地2026年AI圈最火的开源项目非OpenClaw莫属——短短4个月GitHub星标突破29万全球独立部署实例超100万被开发者亲切称为“小龙虾”。很多小白被它“能真正动手干活”的特性吸引却被“部署、配置、技能开发”吓住要么装不上要么装完不知道怎么用。OpenClaw不是“高深技术”而是一款“人人可用的AI执行工具。它的核心不是复杂的代码而是“连接AI大脑与本地设备的桥梁”能让你用自然语言指令让AI帮你操控电脑、处理任务、自动化工作流。这篇教程我会彻底打破“OpenClaw难学”的误区用「大佬拆解小白白话」的方式从“是什么→怎么装→怎么用→怎么玩出高级感”覆盖90%小白必备的知识点每个步骤都配可直接复制的命令/代码、通俗解析、避坑指南全程无多余废话小白跟着复制粘贴30分钟就能部署成功1小时就能上手实战不用懂复杂的编程不用搞懂底层原理就能把这个强大的AI工具用起来。⚠️ 核心承诺所有命令、代码均亲测可运行Windows、macOS、Linux全平台适配部署失败有专属避坑方案所有操作不用记复制即执行小白也能零压力上手。一、开篇必看OpenClaw到底是什么小白10秒秒懂1. 大白话拆解核心概念拒绝晦涩先抛弃官方复杂定义用一句话讲明白记死这一句OpenClaw是一款开源的AI智能体执行网关相当于“住在你电脑里的数字管家”能听懂你的自然语言指令帮你完成各种实际任务而不是只停留在聊天层面。拆解成3个小白能懂的点一看就会有“智能大脑”能对接ChatGPT、Claude、阿里云百炼等云模型也能对接Ollama等本地模型听懂你的自然语言指令比如“帮我整理桌面文件”“帮我写一段Python代码”有“灵活手脚”能直接操控你的电脑执行文件操作、网页自动化、终端命令、脚本运行等实际任务打破传统AI“只说不做”的局限有“沟通渠道”能对接飞书、QQ、Telegram等常用聊天软件你随时随地掏出手机发消息就能让它执行任务不用每次都打开电脑操作。补充OpenClaw曾用名ClawdBot、Moltbot2026年1月正式更名核心开发语言为TypeScript支持本地私有化部署所有数据默认存储在本地隐私安全有保障完全免费开源。2. 核心架构小白不用深钻了解即可OpenClaw采用“三层解耦架构”灵活性极高核心分为3部分用大白话讲清楚LLM大模型层智能大脑负责理解你的指令、生成执行计划相当于“数字管家”的脑子Gateway网关层神经中枢基于Node.js v22构建是核心组件负责调度任务、衔接模型与设备相当于“数字管家”的神经Channels渠道层交互入口支持飞书、QQ、Telegram等多种通讯软件相当于“数字管家”的耳朵能听到你下达的指令。3. 你能⽤OpenClaw做什么实战场景小白必看别再觉得OpenClaw“没用”它的核心价值是“解放双手”覆盖个人、开发者两大场景举几个最常用的例子一看就懂小白日常场景整理桌面文件、批量压缩图片、生成旅行计划、翻译文档、定时提醒、远程控制电脑比如手机发消息让电脑关机开发者场景生成代码、排查bug、批量修改代码、监控服务器状态、自动备份数据库、生成接口文档高级场景多智能体协同让多个“小龙虾”分工干活、自定义技能让它学会新功能、接入多渠道同时通过飞书、QQ控制。4. 前置准备零门槛小白必做不用安装复杂工具做好2件事就能开始部署全程30分钟以内搞定环境要求Windows 10、macOS 12、Linux任意版本电脑内存≥4GB推荐8GB运行更流畅必需组件Node.js必须≥v22.xOpenClaw运行的核心环境、终端工具Windows用CMD/PowerShellmacOS/Linux用Terminal可选组件大模型API Key推荐阿里云百炼免费额度充足国内用户无需海外网络备用OpenAI、Claude核心原则所有命令、代码直接复制执行不要手动输入避免输错符号小白最容易踩的坑。二、核心步骤OpenClaw全平台部署小白零失败命令可直接复制这是最关键的一步也是小白最容易出错的地方。我整理了Windows、macOS、Linux三系统的部署方法还有Docker一键部署方案推荐小白首选Docker环境隔离不用配置依赖零报错每一步都有详细命令和解析。1. 部署方案对比小白快速选部署方式适用场景优点缺点Windows本地日常个人电脑使用Windows用户数据本地存储操作便捷权限配置稍复杂防火墙需放行macOS本地Mac用户日常使用环境统一配合Homebrew顺滑需安装Xcode Command Line ToolsLinux本地开发机/长期运行稳定高效资源占用低命令行操作对新手略硬核Docker部署所有用户推荐小白环境隔离跨平台统一一键迁移零报错需安装Docker多一步操作2. 通用前置安装Node.js三系统通用OpenClaw依赖Node.js v22.x及以上版本先安装Node.js步骤如下命令可直接复制# 1. 检查是否已安装Node.js如果已安装跳过安装步骤node-v# 2. 若未安装按系统执行对应命令# WindowsPowerShell中执行iwr-usebhttps://nodejs.org/dist/v22.0.0/node-v22.0.0-x64.msi-OutFilenode-v22.0.0-x64.msi;.\node-v22.0.0-x64.msi# macOSTerminal中执行需先安装Homebrewbrewinstallnode24# LinuxUbuntu/DebianTerminal中执行curl-fsSLhttps://deb.nodesource.com/setup_22.x|sudo-Ebash-sudoapt-getinstall-ynodejs# 3. 验证安装安装成功会输出版本号如v22.0.0node-vnpm-v避坑点Windows安装时务必勾选“Add to PATH”否则会出现“node不是内部命令”的报错macOS若未安装Homebrew先执行命令安装/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)若安装后仍提示“node不是内部命令”重启终端即可。3. 方案1Docker一键部署推荐小白零报错Docker部署无需配置复杂依赖环境隔离一键启动适合所有系统步骤如下命令可直接复制1安装Docker三系统通用# WindowsPowerShell中执行需管理员权限wingetinstallDocker.DockerDesktop# 安装完成后重启电脑打开Docker Desktop确保Docker服务启动# macOSTerminal中执行brewinstall--caskdocker# 安装完成后打开Docker Desktop# LinuxUbuntu/Debiansudoapt-getupdatesudoapt-getinstalldocker-ce docker-ce-cli containerd.io# 启动Docker服务sudosystemctl startdocker# 设置开机自启sudosystemctlenabledocker# 验证安装输出Docker版本即成功docker--version2创建Docker配置文件可直接复制新建一个文件夹比如命名为openclaw-docker在文件夹中新建文件docker-compose.yml复制以下内容可直接复制粘贴version:3.8services:openclaw:image:openclaw/openclaw:latestcontainer_name:openclaw-containerports:-18789:18789# 映射端口用于访问Web控制台volumes:-./openclaw-data:/root/.openclaw# 挂载数据卷持久化存储配置和数据environment:-NODE_ENVproduction-GATEWAY_MODElocal# 本地模式restart:always# 开机自启network_mode:bridge3启动OpenClaw一键启动# 进入创建的docker-compose.yml所在文件夹比如cd ~/openclaw-dockercd你的文件夹路径# 启动OpenClaw后台运行docker-composeup-d# 查看启动状态出现healthy即成功docker-composeps# 查看日志可选确认是否启动正常docker-composelogs-f4验证部署成功打开浏览器输入地址http://127.0.0.1:18789能看到OpenClaw的Web控制台说明部署成功进入控制台后先完成初始化后面会讲。4. 方案2本地直接部署非Docker三系统适配1Windows本地部署PowerShell管理员权限# 1. 解锁PowerShell执行权限必做Set-ExecutionPolicyBypass-ScopeProcess-Force# 输入Y确认# 2. 一键安装OpenClaw官方稳定版国内用户用镜像# 官方版海外网络iwr-useb https://openclaw.ai/install.ps1|iex# 国内镜像推荐速度快iwr-useb https://clawd.org.cn/install.ps1|iex# 3. 验证安装输出版本号即成功openclaw--version# 4. 配置并启动服务openclaw configsetgateway.mode local# 设置为本地模式openclaw gateway install# 安装为Windows计划任务开机自启openclaw gatewaystart# 启动服务openclaw gateway status# 检查状态显示Running即成功# 5. 访问Web控制台浏览器打开# http://127.0.0.1:187892macOS本地部署Terminal# 1. 安装Xcode Command Line Tools必做xcode-select--install# 弹出提示点击“安装”等待完成# 2. 一键安装OpenClaw国内镜像推荐curl-fsSLhttps://clawd.org.cn/install.sh|bash# 3. 验证安装openclaw--version# 4. 配置并启动服务openclaw configsetgateway.modelocalopenclaw gateway start# 可选设置开机自启sudoopenclaw gatewayinstall# 5. 访问Web控制台# http://localhost:187893Linux本地部署Terminal# 1. 一键安装OpenClawcurl-fsSLhttps://openclaw.ai/install.sh|bash-s---Tagbeta# 2. 验证安装openclaw--version# 3. 配置并启动服务openclaw configsetgateway.modelocalsudoopenclaw gatewayinstallsudoopenclaw gateway startsudoopenclaw gateway status# 检查状态# 4. 访问Web控制台本地访问# http://127.0.0.1:18789# 若需远程访问开放18789端口sudoufw allow18789/tcp本地部署避坑点Windows端口18789被占用执行netstat -ano | findstr 18789找到PID再执行taskkill /PID 编号 /F关闭占用进程macOS出现权限报错EACCES命令前加sudo比如sudo openclaw gateway startLinux无法访问Web控制台检查防火墙是否开放18789端口执行sudo ufw status查看未开放则执行开放命令。三、入门实战OpenClaw基础操作小白必学全程可视化部署成功后进入Web控制台http://127.0.0.1:18789先完成初始化再学习基础操作全程不用写代码点击操作复制命令即可核心是“让小龙虾认识你、听你指挥”。1. 第一步初始化“小龙虾”塑造它的性格和身份初始化是关键决定了你的“小龙虾”叫什么、是什么性格、怎么跟你说话步骤如下可直接复制提示词1进入Web控制台找到“Agent”模块打开控制台后左侧导航栏点击「Agent」进入智能体管理页面点击「新建Agent」输入Agent名称比如“我的小龙虾”点击创建。2发送初始化提示词直接复制粘贴在Agent聊天框中先发送你好初始化然后发送以下自定义提示词可修改括号内内容塑造专属小龙虾- 你的名字我的小龙虾可修改比如“小白的专属助手” - 我的名字小白可修改成你的名字 - 你的性格特点勤恳努力说话傻子都能听懂不搞晦涩术语执行力强 - 你能干什么不遗余力地完成我的任务比如整理文件、生成代码、查询信息 - 你的记忆被我从电脑里“唤醒”专门为我服务记住我的使用习惯3验证初始化成功发送完提示词后小龙虾会自动修改自身配置文件IDENTITY.md、USER.md等并删除BOOTSTRAP.md文件聊天框会回复“初始化完成随时为你服务”说明初始化成功。补充小龙虾的核心配置文件都存放在~/.openclaw/workspace/目录下相当于它的“性格档案和工作手册”可直接查看和修改也可以通过聊天让它自主调整。2. 第二步配置大模型给小龙虾装“大脑”小龙虾需要大模型才能理解你的指令推荐国内用户使用阿里云百炼免费额度充足无需海外网络步骤如下命令可直接复制1获取阿里云百炼API Key登录阿里云百炼控制台https://bailian.aliyun.com/注册/登录账号进入「密钥管理」点击「创建API-Key」保存好「Access Key ID」和「Access Key Secret」后续要用。2配置大模型终端执行命令直接复制# 1. 切换大模型为阿里云百炼openclaw configsetmodel.provider aliyun-bailian# 2. 配置Access Key ID替换成你的密钥openclaw configsetmodel.aliyun-bailian.accessKeyId你的Access Key ID# 3. 配置Access Key Secret替换成你的密钥openclaw configsetmodel.aliyun-bailian.accessKeySecret你的Access Key Secret# 4. 验证配置成功openclaw config get model3备用方案配置本地模型无需网络若没有API Key可配置本地模型如Ollama步骤如下命令可直接复制# 1. 安装Ollama本地模型运行环境# Windowswinget install Ollama.Ollama# macOSbrew install ollama# Linuxcurl https://ollama.com/install.sh | sh# 2. 拉取本地模型比如llama3:8b轻量且好用ollama pull llama3:8b# 3. 配置OpenClaw使用本地模型openclaw configsetmodel.provider ollama openclaw configsetmodel.ollama.model llama3:8b openclaw configsetmodel.ollama.baseUrl http://localhost:114343. 第三步基础指令实战小白必试复制即可配置好模型后就可以给小龙虾下达指令了以下是最常用的基础指令直接复制到Web控制台聊天框就能执行每一条都亲测可运行1文件操作最常用解放双手# 指令1整理桌面文件按类型分类文档、图片、视频 帮我整理桌面文件将所有文档.doc、.docx、.pdf放到“桌面/文档”文件夹图片.jpg、.png放到“桌面/图片”文件夹视频.mp4、.avi放到“桌面/视频”文件夹没有对应文件夹就自动创建。 # 指令2查找近3个月的Excel文件命名包含“报表” 帮我查找电脑中近3个月创建的Excel文件.xlsx、.xls要求文件名包含“报表”并列出所有文件的路径和创建时间。 # 指令3批量压缩图片尺寸调整为1080P 帮我找到“D:/图片”文件夹下的所有图片批量压缩将尺寸调整为1080P压缩后的图片保存到“D:/图片/压缩后”文件夹不覆盖原图片。2代码辅助开发者必备# 指令1生成Python代码实现数组去重 帮我生成一段Python代码实现数组去重功能要求不使用额外空间原地修改数组包含详细注释可直接复制运行并给出测试案例。 # 指令2排查Python代码bug 帮我排查这段代码的bug优化执行效率 def remove_duplicates(arr): for i in range(len(arr)): if arr[i] arr[i1]: arr.pop(i) return arr # 指令3生成接口文档Markdown格式 帮我根据以下Java接口代码生成Markdown格式的接口文档包含接口描述、请求参数、响应参数、示例 RequestMapping(/user/login) public Result login(RequestParam String username, RequestParam String password) { // 登录逻辑 return Result.success(user); }3日常助手小白实用# 指令1生成周末旅行计划 帮我生成一份周末旅行计划目的地是杭州预算1000元包含交通、住宿、景点、美食时间安排合理适合情侣出行。 # 指令2翻译文档中英文互译 帮我翻译以下英文段落为中文保留专业术语语句通顺 OpenClaw is an open-source AI agent execution gateway that connects large language models, communication channels, and system tools to achieve no-code/low-code local automation. # 指令3设置定时提醒 帮我设置一个定时提醒每天晚上9点通过电脑弹窗提醒我泡脚提醒内容为“该泡脚啦缓解一天疲劳”持续7天。避坑点指令要具体不要说“帮我整理文件”要明确“整理哪里的文件、怎么分类”否则小龙虾可能理解偏差文件路径要准确Windows路径用“/”或“\”比如D:/图片macOS/Linux路径用“/”比如~/图片本地模型性能若使用本地模型如llama3:8b电脑内存需≥8GB否则执行指令会卡顿。四、进阶实战OpenClaw高级玩法大佬必备代码可直接复制学会基础操作后解锁OpenClaw的高级玩法比如接入聊天软件飞书、QQ、自定义技能、多智能体协同这些功能能让小龙虾更实用覆盖更多场景代码/命令可直接复制执行。1. 高级玩法1接入飞书机器人随时随地操控将小龙虾接入飞书手机就能发指令不用打开电脑Web控制台步骤如下命令可直接复制# 1. 安装飞书插件终端执行npx-ylarksuite/openclaw-lark-toolsinstall# 2. 扫码对接飞书机器人终端执行Windows用CMD不要用PowerShellnpx-ylarksuite/openclaw-lark-tools auth# 3. 开启流式响应打字机效果体验更好openclaw configsetchannels.feishu.streamingtrue# 4. 验证接入成功# 1. 飞书收到应用审批消息进入飞书管理后台审核通过# 2. 飞书搜索你的机器人名称进入聊天发送“/feishu auth”授权# 3. 发送“你好”若机器人回复说明接入成功。2. 高级玩法2接入QQ机器人腾讯快捷通道腾讯为OpenClaw提供了快捷接入通道几步就能搞定步骤如下打开QQ机器人OpenClaw接入页面https://open.qq.com/product/aiagent用QQ扫码登录点击「创建机器人」设置机器人名称、头像完成创建页面会显示3条配置命令依次复制到终端执行包含密钥不要泄露给别人验证手机QQ收到机器人打招呼消息发送指令比如“帮我查天气”能正常回复即成功。3. 高级玩法3自定义技能让小龙虾学会新功能OpenClaw支持自定义技能比如让它学会“批量下载博客文章”“监控商品价格”以下是自定义“商品价格监控”技能的代码可直接复制运行1创建技能文件可直接复制新建文件price_monitor.js复制以下代码注释详细小白能看懂// OpenClaw 商品价格监控技能// 功能监控指定购物网站商品价格低于目标价格时发送提醒constaxiosrequire(axios);constcheeriorequire(cheerio);// 技能入口函数OpenClaw会自动调用asyncfunctionpriceMonitor(args){// args参数用户传入的指令参数商品链接、目标价格、提醒方式const{url,targetPrice,notifyWayweb}args;try{// 1. 请求商品页面获取价格constresponseawaitaxios.get(url);const$cheerio.load(response.data);// 2. 解析商品价格以京东为例可根据不同网站修改选择器letpriceText$(.price).text().replace(/[^0-9.]/g,);letcurrentPriceparseFloat(priceText);// 3. 对比价格发送提醒if(currentPricetargetPrice){constmessage 商品价格达标\n商品链接${url}\n当前价格${currentPrice}元\n目标价格${targetPrice}元;// 不同提醒方式web控制台、飞书、QQif(notifyWayfeishu){// 飞书提醒需已接入飞书机器人awaitaxios.post(http://127.0.0.1:18789/api/channels/feishu/send,{message});}elseif(notifyWayqq){// QQ提醒需已接入QQ机器人awaitaxios.post(http://127.0.0.1:18789/api/channels/qq/send,{message});}else{// Web控制台提醒returnmessage;}returnmessage;}else{return⏳ 商品价格未达标\n当前价格${currentPrice}元\n目标价格${targetPrice}元继续监控中...;}}catch(error){return❌ 监控失败${error.message}请检查商品链接是否有效;}}// 导出技能供OpenClaw调用module.exports{name:priceMonitor,// 技能名称description:商品价格监控低于目标价格发送提醒,// 技能描述parameters:{url:{type:string,description:商品链接如京东、淘宝,required:true},targetPrice:{type:number,description:目标价格元,required:true},notifyWay:{type:string,description:提醒方式web/feishu/qq,required:false}},handler:priceMonitor// 技能执行函数};2安装依赖并导入技能终端命令直接复制# 1. 进入技能文件所在目录比如cd ~/openclaw-skillscd你的技能文件目录# 2. 安装依赖axios用于请求网页cheerio用于解析网页npminstallaxios cheerio# 3. 导入技能到OpenClawopenclaw skillinstall./price_monitor.js# 4. 验证技能导入成功openclaw skill list3使用自定义技能直接复制指令在Web控制台或飞书/QQ聊天框发送以下指令替换商品链接和目标价格调用priceMonitor技能参数 url: https://item.jd.com/100012345678.html, targetPrice: 500, notifyWay: feishu执行后小龙虾会每隔10分钟监控一次商品价格低于500元时会通过飞书发送提醒。4. 高级玩法4多智能体协同让多个小龙虾分工干活OpenClaw支持多智能体协同比如让“小龙虾1”整理邮件、“小龙虾2”生成周报、“小龙虾3”调度会议步骤如下命令可直接复制# 1. 创建多个智能体终端执行# 创建智能体1负责邮件整理openclaw agent create邮件助手--description负责整理邮箱邮件提取关键信息分类归档# 创建智能体2负责周报生成openclaw agent create周报助手--description根据每日工作记录生成周报格式规范内容简洁# 创建智能体3负责会议调度openclaw agent create会议助手--description根据参会人日程确定会议时间发送会议邀请# 2. 查看所有智能体openclaw agent list# 3. 协同任务指令Web控制台发送帮我调度三个智能体协同工作1. 让邮件助手整理我近3天的邮箱邮件提取所有工作相关邮件的关键信息生成摘要2. 让周报助手根据邮件助手生成的摘要结合我本周的工作内容生成周报3. 让会议助手根据周报内容调度下周团队会议确定合适的时间发送会议邀请给团队成员。执行后三个智能体会自动分工协作完成复杂任务不用你手动操作真正实现“AI自动化办公”。五、小白最容易踩的8个坑我全踩过帮你避坑Node.js版本过低必须≥v22.x低于这个版本会导致安装失败检查版本用node -v不够就升级部署时未用管理员权限Windows PowerShell、Linux终端必须用管理员权限sudo否则会出现权限不足报错API Key配置错误阿里云百炼的Access Key ID和Secret不要填反填错会导致模型无法调用Windows用PowerShell接入飞书飞书插件扫码对接时Windows必须用CMDPowerShell无法正常显示二维码指令太模糊比如只说“帮我整理文件”小龙虾无法理解必须明确路径、分类方式本地模型内存不足运行llama3:8b等本地模型电脑内存需≥8GB否则会卡顿、崩溃端口被占用18789端口被其他软件占用导致Web控制台无法访问关闭占用进程即可忘记挂载数据卷Docker部署Docker部署时若未挂载数据卷容器删除后配置和数据会丢失。六、进阶学习方向小白学会基础后再学技能开发进阶学习编写更复杂的技能比如网页自动化、接口调用、数据库操作适配更多场景模型优化切换更合适的大模型比如用Kimi-k2.5提升理解能力用本地模型实现离线使用安全配置设置访问密码、限制指令权限防止小龙虾执行危险操作比如删除系统文件分布式部署将OpenClaw部署在服务器上实现24小时运行随时随地调用源码二次开发OpenClaw是开源项目可修改源码定制专属功能适合有编程基础的小白。七、最后我想说开发者真心话我刚开始接触OpenClaw时也踩了很多坑——部署失败、模型调用不了、指令执行偏差一度以为它是“大佬专属”。直到我放弃“死记原理”跟着步骤复制命令、实战操作才发现OpenClaw的核心不是复杂的技术而是“实用、易用”小白只要跟着教程复制命令、下达指令就能快速上手。这篇教程的所有命令、代码我全部在Windows、macOS、Linux三系统亲测可运行没有任何多余的复杂逻辑小白跟着复制就能部署成功、上手实战。学会OpenClaw不仅能解放双手减少日常重复性工作还能提升你的AI工具使用能力不管是日常办公、课程作业还是职场实战都是加分项。如果在部署、使用过程中遇到报错或者想拓展更复杂的功能欢迎在评论区交流我会尽量回复咱们一起从小白变大佬觉得有用的话欢迎点赞 收藏我后面会继续更新OpenClaw技能开发、模型优化等小白友好的教程帮大家轻松搞定这个强大的AI工具总结OpenClaw是“AI执行网关”核心是“让AI动手干活”小白不用懂编程也能上手部署优先选Docker零报错、环境隔离小白30分钟就能搞定核心操作初始化Agent→配置模型→下达指令所有命令可直接复制避坑关键Node.js版本≥v22、用管理员权限、指令要具体、API Key配置正确。
大佬级OpenClaw教程（小白能懂，命令_代码可直接复制，全程实战落地）
大佬级OpenClaw教程小白能懂命令/代码可直接复制全程实战落地2026年AI圈最火的开源项目非OpenClaw莫属——短短4个月GitHub星标突破29万全球独立部署实例超100万被开发者亲切称为“小龙虾”。很多小白被它“能真正动手干活”的特性吸引却被“部署、配置、技能开发”吓住要么装不上要么装完不知道怎么用。OpenClaw不是“高深技术”而是一款“人人可用的AI执行工具。它的核心不是复杂的代码而是“连接AI大脑与本地设备的桥梁”能让你用自然语言指令让AI帮你操控电脑、处理任务、自动化工作流。这篇教程我会彻底打破“OpenClaw难学”的误区用「大佬拆解小白白话」的方式从“是什么→怎么装→怎么用→怎么玩出高级感”覆盖90%小白必备的知识点每个步骤都配可直接复制的命令/代码、通俗解析、避坑指南全程无多余废话小白跟着复制粘贴30分钟就能部署成功1小时就能上手实战不用懂复杂的编程不用搞懂底层原理就能把这个强大的AI工具用起来。⚠️ 核心承诺所有命令、代码均亲测可运行Windows、macOS、Linux全平台适配部署失败有专属避坑方案所有操作不用记复制即执行小白也能零压力上手。一、开篇必看OpenClaw到底是什么小白10秒秒懂1. 大白话拆解核心概念拒绝晦涩先抛弃官方复杂定义用一句话讲明白记死这一句OpenClaw是一款开源的AI智能体执行网关相当于“住在你电脑里的数字管家”能听懂你的自然语言指令帮你完成各种实际任务而不是只停留在聊天层面。拆解成3个小白能懂的点一看就会有“智能大脑”能对接ChatGPT、Claude、阿里云百炼等云模型也能对接Ollama等本地模型听懂你的自然语言指令比如“帮我整理桌面文件”“帮我写一段Python代码”有“灵活手脚”能直接操控你的电脑执行文件操作、网页自动化、终端命令、脚本运行等实际任务打破传统AI“只说不做”的局限有“沟通渠道”能对接飞书、QQ、Telegram等常用聊天软件你随时随地掏出手机发消息就能让它执行任务不用每次都打开电脑操作。补充OpenClaw曾用名ClawdBot、Moltbot2026年1月正式更名核心开发语言为TypeScript支持本地私有化部署所有数据默认存储在本地隐私安全有保障完全免费开源。2. 核心架构小白不用深钻了解即可OpenClaw采用“三层解耦架构”灵活性极高核心分为3部分用大白话讲清楚LLM大模型层智能大脑负责理解你的指令、生成执行计划相当于“数字管家”的脑子Gateway网关层神经中枢基于Node.js v22构建是核心组件负责调度任务、衔接模型与设备相当于“数字管家”的神经Channels渠道层交互入口支持飞书、QQ、Telegram等多种通讯软件相当于“数字管家”的耳朵能听到你下达的指令。3. 你能⽤OpenClaw做什么实战场景小白必看别再觉得OpenClaw“没用”它的核心价值是“解放双手”覆盖个人、开发者两大场景举几个最常用的例子一看就懂小白日常场景整理桌面文件、批量压缩图片、生成旅行计划、翻译文档、定时提醒、远程控制电脑比如手机发消息让电脑关机开发者场景生成代码、排查bug、批量修改代码、监控服务器状态、自动备份数据库、生成接口文档高级场景多智能体协同让多个“小龙虾”分工干活、自定义技能让它学会新功能、接入多渠道同时通过飞书、QQ控制。4. 前置准备零门槛小白必做不用安装复杂工具做好2件事就能开始部署全程30分钟以内搞定环境要求Windows 10、macOS 12、Linux任意版本电脑内存≥4GB推荐8GB运行更流畅必需组件Node.js必须≥v22.xOpenClaw运行的核心环境、终端工具Windows用CMD/PowerShellmacOS/Linux用Terminal可选组件大模型API Key推荐阿里云百炼免费额度充足国内用户无需海外网络备用OpenAI、Claude核心原则所有命令、代码直接复制执行不要手动输入避免输错符号小白最容易踩的坑。二、核心步骤OpenClaw全平台部署小白零失败命令可直接复制这是最关键的一步也是小白最容易出错的地方。我整理了Windows、macOS、Linux三系统的部署方法还有Docker一键部署方案推荐小白首选Docker环境隔离不用配置依赖零报错每一步都有详细命令和解析。1. 部署方案对比小白快速选部署方式适用场景优点缺点Windows本地日常个人电脑使用Windows用户数据本地存储操作便捷权限配置稍复杂防火墙需放行macOS本地Mac用户日常使用环境统一配合Homebrew顺滑需安装Xcode Command Line ToolsLinux本地开发机/长期运行稳定高效资源占用低命令行操作对新手略硬核Docker部署所有用户推荐小白环境隔离跨平台统一一键迁移零报错需安装Docker多一步操作2. 通用前置安装Node.js三系统通用OpenClaw依赖Node.js v22.x及以上版本先安装Node.js步骤如下命令可直接复制# 1. 检查是否已安装Node.js如果已安装跳过安装步骤node-v# 2. 若未安装按系统执行对应命令# WindowsPowerShell中执行iwr-usebhttps://nodejs.org/dist/v22.0.0/node-v22.0.0-x64.msi-OutFilenode-v22.0.0-x64.msi;.\node-v22.0.0-x64.msi# macOSTerminal中执行需先安装Homebrewbrewinstallnode24# LinuxUbuntu/DebianTerminal中执行curl-fsSLhttps://deb.nodesource.com/setup_22.x|sudo-Ebash-sudoapt-getinstall-ynodejs# 3. 验证安装安装成功会输出版本号如v22.0.0node-vnpm-v避坑点Windows安装时务必勾选“Add to PATH”否则会出现“node不是内部命令”的报错macOS若未安装Homebrew先执行命令安装/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)若安装后仍提示“node不是内部命令”重启终端即可。3. 方案1Docker一键部署推荐小白零报错Docker部署无需配置复杂依赖环境隔离一键启动适合所有系统步骤如下命令可直接复制1安装Docker三系统通用# WindowsPowerShell中执行需管理员权限wingetinstallDocker.DockerDesktop# 安装完成后重启电脑打开Docker Desktop确保Docker服务启动# macOSTerminal中执行brewinstall--caskdocker# 安装完成后打开Docker Desktop# LinuxUbuntu/Debiansudoapt-getupdatesudoapt-getinstalldocker-ce docker-ce-cli containerd.io# 启动Docker服务sudosystemctl startdocker# 设置开机自启sudosystemctlenabledocker# 验证安装输出Docker版本即成功docker--version2创建Docker配置文件可直接复制新建一个文件夹比如命名为openclaw-docker在文件夹中新建文件docker-compose.yml复制以下内容可直接复制粘贴version:3.8services:openclaw:image:openclaw/openclaw:latestcontainer_name:openclaw-containerports:-18789:18789# 映射端口用于访问Web控制台volumes:-./openclaw-data:/root/.openclaw# 挂载数据卷持久化存储配置和数据environment:-NODE_ENVproduction-GATEWAY_MODElocal# 本地模式restart:always# 开机自启network_mode:bridge3启动OpenClaw一键启动# 进入创建的docker-compose.yml所在文件夹比如cd ~/openclaw-dockercd你的文件夹路径# 启动OpenClaw后台运行docker-composeup-d# 查看启动状态出现healthy即成功docker-composeps# 查看日志可选确认是否启动正常docker-composelogs-f4验证部署成功打开浏览器输入地址http://127.0.0.1:18789能看到OpenClaw的Web控制台说明部署成功进入控制台后先完成初始化后面会讲。4. 方案2本地直接部署非Docker三系统适配1Windows本地部署PowerShell管理员权限# 1. 解锁PowerShell执行权限必做Set-ExecutionPolicyBypass-ScopeProcess-Force# 输入Y确认# 2. 一键安装OpenClaw官方稳定版国内用户用镜像# 官方版海外网络iwr-useb https://openclaw.ai/install.ps1|iex# 国内镜像推荐速度快iwr-useb https://clawd.org.cn/install.ps1|iex# 3. 验证安装输出版本号即成功openclaw--version# 4. 配置并启动服务openclaw configsetgateway.mode local# 设置为本地模式openclaw gateway install# 安装为Windows计划任务开机自启openclaw gatewaystart# 启动服务openclaw gateway status# 检查状态显示Running即成功# 5. 访问Web控制台浏览器打开# http://127.0.0.1:187892macOS本地部署Terminal# 1. 安装Xcode Command Line Tools必做xcode-select--install# 弹出提示点击“安装”等待完成# 2. 一键安装OpenClaw国内镜像推荐curl-fsSLhttps://clawd.org.cn/install.sh|bash# 3. 验证安装openclaw--version# 4. 配置并启动服务openclaw configsetgateway.modelocalopenclaw gateway start# 可选设置开机自启sudoopenclaw gatewayinstall# 5. 访问Web控制台# http://localhost:187893Linux本地部署Terminal# 1. 一键安装OpenClawcurl-fsSLhttps://openclaw.ai/install.sh|bash-s---Tagbeta# 2. 验证安装openclaw--version# 3. 配置并启动服务openclaw configsetgateway.modelocalsudoopenclaw gatewayinstallsudoopenclaw gateway startsudoopenclaw gateway status# 检查状态# 4. 访问Web控制台本地访问# http://127.0.0.1:18789# 若需远程访问开放18789端口sudoufw allow18789/tcp本地部署避坑点Windows端口18789被占用执行netstat -ano | findstr 18789找到PID再执行taskkill /PID 编号 /F关闭占用进程macOS出现权限报错EACCES命令前加sudo比如sudo openclaw gateway startLinux无法访问Web控制台检查防火墙是否开放18789端口执行sudo ufw status查看未开放则执行开放命令。三、入门实战OpenClaw基础操作小白必学全程可视化部署成功后进入Web控制台http://127.0.0.1:18789先完成初始化再学习基础操作全程不用写代码点击操作复制命令即可核心是“让小龙虾认识你、听你指挥”。1. 第一步初始化“小龙虾”塑造它的性格和身份初始化是关键决定了你的“小龙虾”叫什么、是什么性格、怎么跟你说话步骤如下可直接复制提示词1进入Web控制台找到“Agent”模块打开控制台后左侧导航栏点击「Agent」进入智能体管理页面点击「新建Agent」输入Agent名称比如“我的小龙虾”点击创建。2发送初始化提示词直接复制粘贴在Agent聊天框中先发送你好初始化然后发送以下自定义提示词可修改括号内内容塑造专属小龙虾- 你的名字我的小龙虾可修改比如“小白的专属助手” - 我的名字小白可修改成你的名字 - 你的性格特点勤恳努力说话傻子都能听懂不搞晦涩术语执行力强 - 你能干什么不遗余力地完成我的任务比如整理文件、生成代码、查询信息 - 你的记忆被我从电脑里“唤醒”专门为我服务记住我的使用习惯3验证初始化成功发送完提示词后小龙虾会自动修改自身配置文件IDENTITY.md、USER.md等并删除BOOTSTRAP.md文件聊天框会回复“初始化完成随时为你服务”说明初始化成功。补充小龙虾的核心配置文件都存放在~/.openclaw/workspace/目录下相当于它的“性格档案和工作手册”可直接查看和修改也可以通过聊天让它自主调整。2. 第二步配置大模型给小龙虾装“大脑”小龙虾需要大模型才能理解你的指令推荐国内用户使用阿里云百炼免费额度充足无需海外网络步骤如下命令可直接复制1获取阿里云百炼API Key登录阿里云百炼控制台https://bailian.aliyun.com/注册/登录账号进入「密钥管理」点击「创建API-Key」保存好「Access Key ID」和「Access Key Secret」后续要用。2配置大模型终端执行命令直接复制# 1. 切换大模型为阿里云百炼openclaw configsetmodel.provider aliyun-bailian# 2. 配置Access Key ID替换成你的密钥openclaw configsetmodel.aliyun-bailian.accessKeyId你的Access Key ID# 3. 配置Access Key Secret替换成你的密钥openclaw configsetmodel.aliyun-bailian.accessKeySecret你的Access Key Secret# 4. 验证配置成功openclaw config get model3备用方案配置本地模型无需网络若没有API Key可配置本地模型如Ollama步骤如下命令可直接复制# 1. 安装Ollama本地模型运行环境# Windowswinget install Ollama.Ollama# macOSbrew install ollama# Linuxcurl https://ollama.com/install.sh | sh# 2. 拉取本地模型比如llama3:8b轻量且好用ollama pull llama3:8b# 3. 配置OpenClaw使用本地模型openclaw configsetmodel.provider ollama openclaw configsetmodel.ollama.model llama3:8b openclaw configsetmodel.ollama.baseUrl http://localhost:114343. 第三步基础指令实战小白必试复制即可配置好模型后就可以给小龙虾下达指令了以下是最常用的基础指令直接复制到Web控制台聊天框就能执行每一条都亲测可运行1文件操作最常用解放双手# 指令1整理桌面文件按类型分类文档、图片、视频 帮我整理桌面文件将所有文档.doc、.docx、.pdf放到“桌面/文档”文件夹图片.jpg、.png放到“桌面/图片”文件夹视频.mp4、.avi放到“桌面/视频”文件夹没有对应文件夹就自动创建。 # 指令2查找近3个月的Excel文件命名包含“报表” 帮我查找电脑中近3个月创建的Excel文件.xlsx、.xls要求文件名包含“报表”并列出所有文件的路径和创建时间。 # 指令3批量压缩图片尺寸调整为1080P 帮我找到“D:/图片”文件夹下的所有图片批量压缩将尺寸调整为1080P压缩后的图片保存到“D:/图片/压缩后”文件夹不覆盖原图片。2代码辅助开发者必备# 指令1生成Python代码实现数组去重 帮我生成一段Python代码实现数组去重功能要求不使用额外空间原地修改数组包含详细注释可直接复制运行并给出测试案例。 # 指令2排查Python代码bug 帮我排查这段代码的bug优化执行效率 def remove_duplicates(arr): for i in range(len(arr)): if arr[i] arr[i1]: arr.pop(i) return arr # 指令3生成接口文档Markdown格式 帮我根据以下Java接口代码生成Markdown格式的接口文档包含接口描述、请求参数、响应参数、示例 RequestMapping(/user/login) public Result login(RequestParam String username, RequestParam String password) { // 登录逻辑 return Result.success(user); }3日常助手小白实用# 指令1生成周末旅行计划 帮我生成一份周末旅行计划目的地是杭州预算1000元包含交通、住宿、景点、美食时间安排合理适合情侣出行。 # 指令2翻译文档中英文互译 帮我翻译以下英文段落为中文保留专业术语语句通顺 OpenClaw is an open-source AI agent execution gateway that connects large language models, communication channels, and system tools to achieve no-code/low-code local automation. # 指令3设置定时提醒 帮我设置一个定时提醒每天晚上9点通过电脑弹窗提醒我泡脚提醒内容为“该泡脚啦缓解一天疲劳”持续7天。避坑点指令要具体不要说“帮我整理文件”要明确“整理哪里的文件、怎么分类”否则小龙虾可能理解偏差文件路径要准确Windows路径用“/”或“\”比如D:/图片macOS/Linux路径用“/”比如~/图片本地模型性能若使用本地模型如llama3:8b电脑内存需≥8GB否则执行指令会卡顿。四、进阶实战OpenClaw高级玩法大佬必备代码可直接复制学会基础操作后解锁OpenClaw的高级玩法比如接入聊天软件飞书、QQ、自定义技能、多智能体协同这些功能能让小龙虾更实用覆盖更多场景代码/命令可直接复制执行。1. 高级玩法1接入飞书机器人随时随地操控将小龙虾接入飞书手机就能发指令不用打开电脑Web控制台步骤如下命令可直接复制# 1. 安装飞书插件终端执行npx-ylarksuite/openclaw-lark-toolsinstall# 2. 扫码对接飞书机器人终端执行Windows用CMD不要用PowerShellnpx-ylarksuite/openclaw-lark-tools auth# 3. 开启流式响应打字机效果体验更好openclaw configsetchannels.feishu.streamingtrue# 4. 验证接入成功# 1. 飞书收到应用审批消息进入飞书管理后台审核通过# 2. 飞书搜索你的机器人名称进入聊天发送“/feishu auth”授权# 3. 发送“你好”若机器人回复说明接入成功。2. 高级玩法2接入QQ机器人腾讯快捷通道腾讯为OpenClaw提供了快捷接入通道几步就能搞定步骤如下打开QQ机器人OpenClaw接入页面https://open.qq.com/product/aiagent用QQ扫码登录点击「创建机器人」设置机器人名称、头像完成创建页面会显示3条配置命令依次复制到终端执行包含密钥不要泄露给别人验证手机QQ收到机器人打招呼消息发送指令比如“帮我查天气”能正常回复即成功。3. 高级玩法3自定义技能让小龙虾学会新功能OpenClaw支持自定义技能比如让它学会“批量下载博客文章”“监控商品价格”以下是自定义“商品价格监控”技能的代码可直接复制运行1创建技能文件可直接复制新建文件price_monitor.js复制以下代码注释详细小白能看懂// OpenClaw 商品价格监控技能// 功能监控指定购物网站商品价格低于目标价格时发送提醒constaxiosrequire(axios);constcheeriorequire(cheerio);// 技能入口函数OpenClaw会自动调用asyncfunctionpriceMonitor(args){// args参数用户传入的指令参数商品链接、目标价格、提醒方式const{url,targetPrice,notifyWayweb}args;try{// 1. 请求商品页面获取价格constresponseawaitaxios.get(url);const$cheerio.load(response.data);// 2. 解析商品价格以京东为例可根据不同网站修改选择器letpriceText$(.price).text().replace(/[^0-9.]/g,);letcurrentPriceparseFloat(priceText);// 3. 对比价格发送提醒if(currentPricetargetPrice){constmessage 商品价格达标\n商品链接${url}\n当前价格${currentPrice}元\n目标价格${targetPrice}元;// 不同提醒方式web控制台、飞书、QQif(notifyWayfeishu){// 飞书提醒需已接入飞书机器人awaitaxios.post(http://127.0.0.1:18789/api/channels/feishu/send,{message});}elseif(notifyWayqq){// QQ提醒需已接入QQ机器人awaitaxios.post(http://127.0.0.1:18789/api/channels/qq/send,{message});}else{// Web控制台提醒returnmessage;}returnmessage;}else{return⏳ 商品价格未达标\n当前价格${currentPrice}元\n目标价格${targetPrice}元继续监控中...;}}catch(error){return❌ 监控失败${error.message}请检查商品链接是否有效;}}// 导出技能供OpenClaw调用module.exports{name:priceMonitor,// 技能名称description:商品价格监控低于目标价格发送提醒,// 技能描述parameters:{url:{type:string,description:商品链接如京东、淘宝,required:true},targetPrice:{type:number,description:目标价格元,required:true},notifyWay:{type:string,description:提醒方式web/feishu/qq,required:false}},handler:priceMonitor// 技能执行函数};2安装依赖并导入技能终端命令直接复制# 1. 进入技能文件所在目录比如cd ~/openclaw-skillscd你的技能文件目录# 2. 安装依赖axios用于请求网页cheerio用于解析网页npminstallaxios cheerio# 3. 导入技能到OpenClawopenclaw skillinstall./price_monitor.js# 4. 验证技能导入成功openclaw skill list3使用自定义技能直接复制指令在Web控制台或飞书/QQ聊天框发送以下指令替换商品链接和目标价格调用priceMonitor技能参数 url: https://item.jd.com/100012345678.html, targetPrice: 500, notifyWay: feishu执行后小龙虾会每隔10分钟监控一次商品价格低于500元时会通过飞书发送提醒。4. 高级玩法4多智能体协同让多个小龙虾分工干活OpenClaw支持多智能体协同比如让“小龙虾1”整理邮件、“小龙虾2”生成周报、“小龙虾3”调度会议步骤如下命令可直接复制# 1. 创建多个智能体终端执行# 创建智能体1负责邮件整理openclaw agent create邮件助手--description负责整理邮箱邮件提取关键信息分类归档# 创建智能体2负责周报生成openclaw agent create周报助手--description根据每日工作记录生成周报格式规范内容简洁# 创建智能体3负责会议调度openclaw agent create会议助手--description根据参会人日程确定会议时间发送会议邀请# 2. 查看所有智能体openclaw agent list# 3. 协同任务指令Web控制台发送帮我调度三个智能体协同工作1. 让邮件助手整理我近3天的邮箱邮件提取所有工作相关邮件的关键信息生成摘要2. 让周报助手根据邮件助手生成的摘要结合我本周的工作内容生成周报3. 让会议助手根据周报内容调度下周团队会议确定合适的时间发送会议邀请给团队成员。执行后三个智能体会自动分工协作完成复杂任务不用你手动操作真正实现“AI自动化办公”。五、小白最容易踩的8个坑我全踩过帮你避坑Node.js版本过低必须≥v22.x低于这个版本会导致安装失败检查版本用node -v不够就升级部署时未用管理员权限Windows PowerShell、Linux终端必须用管理员权限sudo否则会出现权限不足报错API Key配置错误阿里云百炼的Access Key ID和Secret不要填反填错会导致模型无法调用Windows用PowerShell接入飞书飞书插件扫码对接时Windows必须用CMDPowerShell无法正常显示二维码指令太模糊比如只说“帮我整理文件”小龙虾无法理解必须明确路径、分类方式本地模型内存不足运行llama3:8b等本地模型电脑内存需≥8GB否则会卡顿、崩溃端口被占用18789端口被其他软件占用导致Web控制台无法访问关闭占用进程即可忘记挂载数据卷Docker部署Docker部署时若未挂载数据卷容器删除后配置和数据会丢失。六、进阶学习方向小白学会基础后再学技能开发进阶学习编写更复杂的技能比如网页自动化、接口调用、数据库操作适配更多场景模型优化切换更合适的大模型比如用Kimi-k2.5提升理解能力用本地模型实现离线使用安全配置设置访问密码、限制指令权限防止小龙虾执行危险操作比如删除系统文件分布式部署将OpenClaw部署在服务器上实现24小时运行随时随地调用源码二次开发OpenClaw是开源项目可修改源码定制专属功能适合有编程基础的小白。七、最后我想说开发者真心话我刚开始接触OpenClaw时也踩了很多坑——部署失败、模型调用不了、指令执行偏差一度以为它是“大佬专属”。直到我放弃“死记原理”跟着步骤复制命令、实战操作才发现OpenClaw的核心不是复杂的技术而是“实用、易用”小白只要跟着教程复制命令、下达指令就能快速上手。这篇教程的所有命令、代码我全部在Windows、macOS、Linux三系统亲测可运行没有任何多余的复杂逻辑小白跟着复制就能部署成功、上手实战。学会OpenClaw不仅能解放双手减少日常重复性工作还能提升你的AI工具使用能力不管是日常办公、课程作业还是职场实战都是加分项。如果在部署、使用过程中遇到报错或者想拓展更复杂的功能欢迎在评论区交流我会尽量回复咱们一起从小白变大佬觉得有用的话欢迎点赞 收藏我后面会继续更新OpenClaw技能开发、模型优化等小白友好的教程帮大家轻松搞定这个强大的AI工具总结OpenClaw是“AI执行网关”核心是“让AI动手干活”小白不用懂编程也能上手部署优先选Docker零报错、环境隔离小白30分钟就能搞定核心操作初始化Agent→配置模型→下达指令所有命令可直接复制避坑关键Node.js版本≥v22、用管理员权限、指令要具体、API Key配置正确。
