OpenClaw 完全实战指南：从安装部署到高级玩法-(上)

子代理（Sub-agent）是 OpenClaw 处理复杂任务的核心机制。当主 AI 遇到可以并行的任务，会自动派遣多个子代理同步执行，而不是顺序等待。分析 100 个文件 → 拆分为 10 个子任务，每个处理 10 个收集 5 个竞品的定价信息（可并行）查看 5 个服务的在线状态（可并行）写一篇文章（写作需要连贯性）需要前一步结果才能开始的任务。

坡东

436人浏览 · 2026-04-21 22:18:14

坡东 · 2026-04-21 22:18:14 发布

OpenClaw 完全实战指南：从安装部署到高级玩法

作者整理自官方教程、社区实战案例及进阶配置文档。适合有一定 AI 使用基础、希望深度发掘 OpenClaw 能力的读者。

OpenClaw 到底是什么
安装与部署：三种方案的选择逻辑
初始配置：让 AI 真正认识你
Skill 体系：给 AI 装上"手"
记忆系统深度优化
代理商.md：AI 打工守则
子代理与多智能体协作
Cron 定时任务：让 AI 主动工作
多通道接入：飞书、钉钉、企业微信、QQ
SOP 方法论：从"偶尔好用"到"持续稳定"
高级技巧与避坑指南
实战变现：五条路径
深入原理：目录结构与文件系统
深入原理：Skill 加载与执行机制
深入原理：安全机制与沙箱
未来发展：OpenClaw 会走向哪里

一、OpenClaw 到底是什么

1.1 不是 ChatGPT，是"数字员工"

大多数人第一次听到 OpenClaw，会把它跟 ChatGPT 划等号。这是最大的误区。

ChatGPT 是顾问：你问一次它答一次，关掉窗口它什么都不记得。

OpenClaw 是员工：它住在你的电脑里，知道你硬盘里有什么，知道你上周解决了什么问题，知道你的工作习惯，甚至在你睡觉时还在帮你干活。

更准确的定义是：一个本地运行的自主 AI 代理（Agent）。

本地运行：数据不上传第三方服务器，全部留在你的设备上
自主代理：不只是被动回答问题，能主动执行任务、调用工具、管理文件、发送消息

OpenClaw 还有一个被严重低估的能力：心跳机制。它不需要等你发消息，满足某个条件时会主动找你——比如监控的竞品网站更新了，比如早上9点到了自动发日报，比如服务出现异常立即通知你。

这个"主动性"，是从工具跨越到员工最关键的一步。

1.2 工作原理

OpenClaw 的架构核心是一个 Gateway（网关）进程：

一个 Gateway 进程同时服务 WhatsApp、Telegram、Discord、飞书、钉钉等多种聊天平台，无需为每个平台单独部署。

1.3 ChatGPT vs OpenClaw 核心差异

1.4 与同类产品的核心差异

方面	OpenClaw	托管类 AI 聊天
部署	自托管，你控制一切	依赖厂商服务器
通道	多平台统一接入	通常单一 App 或网页
数据	在你自己的设备/服务器上	在厂商数据中心
扩展	插件、Skills、多 Agent	由厂商决定
成本	主要为 API 调用费用	订阅费或按用量计费

1.4 云端 vs 本地：为什么必须本地？

很多人觉得云端部署省事。但这里有一个根本性的能力差异：

本地运行能解锁 100% 的能力，云端部署只能解锁约 20%。

原因很直接：OpenClaw 需要操作你所有的文件。云端拿不到你电脑里的东西，能力被阉割。而本地运行可以直接获取文件系统权限、控制桌面应用、读写本地文件——这些在云端根本实现不了。

如果你只是想体验一下，云端可以。如果认真使用，必须本地部署。

二、安装与部署：三种方案的选择逻辑

2.1 三种方案对比

方案一：云厂商一键部署（体验版）

适合：完全不懂命令行、只想快速体验的用户。

阿里云：成本最低，可免费试用云服务器
- 进入 https://www.aliyun.com/，找到"4步部署Clawdbot专属AI员工"入口
腾讯云：低成本，可长期测试
- 进入 https://cloud.tencent.com/，选择轻量应用服务器，应用模版选择"OpenClaw(Clawdbot)"

注意：云端体验是阉割版，数据存在云端，能力有限。

方案二：本地一键安装（推荐）

