一文掌握|开发者手把手教你如何拥有自己的OpenClaw
你希望快速了解服务器的运行状态,包括CPU/内存占用、磁盘空间、OpenClaw Gateway状态以及关键服务(如Docker、PostgreSQL)的存活情况,确保系统处于最佳运行环境。OpenClaw越用越好用的秘密不是它本身有多聪明,而是你每一次与它交互、每一次踩坑、每一次复盘,都在积累经验。,连接你的聊天应用(飞书、Telegram、Discord、WhatsApp等)和AI编程助手,支

OpenClaw,第一次让Agent走出了聊天框。作为技术极客,如何更优雅地部署OpenClaw?
星河社区开发者笠雨聆月带你一文读透OpenClaw,并教你如何利用文心大模型5.0接口运行OpenClaw框架。
1. OpenClaw是什么
1.1 一句话定义
OpenClaw是开源的AI Agent Gateway,连接你的聊天应用(飞书、Telegram、Discord、WhatsApp等)和AI编程助手,支持定时任务、自动化工作流,所有数据100%本地存储。
1.2 典型使用场景

1.3 核心特性
-
多渠道支持:同时接入飞书/Telegram/Discord/WhatsApp等10+渠道;
-
完全自主托管:数据100%本地存储,不依赖第三方;
-
Agent原生:支持工具调用、会话管理、长期记忆、多Agent路由;
-
Skill系统:可扩展技能包,即装即用(100+Skills);
-
定时任务:内置Heartbeat+Cron系统;
-
移动端控制:iOS/Android节点配对;
-
开源免费:MIT许可证。
2. 核心差异:OpenClaw与既有方案的区别
2.1 为什么需要OpenClaw?
在AI工具百花齐放的今天,我们已经有了ChatGPT、Claude、各种Workflow工具。为什么还需要OpenClaw?
核心答案:OpenClaw不是另一个AI工具,而是连接一切的基础设施。
2.2 三类方案对比
2.2.1
方案对比

「术语解释」
-
¹ 无状态:每次对话都是独立的,不记住之前的交流;
-
² 持久化:对话历史保存在本地,重启后依然记得;
-
流程节点:Workflow中的一个个步骤,按预设路径执行;
- 热加载:无需重启程序,直接加载新功能。
「Workflow工具代表:Zapier、Make、n8n」
-
优势:可视化编排、丰富集成、定时触发;
-
局限:被动触发、无长期记忆、无法处理复杂对话。
「AI Agent代表:豆包、文心一言、通义千问」
-
优势:开箱即用、多模态能力、持续更新
-
局限:数据上云、无法自定义、被动响应
2.2.2
OpenClaw的独特定位
一句话总结:OpenClaw=Agent的智能+Workflow的自动化+完全自主可控。
2.3 Heartbeat:从“工具”到“助手”的质变
2.3.1
传统Agent的局限
-
你问,它答;
-
你触发,它执行;
-
它是工具,你是操作员。
2.3.2
OpenClaw的Heartbeat机制
flowchart LR A[定时轮询] --> B[状态检查] B --> C[条件判断] C --> D[主动执行] D -.-> A
style A fill:#fff3e0 style D fill:#e8f5e9
2.3.3
Heartbeat核心能力

2.3.4
关键区别:Heartbeat vs Workflow
-
Workflow工具:“当X发生时,做Y”(被动触发);
-
OpenClaw Heartbeat:“每N分钟检查一次,如果满足条件,主动做Y”(主动轮询+智能判断)
这意味着OpenClaw可以:
-
在没有用户输入的情况下持续运行;
-
主动发现问题,而不是等待报告;
-
长期维护状态,并基于历史做决策。
2.4 为什么选择OpenClaw?生态与定位
OpenClaw属于自主托管AI Agent Gateway这一细分赛道。同类产品有NanoBot、ZeroClaw等,但OpenClaw的独特之处在于其繁荣的生态系统和活跃的社区。
3. Skills系统“为什么越用越好用”
3.1 什么是Skill?
Skill是OpenClaw的可扩展能力单元,把「如何完成一个任务」的完整方案封装起来,包括提示词、工具、工作流。下次遇到类似任务直接调用,无需重复配置。
3.2 Skill的核心价值
OpenClaw越用越好用的秘密不是它本身有多聪明,而是你每一次与它交互、每一次踩坑、每一次复盘,都在积累经验。这些经验被沉淀为Skills,下次遇到类似问题就能直接调用。
公式:失败+复盘=更好的Skills。
如果说Gateway是OpenClaw的身体,那Skills就是它的大脑——一个越用越聪明的大脑。

