第六章:参考与附录
约 1662 字大约 6 分钟
本章包含项目致谢、OpenClaw 的诞生故事、ClawHub 技能市场、安全合作伙伴关系,以及社区资源。
6.1 项目介绍与命名历程
OpenClaw 的诞生
OpenClaw 最初是 Peter Steinberger(@steipete)在 2025 年 11 月利用周末时间开发的个人项目,当时名为 "WhatsApp Relay"。
命名演变历史:
| 名称 | 时间 | 原因变更 |
|---|---|---|
| Clawd | 2025年11月 | "Claude" + "claw" 的双关,Anthropic 法务要求更名 |
| Moltbot | 过渡期 | 源于脱壳(Molting)隐喻,但不够朗朗上口 |
| OpenClaw | 最终版本 | Open(开源)+ Claw(龙虾爪),商标清查通过 |
名称含义:OpenClaw = CLAW + TARDIS,因为每只太空龙虾都需要一台时空机器。
项目里程碑
- 发布 2 个月后:GitHub 突破 10 万 Star
- 单周访问量:超过 200 万次
- 社区:数万名活跃用户,Discord 持续增长
6.2 核心团队与致谢
创始人
- Peter Steinberger(@steipete)— 创始人,龙虾驯服师
主要贡献者
| 贡献者 | 贡献内容 |
|---|---|
| Mario Zechner(@badlogicc) | Pi 创建者,安全渗透测试 |
| Maxim Vovshin(@Hyaxia) | 博客监控技能 |
| Nacho Iacovino(@nachoiacovino) | 位置解析(Telegram 和 WhatsApp) |
| Vincent Koc(@vincentkoc) | 智能体、遥测、Hooks、安全 |
安全顾问
- Jamieson O'Reilly — Dvuln 创始人,Aether AI 联合创始人,CREST 顾问委员会成员
开源协议
MIT 协议 — 像海洋中的龙虾一样自由。
"我们都只是在玩弄自己的提示词。"(某 AI,大概是 Token 用多了)
6.3 ClawHub 技能市场
ClawHub 是 OpenClaw 的官方技能市场,提供社区创建的技能扩展。
什么是技能(Skill)
技能是 OpenClaw 的扩展包,让 AI 助手学会新的能力:
- 控制智能家居设备
- 管理财务和账单
- 自动化工作流程
- 集成第三方服务
安全保障:VirusTotal 扫描
OpenClaw 与 VirusTotal 合作,为 ClawHub 所有技能提供安全扫描:
扫描流程:
- 确定性打包 — 技能文件打包为 ZIP(含一致的压缩设置和时间戳)
- 哈希计算 — 计算整个包的 SHA-256 哈希
- VirusTotal 查找 — 与 VirusTotal 数据库比对
- 上传分析 — 未发现记录时,上传进行新鲜扫描
- Code Insight 分析 — 由 Gemini 驱动的安全代码分析,从 SKILL.md 开始分析整个技能包
- 自动审批 — "benign"(良性)自动审批,"suspicious"(可疑)标注警告,"malicious"(恶意)立即阻止
- 每日重扫 — 所有活跃技能每天重新扫描
扫描能检测的内容:
- 已知恶意软件(木马、窃密软件、后门)
- 可疑的代码行为模式
- 供应链攻击和被篡改的依赖
- 嵌入的恶意载荷
扫描不能替代的:
- 人工代码审查
- 提示词注入攻击检测
- 对发布者的信任评估
使用技能的安全建议
- 查看技能页面上的 VirusTotal 扫描状态
- 优先使用来自信任发布者的技能
- 检查技能申请的权限
- 对可疑行为向 security@openclaw.ai 报告
6.4 用户案例精选
以下是来自社区的真实使用案例(来自官网):
个人生产力
"管理收件箱、发邮件、管日历、办理航班值机。全都从我已经在用的 WhatsApp 或 Telegram 完成。"
"我用手机在遛狗时发消息,它在和 Codex CLI 通信,在我电脑上创建详细的规范文件。🤯"
"我让 OpenClaw 写了定制冥想内容,然后自动 TTS 转语音,配上生成的环境音乐做成个性化冥想。"
开发工作
"Claude Max 订阅 + Claw,管理 Claude Code/Codex 会话,自动运行测试、捕获 Sentry 错误、修复并开 PR……未来已到来。"
"我终于试了 OpenClaw,发现它能自主评估如何帮我工作。它把两个不同沟通渠道的完全不相关对话连接起来写了一份文档。"
基础设施控制
"我的 @openclaw 意识到它需要 API Key……它打开了浏览器……打开了 Google Cloud Console……配置了 OAuth 并分配了新 Token。"
"我让它构建一个终端 CLI 工具来查询航班,支持多个提供商。全程无需我动手。"
家庭自动化
"我的树莓派装上 Cloudflare 和 OpenClaw,感觉神奇✨ 从手机几分钟内搭建了网站,连上 WHOOP 获取健康数据。"
"我的 Winix 空气净化器,Claude Code 在几分钟内发现并确认控制功能有效。现在 OpenClaw 根据我的生物指标优化目标控制房间空气质量。"
6.5 快速帮助入口
遇到问题时的第一步
# 1. 运行诊断
openclaw doctor
# 2. 查看日志
openclaw logs --follow
# 3. 完整状态检查
openclaw status --all
# 4. 深度诊断
openclaw gateway status --deep常见问题解决
| 问题 | 快速检查 |
|---|---|
| Gateway 不启动 | openclaw doctor |
| 渠道无回复 | openclaw channels status --probe |
| 安装路径问题 | 检查 Node/npm PATH |
| 配置错误 | openclaw doctor --fix |
帮助资源
- 官方文档:https://docs.openclaw.ai
- 故障排查:https://docs.openclaw.ai/help/troubleshooting
- FAQ:https://docs.openclaw.ai/help/faq
- 安全信任页:https://trust.openclaw.ai
- 安全报告:security@openclaw.ai
6.6 社区与资源
| 资源 | 链接 |
|---|---|
| 官网 | https://openclaw.ai |
| GitHub | https://github.com/openclaw/openclaw |
| Discord 社区 | https://discord.com/invite/clawd |
| ClawHub 技能市场 | https://clawhub.ai |
| 官方文档 | https://docs.openclaw.ai |
| 安全信任页 | https://trust.openclaw.ai |
| 博客 | https://openclaw.ai/blog |
| 案例展示 | https://openclaw.ai/showcase |
6.7 积分与 API 费用说明
OpenClaw 本身是免费开源的。运行费用主要来自:
AI 模型费用
- OpenClaw 调用你配置的 AI 提供商(Anthropic、OpenAI 等)
- 每次对话消耗 Token,按提供商定价计费
- 心跳任务(Heartbeat)每次也消耗 Token
节约建议
- 初期禁用心跳:
"heartbeat": {"every": "0m"} - 使用较轻模型做日常任务,Opus 系列用于复杂任务
- 合理设置
thinkingDefault:普通任务不需要"high" - 启用图像压缩:
"imageMaxDimensionPx": 800减少视觉 Token
免费/低成本选项
- Venice AI(
venice/llama-3.3-70b):隐私优先,官方推荐的低成本选项 - Qwen、Moonshot 等国内提供商:有相对低廉的定价
- OpenRouter:可统一访问多个提供商,灵活切换
6.8 教程文件索引
本教程基于 OpenClaw 官方文档整理,涵盖以下内容:
| 章节 | 主要内容 |
|---|---|
| 第一章:入门指南 | 安装、快速配置、Telegram/WhatsApp 配置、心跳任务 |
| 第二章:核心概念 | 系统架构、WebSocket 协议、多智能体路由 |
| 第三章:平台与渠道 | 支持平台、各渠道配置、Web 控制界面 |
| 第四章:工具与功能 | 所有内置工具、节点系统、AI 提供商、CLI 参考 |
| 第五章:网关配置 | 完整配置、远程访问、安全加固、故障排查 |
| 第六章:参考与附录 | 项目背景、ClawHub、社区资源 |