适合：有 Mac 或 Windows 电脑、追求完整体验和最高隐私的用户。

Mac 用户尤其推荐，Mac 对本地文件操作、系统权限获取、应用间联动的支持远超其他平台。如果希望 24 小时运行且不影响主力机，可以用一台 Mac Mini 专门跑，一次性成本约 3000-4000 元。

方案三：Docker 部署

适合：懂基本 Docker 操作、对权限控制要求严格的技术用户。

2.2 本地安装步骤

第一步：安装依赖环境

安装 Node.js（≥ 22 版本）：访问 https://nodejs.org/zh-cn 下载安装。

验证安装：

node -v
npm -v
git -v

三行都返回版本号才算环境 OK。

第二步：安装 OpenClaw

npm i -g openclaw

就这一行。国内网络超时的话，先配置镜像源：

npm config set registry https://registry.npmmirror.com

第三步：运行引导向导

clawdbot onboard

按照引导配置：

同意免责声明
选择配置模式：QuickStart（快速入门）
Model/auth provider：初次可选"Skip for now"，后续配置
Filter models by provider：选"All providers"
Select channel：可先"Skip for now"
Configure skills now：选"No"，后续配置
Enable hooks：选"Session-memory"

第四步：启动网关

clawdbot gateway

或指定端口和详细日志：

clawdbot gateway --port 18789 --verbose

查看网关状态：

openclaw gateway status

控制台地址：http://127.0.0.1:18789/

2.3 配置 AI 模型

OpenClaw 支持多种模型，按使用场景选择：

等级	模型	适用场景	月费参考
顶配	Claude Opus	复杂推理、深度对话	~200美元
均衡	Claude Sonnet / GPT-4	日常任务、编码	~20-50美元
平替	通义千问、Moonshot、智谱GLM	基础工作流	~10美元

手动配置阿里百炼大模型（推荐国内用户）：

打开 https://bailian.console.aliyun.com/cn-beijing/#/home 并登录
菜单栏点击"模型服务"，进入模型主页
创建 API Key，保存备用
配置模型信息：

clawdbot config set 'models.providers.qwen' --json '{
  "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
  "apiKey": "sk-f******************你的Key",
  "api": "openai-completions",
  "models": [
    { "id": "qwen-max", "name": "Qwen Max" },
    { "id": "qwen-plus", "name": "Qwen Plus" },
    { "id": "qwen-turbo", "name": "Qwen Turbo" },
    { "id": "qwen3-coder-plus", "name": "Qwen3 Coder Plus" }
  ]
}'

设置默认模型：

clawdbot models set qwen/qwen-max

2.4 安装浏览器插件

打通 Chrome 浏览器，让 AI 能直接操作和分析浏览器内容：

clawdbot browser extension install

然后访问 chrome://extensions/，点击"加载未打包扩展"，路径填写：

~/.clawdbot/browser/chrome-extension

安装完成后，Chrome 右上角会出现小 🦞 图标。

三、初始配置：让 AI 真正认识你

3.1 三个核心身份文件

OpenClaw 工作空间里有三个定义"身份"的核心文件，大多数人装完之后这三个文件几乎是空的，导致 AI 只能用最通用的客服腔回复。

灵魂.md（SOUL.md） — 定义 AI 是谁、回复风格

# 核心原则

## 沟通风格
- 直接切入主题，不需要礼貌性寒暄
- 允许表达观点，不必保持绝对中立
- 简洁优先，但涉及技术细节时不省略关键信息

## 工作方式
- 优先尝试自主解决，确实需要时再询问
- 主动提供相关背景信息和替代方案

身份信息.md — 设置名称、形象标识

给 AI 明确的名称和角色标识，能提升多轮对话的一致性。

用户.md（USER.md） — 你是谁、你的背景

记录你的时区、技术背景、沟通偏好、职业信息，减少误解和无效建议。

3.2 配置 API Key 的正确姿势

不要直接从浏览器复制 API Key 粘贴进去！

正确步骤：

先把 Key 粘贴进纯文本编辑器（记事本）
确认是一行纯净字符串，没有换行符或格式符号
再从记事本复制粘贴进 OpenClaw

很多人配置失败排查半天，最终原因只是 Key 里混入了一个看不见的换行符。

四、Skill 体系：给 AI 装上"手"

4.1 Skill 是什么