4. 安装配置与中国大陆方案
4.1 安装前准备
4.1.1
环境要求
-
Node.js: 22.x或更高;
-
系统: macOS/Linux/Windows WSL;
-
内存: 4GB+(推荐8GB+);
-
网络: 中国大陆用户建议配置代理。
4.1.2
三种部署方式
OpenClaw支持多种部署方式,根据你的场景选择:

一键安装脚本:
-
原生安装和Docker部署在官网均提供一键安装脚本;
-
访问https://docs.openclaw.ai/install获取最新脚本。
推荐:
-
个人用户/开发者:选择原生安装(完全自主可控)
-
团队/企业:选择云服务(开箱即用,无需运维)
-
容器化环境:选择Docker(便于集成到现有基础设施)
4.1.3
SkillHub安装(推荐)
SkillHub是中国用户推荐的Skill市场,提供加速下载和合规能力。
安装SkillHub CLI:
# 完整安装(CLI + Skill)curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash# 仅安装 CLI```curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装后重启OpenClaw:
openclaw gateway restart
使用SkillHub:
# 搜索 Skillsskillhub search notification# 安装 Skillskillhub install skill-name
特点:
-
✅ 国内加速访问;
-
✅ 合规审核;
-
✅ 与ClawHub互通;
-
✅ 自然语言安装支持。
4.2 快速安装
4.2.1
四步完成安装
Step 1: 安装Node.js
# macOSbrew install node@22# Ubuntu/Debiancurl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -sudo apt-get install -y nodejs
Step 2: 安装OpenClaw
npm install -g openclaw
Step 3: 初始化配置
openclaw onboard
预期交互:
-
选择要接入的渠道(飞书/Telegram/Discord...);
-
输入API密钥(可选,可后续配置);
-
选择默认AI模型;
-
接入飞书需要在飞书开发者平台创建应用,获取App ID和App Secret,并配置权限,可参考⬇️
https://docs.openclaw.ai/zh-CN/channels/feishu
Step 4: 启动Gateway
openclaw gateway start
4.2.2
常见问题排查

4.3 中国大陆使用方案
4.3.1
主要难点与解决方案

4.3.2
npm切换国内镜像
npm config set registry https://registry.npmmirror.com
4.3.3
国内模型替代
这里我们选用百度文心大模型:
https://aistudio.baidu.com/overview
4.3.4
快速配置第三方OpenAI接口模型
以ERNIE-5.0(百度文心大模型)为例:
# 1. 配置模型提供商openclaw config set models.providers.ernie-profile '{ "baseUrl": "https://aistudio.baidu.com/llm/lmapi/v3", "apiKey": "你的_API_KEY", "api": "openai-completions", "models": [ { "id": "ernie-5.0-thinking-preview", "name": "Ernie 5.0 Thinking" } ]}'# 2. 设置为默认模型openclaw config set agents.defaults.model.primary "ernie-profile/ernie-5.0-thinking-preview"# 3. 重启 Gatewayopenclaw gateway restart
配置说明:
-
baseUrl: 第三方API的OpenAI兼容接口地址;
-
apiKey: 从对应平台获取的API密钥;
-
api: 固定为openai-completions(OpenAI兼容模式);
-
models.id: 模型标识符,可在对应平台文档中查询。
5. 实操演示:基于Skill-creator的工作流
5.1 演示概览
本章节通过三个真实场景,展示OpenClaw的Skill-creator工作流:

