MyAiDesk/nomifun-tauri/test-data/builtin-skills/openclaw-setup/references/best-practices.md

OpenClaw 最佳实践和特殊场景

帮助用户时的最佳实践

1. 先诊断，再操作：遇到问题先运行 openclaw doctor
2. 检查最新文档：不确定时查阅 GitHub README 或官方文档
3. 保护隐私：涉及 API 密钥、令牌等敏感信息时，引导用户自己处理
4. 分步引导：复杂操作分步骤，每步确认成功后再继续
5. 提供备选方案：如果一种方法不行，提供替代方案
6. 记录问题：如果发现新问题或文档过时，提醒用户查看最新资料

特殊场景处理

场景 1：用户想创建特定功能的机器人

1. 确认 Gateway 已运行
2. 创建工作区或使用现有工作区
3. 配置 AGENTS.md 定义 Agent 行为
4. 配置 TOOLS.md 启用所需工具
5. 测试 Agent 响应

示例：创建一个代码审查机器人

# 1. 创建新的 Agent
openclaw agents add code-review --workspace ~/.openclaw/workspace-code-review

# 2. 编辑工作区的 AGENTS.md，定义代码审查逻辑
# 3. 配置 TOOLS.md，启用 GitHub 相关工具
# 4. 测试
openclaw agent --agent code-review --message "审查这个 PR: https://github.com/..."

场景 2：用户想执行自动化任务

1. 使用 openclaw cron 设置定时任务
2. 或使用 openclaw webhooks 接收外部触发
3. 配置 Agent 的 AGENTS.md 定义任务逻辑

示例：每日报告任务

# 设置每日 9 点执行
openclaw cron add "0 9 * * *" --message "生成每日报告" --agent main

# Agent 的 AGENTS.md 中定义报告生成逻辑

场景 3：多 Agent 路由

1. 创建多个 Agent：openclaw agents add <name>
2. 配置路由规则在 openclaw.json 中
3. 参考文档：https://docs.openclaw.ai/concepts/multi-agent

示例配置：

{
  agents: {
    list: [
      { id: 'work', workspace: '~/.openclaw/workspace-work' },
      { id: 'personal', workspace: '~/.openclaw/workspace-personal' },
    ],
  },
  bindings: [
    {
      match: { channel: 'slack', accountId: 'work-account' },
      agent: 'work',
    },
    {
      match: { channel: 'telegram' },
      agent: 'personal',
    },
  ],
}

场景 4：远程 Gateway

1. 在远程服务器上安装并运行 Gateway
2. 本地配置 gateway.mode=remote
3. 配置 gateway.remote.url 和认证
4. 使用 SSH 隧道或 Tailscale 连接

示例：通过 SSH 隧道连接

# 在本地机器上
ssh -N -L 18789:127.0.0.1:18789 user@remote-server

# 在另一个终端
openclaw gateway status  # 应该能连接到远程 Gateway

场景 5：工作区备份

工作区包含 Agent 的记忆和配置，建议定期备份：

# 使用 git 备份（推荐）
cd ~/.openclaw/workspace
git init
git add .
git commit -m "Backup workspace"

# 推送到私有仓库
git remote add origin git@github.com:username/openclaw-workspace.git
git push -u origin main

场景 6：迁移到新机器

1. 备份配置文件：~/.openclaw/openclaw.json
2. 备份工作区：~/.openclaw/workspace
3. 备份凭证（如果需要）：~/.openclaw/credentials/
4. 在新机器上安装 OpenClaw
5. 恢复配置和工作区
6. 运行 openclaw doctor 检查配置

安全建议

1. 配置文件权限：确保 ~/.openclaw/openclaw.json 权限为 600
2. API 密钥：使用环境变量或安全的密钥管理工具
3. DM 策略：默认使用 pairing 策略，避免开放 DM
4. Gateway 认证：即使本地运行，也建议设置 Gateway token
5. 定期更新：保持 OpenClaw 和依赖项更新

性能优化

1. 会话清理：定期清理旧会话以释放空间
2. 模型选择：根据任务复杂度选择合适的模型
3. 工作区大小：保持工作区文件精简，避免过大的记忆文件
4. 日志管理：定期清理日志文件