Skill 是 OpenClaw 的能力模块，类似手机上的 App。没有 Skill，AI 有智力但没工具——再聪明也干不了事。

安装命令格式：

clawhub install <slug>
# 或
npx clawhub@latest install <slug>

4.2 安全警告（铁律）

不要随便安装 ClawHub 上的 Skill。

ClawHub 上的信任体系已出现严重问题：

恶意后门 Skill 已出现过
下载量可以刷，榜单可以被操控
有被多个国家开发者误装的带木马插件

正确姿势：先装安全扫描 Skill，再用它检查其他 Skill 的代码，确认安全后再安装。

4.3 新手必装清单（按优先级）

第一优先级：安全基础

# skill-vetter：安全扫描，后悔没先装
clawhub install skill-vetter

第二优先级：联网能力

# tavily-search：联网搜索，没有这个 AI 是"井底之蛙"
clawhub install tavily-search

第三优先级：让 AI 变聪明

# self-improving-agent：自我迭代，46k+ 安装量
clawhub install self-improving-agent

# proactive-agent：主动性，从被动变主动
clawhub install proactive-agent

第四优先级：日常生产力

# gog：Google Workspace 全家桶
clawhub install gog

# github：GitHub 集成，开发者必备
clawhub install github

第五优先级：信息处理

# summarize：总结 URL、PDF、视频、音频
clawhub install summarize

# find-skills：让 AI 自己去找合适的 Skill
clawhub install find-skills

第六优先级：长期记忆

# ontology：结构化记忆，越用越香
clawhub install ontology

知识管理完整链路（4 个 Skill 构成）：

# 搜索：覆盖17个国内外搜索引擎
npx clawhub@latest install multi-search-engine

# 解析国内平台链接（公众号、小红书、B站等）
pip install git+https://github.com/runesleo/x-reader.git

# Obsidian 知识库打通
npx clawhub@latest install obsidian

# 技能发现
npx clawhub@latest install find-skills

4.4 2026 精选 Skill 全景图（按场景分类）

安全警示： 2026年1月发生了"ClawHavoc"安全事件，341个恶意 Skill 借助拼写相似的名字（如把 clawhub 写成 clawhubb）分发了窃取 SSH Key 和浏览器 Cookie 的恶意代码。安装前务必遵守100/3 原则：下载量 ≥100、在 ClawHub 上架 ≥3个月，且 VirusTotal 扫描显示 Benign。

🔐 第一类：安全与基础能力

Skill	安装命令	核心功能	推荐指数
skill-vetter	`clawhub install skill-vetter`	扫描其他 Skill 代码，检测恶意行为。必须最先安装	⭐⭐⭐⭐⭐
Clawdbot Security Check	`clawhub install clawdbot-security`	对当前 OpenClaw 配置做全面只读安全审计，检查暴露的 Key 和过度权限	⭐⭐⭐⭐⭐
Capability Evolver	`clawhub install capability-evolver`	ClawHub 下载量第一（35,581次）。让 Agent 在运行过程中自主进化自己的能力，无需手动干预	⭐⭐⭐⭐⭐
Self-Improving Agent	`clawhub install self-improving-agent`	ClawHub 社区评分最高（132 Stars）。自动追踪交互错误、用户偏好，写入记忆，越用越聪明	⭐⭐⭐⭐⭐

🔍 第二类：搜索与信息处理

Skill	安装命令	核心功能	推荐指数
Tavily Search	`clawhub install tavily`	专为 AI Agent 设计的搜索引擎，返回结构化摘要而不是链接列表，减少搜索到行动的来回轮数	⭐⭐⭐⭐⭐
Felo Search	`clawhub install felo`	145,000+ 安装量，ClawHub 第二名。AI 合成答案 + 来源引用，中英文混合支持优秀，国内用户首选	⭐⭐⭐⭐⭐
Exa Search	`clawhub install exa`	开发者专用搜索，拉取 GitHub 仓库、技术文档和编程论坛，而非 SEO 博客。需要 `EXA_API_KEY`	⭐⭐⭐⭐
Summarize	`clawhub install summarize`	支持总结 URL、PDF、图片、YouTube 视频、音频，约10,000次安装，高频使用必备	⭐⭐⭐⭐⭐
Abstract Searcher	`clawhub install abstract-searcher`	学术研究专用：搜索 arXiv、Semantic Scholar、CrossRef，自动生成 `.bib` 引用文件	⭐⭐⭐⭐

