本文适合AI智能体入门者、本地部署爱好者、想低代码扩展AI能力的开发者。全文从原理到实战保姆级带你吃透OpenClaw文末附完整自定义Skill源码与避坑指南。一、OpenClaw 是什么为什么它是2026最火本地智能体框架OpenClaw原Clawdbot昵称“小龙虾”是一款MIT 开源、本地优先的 AI 智能体运行时与执行网关由 PSPDFKit 创始人 Peter Steinberger 主导开发GitHub 星标 28W是当前增长最快的开源 AI 项目之一。1.1 核心定位会“动手”的本地AI助手传统大模型ChatGPT、Kimi等只能“说话、写文字”OpenClaw 是让 AI 真正“动手做事”的执行中枢连接大模型GPT/通义千问/Ollama本地模型作为“大脑”连接你的电脑/服务器作为“手脚”连接微信/企微/飞书/Telegram 作为“沟通入口”核心能力自然语言指令 → 任务拆解 → 调用技能 → 本地执行 → 结果反馈1.2 OpenClaw 核心优势小白必看数据绝对安全全程本地运行对话、文件、操作记录不上云隐私可控全平台兼容支持 Windows / Mac / Linux / 服务器部署零代码低代码小白直接用内置Skill开发者可快速自定义扩展无限扩展Skills 插件化生态像装APP一样给AI加能力多平台接入一键接入微信、企业微信、钉钉、飞书等1.3 OpenClaw 与传统聊天机器人的区别特性传统ChatBotOpenClaw智能体核心能力文本生成、对话任务拆解、工具调用、系统操作数据存储云端本地私有执行能力无仅输出文字读写文件、运行代码、浏览器自动化扩展方式固定功能Skills插件化无限自定义适用场景聊天、问答自动化办公、本地操作、批量任务二、OpenClaw 核心原理与技术架构看懂底层开发不迷路OpenClaw 遵循“万物皆消息配置即代码”的设计哲学整体架构分为6大核心模块形成完整的“思考-执行-反馈”闭环。2.1 六大核心模块详解Gateway网关系统“心脏”中央消息枢纽负责消息路由、模型调度、技能编排、多平台接入内置消息队列支持配置热重载Adapters适配器AI 的“感官”对接外部平台支持微信、企微、钉钉、Telegram 等20平台将外部消息标准化为OpenClaw内部格式Models模型管理层AI 的“大脑”统一封装所有LLM支持 GPT、Claude、通义千问、DeepSeek、Ollama本地模型支持故障自动切换Fallback链保证高可用Skills技能系统⭐AI 的“手脚工具箱”OpenClaw 灵魂所在每个Skill是独立插件文件读写、代码执行、网页抓取、API调用支持零代码配置、TypeScript开发、Python脚本扩展Memory记忆系统AI 的“记忆体”存储对话历史、用户偏好、任务状态基于向量数据库PGVector Redis支持长期记忆、上下文关联越用越智能Cell Isolation沙箱隔离安全防线技能在虚拟沙箱运行限制系统权限防止误操作/恶意攻击可自定义权限只读/读写/完全控制2.2 一条指令的执行流程用户发消息微信帮我整理D盘所有PDF → Adapter接收 → Gateway转发 → Agent智能体拆解任务 1. 读取D盘PDF文件 2. 提取文件名页数 3. 生成汇总表格 → 调用对应 Skills文件读取表格生成 → 沙箱安全执行本地操作 → 结果返回用户汇总表文件列表三、OpenClaw 部署Windows/Mac/Linux 保姆级如果有不想本地安装或者电脑配置不够的朋友可以尝试阿里云腾讯云购买服务器进行一键部署如果对服务器不熟悉推荐用扣子点击扣子官网进行注册后一键部署。3.1 环境要求极低门槛系统Windows 10/MacOS 12/LinuxUbuntu/CentOS内存≥4GB推荐8GB依赖Node.js ≥18、Git、Python 3.9可选模型API KeyGPT/通义或 Ollama 本地模型3.2 一键安装官方脚本推荐WindowsPowerShell 管理员# 官方一键安装 curl -fsSL https://openclaw.ai/install.sh | bash # 或Git方式更稳定 curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method gitMac/Linux终端curl -fsSL https://openclaw.ai/install.sh | bash # Git安装 curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git3.3 手动安装避坑专用# 1. 克隆仓库 git clone https://github.com/OpenClawAI/OpenClaw.git cd OpenClaw # 2. 安装依赖 npm install # 3. 初始化配置 npm run setup # 4. 启动网关 npm run start3.4 首次配置关键步骤安装完成后访问http://localhost:2024进入WebUI配置页配置模型填写 API KeyOpenAI/通义千问/Gemini或选择 Ollama 本地模型llama3/qwen等配置平台接入微信/企微选择 Adapter → 扫码登录/配置Webhook权限配置开启沙箱/文件读写/网络权限启动网关→ 显示Gateway running即成功3.5 常见部署避坑Windows 报错关闭360/电脑管家以管理员权限运行端口占用修改~/.openclaw/openclaw.json中的端口配置模型调用失败检查API Key余额/权限、网络代理微信登录失败使用小号登录避免风控四、Skills 系统OpenClaw 核心扩展能力零代码开发4.1 什么是 SkillSkill AI 可调用的工具函数是OpenClaw实现“动手能力”的核心。内置Skill文件读写、网页抓取、代码执行、搜索、邮件发送社区SkillClawHub市场下载批量重命名、PDF处理、数据爬取自定义Skill自己开发实现任何个性化功能4.2 内置 Skill 快速启用零代码WebUI → Agent 编辑 → Tools技能→ 直接勾选启用browse_url抓取网页内容search_web联网搜索run_code沙箱执行 Python/JS 代码read_file/write_file本地文件读写沙箱目录schedule_task定时任务4.3 自定义 Skill 开发实战天气查询4.3.1 Skill 开发两种方式Markdown 零代码 Skill小白首选TypeScript 高级 Skill开发者4.3.2 实战1零代码 Markdown Skill天气查询Step1进入技能目录# Windows cd C:\Users\你的用户名\.openclaw\skills # Mac/Linux cd ~/.openclaw/skillsStep2创建weather-query.md--- name: weather-query description: 查询城市实时天气支持中文城市名 metadata: openclaw: requires: bins: [curl] permissions: [network:get] --- # 天气查询 Skill ## 功能 - 支持全球城市天气查询 - 返回温度、天气状况、风速 ## 触发语句 - 北京天气怎么样 - 查询上海温度 - 广州今天天气 python #!/usr/bin/env python3 import sys, json, requests def get_weather(city): try: # 和风天气API免费 url fhttps://devapi.qweather.com/v7/weather/now?location{city}key你的KEY res requests.get(url).json() if res[code] 200: data res[now] return f【{city}】{data[text]}温度{data[temp]}℃风速{data[windDir]}{data[windSpeed]}级 except: return 查询失败请检查城市名 if __name__ __main__: city sys.argv[1] print(get_weather(city))**Step3重启网关生效** bash npm run restart直接发消息北京天气→ AI 自动调用 Skill 返回结果。4.3.3 实战2TypeScript 高级 Skill官方标准Step1创建src/skills/weather.tsimport { Skill } from /types/skill; export const getWeather: Skill { name: get_weather, description: 获取指定城市的当前天气, parameters: { type: object, properties: { city: { type: string, description: 城市名称 } }, required: [city] }, async execute({ city }) { // 1. 地理编码 const geo await fetch(https://geocoding-api.open-meteo.com/v1/search?name${city}count1).then(r r.json()); if (!geo.results?.[0]) throw new Error(城市未找到); const { latitude, longitude } geo.results[0]; // 2. 查询天气 const weather await fetch(https://api.open-meteo.com/v1/forecast?latitude${latitude}longitude${longitude}current_weathertrue).then(r r.json()); return { city, temperature: weather.current_weather.temperature, weather: weather.current_weather.weathercode, unit: °C }; } };Step2注册 Skillsrc/skills/index.tsimport { getWeather } from ./weather; export const skills [getWeather];Step3编译启动npm run build npm run start4.4 Skill 开发规范必看命名唯一Skill name 不可重复权限最小化仅申请必要权限network/file/exec沙箱隔离文件操作仅限~/.openclaw/workspace/目录错误处理完善异常捕获避免网关崩溃描述清晰让AI能准确理解Skill功能五、OpenClaw 进阶玩法与实战场景5.1 本地自动化办公高频实用自动整理下载文件夹按类型分类文件批量重命名照片/文档自动备份重要文件到网盘每日自动生成工作日报5.2 浏览器自动化赛博手替自动签到、领取优惠券网页数据批量抓取、生成报表自动填写表单、自动测试5.3 私有知识库智能体结合 RAG 技术读取本地PDF/Word/Markdown构建个人/企业私有问答助手数据完全本地不泄露商业机密5.4 多平台统一助手微信企微飞书 同时接入一个AI助手全平台响应消息同步、记忆互通六、总结与下一步OpenClaw 是2026 本地智能体的最佳入门框架门槛低、扩展性强、安全可控、生态活跃。小白直接部署 启用内置Skill快速拥有私人AI助手开发者自定义Skill 二次开发打造行业专属智能体核心价值数据私有、真正执行、无限扩展下一步行动按本文教程完成本地部署尝试零代码 Markdown Skill 开发去 ClawHub 下载社区热门Skill结合 Ollama 打造完全离线的本地智能体 OpenClaw 智能体全解：原理、部署、自定义 Skill 一站式教程
本文适合AI智能体入门者、本地部署爱好者、想低代码扩展AI能力的开发者。全文从原理到实战保姆级带你吃透OpenClaw文末附完整自定义Skill源码与避坑指南。一、OpenClaw 是什么为什么它是2026最火本地智能体框架OpenClaw原Clawdbot昵称“小龙虾”是一款MIT 开源、本地优先的 AI 智能体运行时与执行网关由 PSPDFKit 创始人 Peter Steinberger 主导开发GitHub 星标 28W是当前增长最快的开源 AI 项目之一。1.1 核心定位会“动手”的本地AI助手传统大模型ChatGPT、Kimi等只能“说话、写文字”OpenClaw 是让 AI 真正“动手做事”的执行中枢连接大模型GPT/通义千问/Ollama本地模型作为“大脑”连接你的电脑/服务器作为“手脚”连接微信/企微/飞书/Telegram 作为“沟通入口”核心能力自然语言指令 → 任务拆解 → 调用技能 → 本地执行 → 结果反馈1.2 OpenClaw 核心优势小白必看数据绝对安全全程本地运行对话、文件、操作记录不上云隐私可控全平台兼容支持 Windows / Mac / Linux / 服务器部署零代码低代码小白直接用内置Skill开发者可快速自定义扩展无限扩展Skills 插件化生态像装APP一样给AI加能力多平台接入一键接入微信、企业微信、钉钉、飞书等1.3 OpenClaw 与传统聊天机器人的区别特性传统ChatBotOpenClaw智能体核心能力文本生成、对话任务拆解、工具调用、系统操作数据存储云端本地私有执行能力无仅输出文字读写文件、运行代码、浏览器自动化扩展方式固定功能Skills插件化无限自定义适用场景聊天、问答自动化办公、本地操作、批量任务二、OpenClaw 核心原理与技术架构看懂底层开发不迷路OpenClaw 遵循“万物皆消息配置即代码”的设计哲学整体架构分为6大核心模块形成完整的“思考-执行-反馈”闭环。2.1 六大核心模块详解Gateway网关系统“心脏”中央消息枢纽负责消息路由、模型调度、技能编排、多平台接入内置消息队列支持配置热重载Adapters适配器AI 的“感官”对接外部平台支持微信、企微、钉钉、Telegram 等20平台将外部消息标准化为OpenClaw内部格式Models模型管理层AI 的“大脑”统一封装所有LLM支持 GPT、Claude、通义千问、DeepSeek、Ollama本地模型支持故障自动切换Fallback链保证高可用Skills技能系统⭐AI 的“手脚工具箱”OpenClaw 灵魂所在每个Skill是独立插件文件读写、代码执行、网页抓取、API调用支持零代码配置、TypeScript开发、Python脚本扩展Memory记忆系统AI 的“记忆体”存储对话历史、用户偏好、任务状态基于向量数据库PGVector Redis支持长期记忆、上下文关联越用越智能Cell Isolation沙箱隔离安全防线技能在虚拟沙箱运行限制系统权限防止误操作/恶意攻击可自定义权限只读/读写/完全控制2.2 一条指令的执行流程用户发消息微信帮我整理D盘所有PDF → Adapter接收 → Gateway转发 → Agent智能体拆解任务 1. 读取D盘PDF文件 2. 提取文件名页数 3. 生成汇总表格 → 调用对应 Skills文件读取表格生成 → 沙箱安全执行本地操作 → 结果返回用户汇总表文件列表三、OpenClaw 部署Windows/Mac/Linux 保姆级如果有不想本地安装或者电脑配置不够的朋友可以尝试阿里云腾讯云购买服务器进行一键部署如果对服务器不熟悉推荐用扣子点击扣子官网进行注册后一键部署。3.1 环境要求极低门槛系统Windows 10/MacOS 12/LinuxUbuntu/CentOS内存≥4GB推荐8GB依赖Node.js ≥18、Git、Python 3.9可选模型API KeyGPT/通义或 Ollama 本地模型3.2 一键安装官方脚本推荐WindowsPowerShell 管理员# 官方一键安装 curl -fsSL https://openclaw.ai/install.sh | bash # 或Git方式更稳定 curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method gitMac/Linux终端curl -fsSL https://openclaw.ai/install.sh | bash # Git安装 curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git3.3 手动安装避坑专用# 1. 克隆仓库 git clone https://github.com/OpenClawAI/OpenClaw.git cd OpenClaw # 2. 安装依赖 npm install # 3. 初始化配置 npm run setup # 4. 启动网关 npm run start3.4 首次配置关键步骤安装完成后访问http://localhost:2024进入WebUI配置页配置模型填写 API KeyOpenAI/通义千问/Gemini或选择 Ollama 本地模型llama3/qwen等配置平台接入微信/企微选择 Adapter → 扫码登录/配置Webhook权限配置开启沙箱/文件读写/网络权限启动网关→ 显示Gateway running即成功3.5 常见部署避坑Windows 报错关闭360/电脑管家以管理员权限运行端口占用修改~/.openclaw/openclaw.json中的端口配置模型调用失败检查API Key余额/权限、网络代理微信登录失败使用小号登录避免风控四、Skills 系统OpenClaw 核心扩展能力零代码开发4.1 什么是 SkillSkill AI 可调用的工具函数是OpenClaw实现“动手能力”的核心。内置Skill文件读写、网页抓取、代码执行、搜索、邮件发送社区SkillClawHub市场下载批量重命名、PDF处理、数据爬取自定义Skill自己开发实现任何个性化功能4.2 内置 Skill 快速启用零代码WebUI → Agent 编辑 → Tools技能→ 直接勾选启用browse_url抓取网页内容search_web联网搜索run_code沙箱执行 Python/JS 代码read_file/write_file本地文件读写沙箱目录schedule_task定时任务4.3 自定义 Skill 开发实战天气查询4.3.1 Skill 开发两种方式Markdown 零代码 Skill小白首选TypeScript 高级 Skill开发者4.3.2 实战1零代码 Markdown Skill天气查询Step1进入技能目录# Windows cd C:\Users\你的用户名\.openclaw\skills # Mac/Linux cd ~/.openclaw/skillsStep2创建weather-query.md--- name: weather-query description: 查询城市实时天气支持中文城市名 metadata: openclaw: requires: bins: [curl] permissions: [network:get] --- # 天气查询 Skill ## 功能 - 支持全球城市天气查询 - 返回温度、天气状况、风速 ## 触发语句 - 北京天气怎么样 - 查询上海温度 - 广州今天天气 python #!/usr/bin/env python3 import sys, json, requests def get_weather(city): try: # 和风天气API免费 url fhttps://devapi.qweather.com/v7/weather/now?location{city}key你的KEY res requests.get(url).json() if res[code] 200: data res[now] return f【{city}】{data[text]}温度{data[temp]}℃风速{data[windDir]}{data[windSpeed]}级 except: return 查询失败请检查城市名 if __name__ __main__: city sys.argv[1] print(get_weather(city))**Step3重启网关生效** bash npm run restart直接发消息北京天气→ AI 自动调用 Skill 返回结果。4.3.3 实战2TypeScript 高级 Skill官方标准Step1创建src/skills/weather.tsimport { Skill } from /types/skill; export const getWeather: Skill { name: get_weather, description: 获取指定城市的当前天气, parameters: { type: object, properties: { city: { type: string, description: 城市名称 } }, required: [city] }, async execute({ city }) { // 1. 地理编码 const geo await fetch(https://geocoding-api.open-meteo.com/v1/search?name${city}count1).then(r r.json()); if (!geo.results?.[0]) throw new Error(城市未找到); const { latitude, longitude } geo.results[0]; // 2. 查询天气 const weather await fetch(https://api.open-meteo.com/v1/forecast?latitude${latitude}longitude${longitude}current_weathertrue).then(r r.json()); return { city, temperature: weather.current_weather.temperature, weather: weather.current_weather.weathercode, unit: °C }; } };Step2注册 Skillsrc/skills/index.tsimport { getWeather } from ./weather; export const skills [getWeather];Step3编译启动npm run build npm run start4.4 Skill 开发规范必看命名唯一Skill name 不可重复权限最小化仅申请必要权限network/file/exec沙箱隔离文件操作仅限~/.openclaw/workspace/目录错误处理完善异常捕获避免网关崩溃描述清晰让AI能准确理解Skill功能五、OpenClaw 进阶玩法与实战场景5.1 本地自动化办公高频实用自动整理下载文件夹按类型分类文件批量重命名照片/文档自动备份重要文件到网盘每日自动生成工作日报5.2 浏览器自动化赛博手替自动签到、领取优惠券网页数据批量抓取、生成报表自动填写表单、自动测试5.3 私有知识库智能体结合 RAG 技术读取本地PDF/Word/Markdown构建个人/企业私有问答助手数据完全本地不泄露商业机密5.4 多平台统一助手微信企微飞书 同时接入一个AI助手全平台响应消息同步、记忆互通六、总结与下一步OpenClaw 是2026 本地智能体的最佳入门框架门槛低、扩展性强、安全可控、生态活跃。小白直接部署 启用内置Skill快速拥有私人AI助手开发者自定义Skill 二次开发打造行业专属智能体核心价值数据私有、真正执行、无限扩展下一步行动按本文教程完成本地部署尝试零代码 Markdown Skill 开发去 ClawHub 下载社区热门Skill结合 Ollama 打造完全离线的本地智能体