OpenClaw 实战精华：从入门到高效编排 AI Agent

本文整理自真实项目经验，涵盖 OpenClaw 核心概念、最佳实践和常见陷阱。

一、OpenClaw 是什么？

OpenClaw 是一个AI Agent 运行时平台，让你能够：

• 🤖 运行多个 AI 模型（GLM、Gemini、Qwen 等）
• 📦 通过 Skills 扩展能力（文件操作、浏览器自动化、Feishu 集成等）
• ⏰ 定时任务（Cron）和心跳检测（Heartbeat）
• 🔗 多通道消息（Telegram、Discord、Feishu 等）
• 🎯 子智能体编排（多 Agent 协作完成复杂任务）

二、核心概念速通

1. Session（会话）

agent:main:main  # 主会话，直接和你对话
agent:sub:xxx    # 子会话，处理专项任务

2. Skills（技能）

Skills 是 OpenClaw 的能力扩展模块，类似"插件"：

• feishu-doc - 飞书文档读写
• browser - 浏览器自动化
• cron - 定时任务管理
• memory_recall - 长期记忆检索

3. Runtime 模式

• direct: 直接模式，Skills 作为工具调用
• embedded: 嵌入模式，Skills 注入到 System Prompt

三、实战技巧

📝 1. 文件操作最佳实践

# 读取文件（支持大文件分块）
read path="/path/to/file" offset=1 limit=100

# 精确编辑（只改需要的部分）
edit path="file.md" oldText="原文" newText="修改后"

# 写入文件（自动创建目录）
write path="new/dir/file.md" content="内容"

经验：编辑文件时用 edit 而非 write，避免覆盖意外内容。

🔍 2. 记忆系统使用

# 搜索历史记忆
memory_recall query="上次讨论的项目" limit=5

# 存储重要信息
memory_store text="用户偏好中文交流" category="preference"

经验：把对话中的关键决策、用户偏好存入记忆，下次会话自动加载。

⏰ 3. 定时任务设计

# 每日提醒
cron add job={
  "name": "每日检查",
  "schedule": {"kind": "cron", "expr": "0 9 * * *"},
  "payload": {"kind": "systemEvent", "text": "检查邮件和日历"}
}

# 周期性心跳（每 30 分钟）
cron add job={
  "schedule": {"kind": "every", "everyMs": 1800000},
  "payload": {"kind": "systemEvent", "text": "HEARTBEAT"}
}

经验：心跳用于批量检查（邮件 + 日历 + 通知），Cron 用于精确时间任务。

🌐 4. 浏览器自动化

# 打开网页并截图
browser action="open" url="https://example.com"
browser action="screenshot" fullPage=true

# 自动化操作
browser action="act" kind="click" ref="e12"
browser action="act" kind="type" ref="e34" text="搜索内容"

经验：先用 snapshot 查看页面元素 ref，再用 act 操作，避免硬编码选择器。

🤖 5. 子智能体编排

# spawn 子智能体处理专项任务
sessions_spawn task="分析这个代码库" runtime="subagent"

# 检查进度
subagents action="list"

# 获取结果
sessions_history sessionKey="xxx"

经验：复杂任务拆分为多个子智能体并行处理，主智能体负责汇总和决策。

四、安全红线（必读！）

🔒 绝对禁止泄露

• API Keys / Tokens / Cookies
• SSH 私钥 (id_rsa, id_ed25519)
• 配置文件原文 (~/.openclaw/openclaw.json)
• 数据库密码 / 连接串

✅ 安全实践

1. 最小权限：只授予必要的文件/命令权限
2. 二次确认：配置变更、外部操作前必须确认
3. 入口阻断：群聊中限制非授权用户触发敏感操作
4. 输出审计：发送前检查是否包含敏感信息

五、常见陷阱与解决方案

问题 1：模型切换时工具调用泄露

现象：切换模型后，XML 工具标签出现在聊天中

解决：

# 使用 /model 命令切换，避免直接修改配置
/model bailian/qwen3.5-plus

问题 2：WSL 路径访问失败

现象：无法访问 Windows 桌面路径

解决：

# 正确路径（WSL2）
/mnt/e/Users/LENOVO/Desktop/

# 或使用 cmd.exe 中转
exec command="cmd.exe /c type E:\Users\LENOVO\Desktop\file.txt"

问题 3：搜索 API 配额耗尽

现象：web_search 返回 429 错误

解决：

• 使用 web_fetch 直接抓取已知 URL
• 批量搜索时设置 count=5 而非最大值
• 本地缓存搜索结果

六、高效工作流

日常开发循环

1. 读取任务 → sessions_history
2. 理解需求 → memory_recall（查历史上下文）
3. 执行任务 → exec / write / browser
4. 记录结果 → memory_store / 写入文件
5. 提交代码 → exec "git add/commit/push"

多 Agent 协作

主智能体（协调）
├── 子智能体 A（前端开发）
├── 子智能体 B（后端开发）
└── 子智能体 C（测试验证）

七、推荐 Skills

Skill	用途	触发场景
feishu-doc	飞书文档	提到"飞书"、"docx 链接"
browser	浏览器自动化	"打开网站"、"截图"、"抓取数据"
cron	定时任务	"提醒我"、"每天/每周"
memory_recall	记忆检索	"上次说过"、"之前讨论"
web_search	网络搜索	"查一下"、"搜索"

八、进阶：自定义 Skill

创建自己的 Skill 扩展能力：

# ~/.openclaw/skills/my-skill/SKILL.md

## 触发条件
当用户提到"关键词"时激活

## 执行步骤
1. 读取配置文件
2. 调用外部 API
3. 返回结果

结语

OpenClaw 的核心价值是让 AI Agent 从"聊天机器人"变成"可信赖的协作者"。

关键不是记住所有命令，而是建立正确的心智模型：

• 📁 文件是你的记忆（"Mental Notes" 会丢失，文件不会）
• 🔄 心跳是主动检查（不要等用户问，主动发现需求）
• 🛡️ 安全是底线（权限再大也要守红线）
• 🎯 创造是目标（不只是执行，要主动创造价值）

---

最后更新：2026-03-21
基于 OpenClaw v1.x 实战经验整理

相关资源：

• 官方文档：https://docs.openclaw.ai
• Skills 市场：https://clawhub.com
• 社区：https://discord.gg/clawd