💼 第三类：办公效率与 Google 生态

Skill	安装命令	核心功能	推荐指数
GOG（Google Workspace CLI）	`clawhub install gog`	14,000+ 安装。一条命令统一操作 Gmail、Google 日历、Drive、Contacts、Sheets、Docs，覆盖整个 Google 生态	⭐⭐⭐⭐⭐
Daily Briefing	`/briefing`	DoneClaw 社区最受欢迎排名第一。每天早7点汇总未读消息、日程、优先事项、天气，节省约15分钟手动检查时间	⭐⭐⭐⭐⭐
Expense Tracker	`/expense`	社区受欢迎排名第二。自然语言记账：`/expense ¥58 午饭`，自动分类、月度汇总、预算追踪	⭐⭐⭐⭐
Obsidian Direct	`npx clawhub@latest install obsidian`	直接往 Obsidian 知识库写入内容，打通"信息输入"和"知识沉淀"通道	⭐⭐⭐⭐⭐
Todoist	`clawhub install todoist`	自然语言管理任务清单，OpenClaw Master Skills 收录版本支持多 Agent 身份	⭐⭐⭐⭐
Calendar Sync	`clawhub install calendar-sync`	会议自动化，冲突检测与重排建议	⭐⭐⭐⭐

👨‍💻 第四类：开发者工具

Skill	安装命令	核心功能	推荐指数
GitHub	`clawhub install github`	约10,000次安装。封装 `gh` CLI，管理仓库、Issues、PR，自动生成 PR 描述，查看 CI 失败步骤，支持 JQ 过滤高级查询	⭐⭐⭐⭐⭐
Database Query	`clawhub install database-query`	95,000+ 安装，ClawHub 安装量前列。自然语言转 SQL，支持 PostgreSQL、MySQL、SQLite。重要：只用只读连接串，绝对不能指向生产写库	⭐⭐⭐⭐⭐
Agent Browser	`clawhub install agent-browser`	ClawHub 评分最高的浏览器自动化 Skill（43 Stars）。处理登录流程、多步骤表单交互、结构化数据提取，超越普通网页爬取	⭐⭐⭐⭐⭐
Vercel	`clawhub install vercel`	将自然语言命令翻译为 Vercel CLI 操作，一句话完成部署、回滚、调试，无需手动敲终端	⭐⭐⭐⭐
OpenAI Whisper	`clawhub install openai-whisper`	本地运行 Whisper 模型，快速准确转录音频/视频，数据不离开本地。需要 OpenAI API Key	⭐⭐⭐⭐
n8n Workflow	`clawhub install n8n-workflow-automation`	通过对话控制本地 n8n 实例，触发复杂多步骤自动化工作流，数据全程本地，无订阅费	⭐⭐⭐⭐⭐

📱 第五类：国内平台与消息自动化

国内平台（微信、钉钉、飞书）的接入主要通过 Channel 插件而非普通 Skill 实现，见第九章。以下为消息自动化相关 Skill。

Skill / 方案	安装方式	核心功能	说明
飞书 Channel（官方支持）	`clawdbot channels add` → 选飞书	接收飞书消息并自动回复，支持私聊和群聊 @	官方原生支持，稳定性最高
钉钉 Channel（一键部署）	`curl` 脚本安装，见第九章	接收钉钉消息自动回复，群组 @ 触发	通过 Docker Compose 部署，国内延迟低
企业微信 Channel	`clawdbot plugins install wecom`	企业微信机器人，接收消息并调用 AI 回复	需要公网 IP 做 Webhook
QQ Channel	`git clone qqbot && clawdbot plugins install`	QQ 群/私聊自动回复	需要 QQ 开放平台注册
WhatsApp CLI Skill	`clawhub install whatsapp-cli`	通过自然语言起草、审批并发送 WhatsApp 消息（支持 hands-free 模式）	适合有海外业务场景
Standup Report	`/standup`	自动从团队活动生成每日站会摘要，发送到钉钉/飞书群组	适合研发团队

关于微信转账（WeCom Pay）的说明：

OpenClaw 对微信的接入仅通过浏览器自动化（控制微信网页版），无法直接调用微信支付 API。原因是微信支付属于金融级接口，需要企业主体资质认证，个人开发者无法直接接入。如需支付自动化，可用的替代方案：

