OpenClaw 使用 Tips：从入门到精通

基于实战经验 + 橙皮书 + 社区实践总结的实用指南。

一、启动与配置

1.1 最小可用配置

# 安装
curl -fsSL https://openclaw.ai/install.sh | bash

# 首次启动
openclaw onboard --install-daemon

# 验证
openclaw status

Tips：
- 先用 OAuth 登录（不要一上来就配 API Key）
- 等第一次成功跑通再加复杂配置
- 用 openclaw status 检查状态，比猜测更可靠

1.2 模型选择

Tips：
- 不要一上来就用最贵的模型
- 每个任务可以配不同模型（在 openclaw.json 里）
- 测试时用便宜的，生产再用好的

二、记忆系统

2.1 记忆文件结构

workspace/
├── MEMORY.md          # 长期记忆（人工维护）
├── AGENTS.md          # Agent 规则（系统行为）
├── SOUL.md            # 人格设定（语气风格）
├── TOOLS.md           # 工具使用规范
├── memory/            # 每日记忆（自动生成）
│   ├── 2026-03-14.md
│   └── 2026-03-13.md
└── workspace-shared/  # 多 Agent 共享记忆
    └── knowledge/

2.2 记忆管理原则

DO：
- ✅ 把重要决策写进 MEMORY.md（长期）
- ✅ 每日对话结束后检查 memory/YYYY-MM-DD.md
- ✅ 重复出现 3 次的问题，提炼成规则（写入 AGENTS.md）
- ✅ 多 Agent 共享的知识放在 workspace-shared/

DON'T：
- ❌ 不要把所有对话都记下来（记忆会爆炸）
- ❌ 不要让记忆文件超过 2000 字（定期清理）
- ❌ 不要在 SOUL.md 里写具体规则（那是人格，不是行为）

实战案例：

# MEMORY.md 记录格式

## 进行中项目
| 项目 | 状态 | 下一步 | 截止 |
|------|------|--------|------|
| opcpay.org | v3.5 完成 | 验证 cron | - |

## 重要决策记录
| 日期 | 决策 | 原因 | 结果 |
|------|------|------|------|
| 2026-03-12 | 改用 OAuth | 无 API Key | 可用 |

三、工具使用

3.1 工具优先级

1. read/write/edit → 文件操作（最常用）
2. exec → 执行命令（次常用）
3. web_fetch → 网络请求（注意 DNS 问题）
4. sessions_send → 跨 Agent 通信（高级）

3.2 工具使用技巧

exec 使用：

# ✅ 好的做法
exec --yieldMs 5000 --timeout 30 "npm run build"

# ❌ 坏的做法
exec "npm run build"  # 没设置超时，可能卡死

web_fetch 使用：

# ✅ 先检查是否被 DNS 拦截
curl -I https://example.com

# ❌ 直接用 web_fetch 可能失败
web_fetch --url "https://example.com"

sessions_send 使用：

{
  "sessionKey": "agent:muse:internal:main",
  "message": "请执行任务 X",
  "timeoutSeconds": 60
}

Tips：
- timeoutSeconds: 0 = fire-and-forget
- timeoutSeconds: 60 = 等待回复（最多 60 秒）

四、多 Agent 协作

4.1 Agent 分工原则

4.2 协作通信格式

{
  "sessionKey": "agent:forge:internal:main",
  "message": "任务：部署 X\n要求：1. 备份 2. 部署 3. 验证\n回滚：如果失败，执行 Y",
  "timeoutSeconds": 0
}

Tips：
- ✅ 每条消息都写清楚"任务 + 要求 + 回滚方案"
- ✅ 用 timeoutSeconds: 0 避免等待
- ✅ 重要任务用 timeoutSeconds: 60 确认收到
- ❌ 不要在群聊里暴露 API Key 或私密信息

五、定时任务（Cron）

5.1 Cron 配置示例

{
  "crons": [
    {
      "name": "zen-daily-summary",
      "schedule": "0 22 * * *",
      "command": "openclaw run --agent zen --prompt '生成日报'"
    },
    {
      "name": "muse-morning-briefing",
      "schedule": "30 6 * * *",
      "command": "openclaw run --agent muse --prompt '晨间情报巡逻'"
    }
  ]
}

5.2 Cron 管理原则

DO：
- ✅ 先手动跑通，再加 cron
- ✅ 每个 cron 都有日志记录
- ✅ 失败时发送告警（用 sessions_send）

DON'T：
- ❌ 不要一上来就配 10 个 cron
- ❌ 不要把 cron 时间设得太密集（浪费资源）
- ❌ 不要让 cron 任务依赖网络（可能失败）

实战命令：

# 检查 cron 是否正常
openclaw cron list

# 手动触发测试
openclaw cron trigger zen-daily-summary

# 查看日志
tail -f ~/.openclaw/logs/cron.log

六、安全与成本

6.1 安全管理

