最佳实践

社区总结的 OpenClaw 使用最佳实践。

🎯 Agent 设计

单一职责

每个 Agent 专注一个领域：

# 好的做法
agents:
  research-agent:
    skills: [web-search, wikipedia]
  code-agent:
    skills: [github, code-review]

# 不好的做法
agents:
  super-agent:
    skills: [web-search, github, calendar, email, ...]

合适的模型

根据任务选择模型：

• 简单任务：GPT-3.5 / Claude Haiku
• 复杂推理：GPT-4 / Claude Opus
• 代码任务：Claude / GPT-4

🧠 记忆管理

写下来

不要依赖"脑记"，写入文件：

# 记住这个
- 重要决策：xxx
- 用户偏好：xxx

定期整理

通过 Heartbeat 定期整理记忆：

heartbeat:
  task: "整理 MEMORY.md，删除过时信息"

🛠️ Skill 开发

清晰的描述

工具描述要清晰：

// 好
description: '搜索网页并返回相关结果'

// 不好
description: '搜索'

错误处理

处理可能的错误：

execute: async (params) => {
  try {
    // ...
  } catch (error) {
    return { error: error.message }
  }
}

📢 渠道选择

公开 vs 私密

• 私密任务：Web Chat / Telegram 私聊
• 团队协作：Discord / Slack
• 公开分享：Discord 公开频道

避免打扰

在群组中：

• 只在必要时发言
• 使用反应代替回复
• 遵守群组规则

🔒 安全

API Key 管理

使用环境变量，不要硬编码：

# 好
apiKey: ${OPENAI_API_KEY}

# 不好
apiKey: sk-xxxxxx

权限最小化

只授予必要的权限：

skills:
  - file-read  # 只读
  # 不给 file-write 除非必要

📊 性能

缓存

对重复请求使用缓存：

cache:
  enabled: true
  ttl: 3600

并发控制

限制并发请求：

rateLimit:
  maxRequests: 100
  per: minute

更多内容

（待补充）