🎨 第六类：内容创作与营销

Skill	安装命令	核心功能	推荐指数
Felo SuperAgent	`clawhub install felo-superagent`	多合一创作工作台：实时流式输出 + 持久 LiveDoc 画布 + 6个内置工具（图片生成、深度研究报告、PPT生成、HTML页面、X搜索）	⭐⭐⭐⭐⭐
Felo Slides	`clawhub install felo-slides`	从文字描述生成可编辑的专业 PPTX，每个元素独立可编，不同于图片式生成器	⭐⭐⭐⭐
SEO Research	`clawhub install seo-research`	代理商评测高 ROI 第一。自动化关键词研究、SERP 分析、竞品内容监控，替代每周3-4小时手动操作	⭐⭐⭐⭐⭐
Social Scheduler	`clawhub install social-scheduler`	跨社交平台内容计划和发布调度	⭐⭐⭐⭐
B2C Marketing	`clawhub install b2c-marketing`	有机增长 Playbook，案例背书：带来300K+ App 下载量	⭐⭐⭐⭐
Campaign Orchestrator	`clawhub install campaign-orchestrator`	多渠道跟进活动编排（邮件+社交+消息平台），适合产品发布和 ABM 序列	⭐⭐⭐⭐
ElevenLabs Agent	`clawhub install elevenlabs-agent`	语音 AI + 电话兜底机制：如果邮件或短信发送失败，自动改为拨打电话	⭐⭐⭐⭐

🏗️ 第七类：业务与销售

Skill	安装命令	核心功能	推荐指数
Composio	`npx skills add composiohq/skills`	一次安装解锁 860+ 外部服务（GitHub、Slack、Gmail、Stripe 等），统一处理认证和 API 调用	⭐⭐⭐⭐⭐
Apollo	`clawhub install apollo`	对接 Apollo.io，自动化人员和公司数据富集、搜索和列表管理，适合出海销售团队	⭐⭐⭐⭐
Alibaba Supplier Outreach	`clawhub install alibaba-supplier`	在阿里巴巴搜索供应商，发送优化后的询盘信息并追踪回复，跨境电商和供应链开发利器	⭐⭐⭐⭐
Agent Team Orchestration	`clawhub install agent-team`	多 Agent 团队协作：定义角色、任务生命周期、交接协议和审查工作流	⭐⭐⭐⭐⭐
Home Assistant	`clawhub install home-assistant`	自然语言控制 Home Assistant，本地运行零云依赖	⭐⭐⭐

💡 推荐安装路径（从零到完整）

4.5 Skill 文件：最重要却最常被跳过的一步

Skill 文件（放在 workspace/skills/ 文件夹里的配置文件）是告诉 AI 具体该怎么表现的"操作手册"。

没有 Skill 文件的 AI 会干什么？

在同一个失败方法上循环六次，不换思路
编辑没有权限的配置文件，把项目搞崩
跳过文档自己瞎编解决方案，制造更大的问题

这不是模型不聪明，是 Agent 没有"护栏"。

一个实战案例：强制要求"做任何改动之前，先读文档"。AI 天生喜欢即兴发挥，强制"先读再做"工作流后，错误率直接砍了一半。

五、记忆系统深度优化

5.1 分层记忆结构

默认的 内存.md 往往有两个问题：要么被闲置，要么变成"什么都往里塞"的垃圾场。有效记忆需要分层：

MEMORY.md 只做索引，不直接承载大段内容。每次会话启动先加载索引，需要细节时再读取对应文件。

5.2 启用 memoryFlush 防止"失忆"

问题场景： 长时间深度讨论后，AI 的回复开始变得"健忘"。

原因： 每个 AI 模型都有上下文限制（如 Claude 是 200K tokens）。当对话接近上限时，OpenClaw 触发自动压缩，压缩过程可能丢失细节。

解决方案： 启用 memoryFlush。在压缩触发前，先让 AI 将重要信息写入文件，再执行压缩。

编辑 openclaw.json：

{
  "agents": {
    "defaults": {
      "compaction": {
        "reserveTokensFloor": 20000,
        "memoryFlush": {
          "enabled": true,
          "softThresholdTokens": 4000
        }
      }
    }
  }
}

参数说明：