认证：
- ✅ 用 OAuth 而不是 API Key（更安全）
- ✅ 配置 allowedUsers 白名单
- ✅ 定期检查 openclaw status

权限：
- ✅ 用最小权限原则
- ✅ 危险操作（git push、删除文件）必须确认
- ❌ 不要给 Agent 完全的 shell 权限

数据：
- ✅ 敏感信息写在 .env 文件里
- ✅ 定期备份 workspace/ 目录
- ❌ 不要在对话中暴露密码、API Key

6.2 成本控制

控制成本：
- ✅ 测试时用便宜的模型（MiniMax、GLM-5）
- ✅ 设置每日调用上限
- ✅ 监控 openclaw status 里的 token 使用量

估算成本：

# 查看今日用量
openclaw status

# 估算成本（假设 GPT-5.4）
# 输入：$15/1M tokens
# 输出：$60/1M tokens

七、常见问题与解决

7.1 网络问题

问题：web_fetch 失败，DNS 解析到 198.18.x.x

原因：代理软件（Shadowrocket）劫持了 DNS

解决方案：

# 方案 1：关闭代理
# 方案 2：用 agent-browser 替代
agent-browser open 'https://example.com'
# 方案 3：用 Tavily 搜索（如果可用）

7.2 模型认证失败

问题：API Key 401 错误

原因：API Key 过期或无效

解决方案：

# 方案 1：改用 OAuth
openclaw auth login --provider openai

# 方案 2：更新 API Key
openclaw config set openai.apiKey "sk-..."

7.3 记忆文件过大

问题：MEMORY.md 超过 2000 字

原因：记录了太多细节

解决方案：

# 1. 把细节移到 daily notes
mv MEMORY.md memory/backup-$(date +%Y%m%d).md

# 2. 重新写精简版
# 只保留：进行中项目 + 重要决策 + 技术环境

# 3. 定期晋升
# 每周五把 daily notes 的有价值内容提炼到 MEMORY.md

7.4 Agent 无响应

问题：sessions_send 超时

原因：Agent 忙或卡死

解决方案：

# 1. 检查 Agent 状态
openclaw status

# 2. 重启 Agent
openclaw restart --agent muse

# 3. 检查日志
tail -f ~/.openclaw/agents/muse/logs/error.log

八、调试技巧

8.1 日志查看

# 主日志
tail -f ~/.openclaw/logs/openclaw.log

# Agent 日志
tail -f ~/.openclaw/agents/zen/logs/openclaw.log

# Cron 日志
tail -f ~/.openclaw/logs/cron.log

8.2 状态检查

# 完整状态
openclaw status

# 简要状态
openclaw status --short

# 特定 Agent
openclaw status --agent zen

8.3 手动测试

# 直接运行 Agent（不走渠道）
openclaw run --agent zen --prompt "测试消息"

# 测试特定工具
openclaw run --agent zen --prompt "读取 MEMORY.md"

九、最佳实践

9.1 入门三步

1. 先跑通一个简单场景（每日简报）
2. 观察实际效果（记录失败模式）
3. 逐步加复杂度（不要一上来就多 Agent）

9.2 核心原则

• 规则驱动，不改单条：系统性纠偏，不手工补单条
• 记忆分层：工作记忆 / 项目记忆 / 角色记忆 / 组织记忆
• 最小权限：只给必要的工具和权限
• 持续运行：24/7 才是 OpenClaw 的优势

9.3 避坑指南

• ❌ 不要把 OpenClaw 当 ChatGPT 用（浪费）
• ❌ 不要一上来就复杂配置（容易失败）
• ❌ 不要忽略记忆管理（会爆炸）
• ❌ 不要给完全权限（安全问题）
• ❌ 不监控成本（会超支）

十、快速参考

常用命令

# 安装
curl -fsSL https://openclaw.ai/install.sh | bash

# 启动
openclaw start

# 状态
openclaw status

# 重启
openclaw restart

# 日志
openclaw logs

# 停止
openclaw stop

配置文件结构

~/.openclaw/
├── openclaw.json      # 主配置
├── .env               # 环境变量
└── agents/
    ├── zen/
    │   └── openclaw.json
    └── muse/
        └── openclaw.json

记忆文件结构

workspace/
├── MEMORY.md          # 长期记忆
├── AGENTS.md          # Agent 规则
├── SOUL.md            # 人格设定
├── TOOLS.md           # 工具规范
└── memory/            # 每日记忆
    └── YYYY-MM-DD.md

总结

一句话：OpenClaw 最适合"把重复性、多步骤、需要记忆和工具调用的任务自动化"，而不是替代 ChatGPT 聊天。

养成路径：每日简报 → 信息流处理 → 业务自动化 → 多 Agent 协作。

核心原则：先简单后复杂，先手动后自动，先测试后生产。

参考来源：
- OpenClaw 橙皮书 v2.0
- 社区实践（Tavily 搜索）
- 本地实战案例（opcpay.org、native-ai-office）

opcpay.org 实践团队
2026-03-14