Update: 将子项目从 submodule 转为完整内容

- 移除 GovAI, nomifun-tauri, 算力盒子的 submodule 引用 - 添加所有子项目的完整源代码 - 保留原始 .git 为 .git.bak 备份
2026-07-04 19:20:46 +08:00
parent 54d6465fa7
commit f7a720204a
3360 changed files with 802660 additions and 3 deletions
@@ -0,0 +1,133 @@
+# 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 响应
+
+**示例：创建一个代码审查机器人**
+
+```bash
+# 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` 定义任务逻辑
+
+**示例：每日报告任务**
+
+```bash
+# 设置每日 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
+
+**示例配置：**
+
+```json5
+{
+  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 隧道连接**
+
+```bash
+# 在本地机器上
+ssh -N -L 18789:127.0.0.1:18789 user@remote-server
+
+# 在另一个终端
+openclaw gateway status  # 应该能连接到远程 Gateway
+```
+
+### 场景 5：工作区备份
+
+工作区包含 Agent 的记忆和配置，建议定期备份：
+
+```bash
+# 使用 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. **日志管理**：定期清理日志文件