5.2 Demo 1:系统健康检查Skill(基于server-health)
5.2.1
场景描述
你希望快速了解服务器的运行状态,包括CPU/内存占用、磁盘空间、OpenClaw Gateway状态以及关键服务(如Docker、PostgreSQL)的存活情况,确保系统处于最佳运行环境。
5.2.2
执行步骤
Step 1:检查与安装Skill
用户:帮我看看有没有能查服务器实时状态的 Skill?
OpenClaw:🔍 找到并在ClawHub获取到以下 Skill:
1. 【server-health】- 综合服务器健康监测 ⭐⭐⭐⭐⭐
功能:系统统计(CPU/RAM/Disk)、Top 进程、OpenClaw 状态、关键服务监测
特点:支持 Telegram/CLI 快速查看,支持 JSON 自动化输出
用户:安装这个 server-health
Step 2:运行实时健康检查
用户:执行一下服务器健康检查
OpenClaw:好的,正在调用 server-health Skill 执行监测...
🖥️ SERVER HEALTH
━━━━━━━━━━━━━━━━━━━━
💻 SYSTEM
CPU: ████░░░░░░ 42% (Load: 1.2, 0.8, 0.5)
RAM: ██████░░░░ 1.4GB/8GB (18%)
DISK: ████░░░░░░ 45GB/100GB (45%)
UP: ⏱️ 5d 3h
🔄 TOP PROCESSES
node 35% 450MB
postgres 12% 280MB
openclaw 8% 180MB
⚡ OPENCLAW GATEWAY
Status: ✅ Running (PID: 1639125)
Uptime: 2d 5h | Port: 18789 | v2026.2.6-3
🤖 MODEL CONFIG
Primary: claude-sonnet-4-5
Context: 43k/128k (33%) | 574↓ 182↑ tokens
📊 SESSIONS
Active: 3 | Heartbeat: 30m | Last: 1m ago
🐳 SERVICES
Docker: ✅ 3 containers
PostgreSQL: ✅ Running
是否需要查看详细的网卡流量或磁盘 I/O 状态?
Step 3:配置自动化告警阈值
用户:每小时检测一次,如果磁盘超过 90% 提醒我
OpenClaw:📋 已将监控集成至 Heartbeat 系统。
策略配置:
- 监控项:server-health --alerts
- 轮询间隔:每 1 小时 (0 * * * *)
- 告警触发:当输出包含 🔴 或 🟡 异常标记时
- 通知渠道:当前 Feishu 机器人
✅ 自动化巡检已就绪。
📋 Demo 1 关键步骤总结

