夜雨聆风
OpenClaw完整详解:框架定性+手把手安装及配置教程
内容速览
1. OpenClaw精准定性：属于哪一类技术产品
2. 四大核心架构组件通俗讲解
3. 完整分步安装部署教程（原版+国内镜像）
4. 核心配置文件详解：大模型、聊天渠道、技能、工作流完整示例
5. 官方全平台地址汇总
一、OpenClaw性质定位
配图说明：来源于官方网站截图
OpenClaw是一款开源自主AI智能体（Agent）执行框架，同时也是自托管式AI执行网关，采用MIT开源协议，完全私有化部署，不属于成品聊天软件、不属于零代码RPA工具、也不是大模型本身 ，圈内俗称龙虾（Claw）。
OpenClaw是整机式完整Agent运行框架，自带消息网关、持久记忆、技能插件、工作流全套运行环境；偏向对外真实系统执行能力（浏览器、服务器命令、文件、第三方软件）；支持自定义插件、定时任务、多智能体调度、Docker沙箱运行，可以自由对接任意大模型。
两大核心本质特征：
1. 自托管私有化框架：所有程序、数据、任务全部跑在自己电脑/云服务器，无官方云端收集数据，不存在厂商锁定，可以自由替换任意LLM（豆包、DeepSeek、GPT、Ollama本地模型） ；
2. 插件化技能驱动框架：整个能力靠Skill技能包扩展，官方预置50+成熟技能，开发者可自定义开发插件，搭配YAML工作流实现复杂循环、分支自动化任务。
二、四大核心架构组件
整套OpenClaw框架由下面4个核心模块构成：
1、Message Gateway 消息网关（入口）
框架总入口，负责接收各个聊天平台发来的自然语言指令，支持钉钉、企业微信、Telegram、Discord、Slack等。
用户在聊天软件发指令，网关接收、鉴权、分发给智能体处理，日常不需要登录专属后台操控机器人。
2、State持久化记忆系统（大脑）
全局状态存储层，采用SQLite/Redis持久化保存任务进度、历史对话、采集数据、中间结果。
区别普通AI关闭对话就失忆，OpenClaw支持断点续跑，服务器重启后可以接着上次未完成任务继续执行。
3、Skill技能插件系统（手脚）
框架所有实操能力都以独立技能包形式存在，是框架可扩展的核心：
– 官方预制技能：浏览器爬虫、Shell命令执行、GitHub运维、RAG知识库、定时Cron任务、消息推送、Excel数据处理；
– 安装方式：一键命令安装，开箱即用，也可以自己用Python/TypeScript开发自定义技能。
4、Workflow工作流引擎（总指挥）
采用YAML格式编写任务流程，支持顺序执行、条件分支、失败重试、循环调度，用来把多个Skill串联成完整业务自动化流水线。
三、完整分步安装使用教程
前置硬件环境要求
1. Node.js 版本 ≥22.0.0；
2. 系统：Windows、Mac、Linux、WSL2均可；
3. 可选：Docker（沙箱安全运行高危脚本）、Git、Ollama（本地离线模型）。
方式1：官方一键全局安装
国外原版命令：
# npm全局安装
npm install -g openclaw@latest
# pnpm安装（依赖更稳定，推荐）
pnpm add -g openclaw@latest
国内镜像加速（解决下载慢）
npm install -g openclaw@latest
–registry=https://registry.npmmirror.com
Linux/Mac一键脚本安装
原版：
curl -fsSL https://openclaw.ai/install.sh | bash
国内社区加速版：
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
方式2：Docker容器一键部署（生产环境安全首选）
# 拉取官方镜像并启动
docker run -d \
-p 18789:18789 \
-v ~/.openclaw:/root/.openclaw \
openclaw/openclaw
启动完成后，可视化管理后台地址： http://localhost:18789
初始化启动运行
# 交互式初始化全套配置
openclaw onboard
# 启动后台常驻守护进程
openclaw daemon start
# 停止服务
openclaw daemon stop
四、核心配置详解
所有配置统一存放在用户目录下 .openclaw 文件夹中：
~/.openclaw/
├── config.yaml # 网关全局总配置
├── agents/main/
│ ├── auth-profiles.json # 各大模型API密钥配置
│ └── skills/ # 已安装所有技能包
└── workflows/ # YAML自动化工作流存放目录
配置1：大模型密钥 auth-profiles.json
同时兼容商用API+Ollama本地模型，示例：
json
{
“profiles”: [
{
“id”: “doubao”,
“type”: “api-key”,
“provider”: “volcengine”,
“apiKey”: “你的火山方舟豆包密钥”,
“model”: “doubao-pro”
},
{
“id”: “local-qwen”,
“type”: “ollama”,
“baseUrl”: “http://localhost:11434”,
“model”: “qwen2.5:14b”
}
],
“default”: “doubao”
}
配置2：安装&管理技能Skill命令
# 安装网页爬虫技能
skill install browser-scraper
# 安装定时任务技能
skill install cron-scheduler
# 查看已安装全部技能
skill list
# 卸载无用技能
skill uninstall browser-scraper
配置3：定时爬虫工作流YAML示例（workflow/crawl.yaml）
yaml
name: 竞品价格每周自动采集
triggers:
– type: cron
schedule: “0 6 * * 1”
steps:
– id: fetch_data
skill: browser-scraper
input:
target_url: “https://demo-shop.com”
– id: push_report
skill: wecom-notify
message: “本周竞品数据采集完成”
运行工作流：
openclaw workflow run ./crawl.yaml
配置4：绑定钉钉/企业微信消息渠道
在config.yaml内填写机器人Webhook地址，绑定完成后，直接在企业微信群发指令操控龙虾运行任务。
五、全平台官方权威地址
1. 官方主页：https://openclaw.im/
2. GitHub开源主仓库：https://github.com/openclaw/openclaw
3. 英文官方文档：https://www.openclawcenter.com/framework
4. 国内中文社区文档：https://open-claw.org.cn/（含更详细教程）
5. 可视化管理后台本地访问：http://localhost:18789
持续更新计算机学生、编程求职者专属干货教程，内容涵盖AI编程工具、版本控制、论文绘图、求职技能、提示词工程。全部配套可直接复制使用的实操指令、模板素材；关注公众号不迷路☑️☑️☑️！
往期精彩：
为什么IT开发岗都要求掌握Git？一文吃透Git全部高频基础指令
字节跳动推出国产免费版编程神器TARE？怎么使用？分为Chat、Builder、SOLO三种模式？