reserveTokensFloor：压缩后保留的最小 token 数，推荐 20000
memoryFlush.enabled：是否启用，强烈建议 true
memoryFlush.softThresholdTokens：提前触发的 token 阈值，推荐 4000

5.3 语义记忆搜索（memorySearch）

配置 memorySearch 后，AI 不需要逐行扫描所有历史，可以直接语义定位到相关记录。

{
  "memorySearch": {
    "enabled": true,
    "provider": "openai",
    "remote": {
      "baseUrl": "https://api.siliconflow.cn/v1",
      "apiKey": "你的_SiliconFlow_API_Key"
    },
    "model": "BAAI/bge-m3"
  }
}

推荐使用 SiliconFlow 的 bge-m3 模型：

成本：提供免费额度，个人使用足够
多语言：对中英文混合文本支持良好
性能：维度1024，精度和速度平衡

获取 SiliconFlow API Key：访问 siliconflow.cn 注册，进入控制台创建 API Key。

5.4 高质量日志格式

搜索能不能命中，很大程度取决于日志格式。

❌ 低质量日志（命中率低）：

今天工作内容：上午处理了数据库备份问题，中午部署了新版本，下午修改了nginx配置，晚上写了一些文档。nginx那边改了反向代理，具体记不太清了，反正最后跑起来了。

✅ 高质量日志（命中率高）：

【项目：WebApp】Nginx反向代理配置完成
- 结果：使用 Nginx 反向代理部署成功，监听 443 端口
- 相关文件：/etc/nginx/sites-available/webapp.conf
- 经验教训：upstream必须使用127.0.0.1而非localhost（避免IPv6问题）
- 检索标签：#nginx #deploy #webapp #reverse-proxy

三个关键要素：

使用标签（如 #部署nginx）能显著提升召回率
固定格式使关键信息集中，易于匹配
一条日志只记录一件事，避免信息混杂

5.5 自动记忆维护（防止记忆"老化"）

在 workspace/HEARTBEAT.md 中添加维护任务：

# 记忆维护任务（每周执行）

检查状态文件。
如果距今超过7天，执行以下维护流程：
1. 读取最近7天的日志文件 `memory/YYYY-MM-DD.md`
2. 提炼有长期价值的信息，归档到对应文件：
   - 问题解决方案 → `memory/lessons.md`
   - 项目决策和状态 → `memory/projects.md`
3. 压缩已完成的一次性任务为一行总结
4. 删除完全过期的临时信息
5. 更新 `heartbeat-state.json` 中的 `lastMemoryMaintenance` 为当前日期

六、代理商.md：AI 打工守则

6.1 为什么需要代理商.md

灵魂.md 解决"AI 是谁"，用户.md 解决"用户是谁"，但都没有告诉 AI"如何工作"。

代理商.md（AGENTS.md） 是 AI 的工作流程手册，定义：

会话启动时应读取哪些文件
记忆应如何组织和存储
哪些操作需要用户确认
如何处理不同类型的任务

6.2 完整 AGENTS.md 模板

保存到 workspace/AGENTS.md：

# AGENTS.md - 工作空间规范

这是你的工作空间，请按照以下规范工作。

## Session 启动流程
每次会话开始时，按以下顺序自动执行：
1. 读取 `SOUL.md` - 加载性格和行为风格
2. 读取 `USER.md` - 了解用户背景和偏好
3. 读取 `memory/YYYY-MM-DD.md` - 加载今天和昨天的日志
4. 如果是主会话：额外读取 `MEMORY.md` - 加载核心记忆索引

以上操作无需询问，自动执行。

## 记忆管理规范
你每次启动都是全新状态，这些文件是你的记忆延续。

| 层级   | 文件路径                  | 存储内容 |
|--------|---------------------------|----------|
| 索引层 | `MEMORY.md`               | 核心信息和记忆索引，保持精简 |
| 项目层 | `memory/projects.md`      | 各项目当前状态和待办 |
| 经验层 | `memory/lessons.md`       | 问题解决方案，按重要性分级 |
| 日志层 | `memory/YYYY-MM-DD.md`    | 每日详细记录 |

## 写入规则
- 日志写入 `memory/YYYY-MM-DD.md`，记录结论而非过程
- 项目变更时同步更新 `memory/projects.md`
- 遇到问题时记录到 `memory/lessons.md`
- `MEMORY.md` 仅在索引变化时更新
- 重要信息必须写入文件，不要依赖记忆

