OpenClaw
跑在你自己机器上的
AI 助手

OpenClaw 的设计是 “可信 Gateway + 受限执行 + 确定性策略”：Gateway 值得信任，具体执行受沙箱和工具策略约束。但必须正视几件事：

• 提示注入仍未解决 —— 这是整个行业级的未解难题，务必用强模型并阅读官方安全指南。
• 一个 Gateway 就是一个信任域 —— 只分享给彼此信任的人；互不信任的用户请各开各的 Gateway。
• 能执行意味着有风险 —— 用好审批、沙箱、工具白名单，让智能体起草、你审批。

✅ 好的做法

• 直接说人话：“把上周的会议纪要整理成一个待办清单”
• 给上下文：“我在写一个 Python 爬虫，帮我看下这段代码”
• 让它记住：“记住我更喜欢用 TypeScript” —— 它会写进记忆文件
• 分阶段：“先做调研，然后写大纲，最后实现” —— 大任务拆开效果更好

🧩 值得尝试的第一个项目

• 建个网站（WordPress、Shopify 或静态站）
• 设计一个 App 的原型（大纲、界面、API 规划）
• 整理散落的文件和文件夹
• 接上 Gmail，自动生成摘要或跟进邮件
• 每天早上的个人简报（收件箱 + 日历 + 新闻）
• 浏览器自动化：填表单、采数据、跑重复性网页任务
• 跨设备协作：手机下任务，服务器上跑，结果回聊天里

• 默认开启 —— 关闭：plugins.entries.memory-core.config.dreaming.enabled: false
• 自动调度 —— 开启后 memory-core 插件自动管理一个周期性任务做完整梦境扫描
• 有门槛 —— 只有通过分数、召回频次、查询多样性三道闸门的候选才能晋升
• 防污染 —— 不可信内容和系统派生内容永远不会进入整理流程或持久化路径
• 可审阅 —— 每个阶段的摘要写进 DREAMS.md，你来决定认不认

导入已有记忆

Control UI 里 Settings → Import Memory，可以从 Codex、Claude Code、Hermes 导入现成的本地记忆。只复制 Markdown，源代码文件保持不变。

openclaw memory status        # 索引与供应商状态
openclaw memory search "关键词"  # 命令行搜索
openclaw memory index --force # 重建索引

一个技能就是一个文件夹，里面必须有 SKILL.md。最小版本长这样：

---
name: hello-world
description: 一个会打招呼的简单技能
---

# Hello World

当用户要求打招呼时，用 `exec` 工具运行：

```bash
echo "Hello from your custom skill!"
```

命名规则：只用小写字母、数字和连字符；目录名和 frontmatter 里的 name 保持一致；description 会展示给智能体、也出现在斜杠命令发现列表里，保持一行、160 字符以内。

引用技能内的文件

用 {baseDir} 引用技能自己的目录，不要硬编码路径：

运行 `{baseDir}/scripts/run.sh` 这个辅助脚本。

按条件加载（gating）

依赖不满足时自动不加载，避免让智能体去调一个不存在的命令：

---
name: gemini-search
description: 用 Gemini CLI 搜索
metadata:
  openclaw:
    requires:
      bins: ["gemini"]
    primaryEnv: "GEMINI_API_KEY"
---

可用的 gating 字段：requires.bins（全部存在）、requires.anyBins（至少一个）、requires.env、requires.config、os（如 ["darwin"]）、always。

🔧 故障排查库

按报错原文检索，而不是让你猜。比如「npm blocked because they are not covered by allowScripts」「unauthorized token」「polling stall」，每条给出根因 + 命令 + 成功判据。

🪟 Windows / WSL2 全记录

这是官方文档里最分散的部分，也是最容易卡住的地方。计划任务被拒、端口占用、WSL IP 漂移、计划任务队列状态判读 —— 全部整理成可复制的步骤。

🧩 实战案例拆解

不写玩具 demo。写「用 OpenClaw 每天自动汇总行业情报」「多智能体分渠道接单」这类真实流程，含提示词、失败重试、权限边界。

🎁 会员技能包

自研技能，MIT-0 授权，附带完整 SKILL.md 源码讲解，让你能改能学。

• 基础教程永远免费 —— 安装、渠道、记忆、自动化这些不会收费，也不会锁。
• 付费的是「时间」 —— 官方文档有的内容不重复收费，只卖我实测踩坑换来的部分。
• 不会卖隐私 —— 不接第三方追踪脚本，不做用户画像转卖。
• 不催续费 —— 到期就降级，不搞弹窗轰炸。