From ab9c136bd49ff0048e79b80b57f2f6f7d9675eb6 Mon Sep 17 00:00:00 2001 From: weishen Date: Fri, 17 Apr 2026 13:23:16 +0800 Subject: [PATCH] =?UTF-8?q?=E6=98=9F=E8=BE=89:=20=E6=9B=B4=E6=96=B0TOOLS?= =?UTF-8?q?=E6=A0=87=E5=87=86=E6=A8=A1=E6=9D=BF(=E5=90=AB=E7=AB=A0?= =?UTF-8?q?=E8=8A=8227)=20(2026-04-17)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- openclaw/Agents/TOOLS标准模板.md | 255 ++++-------------------------- wiki/concepts/Multi-Agent-Team.md | 44 ++++++ wiki/log.md | 9 ++ wiki/overview.md | 2 + 4 files changed, 87 insertions(+), 223 deletions(-) create mode 100644 wiki/concepts/Multi-Agent-Team.md diff --git a/openclaw/Agents/TOOLS标准模板.md b/openclaw/Agents/TOOLS标准模板.md index cefe9d93..ab0b7b32 100644 --- a/openclaw/Agents/TOOLS标准模板.md +++ b/openclaw/Agents/TOOLS标准模板.md @@ -7,8 +7,7 @@ created: description: tags: [] --- -```table-of-contents -``` + # TOOLS管理 ## 1.统一SSH管理 @@ -459,6 +458,7 @@ cat ~/.openclaw/skills/agentmail/references/EXAMPLES.md - **参考文档**：详细用法见 `references/API.md` 和 `references/EXAMPLES.md` ## 14.Docker命令路径 (2026-04-04) +### 列表 | 服务器 | 命令 | 说明 | | ------------- | -------------------------------------------------------- | ------------- | @@ -469,7 +469,6 @@ cat ~/.openclaw/skills/agentmail/references/EXAMPLES.md **使用方式**: ```bash - # macmini 本地 docker ps @@ -511,186 +510,79 @@ ssh ubuntu2 'docker ps' ## 16. Last30Days 技能 (2026-03-29) - - ### 功能概述 - -搜索过去 30 天内 Reddit、X、YouTube、TikTok、Instagram、Hacker News、Polymarket 和网页上的热门内容，生成研究报告。 - - - +搜索过去 30 天内 Reddit、X、YouTube、TikTok、Instagram、Hacker News、Polymarket 和网页上的热门内容，生成研究报告 ### 调用方式 - ```bash - python3 ~/.openclaw/skills/last30days-official/scripts/last30days.py "<话题>" --emit=compact --no-native-web --save-dir=~/Documents/Last30Days - ``` - - - -### 常用参数 - - - -| 参数 | 说明 | 示例 | - -|------|------|------| - -| `--days=N` | 回溯 N 天（默认30天） | `--days=7` | - -| `--quick` | 快速模式（8-12条/来源） | | - -| `--deep` | 深度模式（50-70条Reddit） | | - -| `--x-handle=HANDLE` | 指定 X 账号搜索 | `--x-handle=elonmusk` | - - - +### 常用参数 +| 参数 | 说明 | 示例 | +| ------------------- | ------------------ | --------------------- | +| `--days=N` | 回溯 N 天（默认30天） | `--days=7` | +| `--quick` | 快速模式（8-12条/来源） | | +| `--deep` | 深度模式（50-70条Reddit） | | +| `--x-handle=HANDLE` | 指定 X 账号搜索 | `--x-handle=elonmusk` | ### 对比模式 - ```bash - # 比较两个话题 - python3 ~/.openclaw/skills/last30days-official/scripts/last30days.py "cursor vs windsurf" --emit=compact --no-native-web --save-dir=~/Documents/Last30Days - ``` - - - ### 输出说明 - - **What I Learned** — 研究发现摘要 - - **Key Patterns** — 关键模式（3-5条） - - **Stats** — 统计数据（各平台帖子数、点赞数等） - - **Invitation** — 根据类型推荐下一步 - - - ### 数据来源权重 - -| 来源 | 权重 | 说明 | - -|------|------|------| - -| Reddit/X | 高 | 有互动数据（点赞、评论） | - -| YouTube | 高 | 有观看数和字幕 | - -| TikTok/Instagram | 中 | 有观看数和标题 | - -| Polymarket | 高 | 真实钱币投注，数据真实 | - -| Web | 低 | 无互动数据 | - - - +| 来源 | 权重 | 说明 | +| ---------------- | --- | ------------ | +| Reddit/X | 高 | 有互动数据（点赞、评论） | +| YouTube | 高 | 有观看数和字幕 | +| TikTok/Instagram | 中 | 有观看数和标题 | +| Polymarket | 高 | 真实钱币投注，数据真实 | +| Web | 低 | 无互动数据 | ### API Keys 配置 - 在 `~/.openclaw/.env` 中配置： - ```bash - SCRAPECREATORS_API_KEY=...   # Reddit + TikTok + Instagram（必填） - AUTH_TOKEN=...                 # X 搜索（推荐） - CT0=...                        # X 搜索（推荐） - XAI_API_KEY=xai-...           # X 搜索备选 - ``` - - ### 保存位置 - - 研究数据自动保存到：`~/Documents/Last30Days/` - - 文件名格式：`{话题}-YYYY-MM-DD.md` - - - ### 使用场景 - 1. **热点追踪** — 搜索"AI一人公司"了解最新趋势 - 2. **工具对比** — "cursor vs windsurf" 对比两个工具 - 3. **人物研究** — 搜索某人的 X 账号帖子 - 4. **竞品分析** — 搜索竞品最新动态 - 5. **话题深挖** — 发现新工具、新技术 - - - ### 注意事项 - - 深度研究需要 2-8 分钟 - - TikTok/Instagram 需要 ScrapeCreators API key（前 100 次免费） - - 建议先用 `--quick` 测试话题 - - - - -## 17. gog (Google Workspace CLI) 代理配置 (2026-03-30) - - - +## 17. gog (Google Workspace CLI) 代理配置 (2026-03-30) ### 必须走代理 - gog CLI 在 Mac Mini 上直连 Google API 会超时，**必须设置代理**： - - - ```bash - HTTPS_PROXY=socks5h://127.0.0.1:10808 HTTP_PROXY=socks5h://127.0.0.1:10808 gog - ``` - - - ### 常用命令示例 ```bash - # 日历列表（带代理） - HTTPS_PROXY=socks5h://127.0.0.1:10808 HTTP_PROXY=socks5h://127.0.0.1:10808 gog calendar list --account ishenwei@gmail.com - - - # 查看日历事件（带代理） - HTTPS_PROXY=socks5h://127.0.0.1:10808 HTTP_PROXY=socks5h://127.0.0.1:10808 gog calendar events --account ishenwei@gmail.com "OpenClaw" --from 2026-03-30T00:00:00+08:00 --to 2026-04-05T23:59:59+08:00 --max 50 - - # 删除日历事件（带代理） - HTTPS_PROXY=socks5h://127.0.0.1:10808 HTTP_PROXY=socks5h://127.0.0.1:10808 gog calendar delete --account ishenwei@gmail.com "OpenClaw" -y - ``` - - - ### 认证状态 - - 已完成 OAuth 授权（ishenwei@gmail.com） - - Google Calendar: OpenClaw 日历（cfd0ba26...@group.calendar.google.com） - - - - ## 18.n8n工作流标准执行步骤 > ⚠️ n8n 已迁移到 Ubuntu2 服务器（2026-03-30 更新） > 用户可能说："请用n8n内容转换工作流帮我转化这篇文章<文件名>" @@ -785,7 +677,7 @@ ssh ubuntu1 'proxychains4 docker build --pull=false -t : : ' ``` -### 注意事项 +### 注意事项 - **SOCKS5 vs HTTP**: Xray/V2Ray 通常提供 SOCKS5 代理，proxychains4 在 TCP 层转发流量，不依赖 HTTP 代理设置 - **--pull=false**: 在已有本地镜像时使用，避免 build 过程中再次拉取基础镜像（耗时且仍可能失败） @@ -937,9 +829,7 @@ tail -30 ~/.hermes/logs/gateway.log # gateway 日志 ## 22. Claude Code 调用方法（OpenClaw & Hermes Terminal） ### 核心模式 - **Print Mode（推荐）** — 适合绝大多数任务： - ```bash cat << 'TASK_END' | claude -p print \ --dangerously-skip-permissions \ @@ -952,9 +842,6 @@ TASK_END ``` **TMUX 交互模式** — 适合超长任务： - -### 模式二：TMUX 交互模式（适合超长任务） - ```bash tmux new-session -d -s claude-work -x 140 -y 40 tmux send-keys -t claude-work 'claude --permission-mode bypassPermissions' Enter @@ -971,7 +858,6 @@ sleep 8 && tmux capture-pane -t claude-work -p # 确认已启动后即可发送 | `--max-turns N` | 最大迭代次数，建议 20-30 | | `--bare` | 跳过插件/MCP/CLAUDE.md 加载，最快启动 | | `-p print` | 非交互单次执行模式 | - ### 任务文本结构 ``` @@ -983,7 +869,6 @@ sleep 8 && tmux capture-pane -t claude-work -p # 确认已启动后即可发送 ``` ### Skill 加载 - `--add-dir <技能目录>` 会自动扫描该目录下的 `SKILL.md` 和 `.claude/skills/`，触发条件自动匹配激活。 ### 常见坑点 @@ -1005,18 +890,18 @@ sleep 8 && tmux capture-pane -t claude-work -p # 确认已启动后即可发送 ### 基本用法 -#### 直接下载到当前目录 +#### 下载并存放到挂载盘 ```bash -yt-dlp "视频URL" -``` +# 直接下载到目标目录 +yt-dlp -o "/Users/weishen/mnt/volume2/knowledgebase/%(title)s.%(ext)s" "视频URL" -#### 下载并传输到 NAS -```bash -# 1. 下载到本地 +# 或者先下载到本地，再移动 yt-dlp "视频URL" +mv video.mp4 /Users/weishen/mnt/volume2/knowledgebase/ -# 2. 通过 pipe 传输到 NAS -cat video.mp4 | ssh nas "cat > /volume2/knowledgebase/video.mp4" +# 如果需要指定格式 +yt-dlp -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]" \ + -o "/Users/weishen/mnt/volume2/knowledgebase/%(title)s.%(ext)s" "视频URL" ``` ### 常用选项 @@ -1034,7 +919,7 @@ cat video.mp4 | ssh nas "cat > /volume2/knowledgebase/video.mp4" ### ⚠️ 注意事项 - 大文件通过 SSH pipe 传输时可能有连接问题 -- 视频默认保存到执行命令的当前目录 +- 视频默认保存到挂载盘目录 `~/mnt/volume2/knowledgebase/` - 临时文件建议放在 `~/.openclaw/temp//attachments/` 目录 @@ -1057,7 +942,7 @@ openclaw cron add \ ### ⚠️ 关键规则 - `--announce --channel telegram` 必须同时指定 `--to "5038825565"` - 不带 `--to` 时 Telegram 投递会静默失败（无报错），导致 cron 看起来正常但用户收不到通知 -- 禁止使用 launchd / crontab / systemd 管理定时任务，必须用 OpenClaw cron +- **禁止使用 launchd / crontab / systemd 管理定时任务，必须用 OpenClaw cron** ## 25. Obsidian CLI (官方) (2026-04-16) ### 概述 @@ -1073,74 +958,7 @@ openclaw cron add \ - 默认 Vault: `/Users/weishen/Workspace/nexus` ### 核心命令 - -#### 读取笔记 -```bash -obsidian read file="笔记名称" # 按名称（无需扩展名） -obsidian read path="folder/note.md" # 按路径 -``` - -#### 搜索 -```bash -obsidian search query="关键词" limit=10 # 搜索笔记名称 -obsidian search-content "内容" # 搜索笔记内容 -``` - -#### 创建笔记 -```bash -obsidian create name="Folder/新笔记" content="# 标题\n内容" silent -# silent: 不在 Obsidian 中打开 -``` - -#### 追加内容 -```bash -obsidian append file="笔记名称" content="新段落内容" -obsidian append file="笔记名称" content="- [ ] 新任务" inline # 不换行 -``` - -#### 查看/修改属性 (Frontmatter) -```bash -obsidian frontmatter file="笔记名称" # 查看 -obsidian property:set name="status" value="done" file="笔记名称" # 设置属性 -``` - -#### 移动/重命名 -```bash -obsidian move "旧路径/笔记.md" "新路径/笔记.md" # 自动更新所有链接 -``` - -#### 每日日记 -```bash -obsidian daily:read # 读取今日日记 -obsidian daily:append content="- [ ] 新任务" # 追加任务 -``` - -#### 任务管理 -```bash -obsidian tasks daily todo # 查看今日任务 -obsidian tags sort=count # 按数量排序显示标签 -``` - -#### 查看 backlinks -```bash -obsidian backlinks file="笔记名称" # 查看谁链接到了这个笔记 -``` - -### 参数格式说明 -- **参数**: `key=value`，如 `file="My Note"` -- **标志**: 布尔开关，无值，如 `silent`、`inline`、`total` -- **路径**: `file=` 按名称解析（像 wikilink），`path=` 精确路径 - -### Vault 指定 -```bash -obsidian vault="另一个Vault" search query="关键词" -``` - -### 完整帮助 -```bash -obsidian help -``` - +- 请读取obsidian-cli技能 `/Users/weishen/.openclaw/skills/obsidian-cli/SKILL.md` ### ⚠️ 注意事项 - Obsidian 应用必须运行才能使用 CLI - 如果 Obsidian 未运行，会报错或无响应 @@ -1152,7 +970,7 @@ obsidian help 通过 OpenClaw 将本地图片发送到 Telegram。 ### 前置要求 -- Telegram bot 已配置（account: bot1） +- Telegram bot 已配置 - 目标 chat ID（比利哥: 5038825565） ### 操作步骤 @@ -1161,7 +979,6 @@ obsidian help ```bash cp /path/to/image.png ~/.openclaw/media/inbound/ ``` - #### 2. 通过 OpenClaw 发送 ```bash /opt/homebrew/bin/openclaw message send \ @@ -1171,7 +988,6 @@ cp /path/to/image.png ~/.openclaw/media/inbound/ --media ~/.openclaw/media/inbound/image.png \ --message "说明文字" ``` - ### 参数说明 | 参数 | 说明 | @@ -1181,7 +997,6 @@ cp /path/to/image.png ~/.openclaw/media/inbound/ | `--target` | 目标 chat ID（比利哥: 5038825565） | | `--media` | 图片路径 | | `--message` | 说明文字 | - ### 示例 ```bash # 复制并发送 @@ -1194,11 +1009,6 @@ cp ~/Downloads/photo.jpg ~/.openclaw/media/inbound/ - 图片支持 jpg、png、gif 等常见格式 - 临时文件放在 `~/.openclaw/media/inbound/` 目录 - 文件名避免中文，建议用英文或数字 -│ └── ... -├── Canon_DIGITAL_IXUS_400/ -├── Canon_EOS_400D_DIGITAL/ -└── ... -``` ## 27. update-agents-tools.py 一键更新所有 Agent 的 TOOLS.md @@ -1230,5 +1040,4 @@ python3 ~/.openclaw/scripts/update-agents-tools.py - **无需人工数表格**：程序自动解析矩阵，零失误 - **自动发现 Agent**：从表头动态提取，不依赖硬编码 - **支持远程**：自动同步到 Ubuntu1/2 上的 Agent 目录 -- **幂等执行**：重复运行结果一致 - +- **幂等执行**：重复运行结果一致 \ No newline at end of file diff --git a/wiki/concepts/Multi-Agent-Team.md b/wiki/concepts/Multi-Agent-Team.md new file mode 100644 index 00000000..ddf7a8a7 --- /dev/null +++ b/wiki/concepts/Multi-Agent-Team.md @@ -0,0 +1,44 @@ +--- +title: "Multi-Agent Team" +type: concept +tags: [] +sources: [multi-agent-team] +last_updated: 2026-04-17 +--- + +## Definition +多 Agent 团队是一种 AI Agent 协作架构，每个 Agent 有独立的角色、人格和优化的模型，通过共享内存和私有上下文实现协同工作。 + +## Core Components + +### Specialized Agents +- 每个 Agent 有 distinct role、personality、model +- 模型选择与任务复杂度匹配（Claude Opus 用于复杂推理，Claude Sonnet 用于快速分析，Gemini 用于网络研究） + +### Shared Memory +- 项目文档、目标、关键决策所有 Agent 可访问 +- 包含：GOALS.md、DECISIONS.md、PROJECT_STATUS.md + +### Private Context +- 每个 Agent 维护自己的对话历史和领域特定笔记 +- 存储在独立目录（如 agents/milo/、agents/josh/） + +### Single Control Plane +- 单一 Telegram 群组，通过 @tag 触发特定 Agent +- 支持 @all 广播，默认 @milo（团队lead）处理 + +### Scheduled Tasks +- Agent 主动工作而非被动响应 +- 定时任务示例：Milo 早8点晨会总结、Josh 早9点关键指标、Marketing 早10点内容创意 + +## Key Insights +- **Personality matters**: 鲜明人格让与 Agent 交互更像与团队对话 +- **Shared memory + private context**: 组合关键，共享建立共同基础，私有积累领域专业知识 +- **Right model for right job**: 便宜模型做简单任务 +- **Start with 2, not 4**: lead + one specialist 开始，识别瓶颈后再扩展 + +## Related Concepts +- [[Agent Chain]]：多个 Agent 串联工作 +- [[Shared Memory]]：团队共享上下文 +- [[Scheduled Tasks]]：定时任务机制 +- [[OpenClaw]]：支持多 Agent 协调的工具 \ No newline at end of file diff --git a/wiki/log.md b/wiki/log.md index 260b5743..d0c841e5 100644 --- a/wiki/log.md +++ b/wiki/log.md @@ -1,3 +1,12 @@ +## [2026-04-17] ingest | Multi-Agent Specialized Team (Solo Founder Setup) +- Source file: raw/Agent/usecases/multi-agent-team.md +- Status: ✅ 成功摄入 +- Summary: Solo founder 通过多 Agent specialized team 实现高效工作模式，每个 Agent 有独立角色、人格、优化的模型，通过共享内存+私有上下文+单一 Telegram 控制平面+定时任务实现协同 +- Concepts created: Multi-Agent Team, Shared Memory +- Entities created: （已有 OpenClaw） +- Source page: wiki/sources/multi-agent-team.md +- Notes: 与现有 Vibe-Kanban 形成对比/竞争关系；强化 Agent Chain 概念 + ## [2026-04-17] ingest | Project State Management System - Source file: raw/Agent/usecases/project-state-management.md - Status: ✅ 成功摄入 diff --git a/wiki/overview.md b/wiki/overview.md index 8601c33b..518fd371 100644 --- a/wiki/overview.md +++ b/wiki/overview.md @@ -44,6 +44,8 @@ AI 开源项目、Cloud & DevOps、Vibe Coding - Task Automation：自动将任务创建过程从手动操作转化为系统执行的机制 - Self-Healing Systems（自愈系统）：主动检测异常并自动修复的系统，无需人工干预即可恢复正常运行状态 - Cron Jobs（定时任务）：Linux 基于时间的任务调度机制，AI Agent 通过定时作业实现持续自动化价值 +- Multi-Agent Team（多 Agent 团队）：多 Agent 协作架构，每个 Agent 有独立角色、人格、优化的模型，通过共享内存+私有上下文实现协同 +- Shared Memory（共享内存）：多 Agent 团队共享的上下文，包括目标、决策、项目状态，所有 Agent 可访问 - **家庭网络环境概览** — 家庭网络基础设施架构与多服务部署方案（FRP内网穿透、Caddy反向代理、Cloudflare DNS托管） - **Vibe-Kanban + OpenCode 在 Ubuntu Server 上安装与管理指南** — 在 Ubuntu Server 上使用 shenwei 用户安装 Node 20、Vibe-Kanban 与 OpenCode，并通过 pm2 管理进程的完整指南