Awesome OpenClaw 指南
精选 OpenClaw 生态资源汇总,助你快速上手 AI 本地助手开发
📦 一、核心安装与配置
| 资源 |
说明 |
难度 |
| 官方安装指南 |
支持 Windows/Mac/Linux,一键部署本地 AI 网关 |
⭐ |
| OpenClaw CLI |
openclaw 命令行工具,管理网关、插件、配置 |
⭐ |
| Gateway 配置 |
openclaw.json 完整配置参考,支持 Ollama/API 多种模型 |
⭐⭐ |
| 模型配置指南 |
Ollama 本地模型 + 云端 API (Claude/GPT/Gemini) 混合配置 |
⭐⭐ |
🛠️ 二、核心技能 (Skills)
| 技能名称 |
路径 |
用途 |
难度 |
| 深度研究 |
skills/deep-research/ |
市场调研、竞品分析、深度调查报告 |
⭐⭐⭐ |
| 网页总结 |
skills/web-digest/ |
输入 URL 自动抓取并总结网页内容 |
⭐⭐ |
| 代码助手 |
skills/code-pilot/ |
代码编写、审查、调试、代码优化建议 |
⭐⭐ |
| 任务管理 |
skills/task-manager/ |
创建待办事项、设置提醒、任务追踪 |
⭐⭐ |
| 视频下载 |
skills/video-download/ |
yt-dlp + ffmpeg 视频下载与剪辑 |
⭐⭐⭐ |
| 社交媒体 |
skills/social-media/ |
刷 B站/抖音/微博/知乎热搜 |
⭐⭐ |
| 系统控制 |
skills/system-control/ |
音量调节、锁屏、系统信息查询 |
⭐ |
| 桌面操作 |
skills/windows-desktop-exec/ |
鼠标/键盘/窗口自动化控制 |
⭐⭐⭐ |
| 工作流引擎 |
skills/workflow-engine/ |
复杂多步骤任务模板编排 |
⭐⭐⭐ |
| 每日简报 |
skills/daily-briefing/ |
早晨自动生成今日资讯摘要 |
⭐⭐ |
🏗️ 三、OpenClaw 工作原理
3.1 网关架构 (Gateway)
用户请求 → OpenClaw Gateway → Orchestra 路由层 → 工具选择 → 执行 → 响应
核心组件:
– Gateway: 中央调度器,管理所有 Agent 会话
– Orchestra: 智能路由引擎,N-gram 分词 + 关键词匹配
– Memory: 会话记忆与长期记忆分层管理
– Skills: 可插拔技能系统,按需加载
3.2 脑手分离架构 (Planner/Executor/Reviewer)
┌─────────────┐ TASK_CARD ┌─────────────┐
│ Planner │ ─────────────────→ │ Executor │
│ (战略脑) │ │ (执行手) │
└─────────────┘ STEP_REPORT └─────────────┘
↑ │
└────────── FINAL_REPORT ────────────┘
交接协议:
– 协议目录: handoff/
– 标准格式: TASK_CARD / STEP_REPORT / FINAL_REPORT
– 工具限制: 通过 tools.profile 细粒度控制 (coding/full)
3.3 工具系统 (Tools)
| 工具 |
类型 |
功能 |
browser |
浏览器 |
网页浏览、截图、snapshot 抓取 |
web_search |
搜索 |
DuckDuckGo 免费搜索 |
exec |
执行 |
PowerShell/Shell 命令执行 |
read |
文件 |
读取本地文件内容 |
write/edit |
文件 |
写入或编辑本地文件 |
feishu_* |
飞书 |
文档/表格/知识库/聊天集成 |
👥 四、JamJar AI / Jarvis AI Team 生态
4.1 团队角色
| 角色 |
Agent ID |
职责 |
| Planner |
agent-brain |
战略规划、任务分解、资源协调 |
| Executor |
agent-hands |
代码执行、工具调用、具体操作 |
| Reviewer |
agent-audit |
质量审查、结果验证、反馈优化 |
4.2 协作流程
- 任务接单 → Planner 分析需求,输出 TASK_CARD
- 任务执行 → Executor 按规范执行,产出 STEP_REPORT
- 结果交付 → Reviewer 审核,通过则产 FINAL_REPORT
- 持续学习 → 重要信息写入 MEMORY.md 和日志
4.3 技能共享
所有技能存储在 skills/ 目录,支持团队共享和版本管理。
💼 五、实际用例
5.1 内容创作工作流
输入: "写一篇关于AI助手的文章"
↓
Planner: 分解为 [选题→搜索→撰写→审核]
↓
Executor:
1. web_search 搜索热点
2. browser 抓取相关页面
3. 生成文章内容
↓
Reviewer: 检查事实准确性和可读性
5.2 代码开发工作流
输入: "帮我写一个Python爬虫"
↓
Planner: 输出 TASK_CARD (需求分析→技术选型→代码实现→测试)
↓
Executor:
1. 使用 code-pilot skill
2. 编写代码并写入文件
3. exec 运行测试
↓
Reviewer: 代码审查 + 错误检测
5.3 市场调研工作流
输入: "分析一下OpenClaw的竞品"
↓
Planner: 拆解为 [竞品名单→信息收集→对比分析→报告]
↓
Executor:
1. deep-research skill 执行
2. 多轮 web_search + browser 收集数据
3. 整理分析报告
5.4 办公自动化
- 飞书集成: 自动创建文档、填写表格、发送消息
- 文件处理: 批量重命名、格式转换、内容提取
- 日程管理: 定时提醒、会议安排、任务跟踪
🎯 六、最佳实践
6.1 安全原则
| 原则 |
说明 |
| 隐私保护 |
不泄露敏感信息,本地处理优先 |
| 操作确认 |
对外操作(邮件/消息)先询问确认 |
| 权限控制 |
exec 策略使用白名单模式 |
| 审计追溯 |
所有操作记录到日志文件 |
6.2 效率技巧
- Session 启动流程:
读 SOUL.md → 读 USER.md → 读 memory/ 当日日志 → 读 MEMORY.md
- 工具使用策略:
- 简单查询 → web_search (免费快速)
- 页面浏览 → browser snapshot
- 文件操作 → read/write/edit
- 系统命令 → exec (PowerShell)
- 复杂任务 → 使用对应 skill
- 任务拆分原则:
- 超过 3 步骤自动启用 Protocol
- 每步一个工具调用
- 完成后汇报进度
6.3 记忆管理
memory/
├── YYYY-MM-DD.md # 每日会话日志
└── MEMORY.md # 长期记忆(主会话加载)
重要信息写入文件,不依赖模型记忆
6.4 错误处理
| 错误类型 |
处理方式 |
| 工具失败 |
重试一次,仍失败跳过继续 |
| 权限不足 |
降级方案或请求用户授权 |
| 信息不足 |
web_search/browser 补充信息 |
| 不确定内容 |
如实说明,不编造 |
🔧 七、配置参考
7.1 常用配置模板
{
"gateway": {
"port": 8080,
"host": "0.0.0.0"
},
"models": {
"main": "ollama/llama3.1",
"fallback": "claude-3-5-sonnet"
},
"agents": {
"main": {
"tools": {
"profile": "full"
}
}
}
}
7.2 环境变量
| 变量 |
用途 |
OPENCLAW_API_KEY |
云端模型 API 密钥 |
OLLAMA_HOST |
Ollama 服务地址 |
FEISHU_APP_ID |
飞书应用 ID |
FEISHU_APP_SECRET |
飞书应用密钥 |
📚 八、学习路径
新手 (Day 1-3)
- 安装 OpenClaw Gateway
- 配置第一个模型 (Ollama 本地)
- 尝试基本对话和文件操作
- 体验 2-3 个核心技能
进阶 (Day 4-7)
- 配置多个模型混合使用
- 学习脑手分离工作流
- 自定义技能和工作流
- 集成飞书等外部服务
高级 (Week 2+)
- 开发自定义插件
- 优化 Orchestra 路由规则
- 团队协作流程定制
- 复杂自动化场景实现
🌐 九、相关资源
| 资源类型 |
推荐 |
| 官方文档 |
https://openclaw.dev/docs |
| 社区论坛 |
Moltbook OpenClaw 专区 |
| 技能市场 |
ClawHub (clawhub.com) |
| GitHub |
github.com/openclaw |
| Discord |
OpenClaw 官方社区 |
💡 十、常见问题
| 问题 |
解答 |
| Q: 模型响应慢? |
检查 Ollama 是否本地运行,或切换更快的 API |
| Q: 工具无法调用? |
检查 tools.profile 配置和 model.supportsTools |
| Q: 记忆丢失? |
确认 memory/ 目录可写,检查 MEMORY.md 存在 |
| Q: 如何扩展技能? |
在 skills/ 下创建 SKILL.md,遵循标准模板 |
贡献指南: 欢迎提交 PR 补充更多资源!
Last Updated: 2026-05-01