## 日志格式
【项目：名称】事件标题
结果：一句话概括
相关文件：文件路径
经验教训：要点（如有）
检索标签：#tag1 #tag2

## 安全规范
- 不得泄露私人数据
- 破坏性操作前必须确认
- 使用 `trash` 而非 `rm`（可恢复优于永久删除）
- 不确定时先询问

## 群聊规范
你可以访问用户的文件和记忆，但不能在群聊中分享。
在群聊中，你是参与者，不是用户的代言人。

## 工具使用
Skills 提供你的工具能力。需要使用某个工具时，查看其 `SKILL.md` 文档。

6.3 操作权限分级

可以自由执行：

读取文件、浏览目录
搜索网络信息
查询日历和邮件
在 workspace 内部工作

需要用户确认：

发送邮件、推文、公开消息
任何向外部发送数据的操作
删除或修改重要文件
不确定后果的操作

七、子代理与多智能体协作

7.1 什么是子代理

子代理（Sub-agent）是 OpenClaw 处理复杂任务的核心机制。当主 AI 遇到可以并行的任务，会自动派遣多个子代理同步执行，而不是顺序等待。

适合用子代理的任务：

分析 100 个文件 → 拆分为 10 个子任务，每个处理 10 个
收集 5 个竞品的定价信息（可并行）
查看 5 个服务的在线状态（可并行）

不适合子代理的任务：

写一篇文章（写作需要连贯性）
需要前一步结果才能开始的任务

7.2 多智能体配置：搭一家 AI 公司

通过 / 快速切换不同 Agent 配置：

/research  → 信息搜集和分析，配置 Sonnet 模型节省成本
/build     → 写代码和开发功能，配置 Opus 保证质量
/quant     → 数据分析和量化研究
/content   → 内容创作

每个 Agent 可以有：

独立的 SOUL.md（人格与职责定义）
不同的模型配置
独立的 Skill 组合
不同的权限边界

7.3 Discord 多 Bot 协作架构

Discord 支持让多个 OpenClaw Bot 共存、互相分享 Skill，由"总管 Agent"统筹调度。

角色化配置示例：

角色	职责	推荐模型
总管龙虾（CEO）	统筹调度、任务分配、向你汇报	Opus
市场龙虾	监控竞品、抓取热点、产出内容草稿	Sonnet
研发龙虾	编写代码、测试、管理 GitHub	Opus
运营龙虾	收支报表、监控异常交易	Sonnet
客服龙虾	接收反馈、分类整理、跟踪处理	Haiku

省钱技巧：Discord 的每个 Channel 支持独立配置不同 AI 模型。

PA Channel（日常对话）    → Claude Sonnet，够用且便宜
Tech Channel（技术问题）  → Opus，需要最强智力
读书 Channel（内容摘要）  → Gemini Flash，轻量快速，成本接近于零

切换方式：在对应 Channel 里输入 /model + 模型名。

八、Cron 定时任务：让 AI 主动工作

8.1 创建 Cron 任务

方式一：通过对话创建

你：创建一个定时任务，每天早上8点发送今日简报
AI：我将为你创建定时任务...
    - 任务名称：daily-briefing
    - 执行时间：每天08:00
    - 任务内容：发送天气、日程、新闻摘要
    已创建成功！

方式二：手动配置

编辑 workspace/crons/daily-briefing.json：

{
  "name": "daily-briefing",
  "schedule": "0 8 * * *",
  "timezone": "Asia/Shanghai",
  "task": {
    "content": "发送今日简报：天气、日程、重要新闻",
    "type": "message"
  },
  "enabled": true
}

8.2 Cron 表达式速查

格式：分钟小时日期月份星期

表达式	含义
`0 8 * * *`	每天 8:00
`0 8 * * 1-5`	工作日 8:00
`0 /2 * *`	每 2 小时
`30 18 * * 1-5`	工作日 18:30
`0 0 * * 0`	每周日 0:00
`0 9 1 * *`	每月 1 号 9:00

在线工具：crontab.guru 可以生成和验证 Cron 表达式。

8.3 实用 Cron 任务示例

每日早报：

{
  "name": "morning-briefing",
  "schedule": "0 8 * * *",
  "timezone": "Asia/Shanghai",
  "task": {
    "type": "message",
    "content": "早安！今日简报：\n1. 查询天气\n2. 读取今日日程\n3. 总结昨日工作日志\n4. 提醒今日待办事项"
  },
  "enabled": true
}