核心价值:从手动查看top命令演进为AI驱动的自动化体检,所有关键指标一目了然。
5.3 Demo 2:智能日报生成Skill(人工引导沉淀)
5.3.1
场景描述
你每天需要花费大量时间整理工作日报,内容包括:
-
今日完成的任务(从项目管理工具同步);
-
代码提交记录(从Git仓库获取);
-
待办事项(从备忘录提取);
-
明日计划。
这个过程重复且耗时,希望通过Skill实现自动化。
5.3.2
执行步骤
Step 1:提出需求
用户:我每天花 30 分钟写日报,太痛苦了。能不能创建一个 Skill 自动生成日报?
OpenClaw:好的!我来帮你创建一个【智能日报助手】Skill。
首先,让我了解一下你的工作流:
1. 你使用什么项目管理工具?(飞书项目 / Jira / Notion /...)
2. 代码托管在哪里?(GitHub / GitLab / Gitee)
3. 平时在哪里记录待办事项?
4. 日报需要发送到哪里?(飞书群 / 邮件 /...)
5. 希望什么时候自动生成?(下班前 / 第二天早上)
Step 2:对话中设计Skill
用户:
- 项目管理:飞书项目
- 代码:GitHub
- 待办:飞书文档
- 发送:飞书群
- 时间:每天 18:00 自动生成
OpenClaw:收到!基于你的需求,我来设计【智能日报助手】Skill:
触发词:生成日报 / daily report / 日报
数据来源:
📋 飞书项目 API
→ 获取今日完成的任务
→ 获取进行中的任务进度
📊 GitHub API
→ 获取今日代码提交记录
→ 统计新增/修改/删除行数
→ 获取 PR 状态
📝 飞书文档
→ 读取今日待办清单
→ 标记已完成项目
⏰ Heartbeat 定时触发
→ 每天 18:00 自动执行
→ 飞书群推送
输出格式:
═══════════════════════════════════════
📊 日报 - 2024 年 1 月 15 日
═══════════════════════════════════════
🎯 今日完成 (5 项)
✓ 完成用户登录模块开发
✓ 修复订单查询性能问题
✓ Code Review 3 个 PR
...
💻 代码贡献
• 提交: 8 commits
• 新增: +523 行
• 删除: -128 行
• PR: #123(已合并), #124(审核中)
📋 待办进展
• 原定 5 项,完成 4 项
• 剩余: 接口文档编写
🎯 明日计划
1. 完成支付接口对接
2. 编写单元测试
3. 参加 14:00 技术评审
═══════════════════════════════════════
这个设计符合你的需求吗?需要调整哪些部分?
Step 3:创建并配置Skill
用户:很好!但希望能加上本周累计数据对比
OpenClaw:✅ 已更新设计!
新增功能:
📈 本周累计统计
• 本周完成任务数 vs 上周
• 代码提交趋势图
• 平均任务完成时间
现在创建这个 Skill 吗?
用户:创建!
OpenClaw:✅ 【智能日报助手】Skill 已创建!
文件位置:~/.openclaw/skills/daily-report-assistant/
配置完成:
• 飞书项目 API 已连接
• GitHub Token 已配置
• 飞书群推送已设置
• Heartbeat 定时任务:每天 18:00
首次运行测试:
🧪 正在生成今日日报...
═══════════════════════════════════════
📊 日报 - 2024 年 1 月 15 日
═══════════════════════════════════════
🎯 今日完成 (5 项)
✓ 完成用户登录模块开发
✓ 修复订单查询性能问题
✓ Code Review 3 个 PR
✓ 更新技术文档
✓ 参加需求评审会议
💻 代码贡献
• 提交: 8 commits
• 新增: +523 行
• 删除: -128 行
• PR: #123(已合并), #124(审核中)
📈 本周对比
• 任务完成: 5/7 (上周同期: 4/7) ↑
• 代码提交: 8 (上周同期: 6) ↑
• 平均完成时间: 3.2h (上周: 4.1h) ↑
📋 待办进展
• 原定 5 项,完成 4 项 (80%)
• 剩余: 接口文档编写
🎯 明日计划
1. 完成支付接口对接
2. 编写单元测试
3. 参加 14:00 技术评审
═══════════════════════════════════════
✅ 日报已生成并发送到飞书群!
Step 4:持续优化
用户:日报很棒!但希望能自动识别“阻塞问题”。如果有任务延期或遇到阻碍,单独标红提醒
OpenClaw:✅ 已更新 Skill!
新增智能识别:
🚨 阻塞问题检测
• 任务延期超过 1 天 → 🔴 标红提醒
• PR 审核超过 24 小时 → 🔴 提醒 reviewer
• CI/CD 失败 → 🔴 立即告警
• 依赖阻塞 → 🔴 标记等待中
下次日报会自动包含此项!
📋 Demo 2 关键步骤总结

核心价值:30分钟手工整理 → 0分钟自动生成,且数据更准确、全面。
5.4 Demo总结:Skill-creator工作流
5.4.1
两种模式对比

5.4.2
Skill-creator完整流程
flowchart LR A[1. 提出需求<br/>"我想做X"] --> B[2. 对话细化<br/>澄清细节/优先级] B --> C[3. 迭代设计<br/>调整规则/格式] C --> D[4. 自动创建<br/>生成文件/脚本] D --> E[5. 试用验证<br/>实际使用测试] E --> F[6. 持续进化<br/>根据反馈优化] F -.-> A
style A fill:#e1f5fe style F fill:#e8f5e9
5.4.3
核心价值

6. 结语
6.1 核心回顾
OpenClaw不仅仅是一个AI工具,它是一个持续进化的智能工作平台。

6.2 为什么现在就要尝试?
OpenClaw采用大模型+Skill的架构,既能利用AI的智能化能力,又能遵循特定的流程规范。这使它特别适合那些无法沉淀为明确工作流,但又有一定重复性的复杂业务场景。
典型场景:

核心优势:
-
智能化:大模型理解复杂需求,灵活处理非结构化任务;
-
规范化:Skill沉淀最佳实践,确保输出质量一致;
-
自动化:Heartbeat定时触发,无需人工干预;
-
可进化:根据反馈持续优化,越用越聪明。
现在就开始,让AI真正成为你的助手,而不只是工具。
6.3 开始你的OpenClaw之旅
npm install -g openclawopenclaw onboardopenclaw gateway start

关注【飞桨PaddlePaddle】公众号
获取更多技术内容~
更多推荐


所有评论(0)