政安晨的个人主页:政安晨
欢迎 👍点赞✍评论⭐收藏
希望政安晨的博客能够对您有所裨益,如有不足之处,欢迎在评论区提出指正!
目录
引言
第一章:重新认识AI——从“顾问”到“管家”
1.1 什么是OpenClaw?
1.2 理解OpenClaw:用“智能管家”来类比
1.3 聊天机器人 vs 行动式AI
1.4 OpenClaw的核心能力
1.5 技术架构解析
1.6 四大设计理念
第二章:快速开始——5分钟上手OpenClaw
2.1 环境准备
2.2 安装步骤
2.3 基础配置
2.4 连接渠道
2.5 第一个任务
第三章:核心概念详解——五大支柱
3.1 Session(会话)——用“房间”类比
3.2 Tool(工具)——用“工具箱”类比
3.3 Skill(技能)——用“手机APP”类比
3.4 Memory(记忆)——用“日记本”类比
3.5 Subagent(子代理)——用“助手团队”类比
第四章:技能体系详解——让AI能力无限扩展
4.1 技能体系原理
4.2 核心技能详解
4.2.1 Self-Improving Agent(自我改进代理)
4.2.2 Ontology(本体论技能)(知识图谱)
4.2.3 Baidu Web Search(百度搜索技能)
4.3 技能组合与协同
第五章:多渠道集成——随时随地唤起AI
5.1 支持的渠道
5.2 钉钉集成详解
5.3 Telegram集成
5.4 渠道管理
第六章:记忆与持续学习——让AI越用越聪明
6.1 记忆系统原理
6.2 日常记忆管理
6.3 长期记忆维护
6.4 心跳检查机制
第七章:子代理与多智能体协作——分工合作效率高
7.1 什么是子代理?
7.2 使用场景
7.3 子代理配置
7.4 多智能体协作模式
第八章:安全与隐私——让你的数据安全无忧
8.1 安全架构
8.2 隐私保护
8.3 安全**实践
第九章:实战案例——从需求到实现
9.1 案例1:自动整理下载文件夹
9.2 案例2:天气查询助手
9.3 案例3:知识管理系统
第十章:常见问题与解答
Q1:OpenClaw是免费的吗?
Q2:我需要会编程才能使用OpenClaw吗?
Q3:OpenClaw安全吗?
Q4:我需要一直开着电脑吗?
Q5:技能会自动更新吗?
Q6:Skill Creator在哪里?
附录
附录A:命令参考
附录B:配置文件详解
附录C:ClawHub技能推荐
总结
第十一章:技能开发实战——从零创建自定义技能
11.1 技能的基本结构
11.2 SKILL.md详解
11.3 技能开发实战:创建一个天气技能
11.4 技能发布到ClawHub
第十二章:高级进阶——深度定制与优化
12.1 自定义AI模型配置
12.2 多模型路由策略
12.3 性能优化技巧
12.4 高级工作流设计
第十三章:故障排查与**实践
13.1 常见问题与解决方案
13.2 日志分析
13.3 性能监控
13.4 备份与恢复
第十四章:生态与社区
14.1 ClawHub技能市场
14.2 社区资源
14.3 参与贡献
第十五章:未来展望
15.1 OpenClaw的发展路线
15.2 AI Agent的未来
15.3 你的角色
附录D:技能命令速查表
附录E:配置项详解
Gateway配置
模型配置
渠道配置
结语
你是否曾想过:如果有一个AI助手不仅能回答问题,还能帮你操作电脑,那该有多好?
想象一下这样的场景:
- 你说“帮我整理一下下载文件夹”,AI自动读取、分类、移动文件
- 你说“帮我查下明天天气”,AI自动搜索互联网并返回结果
- 你说“把这个PDF转成文字”,AI自动处理文件
这不是科幻,而是OpenClaw正在做的事情。
作为“玩转开源AI系列”的最新成员,本文将带你深入了解这个让AI拥有“双手”的智能体框架。无论你是AI新手还是技术老兵,都能从中找到有价值的内容。
1.1 什么是OpenClaw?
OpenClaw是一个开源的本地计算机智能体(Computer Agent)框架。它允许大语言模型(LLM)直接操作和控制用户的计算机,完成各种实际任务。
一句话概括:OpenClaw让AI拥有“双手”,能够代替你操作电脑。
与传统AI助手不同,OpenClaw不仅仅是“说”,更重要的是“做”。
1.2 理解OpenClaw:用“智能管家”来类比
想象一下,你有了一个24小时待命的智能管家:
举个例子:
传统AI助手:
OpenClaw智能管家:
1.3 聊天机器人 vs 行动式AI
1.4 OpenClaw的核心能力
OpenClaw的核心能力可以分为以下几类:
1. 文件操作
- 读取、编辑、创建文本文件
- 管理和文件夹
- 处理PDF、Word、Excel等文档
2. 命令执行
- 执行shell命令
- 运行脚本(Python、Bash等)
- 安装和管理软件
3. 网络功能
- 搜索互联网
- 获取网页内容
- 控制浏览器自动化
4. 消息功能
- 通过飞书/钉钉/微信等接收消息
- 发送回复和通知
- 跨渠道消息处理
5. 定时任务
- 设置定时提醒
- 自动执行例行任务
- 心跳检查机制
1.5 技术架构解析
OpenClaw的架构可以分为四层:
GPT plus 代充 只需 145┌───────────────────────────────┐ │ 你(通过飞书/钉钉/微信) │ └──────────────┬────────────────┘
│ 消息 ▼
┌───────────────────────────────┐ │ Gateway(门卫室) │ │ - 接收消息 │ │ - 调用AI模型 │ │ - 发送回复 │ └──────────────┬────────────────┘
GPT plus 代充 只需 145 │ 调用 ▼
┌───────────────────────────────┐ │ AI模型(大脑) │ │ - 本地模型(快速) │ │ - 云端模型(强大) │ └──────────────┬────────────────┘
│ 执行 ▼
┌───────────────────────────────┐ │ 工具系统(工具箱) │ │ - 文件操作 │ │ - 命令执行 │ │ - 网络功能 │ └───────────────────────────────┘
Gateway(门卫室)是整个系统的入口,负责接收消息、调用AI模型、发送回复。
AI模型(大脑)是决策中心,可以选择本地模型(快速)或云端模型(强大)。
工具系统(工具箱)是执行层,包含各种操作电脑的能力。
1.6 四大设计理念
OpenClaw有四个核心理念:
- 本地优先(Local-First)
- 数据尽量留在本地,保护隐私
- 减少对云服务的依赖
- 用户对自己的数据有完全控制
- 技能可扩展(Skill-Based)
- 像手机APP一样,按需安装功能
- 通过ClawHub市场安装社区技能
- 开发者可以创建和分享技能
- 安全优先(Security-First)
- 所有操作都有日志记录
- 支持白名单机制
- 本地运行,数据不外泄
- 模组化架构(Modular)
- 各组件解耦,易于维护
- 灵活的扩展机制
- 清晰的接口定义
2.1 环境准备
在开始之前,你需要准备以下环境:
硬件要求:
- 一台电脑(Windows/Mac/Linux都可以)
- 8GB以上内存
- 20GB以上可用磁盘空间
软件要求:
- Node.js 22.x或更高版本
- npm或yarn包管理器
- 代码编辑器(VS Code推荐)
可选但推荐:
- Git版本控制
- Python 3.x(某些技能需要)
2.2 安装步骤
第一步:安装Node.js
GPT plus 代充 只需 145# 检查是否已安装 node –version
如果没有,安装Node.js 22
curl -fsSL https://nodejs.org/dist/v22.12.0/node-v22.12.0-linux-x64.tar.xz -o node.tar.xz tar xf node.tar.xz sudo cp -r node-v22.12.0-linux-x64/* /usr/local/
第二步:安装OpenClaw
# 使用npm安装 npm install -g openclaw
验证安装
openclaw –version
第三步:初始化配置
GPT plus 代充 只需 145# 初始化OpenClaw openclaw init
启动Gateway
openclaw gateway start
2.3 基础配置
安装完成后,需要配置AI模型。编辑配置文件:
# 编辑配置文件 openclaw config edit
配置示例:
GPT plus 代充 只需 145{ “gateway”: {
"port": 18789, "auth": { "mode": "none" }
}, “models”: {
GPT plus 代充 只需 145"default": { "provider": "openai", "model": "gpt-4", "apiKey": "your-api-key" }
} }
2.4 连接渠道
OpenClaw支持多种消息渠道,这里以钉钉为例:
第一步:创建钉钉机器人
- 登录钉钉开放平台
- 创建应用 → 选择“机器人”
- 获取AppKey和AppSecret
第二步:配置渠道
{ “channels”: {
GPT plus 代充 只需 145"dingtalk": { "enabled": true, "clientId": "你的AppKey", "clientSecret": "你的AppSecret", "dmPolicy": "pairing", "groupPolicy": "allowlist" }
} }
第三步:重启Gateway
openclaw gateway restart
2.5 第一个任务
现在你可以和OpenClaw对话了!试试这些命令:
GPT plus 代充 只需 145你:你好 AI:你好!我是OpenClaw助手…
你:今天几号? AI:今天是2026年3月16日…
你:帮我看看桌面上有什么文件 AI:好的,我来查看… (读取桌面文件列表并返回)
OpenClaw有五个核心概念,理解它们是进阶的关键。
3.1 Session(会话)——用“房间”类比
什么是会话?
会话是OpenClaw中一次完整对话的上下文环境。简单说:每次聊天都在一个独立的“房间”里进行。
房间特性:
会话类型:
- 主会话(Main Session)
- 用途:日常对话
- 特点:持久化,有完整记忆
- 场景:钉钉/微信中的对话
- 隔离会话(Isolated Session)
- 用途:临时任务
- 特点:独立,不影响主会话
- 场景:一次性查询、测试
- 子代理会话(Subagent Session)
- 用途:复杂任务
- 特点:由子代理使用
- 场景:代码分析、多步骤任务
会话管理命令:
# 查看所有会话 openclaw sessions list
查看历史消息
openclaw sessions history
在对话中清除会话
/clear
3.2 Tool(工具)——用“工具箱”类比
什么是工具?
工具是AI用来操作电脑的基本能力。每个工具执行一个特定的操作。
内置工具:
工具调用方式:
工具通常由AI自动调用。你不需要手动指定,AI会根据任务需要选择合适的工具。
3.3 Skill(技能)——用“手机APP”类比
什么是技能?
技能是按需安装的功能模块,就像手机上的APP。与工具的区别在于:
热门技能:
- Self-Improving Agent:持续学习改进
- Ontology:知识结构化管理
- Baidu Web Search:高效中文检索
- weather:天气查询
安装技能:
GPT plus 代充 只需 145# 搜索技能 openclaw skills search pdf
安装技能
openclaw skills install pdf-tools
查看已安装
openclaw skills list
3.4 Memory(记忆)——用“日记本”类比
什么是记忆?
记忆系统记录对话和历史,让AI能够记住之前说过的话、做过的事。
记忆类型:
- 短期记忆:当前会话的上下文
- 长期记忆:跨会话的重要信息
- 结构化记忆:AGENTS.md、TOOLS.md等文件
记忆文件:
- MEMORY.md:长期记忆精选
- AGENTS.md:代理行为规范
- TOOLS.md:工具配置笔记
- SOUL.md:AI人格设定
- USER.md:用户偏好
3.5 Subagent(子代理)——用“助手团队”类比
什么是子代理?
子代理是处理复杂任务的分身。你可以派一个“助手”去完成特定任务,然后汇报结果。
使用场景:
- 需要多步骤完成的任务
- 需要专门技能的复杂操作
- 需要并行处理多个子任务
子代理与主会话的关系:
主会话 ├── 任务:分析这个代码库 │ └── 子代理A → 分析前端代码 │ └── 子代理B → 分析后端代码 │ └── 子代理C → 整理测试报告
GPT plus 代充 只需 145 │ ▼ 汇总结果,返回给主会话
技能系统是OpenClaw最强大的特性之一。它让AI能够自动匹配场景,触发相应功能。
4.1 技能体系原理
什么是技能体系?
技能体系是OpenClaw中自动触发的功能扩展机制。核心特点:
- 自动触发:无需用户显式调用,语义匹配即激活
- 领域专用:每个技能解决一类特定问题
- 即插即用:通过ClawHub安装,配置简单
- 社区生态:开发者可以创建和分享技能
技能在Agent架构中的位置:
用户输入 → 语义理解 → 技能匹配(自动) 或 工具调用(手动) → 执行 → 回复
4.2 核心技能详解
4.2.1 Self-Improving Agent(自我改进代理)
这是OpenClaw最独特的技能——让AI能够从错误中学习,不断改进。
工作原理:
GPT plus 代充 只需 145用户纠正 → 触发技能 → 记录到文件 → 下次应用 → 验证改进
触发条件:
- 用户纠正:“不对”、“错了”、“应该是”
- 操作失败:命令执行失败、API调用失败
- 发现更好的方法:AI自己意识到有更优解
- 知识过时:发现之前的知识不正确
- 用户请求缺失能力:要求的功能当前不存在
学习记录系统:
- LEARNINGS.md - 学习记录
2026-03-16 - 邮件发送方式 问题:尝试使用himxxxxx发送邮件失败 原因:SMTP服务器smtp.wo.cn不支持SSL 解决方案:使用Python smtplib通过端口25发送 应用:后续邮件发送优先使用Python smtplib
- ERRORS.md - 错误记录
GPT plus 代充 只需 145 2026-03-15 - GitHub API调用失败 命令:`gh api /repos/owner/repo/issues` 错误:HTTP 401 Unauthorized 原因:GitHub token未配置 解决:运行`gh auth login`重新认证
- FEATURE_REQUESTS.md - 功能请求
请求:用户希望AI能自动回复微信消息 当前状态:不支持(微信个人号API限制) 替代方案:使用企业微信或通知提醒
**实践:
- 及时纠正:发现错误立即指出
- 明确说明:解释“为什么错”和“应该怎样”
- 定期回顾:每周查看LEARNINGS.md
- 鼓励改进:应用学到的知识时给予反馈
4.2.2 Ontology(本体论技能)(知识图谱)
本体论是对某个领域内概念及其关系的形式化表示。简单说:它是知识的结构化地图(知识图谱)。
在Agent系统中的作用:
- 概念层次:父类、子类关系
- 关系网络:属于、包含、相关
- 属性继承:子类继承父类属性
- 推理能力:基于关系进行逻辑推理
构建个人知识本体示例:
GPT plus 代充 只需 145// 学习领域本体 const learningOntology = { // 领域 domains: [‘编程’, ‘语言’, ‘AI/ML’],
// 技能树 skills: {
'编程': { 'Python': { level: '高级' }, 'JavaScript': { level: '中级' } }, '框架': ['React', 'Vue'], 'AI/ML': { '理论': ['机器学习', '深度学习'], '工具': ['OpenClaw', 'LangChain'] }
},
// 资源 resources: {
GPT plus 代充 只需 145books: ['Python编程', '深度学习'], courses: ['Coursera ML', 'B站教程']
},
// 目标 goals: {
shortTerm: '完成OpenClaw文档', longTerm: '成为AI Agent专家'
} };
实战:构建咖啡本体
GPT plus 代充 只需 145const coffeeOntology = { coffee: {
types: [ { name: '阿拉比卡', origin: ['埃塞俄比亚', '哥伦比亚'] }, { name: '罗布斯塔', origin: ['越南', '印尼'] } ], methods: ['手冲', '意式浓缩', '冷萃'], flavors: ['酸度', '苦度', '香气']
} };
推理示例:
有了上述本体,AI可以回答:
- “我学过哪些Python相关的项目?”
- “我的AI学习资源有哪些?”
- “我的短期学习目标完成得如何?”
4.2.3 Baidu Web Search(百度搜索技能)
这是专门针对中文搜索优化的技能,相比通用搜索有以下优势:
适用场景:
- 英文/技术内容 → 用web_search
- 中文信息 → 用Baidu Web Search
- 混合内容 → 两者结合使用
搜索策略:
- 关键词选择
- 模糊:“怎么学习编程”
- 具体:“Python入门教程2026推荐”
- 时间范围
- 最新:
freshness=“day”或“week” - 历史:
date_before=“2025-12-31”
- 最新:
- 地域限定
- 中国大陆:
country=“CN” - 全球中文:
country=“ALL” + search_lang=“zh-hans”
- 中国大陆:
4.3 技能组合与协同
复杂任务需要多个技能协同工作。
技能协同工作模式:
任务:调研并记录AI Agent最新进展
技能组合:
- Baidu Web Search → 搜索中文信息
- web_search → 补充英文信息
- Obsidian → 整理笔记到知识库
- Self-Improving → 记录搜索过程中的学习
- Ontology → 更新知识图谱中的“AI Agent”分支
实战案例:创建周报
技能调用链:
- Gmail (gog) → 获取本周邮件摘要
- Calendar (gog) → 提取本周会议
- Things (things-mac) → 获取已完成任务
- GitHub (github) → 获取代码提交记录
- web_search → 补充行业动态
- Self-Improving → 记录周报生成经验
- Obsidian → 保存周报到知识库
输出:
- 本周工作总结
- 关键成果
- 遇到的问题
- 下周计划
- 行业动态
OpenClaw支持多种消息渠道,让你随时随地都能使用AI助手。
5.1 支持的渠道
5.2 钉钉集成详解
配置步骤:
- 登录钉钉开放平台
- 创建应用 → 选择“机器人”
- 获取AppKey和AppSecret
配置文件:
GPT plus 代充 只需 145{ “channels”: {
"dingtalk": { "enabled": true, "clientId": "你的AppKey", "clientSecret": "你的AppSecret", "dmPolicy": "pairing", "groupPolicy": "allowlist", "messageType": "markdown", "debug": false, "allowFrom": ["你的用户ID"] }
} }
配置项说明:
重启Gateway:
GPT plus 代充 只需 145openclaw gateway restart
检查状态
openclaw gateway status
5.3 Telegram集成
Telegram是配置最简单的渠道之一:
- 联系@BotFather创建机器人
- 获取Bot Token
- 配置openclaw.json
{ “channels”: {
GPT plus 代充 只需 145"telegram": { "enabled": true, "botToken": "你的BotToken" }
} }
5.4 渠道管理
查看渠道状态:
# 查看所有渠道 openclaw channels list
查看渠道状态
openclaw channels status
查看渠道日志
openclaw logs –tail 50 | grep channel
启用/禁用渠道:
GPT plus 代充 只需 145{ “channels”: {
"dingtalk": { "enabled": true }, "telegram": { "enabled": false }
} }
多渠道运行:
GPT plus 代充 只需 145{ “channels”: {
"dingtalk": { "enabled": true }, "wechat": { "enabled": true }, "telegram": { "enabled": true }
}, “messages”: {
GPT plus 代充 只需 145"sync": true, "syncChannels": ["dingtalk", "wechat"]
} }
OpenClaw的记忆系统让AI能够记住之前说过的话,做过的事,从而提供更好的服务。
6.1 记忆系统原理
记忆类型:
- 短期记忆:当前会话的上下文
- 最近几轮对话
- 当前任务进度
- 长期记忆:跨会话的重要信息
- 用户偏好
- 重要约定
- 学习到的知识
- 结构化记忆:特定格式的文档
- AGENTS.md:代理行为规范
- TOOLS.md:工具配置
- USER.md:用户信息
6.2 日常记忆管理
关键文件:
- MEMORY.md:长期记忆精选
- AGENTS.md:工作流程规范
- SOUL.md:AI人格设定
- USER.md:用户偏好
示例:SOUL.md
# SOUL.md - 谁是你
核心真理
真正有用,而不是表现有用。 跳过“太棒问题了!”和“我很乐意帮助!”——直接帮忙。
有观点。 你允许不同意、偏好事物、发现有趣或无聊。
在询问之前先尝试。 试着弄清楚。读文件。检查上下文。搜索它。然后,如果卡住了,再问。
边界
- 私人事情保持私密。
- 有疑问时,先问再行动外部。
- 永远不要发送半生不熟的回复到消息表面。
示例:USER.md
GPT plus 代充 只需 145
# USER.md - 关于你 - 名字:政安晨
- 怎么称呼你:晨哥
- 博客:https://zachen.blog.csdn.net/
- 系列:玩转开源AI系列(共43篇)
上下文
- 热爱开源
- 技术博主
- 折腾各种AI工具 维护建议:
6.3 长期记忆维护
- 定期回顾:每月检查MEMORY.md
- 及时更新:新信息立即记录
- 清理过期:删除过时内容
- 结构整理:保持清晰分类
6.4 心跳检查机制
心跳是OpenClaw定期执行的后台检查机制。
用途:
- 检查系统状态
- 执行定时任务
- 定期回顾记忆
- 主动提供服务
配置心跳:
在HEARTBEAT.md中定义检查任务:
# HEARTBEAT.md
定期检查
- 检查邮件(每天2次)
- 检查日历(每天2次)
- 检查天气(根据用户位置)
当任务太复杂时,一个AI可能忙不过来。这时候就需要子代理出场了。
7.1 什么是子代理?
子代理是主AI派出去的“小助手”,专门处理特定任务。
类比:
- 主AI是项目经理
- 子代理是执行团队
- 项目经理分配任务,团队完成后汇报
7.2 使用场景
场景1:代码分析
任务:分析整个代码库
GPT plus 代充 只需 145主AI:派3个子代理 ├── 子代理A → 分析前端代码 ├── 子代理B → 分析后端代码 └── 子代理C → 分析数据库 │ ▼ 汇总结果,生成报告
场景2:并行搜索
任务:调研多个主题
主AI:派4个子代理 ├── 子代理A → 搜索AI最新新闻 ├── 子代理B → 搜索技术文章 ├── 子代理C → 搜索开源项目 └── 子代理D → 搜索社区讨论 │ ▼ 整合所有结果
7.3 子代理配置
GPT plus 代充 只需 145{ “subagents”: {
"enabled": true, "maxConcurrent": 3, "timeout": 300
} }
7.4 多智能体协作模式
1. 串行模式
GPT plus 代充 只需 145A → B → C → 结果
2. 并行模式
A ─┐ B ─┼─→ 结果 C ─┘
3. 分层模式
GPT plus 代充 只需 145主AI ├── 子代理A1 → 子代理A2 └── 子代理B1 → 子代理B2
OpenClaw非常重视安全问题。让我们来看看它是如何保护你的数据的。
8.1 安全架构
本地优先设计:
- 数据尽量留在本地
- 减少对云服务的依赖
- 用户对自己的数据有完全控制
操作日志:
- 所有操作都有记录
- 可以随时审查
- 便于问题排查
8.2 隐私保护
数据存储:
- 本地文件系统
- 可选的云同步
- 加密存储选项
访问控制:
- 白名单机制
- 用户ID验证
- 会话隔离
8.3 安全**实践
- 定期检查日志
openclaw logs –tail 100 - 限制API权限
- 只授予必要的权限
- 定期更新凭据
- 网络安全
- 使用VPN
- 防火墙配置
- 限制访问IP
9.1 案例1:自动整理下载文件夹
需求: 每天自动整理下载文件夹
实现:
- 创建cron任务
- 编写整理脚本
- 配置定时执行
GPT plus 代充 只需 145# 每天凌晨3点执行 0 3 * * * /path/to/organize.sh
9.2 案例2:天气查询助手
需求: 查询任意城市天气
实现:
- 安装weather技能
- 配置天气API
- 测试查询功能
9.3 案例3:知识管理系统
需求: 建立个人知识库
实现:
- 使用Ontology技能
- 定义知识结构
- 持续更新维护
Q1:OpenClaw是免费的吗?
是的,OpenClaw是开源免费的。但使用云端AI模型可能需要付费。
Q2:我需要会编程才能使用OpenClaw吗?
不需要。基础使用不需要编程,但如果要开发自定义技能,需要一些编程基础。
Q3:OpenClaw安全吗?
OpenClaw采用“本地优先”设计,数据尽量留在本地。所有操作都有日志记录,你可以随时审查。
Q4:我需要一直开着电脑吗?
是的。OpenClaw运行在你的电脑上,需要电脑开机才能工作。
Q5:技能会自动更新吗?
技能需要手动更新。可以使用clawhubCLI检查并更新已安装的技能。
Q6:Skill Creator在哪里?
Skill Creator是OpenClaw自带的技能,不在ClawHub市场上架。位置:~/.npm-global/lib/node_modules/openclaw/skills/skill-creator/
附录A:命令参考
# 基础命令 openclaw –version # 查看版本 openclaw init # 初始化 openclaw gateway start # 启动Gateway openclaw gateway stop # 停止Gateway openclaw gateway status # 查看状态
配置命令
openclaw config edit # 编辑配置 openclaw channels list # 查看渠道
技能命令
openclaw skills search # 搜索技能 openclaw skills install # 安装技能 openclaw skills list # 查看已安装
会话命令
openclaw sessions list # 查看会话 openclaw sessions history # 查看历史
附录B:配置文件详解
GPT plus 代充 只需 145{ “gateway”: {
"port": 18789, "auth": { "mode": "none" }
}, “models”: {
GPT plus 代充 只需 145"default": { "provider": "openai", "model": "gpt-4" }
}, “channels”: {
"dingtalk": { "enabled": true }
} }
附录C:ClawHub技能推荐
OpenClaw不仅仅是一个AI助手,它是一个让AI拥有“双手”的智能体框架。通过本文,你应该已经对OpenClaw有了全面的认识:
- 理解本质:从“顾问”到“管家”的转变
- 掌握核心:五大支柱概念
- 灵活运用:技能系统、多渠道集成
- 持续进化:记忆系统、自我改进
现在,轮到你上场了。去尝试OpenClaw,让它成为你的贴心助手吧!
参考资料
- OpenClaw官方文档
- ClawHub技能市场
- GitHub源码
- 社区Discord
11.1 技能的基本结构
每个技能都是一个独立的目录,包含以下核心文件:
GPT plus 代充 只需 145my-skill/ ├── SKILL.md # 技能说明文档(必需) ├── scripts/ # 脚本目录 │ └── main.py # 主脚本 ├── assets/ # 资源目录 │ └── config.json # 配置文件 └── README.md # 使用说明
11.2 SKILL.md详解
SKILL.md是技能的核心文件,定义了技能的元数据和触发规则:
— name: my-skill version: 1.0.0 description: “这是一个示例技能” author: your-name
tags: [example, demo]
我的技能
功能说明
这个技能用于演示如何创建自定义技能。
触发条件
当用户提到以下内容时自动触发:
- “示例”
- “演示”
- “test”
使用方法
- 安装技能
- 配置参数
- 开始使用
配置项
| 配置项 | 说明 | 默认值 |
|---|---|---|
| enabled | 是否启用 | true |
| timeout | 超时时间 | 30 |
11.3 技能开发实战:创建一个天气技能
第一步:创建技能目录
GPT plus 代充 只需 145mkdir -p ~/.openclaw/workspace/skills/weather/scripts
第二步:编写SKILL.md
— name: weather version: 1.0.0 description: “查询指定城市的天气信息” author: openclaw
tags: [weather, utility]
天气查询技能
功能说明
查询指定城市的天气信息,支持实时天气和天气预报。
触发条件
当用户询问天气相关问题时自动触发:
- “天气”
- “温度”
- “下雨”
- “晴天”
使用方法
直接询问城市天气,例如:
- “北京天气怎么样?”
- “明天上海下雨吗?”
第三步:编写天气查询脚本
GPT plus 代充 只需 145
#!/usr/bin/env python3 “”“ 天气查询脚本 ”“” import requests import json import sys
def get_weather(city):
"""获取城市天气""" # 这里使用wttr.in免费天气API url = f"https://wttr.in/{city}?format=j1" try: response = requests.get(url, timeout=10) data = response.json() current = data["current_condition"][0] result = { "city": city, "temp": current["temp_C"], "condition": current["weatherDesc"][0]["value"], "humidity": current["humidity"], "wind": current["windspeedKmph"] } return result except Exception as e: return {"error": str(e)}
def main():
GPT plus 代充 只需 145if len(sys.argv) < 2: print("用法: weather
<城市名>
") sys.exit(1) city = sys.argv[1] result = get_weather(city) if "error" in result: print(f"查询失败: {result['error']}") sys.exit(1) print(f"{result['city']}天气:{result['condition']}") print(f"温度:{result['temp']}°C") print(f"湿度:{result['humidity']}%") print(f"风速:{result['wind']}km/h")
城市名>
if name == “main”:
main()
第四步:测试技能
GPT plus 代充 只需 145# 授予执行权限 chmod +x ~/.openclaw/workspace/skills/weather/scripts/weather.py
测试查询
python3 ~/.openclaw/workspace/skills/weather/scripts/weather.py 北京
11.4 技能发布到ClawHub
第一步:准备发布
# 进入技能目录 cd ~/.openclaw/workspace/skills/weather
初始化git仓库
git init git add . git commit -m “添加天气查询技能”
第二步:发布技能
GPT plus 代充 只需 145# 使用OpenClaw CLI发布 openclaw skills publish weather
12.1 自定义AI模型配置
OpenClaw支持多种AI模型提供商的配置:
OpenAI模型配置:
{ “models”: {
GPT plus 代充 只需 145"default": { "provider": "openai", "model": "gpt-4", "apiKey": "sk-xxx", "temperature": 0.7, "maxTokens": 2000 }
} }
本地模型配置(Ollama):
{ “models”: {
GPT plus 代充 只需 145"local": { "provider": "ollama", "model": "llama2", "baseUrl": "http://localhost:11434" }
} }
MiniMax模型配置:
{ “models”: {
GPT plus 代充 只需 145"minimax": { "provider": "minimax", "model": "xxx", "apiKey": "your-api-key", "baseUrl": "https://api.minimax.chat/v1" }
} }
12.2 多模型路由策略
配置示例:
{ “models”: {
GPT plus 代充 只需 145"default": "gpt-4", "routing": { "fast": "gpt-3.5-turbo", "creative": "gpt-4", "cheap": "claude-3-haiku" }
} }
使用路由:
# 快速响应 你:今天天气怎么样? [使用fast模型]
创意写作
你:帮我写一首诗 [使用creative模型]
省钱模式
你:简单回答我的问题 [使用cheap模型]
12.3 性能优化技巧
1. 减少API调用
- 使用缓存存储重复查询
- 批量处理而非逐个处理
2. 本地模型优先
GPT plus 代充 只需 145{ “models”: {
"default": { "provider": "ollama", "model": "llama2" }, "fallback": { "provider": "openai", "model": "gpt-3.5-turbo" }
} }
3. 并行处理
当有多个独立任务时,使用子代理并行处理:
GPT plus 代充 只需 145你:帮我搜索3个主题的最新资讯 AI:派3个子代理同时搜索,汇总结果
12.4 高级工作流设计
工作流1:自动周报生成
触发条件:每周五下午5点
执行步骤:
- Gmail → 获取本周邮件摘要
- Calendar → 获取本周会议
- GitHub → 获取代码提交
- 整合 → 生成周报
- 发送 → 发送到指定邮箱
工作流2:智能客服系统
GPT plus 代充 只需 145
触发条件:收到新消息
执行步骤:
- 分类 → 判断问题类型
- 知识库 → 搜索相关答案
- AI处理 → 生成回复
- 审核 → 人工审核(可选)
- 发送 → 返回答案
工作流3:自动化运维
触发条件:定时任务/事件触发
执行步骤:
- 检查 → 服务器状态检查
- 分析 → 日志分析
- 预警 → 异常预警通知
- 处理 → 自动修复(可选)
- 记录 → 记录操作日志
13.1 常见问题与解决方案
问题1:Gateway启动失败
症状:运行openclaw gateway start报错
排查步骤:
GPT plus 代充 只需 145# 1. 检查端口占用 lsof -i :18789
2. 检查配置文件
openclaw config validate
3. 查看详细日志
openclaw logs –tail 100
解决方案:
- 端口被占用:更换端口或关闭占用进程
- 配置错误:修正JSON格式
- 权限问题:检查文件权限
问题2:AI模型调用失败
症状:回复“抱歉,我遇到了一些问题”
排查步骤:
# 1. 检查模型配置 openclaw config show | grep model
2. 测试API连接
curl https://api.openai.com/v1/models
3. 检查API Key
echo $OPENAI_API_KEY
解决方案:
- API Key错误:更新正确的Key
- 余额不足:充值或更换模型
- 网络问题:检查代理设置
问题3:渠道消息接收不到
症状:发送消息但没有回复
排查步骤:
GPT plus 代充 只需 145# 1. 检查Gateway状态 openclaw gateway status
2. 检查渠道日志
openclaw logs | grep dingtalk
3. 测试渠道连接
openclaw channels status
解决方案:
- Gateway未运行:重新启动
- 渠道未启用:修改配置并重启
- Webhook配置错误:检查URL配置
13.2 日志分析
查看日志:
# 查看最近日志 openclaw logs –tail 50
查看特定时间范围
openclaw logs –since “2026-03-16 10:00”
过滤关键词
openclaw logs | grep error
日志级别:
- DEBUG:调试信息
- INFO:一般信息
- WARNING:警告
- ERROR:错误
13.3 性能监控
监控命令:
GPT plus 代充 只需 145# 查看资源使用 openclaw status
查看会话统计
openclaw sessions list
查看响应时间
openclaw metrics
13.4 备份与恢复
备份配置:
# 备份配置目录 tar -czvf openclaw-backup.tar.gz ~/.openclaw/
备份记忆文件
cp -r ~/.openclaw/workspace/memory ~/memory-backup
恢复配置:
GPT plus 代充 只需 145# 解压恢复 tar -xzvf openclaw-backup.tar.gz -C ~/
恢复记忆
cp -r ~/memory-backup/memory ~/.openclaw/workspace/
14.1 ClawHub技能市场
ClawHub是OpenClaw的官方技能市场,提供丰富的社区技能:
热门技能分类:
安装技能:
# 搜索技能 openclaw skills search pdf
安装技能
openclaw skills install pdf-tools
查看详情
openclaw skills info pdf-tools
14.2 社区资源
官方资源:
- 官网:https://openclaw.ai
- 文档:https://docs.openclaw.ai
- GitHub:https://github.com/openclaw/openclaw
- Discord:https://discord.com/invite/clawd
社区贡献:
- 技能开发
- 文档翻译
- 问题反馈
- 功能建议
14.3 参与贡献
如何贡献:
- 报告Bug
- 访问GitHub Issues
- 提供复现步骤
- 附加日志信息
- 提交功能
- Fork项目
- 开发功能
- 提交Pull Request
- 分享技能
- 创建技能
- 发布到ClawHub
- 编写文档
15.1 OpenClaw的发展路线
已实现功能:
- 多渠道集成
- 技能系统
- 记忆系统
- 子代理
即将推出:
- 更强大的多模态支持
- 更丰富的技能市场
- 更智能的任务规划
- 更完善的隐私保护
15.2 AI Agent的未来
随着大语言模型技术的快速发展,AI Agent将成为下一个技术热点:
- 更智能:模型能力持续提升
- 更自主:从辅助到自动驾驶
- 更协作:多Agent协同工作
- 更安全:隐私保护更完善
15.3 你的角色
无论你是:
- 普通用户:使用现成技能,提升工作效率
- 开发者:创建自定义技能,构建自动化流程
- 爱好者:参与社区,贡献代码和创意
- 企业用户:定制解决方案,优化业务流程
OpenClaw都有你的一席之地。
GPT plus 代充 只需 145# 搜索技能 openclaw skills search
<关键词>关键词>
安装技能
openclaw skills install <技能名>技能名>
卸载技能
openclaw skills uninstall <技能名>技能名>
查看已安装
openclaw skills list
查看详情
openclaw skills info <技能名>技能名>
更新技能
openclaw skills update <技能名>技能名>
发布技能
openclaw skills publish <技能目录> 技能目录>
Gateway配置
模型配置
渠道配置
通过本文的学习,你应该已经对OpenClaw有了全面而深入的认识。从基本概念到高级应用,从技能开发到故障排查,我们涵盖了OpenClaw的方方面面。
OpenClaw不仅仅是一个工具,它代表着AI发展的新方向——从被动应答到主动服务,从单一对话到多维协作。
现在,是时候让你的AI助手真正“动起来”了。
行动指南:
- ✅ 安装OpenClaw并完成基础配置
- ✅ 连接至少一个消息渠道
- ✅ 安装几个常用技能
- ✅ 尝试与AI助手对话
- ✅ 创建第一个自定义任务
期待你在OpenClaw的世界里,创造出属于自己的智能助手!
政安晨助您养虾愉快!嘻嘻。

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/240037.html