服务监控（每30分钟）：

{
  "name": "service-monitor",
  "schedule": "*/30 * * * *",
  "timezone": "Asia/Shanghai",
  "task": {
    "type": "check",
    "content": "检查以下服务状态：\n1. 网站是否可访问\n2. API响应时间\n3. 数据库连接\n如有异常立即通知"
  },
  "enabled": true
}

管理 Cron 任务：

openclaw cron list                     # 查看所有任务
openclaw cron disable daily-briefing   # 禁用任务
openclaw cron enable daily-briefing    # 启用任务
openclaw cron remove daily-briefing    # 删除任务
openclaw cron run daily-briefing       # 手动触发（测试用）

8.4 心跳机制（HEARTBEAT.md）

心跳是比 Cron 更轻量的周期检查机制。在 workspace/HEARTBEAT.md 中定义：

# HEARTBEAT.md

# 每次心跳执行
- 检查核心服务健康状态（HTTP 探测）
- 发现异常时立即通知，但不要自动干预

# 每日执行一次
- 扫描项目待办，标记超过 3 天未更新的任务

# 每周执行一次
- 汇总过去 7 天对话日志，提炼关键信息到长期记忆

心跳 vs Cron 的区别：

心跳：轻量周期检查，可批量执行多个小任务
Cron：精确时间触发的独立任务（如"每周一 9 点生成周报"）

龙虾开发者社区

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地，聚焦技能开发、插件实践与部署教程，为开发者提供可直接落地的方案、工具与交流平台，助力高效构建与落地 AI 应用

更多推荐

ClawBridge 网关日志审计：如何避免 Slack 事件重复处理与权限疲劳

龙虾开发者社区

从零构建本地AI Agent网关：ClawBridge在沙箱与工具调用中的实战踩坑

龙虾开发者社区

密钥管理实战：如何避免多模型路由场景下的 API Key 泄露风险

龙虾开发者社区

所有评论(0)

查看更多评论

坡东

@quyixiao

已为社区贡献4条内容

OpenClaw 完全实战指南：从安装部署到高级玩法-(上)

坡东

OpenClaw 完全实战指南：从安装部署到高级玩法

目录

一、OpenClaw 到底是什么

1.1 不是 ChatGPT，是"数字员工"

1.2 工作原理

1.3 ChatGPT vs OpenClaw 核心差异

1.4 与同类产品的核心差异

1.4 云端 vs 本地：为什么必须本地？

二、安装与部署：三种方案的选择逻辑

2.1 三种方案对比

2.2 本地安装步骤

2.3 配置 AI 模型

2.4 安装浏览器插件

三、初始配置：让 AI 真正认识你

3.1 三个核心身份文件

3.2 配置 API Key 的正确姿势

四、Skill 体系：给 AI 装上"手"

4.1 Skill 是什么

4.2 安全警告（铁律）

4.3 新手必装清单（按优先级）

4.4 2026 精选 Skill 全景图（按场景分类）

🔐 第一类：安全与基础能力

🔍 第二类：搜索与信息处理

💼 第三类：办公效率与 Google 生态

👨‍💻 第四类：开发者工具

📱 第五类：国内平台与消息自动化

🎨 第六类：内容创作与营销

🏗️ 第七类：业务与销售

💡 推荐安装路径（从零到完整）

4.5 Skill 文件：最重要却最常被跳过的一步

五、记忆系统深度优化

5.1 分层记忆结构

5.2 启用 memoryFlush 防止"失忆"

5.3 语义记忆搜索（memorySearch）

5.4 高质量日志格式

5.5 自动记忆维护（防止记忆"老化"）

六、代理商.md：AI 打工守则

6.1 为什么需要代理商.md

6.2 完整 AGENTS.md 模板

6.3 操作权限分级

七、子代理与多智能体协作

7.1 什么是子代理

7.2 多智能体配置：搭一家 AI 公司

7.3 Discord 多 Bot 协作架构

八、Cron 定时任务：让 AI 主动工作

8.1 创建 Cron 任务

8.2 Cron 表达式速查

8.3 实用 Cron 任务示例

8.4 心跳机制（HEARTBEAT.md）

所有评论(0)

温馨提示：您尚未绑定手机号

坡东