diff --git a/openclaw/Agents/TOOLS权限矩阵.md b/openclaw/Agents/TOOLS权限矩阵.md index 5420ad1e..4bb60ca7 100644 --- a/openclaw/Agents/TOOLS权限矩阵.md +++ b/openclaw/Agents/TOOLS权限矩阵.md @@ -50,7 +50,8 @@ tags: [] | 23 | yt-dlp (网络视频下载) | ✅ | ✅ | ✅ | ✅ | | | | | | 24 | OpenClaw Cron Job 创建规范 | ✅ | | | | | | | | | 25 | Obsidian CLI (官方) | ✅ | ✅ | ✅ | ✅ | | | | | -| 26 | OpenClaw 发送图片到 Telegram | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| 26 | OpenClaw 发送图片到 Telegram | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| 27 | update-agents-tools.py 一键更新TOOLS | ✅ | | | | | | | | --- diff --git a/openclaw/Agents/TOOLS标准模板.md b/openclaw/Agents/TOOLS标准模板.md index e3368b46..cefe9d93 100644 --- a/openclaw/Agents/TOOLS标准模板.md +++ b/openclaw/Agents/TOOLS标准模板.md @@ -7,7 +7,8 @@ created: description: tags: [] --- - +```table-of-contents +``` # TOOLS管理 ## 1.统一SSH管理 @@ -458,7 +459,6 @@ cat ~/.openclaw/skills/agentmail/references/EXAMPLES.md - **参考文档**：详细用法见 `references/API.md` 和 `references/EXAMPLES.md` ## 14.Docker命令路径 (2026-04-04) -### 列表 | 服务器 | 命令 | 说明 | | ------------- | -------------------------------------------------------- | ------------- | @@ -469,6 +469,7 @@ cat ~/.openclaw/skills/agentmail/references/EXAMPLES.md **使用方式**: ```bash + # macmini 本地 docker ps @@ -510,79 +511,186 @@ 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` | -### 对比模式 -```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 | 低 | 无互动数据 | -### 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) -### 必须走代理 -gog CLI 在 Mac Mini 上直连 Google API 会超时，**必须设置代理**： + + +### 常用参数 + + + +| 参数 | 说明 | 示例 | + +|------|------|------| + +| `--days=N` | 回溯 N 天（默认30天） | `--days=7` | + +| `--quick` | 快速模式（8-12条/来源） | | + +| `--deep` | 深度模式（50-70条Reddit） | | + +| `--x-handle=HANDLE` | 指定 X 账号搜索 | `--x-handle=elonmusk` | + + + +### 对比模式 + ```bash -HTTPS_PROXY=socks5h://127.0.0.1:10808 HTTP_PROXY=socks5h://127.0.0.1:10808 gog + +# 比较两个话题 + +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 | 低 | 无互动数据 | + + + +### 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) + + + +### 必须走代理 + +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内容转换工作流帮我转化这篇文章<文件名>" @@ -677,7 +785,7 @@ ssh ubuntu1 'proxychains4 docker build --pull=false -t : : ' ``` -### 注意事项 +### 注意事项 - **SOCKS5 vs HTTP**: Xray/V2Ray 通常提供 SOCKS5 代理，proxychains4 在 TCP 层转发流量，不依赖 HTTP 代理设置 - **--pull=false**: 在已有本地镜像时使用，避免 build 过程中再次拉取基础镜像（耗时且仍可能失败） @@ -829,7 +937,9 @@ 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 \ @@ -842,6 +952,9 @@ 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 @@ -858,6 +971,7 @@ sleep 8 && tmux capture-pane -t claude-work -p # 确认已启动后即可发送 | `--max-turns N` | 最大迭代次数，建议 20-30 | | `--bare` | 跳过插件/MCP/CLAUDE.md 加载，最快启动 | | `-p print` | 非交互单次执行模式 | + ### 任务文本结构 ``` @@ -869,6 +983,7 @@ sleep 8 && tmux capture-pane -t claude-work -p # 确认已启动后即可发送 ``` ### Skill 加载 + `--add-dir <技能目录>` 会自动扫描该目录下的 `SKILL.md` 和 `.claude/skills/`，触发条件自动匹配激活。 ### 常见坑点 @@ -890,18 +1005,18 @@ sleep 8 && tmux capture-pane -t claude-work -p # 确认已启动后即可发送 ### 基本用法 -#### 下载并存放到挂载盘 +#### 直接下载到当前目录 ```bash -# 直接下载到目标目录 -yt-dlp -o "/Users/weishen/mnt/volume2/knowledgebase/%(title)s.%(ext)s" "视频URL" - -# 或者先下载到本地，再移动 yt-dlp "视频URL" -mv video.mp4 /Users/weishen/mnt/volume2/knowledgebase/ +``` -# 如果需要指定格式 -yt-dlp -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]" \ - -o "/Users/weishen/mnt/volume2/knowledgebase/%(title)s.%(ext)s" "视频URL" +#### 下载并传输到 NAS +```bash +# 1. 下载到本地 +yt-dlp "视频URL" + +# 2. 通过 pipe 传输到 NAS +cat video.mp4 | ssh nas "cat > /volume2/knowledgebase/video.mp4" ``` ### 常用选项 @@ -919,7 +1034,7 @@ yt-dlp -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]" \ ### ⚠️ 注意事项 - 大文件通过 SSH pipe 传输时可能有连接问题 -- 视频默认保存到挂载盘目录 `~/mnt/volume2/knowledgebase/` +- 视频默认保存到执行命令的当前目录 - 临时文件建议放在 `~/.openclaw/temp//attachments/` 目录 @@ -942,7 +1057,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) ### 概述 @@ -958,7 +1073,74 @@ openclaw cron add \ - 默认 Vault: `/Users/weishen/Workspace/nexus` ### 核心命令 -- 请读取obsidian-cli技能 `/Users/weishen/.openclaw/skills/obsidian-cli/SKILL.md` + +#### 读取笔记 +```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 - 如果 Obsidian 未运行，会报错或无响应 @@ -970,7 +1152,7 @@ openclaw cron add \ 通过 OpenClaw 将本地图片发送到 Telegram。 ### 前置要求 -- Telegram bot 已配置 +- Telegram bot 已配置（account: bot1） - 目标 chat ID（比利哥: 5038825565） ### 操作步骤 @@ -979,6 +1161,7 @@ openclaw cron add \ ```bash cp /path/to/image.png ~/.openclaw/media/inbound/ ``` + #### 2. 通过 OpenClaw 发送 ```bash /opt/homebrew/bin/openclaw message send \ @@ -988,6 +1171,7 @@ cp /path/to/image.png ~/.openclaw/media/inbound/ --media ~/.openclaw/media/inbound/image.png \ --message "说明文字" ``` + ### 参数说明 | 参数 | 说明 | @@ -997,6 +1181,7 @@ cp /path/to/image.png ~/.openclaw/media/inbound/ | `--target` | 目标 chat ID（比利哥: 5038825565） | | `--media` | 图片路径 | | `--message` | 说明文字 | + ### 示例 ```bash # 复制并发送 @@ -1009,3 +1194,41 @@ 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 + +### 脚本位置 + +``` +~/.openclaw/scripts/update-agents-tools.py +``` + +### 功能 + +通过 Obsidian CLI 读取权限矩阵，自动解析每个 Agent 的章节分配，再从标准模板提取对应章节内容，一键更新所有 Agent 的 TOOLS.md 文件。 + +### 工作流程 + +1. 📖 通过 `obsidian read` 读取 `TOOLS权限矩阵.md` +2. 📊 解析 markdown 表格，自动发现所有 Agent 及其章节 +3. 📄 从 `TOOLS标准模板.md` 提取各章节内容 +4. ✏️ 写入所有 Agent 的 TOOLS.md（支持本地和 SSH 远程路径） + +### 用法 + +```bash +python3 ~/.openclaw/scripts/update-agents-tools.py +``` + +### 特点 + +- **无需人工数表格**：程序自动解析矩阵，零失误 +- **自动发现 Agent**：从表头动态提取，不依赖硬编码 +- **支持远程**：自动同步到 Ubuntu1/2 上的 Agent 目录 +- **幂等执行**：重复运行结果一致 + diff --git a/wiki/concepts/Cron-Jobs.md b/wiki/concepts/Cron-Jobs.md new file mode 100644 index 00000000..6e7efabf --- /dev/null +++ b/wiki/concepts/Cron-Jobs.md @@ -0,0 +1,29 @@ +--- +title: "Cron Jobs" +type: concept +tags: [automation, scheduling, linux] +sources: [self-healing-home-server-infrastructure-management] +last_updated: 2026-04-17 +--- + +## Summary +Cron Jobs（定时任务）是 Linux 系统中基于时间的任务调度机制，允许用户在特定时间间隔或时间点自动执行命令或脚本。在 AI Agent 场景中，定时作业是提供持续价值的关键机制。 + +## Definition +基于 crontab 的时间调度系统，通过配置文件定义任务执行的时间规则。 + +## Key Characteristics +- 基于时间调度（每分钟、每小时、每天等） +- 后台运行，无需人工干预 +- 可用于自动化监控、备份、清理等任务 + +## Use Cases in AI Agent +- 健康检查：定时检测服务状态 +- 数据处理：定时处理新数据 +- 日志分析：定时分析日志发现异常 +- 邮件分类：定时扫描邮箱 +- 每日简报：定时生成并发送报告 + +## Connections +- [[Self-Healing Systems]] ← uses ← [[Cron Jobs]]：自愈系统使用 cron 作业进行定时检查 +- [[Agentic AI]] ← executes ← [[Cron Jobs]]：AI Agent 执行定时任务实现自动化 \ No newline at end of file diff --git a/wiki/concepts/Defense-in-Depth.md b/wiki/concepts/Defense-in-Depth.md new file mode 100644 index 00000000..52712903 --- /dev/null +++ b/wiki/concepts/Defense-in-Depth.md @@ -0,0 +1,30 @@ +--- +title: "Defense in Depth" +type: concept +tags: [security, architecture, risk-mitigation] +sources: [self-healing-home-server-infrastructure-management] +last_updated: 2026-04-17 +--- + +## Summary +Defense in Depth（纵深防御）是一种多层安全架构策略，通过在多个层面部署安全控制来保护系统，即使某一层被突破，其他层仍能提供保护。在 AI Agent 安全设置中尤为重要。 + +## Definition +通过在网络、主机、应用和数据多个层面部署互补的安全控制，实现全面防护的安全架构。 + +## Key Layers +1. **网络层**：网络分段、防火墙、入侵检测 +2. **主机层**：访问控制、系统加固、监控 +3. **应用层**：输入验证、安全扫描、审计日志 +4. **数据层**：加密、访问控制、备份 + +## AI Agent Security Application +- 专用 1Password vault 限制 AI 访问范围 +- 网络分段隔离敏感服务 +- 每日安全审计检查特权容器、硬编码 secrets、过度宽松权限 +- 分支保护：PR 必须人工审查，Agent 无法覆盖 + +## Connections +- [[TruffleHog]] ← implements ← [[Defense in Depth]]：TruffleHog 扫描实现应用层安全 +- [[Gitea]] ← enables ← [[Defense in Depth]]：本地 Git 作为防御层 +- [[Zero Trust Architecture]] ← related_to ← [[Defense in Depth]]：纵深防御是零信任的基础 \ No newline at end of file diff --git a/wiki/concepts/Knowledge-Extraction.md b/wiki/concepts/Knowledge-Extraction.md new file mode 100644 index 00000000..7e43da00 --- /dev/null +++ b/wiki/concepts/Knowledge-Extraction.md @@ -0,0 +1,30 @@ +--- +title: "Knowledge Extraction" +type: concept +tags: [ai, knowledge-management, automation] +sources: [self-healing-home-server-infrastructure-management] +last_updated: 2026-04-17 +--- + +## Summary +Knowledge Extraction（知识提取）是指 AI Agent 从非结构化或半结构化数据源（如笔记、对话记录、邮件）中提取有价值信息并转化为结构化、可查询知识库的过程。 + +## Definition +将分散的、非结构化的信息通过 AI 处理转化为结构化、可复用知识的技术。 + +## Key Characteristics +- 从多种来源提取信息（Obsidian 笔记、ChatGPT 对话导出、邮件） +- 转化为原子事实（atomic facts） +- 构建可搜索的知识库 +- 随着时间推移价值递增 + +## Benefits +- 将个人知识资产结构化 +- 创建可搜索的知识库 +- 随时间累积价值（一个用户从 ChatGPT 历史中提取了 49,079 个原子事实） +- 支持 AI Agent 的上下文记忆 + +## Connections +- [[Obsidian]] ← stores ← [[Knowledge Extraction]]：Obsidian 笔记是知识提取的来源之一 +- [[Agentic AI]] ← performs ← [[Knowledge Extraction]]：AI Agent 执行知识提取 +- [[Knowledge Network]] ← built_by ← [[Knowledge Extraction]]：知识提取构建知识网络 \ No newline at end of file diff --git a/wiki/concepts/Morning-Briefing.md b/wiki/concepts/Morning-Briefing.md new file mode 100644 index 00000000..94383452 --- /dev/null +++ b/wiki/concepts/Morning-Briefing.md @@ -0,0 +1,31 @@ +--- +title: "Morning Briefing" +type: concept +tags: [automation, reporting, ai-agent] +sources: [self-healing-home-server-infrastructure-management] +last_updated: 2026-04-17 +--- + +## Summary +Morning Briefing（每日简报）是 AI Agent 定时生成的综合报告，包含天气、日历、系统健康、任务状态等信息，在每天早晨自动交付给用户。 + +## Definition +AI Agent 每天定时生成并发送的综合报告，汇总多个数据源的关键信息。 + +## Typical Content +- **天气**：当前条件和预报 +- **日历**：当天事件、冲突检测 +- **系统健康**：CPU/RAM/存储、服务状态、最近部署、告警 +- **任务看板**：昨日完成、进行中、阻塞项 +- **亮点**：夜间脑暴要点、待处理邮件、本周截止 + +## Value +- 用户早晨快速了解全局状态 +- 无需手动检查多个系统 +- 自动化日常信息汇总 +- 支持远程运维（如边遛狗边处理部署问题） + +## Connections +- [[Agentic AI]] ← generates ← [[Morning Briefing]]：AI Agent 生成每日简报 +- [[Cron Jobs]] ← triggers ← [[Morning Briefing]]：定时任务触发简报生成 +- [[K3s]] ← monitored_by ← [[Morning Briefing]]：K3s 集群健康状态包含在简报中 \ No newline at end of file diff --git a/wiki/concepts/YouTube-Digest.md b/wiki/concepts/YouTube-Digest.md new file mode 100644 index 00000000..ea83c4bb --- /dev/null +++ b/wiki/concepts/YouTube-Digest.md @@ -0,0 +1,27 @@ +--- +title: "YouTube Digest" +type: concept +tags: [agent-workflow, automation] +date: 2026-04-17 +--- + +## Source +- [[raw/Agent/usecases/daily-youtube-digest.md]] + +## Definition +AI Agent 自动从订阅的 YouTube 频道获取最新视频并生成每日摘要的工作流。 + +## When to Use +- 每天早晨获取感兴趣频道的更新 +- 追踪特定关键词相关的新视频 +- 替代不可靠的 YouTube 官方通知 + +## How It Works +1. 使用 youtube-full skill 的 `channel/latest` 获取频道最新视频 +2. 获取视频 Transcript（消耗积分） +3. 用 AI 总结要点 +4. 推送 digest（每日定时或按需） + +## Related Concepts +- [[Agent-Chain]]：多个 Agent 串联工作 +- [[TranscriptAPI]]：视频转录服务 \ No newline at end of file diff --git a/wiki/concepts/youtube-full-skill.md b/wiki/concepts/youtube-full-skill.md new file mode 100644 index 00000000..11e87dcb --- /dev/null +++ b/wiki/concepts/youtube-full-skill.md @@ -0,0 +1,26 @@ +--- +title: "youtube-full skill" +type: concept +tags: [skill, openclaw, youtube] +date: 2026-04-17 +--- + +## Source +- [[raw/Agent/usecases/daily-youtube-digest.md]] + +## Definition +OpenClaw 的 YouTube 集成 skill，提供频道视频获取和 Transcript 获取能力。 + +## Key Features +- `channel/latest`：获取频道最新视频（免费） +- `channel/resolve`：解析频道 handle（免费） +- 获取视频 Transcript（消耗积分） +- 集成 TranscriptAPI.com API + +## Credits +- 注册赠送 100 免费积分 +- channel 操作免费，仅 Transcript 消耗积分 + +## Related Entities +- [[OpenClaw]]：运行 skill 的 AI Agent 平台 +- [[TranscriptAPI]]：提供视频转录的 API 服务 \ No newline at end of file diff --git a/wiki/entities/ArgoCD.md b/wiki/entities/ArgoCD.md new file mode 100644 index 00000000..c0d5dfa2 --- /dev/null +++ b/wiki/entities/ArgoCD.md @@ -0,0 +1,27 @@ +--- +title: "ArgoCD" +type: entity +tags: [gitops, deployment, kubernetes] +sources: [self-healing-home-server-infrastructure-management] +last_updated: 2026-04-17 +--- + +## Description +GitOps 持续交付工具，用于 Kubernetes 应用程序的自动化部署和管理。 + +## Key Features +- 声明式应用定义 +- 自动同步集群状态与 Git 仓库 +- 可视化 UI 和 CLI +- 回滚和审计功能 +- 多租户支持 + +## Use Cases +- K3s 集群的持续部署 +- 基础设施即代码的自动化同步 +- 家庭实验室应用的部署管理 + +## Related +- [[Kubernetes]] — ArgoCD 部署的目标平台 +- [[K3s]] — 轻量级 K8s，运行 ArgoCD +- [[GitOps]] — ArgoCD 实践的运维模式 \ No newline at end of file diff --git a/wiki/entities/Gitea.md b/wiki/entities/Gitea.md new file mode 100644 index 00000000..6ffde5a9 --- /dev/null +++ b/wiki/entities/Gitea.md @@ -0,0 +1,25 @@ +--- +title: "Gitea" +type: entity +tags: [git, self-hosted, devops] +sources: [self-healing-home-server-infrastructure-management] +last_updated: 2026-04-17 +--- + +## Description +自托管 Git 服务，适合本地优先 Git 工作流。在 AI Agent 场景中作为推送到公共仓库前的中转站。 + +## Key Features +- 轻量级，自托管 +- 支持 CI/CD (Woodpecker) +- 代码浏览、Issue、PR 管理 +- Webhook 支持 + +## Use Cases +- 本地优先 Git 工作流的中转仓库 +- 私有代码托管 +- CI/CD pipeline 集成 + +## Related +- [[GitHub]] — 公共代码托管平台 +- [[TruffleHog]] — 配合 Gitea 进行 secret 扫描 \ No newline at end of file diff --git a/wiki/entities/K3s.md b/wiki/entities/K3s.md new file mode 100644 index 00000000..11ffb536 --- /dev/null +++ b/wiki/entities/K3s.md @@ -0,0 +1,27 @@ +--- +title: "K3s" +type: entity +tags: [kubernetes, lightweight, home-lab] +sources: [self-healing-home-server-infrastructure-management] +last_updated: 2026-04-17 +--- + +## Description +轻量级 Kubernetes 发行版，专为资源受限环境和边缘计算设计，适合家庭实验室使用。 + +## Key Features +- 单一二进制文件，安装简单 +- 内存占用 < 512MB +- 内置 Traefik Ingress 控制器 +- 支持 SQLite 作为存储后端 +- 适合边缘和 IoT 场景 + +## Use Cases +- 家庭实验室容器编排 +- 边缘计算节点 +- 开发/测试环境 +- CI/CD runner + +## Related +- [[Kubernetes]] — K3s 是上游 K8s 的轻量分支 +- [[ArgoCD]] — GitOps 持续交付工具，运行在 K3s 集群上 \ No newline at end of file diff --git a/wiki/entities/Loki.md b/wiki/entities/Loki.md new file mode 100644 index 00000000..7dd72f3d --- /dev/null +++ b/wiki/entities/Loki.md @@ -0,0 +1,27 @@ +--- +title: "Loki" +type: entity +tags: [logging, prometheus, observability] +sources: [self-healing-home-server-infrastructure-management] +last_updated: 2026-04-17 +--- + +## Description +由 Grafana Labs 开发的水平可扩展日志聚合系统，与 Prometheus 设计理念相似，成本低、易于运维。 + +## Key Features +- 水平可扩展 +- 与 Prometheus 和 Grafana 深度集成 +- 标签驱动的日志索引 +- 低存储成本 +- PromQL 风格的日志查询 + +## Use Cases +- Kubernetes 集群日志聚合 +- 基础设施日志分析 +- 与 Prometheus/Grafana 监控栈集成 + +## Related +- [[Grafana]] — Loki 通常与 Grafana 可视化一起使用 +- [[Prometheus]] — Loki 与 Prometheus 同为 CNCF 项目，互补使用 +- [[K3s]] — K3s 集群的日志聚合 \ No newline at end of file diff --git a/wiki/entities/Recapio.md b/wiki/entities/Recapio.md new file mode 100644 index 00000000..8b4234ae --- /dev/null +++ b/wiki/entities/Recapio.md @@ -0,0 +1,18 @@ +--- +title: "Recapio" +type: entity +tags: [product, youtube] +date: 2026-04-17 +--- + +## Source +- [[raw/Agent/usecases/daily-youtube-digest.md]] + +## Definition +Recapio.com 是一款提供每日 YouTube 视频摘要的产品。 + +## Role +- 竞品，提供类似的 Daily YouTube Recap 功能 + +## Aliases +- Recapio - Daily YouTube Recap \ No newline at end of file diff --git a/wiki/entities/TranscriptAPI.md b/wiki/entities/TranscriptAPI.md new file mode 100644 index 00000000..73bcd97f --- /dev/null +++ b/wiki/entities/TranscriptAPI.md @@ -0,0 +1,19 @@ +--- +title: "TranscriptAPI" +type: entity +tags: [api-service, youtube] +date: 2026-04-17 +--- + +## Source +- [[raw/Agent/usecases/daily-youtube-digest.md]] + +## Definition +TranscriptAPI.com 是提供 YouTube 视频 Transcript 获取的 API 服务。 + +## Role +- 为 AI Agent 提供视频字幕文本获取能力 +- 支持每日 digest 工作流的转录提取 + +## Aliases +- TranscriptAPI.com \ No newline at end of file diff --git a/wiki/entities/TruffleHog.md b/wiki/entities/TruffleHog.md new file mode 100644 index 00000000..02918433 --- /dev/null +++ b/wiki/entities/TruffleHog.md @@ -0,0 +1,26 @@ +--- +title: "TruffleHog" +type: entity +tags: [security, secrets, scanning] +sources: [self-healing-home-server-infrastructure-management] +last_updated: 2026-04-17 +--- + +## Description +开源 secrets 扫描工具，检测代码和配置中的硬编码 API 密钥、密码和 tokens。在 AI Agent 安全设置中作为预推送钩子强制执行。 + +## Key Features +- 扫描 Git 历史中的 secrets +- 支持 700+ 检测器（AWS、GitHub、Slack 等） +- 可作为 pre-commit/pre-push 钩子运行 +- CI/CD 集成支持 + +## Use Cases +- 阻止硬编码 secrets 推送到仓库 +- CI pipeline 中的自动化扫描 +- AI Agent 安全防护的关键工具 + +## Related +- [[GitHub]] — 代码托管平台 +- [[Gitea]] — 本地 Git 服务，配合 TruffleHog 进行扫描 +- [[1Password]] — 安全 secrets 管理，AI Agent 应使用此工具而非硬编码 \ No newline at end of file diff --git a/wiki/index.md b/wiki/index.md index 2a007e69..8a1514dd 100644 --- a/wiki/index.md +++ b/wiki/index.md @@ -1,10 +1,14 @@ ## Overview - [Overview](overview.md) — 知识库总览 -- [Claude Code 调用方法总结](sources/claude-code-diao-yong-fang-fa-zong-jie.md) — Hermes 调用 Claude Code 的两种模式及关键参数（Print Mode、TMUX 交互模式） +- [Health & Symptom Tracker](sources/health-symptom-tracker.md) — AI Agent 自动追踪食物和症状的工作流 + +- [Self-Healing Home Server & Infrastructure Management](sources/self-healing-home-server-infrastructure-management.md) — AI Agent 作为家庭基础设施的自动化运维代理（OpenClaw、cron 作业、自愈修复、安全审计） - [N8N Full Tutorial Building AI Agents in 2025 for Beginners!](sources/n8n-full-tutorial-building-ai-agents-in-2025-for-beginners.md) — N8N 平台构建 AI Agent 的入门教程（节点类型、工具集成、记忆机制） +- [Multi-Agent Content Factory](sources/multi-agent-content-factory.md) — 在 Discord 中构建多 Agent 内容工厂，实现研究→写作→设计自动化流水线 + - [Dataview——让我从"笔记黑洞"里逃出来的 Obsidian 神器](sources/Dataview-让我从-笔记黑洞-里逃出来的-Obsidian-神器-1.md) — 微信公众号「赫点茶」分享的 Dataview 插件使用体验，让笔记真正"活"起来 - [为什么你的笔记总是乱糟糟？试试这个方法，彻底告别信息混乱！](sources/bi-ji-zheng-li-fang-fa-ga-bie-hun-luan.md) — 微信公众号「赫点茶」分享的笔记整理方法 - [开发经验与项目规范整理文档](sources/kai-fa-jing-yan-yu-xiang-mu-gui-fan-zheng-li-wen-dang.md) — 软件开发经验与项目规范整理（变量名维护、文件结构、编码规范、架构原则） @@ -87,10 +91,16 @@ - [使用Claude自动生成N8N工作流的实操教程](sources/使用Claude自动生成N8N工作流的实操教程.md) — 利用 Claude AI 助手自动生成 n8n 工作流的实操教程（n8n-mcp 集成、Opensea 模型配置） - [万字保姆级教程，让你90天跑通"一人公司"模式（附AI提示词）](sources/万字保姆级教程-让你90天跑通一人公司模式-附AI提示词.md) — 通过找到个人优势实现一人公司模式的方法论（天才地带自检、Ikigai交集、产品体系搭建） +- [Multi-Agent Specialized Team (Solo Founder Setup)](sources/multi-agent-team.md) — Solo founder 通过多 Agent specialized team 实现高效工作模式（角色定义、共享内存、Telegram 控制、定时任务） + - [Podcast Production Pipeline](sources/podcast-production-pipeline.md) — 多 Agent 协同的播客生产流水线，将录制前研究、脚本、Show Notes、社交媒体素材、SEO 描述等 70% 非创意性工作自动化 - [Automated Meeting Notes & Action Items](sources/meeting-notes-action-items.md) — AI Agent 自动将会议转录转化为结构化笔记，并在项目管理工具（Jira、Linear、Todoist）中创建任务 +- [Daily YouTube Digest](sources/daily-youtube-digest.md) — AI Agent 自动从订阅频道获取视频并生成每日摘要的工作流 + +- [Project State Management System](sources/project-state-management.md) — 事件驱动系统替代 Kanban 看板，通过数据库存储项目状态和历史事件，AI Agent 自然语言交互追踪进度 + ## Entities - [营销人张飞宇](entities/营销人张飞宇.md) — 微信公众号作者，专注于个人品牌、商业变现方法论 - [Mac Mini](entities/Mac-Mini.md) — Apple Mac Mini M4 主控节点，内网 IP 192.168.3.189 diff --git a/wiki/log.md b/wiki/log.md index b58ad931..260b5743 100644 --- a/wiki/log.md +++ b/wiki/log.md @@ -1,3 +1,39 @@ +## [2026-04-17] ingest | Project State Management System +- Source file: raw/Agent/usecases/project-state-management.md +- Status: ✅ 成功摄入 +- Summary: 使用事件驱动系统替代传统 Kanban 看板，通过数据库存储项目状态和历史事件，AI Agent 自然语言交互追踪进度，自动生成每日站会摘要，Git 集成实现代码变更可追溯性 +- Entities created: PostgreSQL（已有）, GitHub（已有）, Discord（已有）, Cron Jobs（已有） +- Concepts created: 事件驱动（已存在于 Node.js 概念中） +- Source page: wiki/sources/project-state-management.md +- Notes: 与现有 Kanban 概念形成对比/冲突关系；强化 AI ChatOps 概念 + +## [2026-04-17] ingest | Health & Symptom Tracker +- Source file: raw/Agent/usecases/health-symptom-tracker.md +- Status: ✅ 成功摄入 +- Summary: 使用 AI Agent 自动追踪食物和症状，识别食物敏感度。通过 Telegram 主题接收消息，OpenClaw 解析并记录到 markdown 文件，三次/日定时提醒，每周自动分析模式 +- Entities created: （已有 OpenClaw） +- Concepts created: （已有 Cron Jobs、上下文记忆） +- Source page: wiki/sources/health-symptom-tracker.md +- Notes: 与现有 OpenClaw entity 关联；健康管理场景的 Agent 应用 + +## [2026-04-17] ingest | Self-Healing Home Server & Infrastructure Management +- Source file: raw/Agent/usecases/self-healing-home-server.md +- Status: ✅ 成功摄入 +- Summary: AI Agent 作为家庭基础设施的自动化运维代理，解决 24/7 待命负担、服务故障、证书过期等问题，通过定时任务实现自愈修复、安全审计、知识提取等功能 +- Entities created: K3s, Gitea, TruffleHog, ArgoCD, Loki +- Concepts created: Cron Jobs, Knowledge Extraction, Morning Briefing, Defense in Depth +- Source page: wiki/sources/self-healing-home-server-infrastructure-management.md +- Notes: 与现有 OpenClaw entity 关联；强化 Self-Healing Systems 概念；新增家庭实验室自动化运维模式 + +## [2026-04-17] ingest | Daily YouTube Digest +- Source file: raw/Agent/usecases/daily-youtube-digest.md +- Status: ✅ 成功摄入 +- Summary: AI Agent 自动从订阅频道获取视频并生成每日摘要的工作流，解决 YouTube 通知不可靠的痛点 +- Entities created: TranscriptAPI, Recapio +- Concepts created: YouTube-Digest, youtube-full-skill +- Source page: wiki/sources/daily-youtube-digest.md +- Notes: 与竞品 Recapio 功能重叠，但此方案是可自托管的开源方案 + ## [2026-04-17] ingest | 安装Claude Desktop - Source file: raw/Agent/n8n+Claude 通过自然语言自动化工作流.md - Status: ✅ 成功摄入 @@ -724,10 +760,10 @@ - Source page: wiki/sources/podcast-production-pipeline.md - Notes: 新增 4 个概念；与 Multi-Agent Content Factory 概念关联（待后续摄入） -## [2026-04-17] ingest | Automated Meeting Notes & Action Items -- Source file: raw/Agent/usecases/meeting-notes-action-items.md +## [2026-04-17] ingest | Multi-Agent Content Factory +- Source file: raw/Agent/usecases/content-factory.md - Status: ✅ 成功摄入 -- Summary: AI Agent 自动将会议转录转化为结构化笔记，并在项目管理工具（Jira、Linear、Todoist、Notion）中创建任务 -- Concepts created: Task Automation -- Source page: wiki/sources/meeting-notes-action-items.md -- Notes: 新增 Task Automation 概念；关联现有 Workflow Automation 概念 +- Summary: 在 Discord 中构建多 Agent 内容工厂，实现研究→写作→设计自动化流水线，解决内容创作三阶段手动操作痛点 +- Concepts created: Agent Chain（已存在） +- Source page: wiki/sources/multi-agent-content-factory.md +- Notes: 与 Podcast Production Pipeline 概念关联；扩展 Agent Chain 应用场景 diff --git a/wiki/overview.md b/wiki/overview.md index 4eb4639a..8601c33b 100644 --- a/wiki/overview.md +++ b/wiki/overview.md @@ -20,6 +20,7 @@ AI 开源项目、Cloud & DevOps、Vibe Coding - CI/CD 流水线：自动化测试、集成和部署的持续交付管道 - Infrastructure as Code (IaC)：通过代码实现一致性、版本控制的基础设施管理 - 敏捷实践：Scrum、Kanban 等迭代开发方法论 +- 事件驱动项目管理：使用数据库存储项目状态和历史事件，通过 AI Agent 自然语言交互替代静态 Kanban 看板 - 内网穿透（NAT Penetration）：将内网服务通过公网服务器暴露给外部访问的技术，FRP 是常用方案之一 - Workspace：OpenClaw 中 Agent 的工作台目录，包含 AGENTS.md、SOUL.md、USER.md、IDENTITY.md、TOOLS.md、BOOTSTRAP.md、memory/ 等配置文件 - Memory 目录：OpenClaw 的长期记忆机制，按日期滚动存储跨会话积累的信息 @@ -41,6 +42,8 @@ AI 开源项目、Cloud & DevOps、Vibe Coding - 内容矩阵：核心主题×内容形式的二维内容策略，一次制作百次分发 - 销售漏斗：获客→激活→转化的客户转化路径 - Task Automation：自动将任务创建过程从手动操作转化为系统执行的机制 +- Self-Healing Systems（自愈系统）：主动检测异常并自动修复的系统，无需人工干预即可恢复正常运行状态 +- Cron Jobs（定时任务）：Linux 基于时间的任务调度机制，AI Agent 通过定时作业实现持续自动化价值 - **家庭网络环境概览** — 家庭网络基础设施架构与多服务部署方案（FRP内网穿透、Caddy反向代理、Cloudflare DNS托管） - **Vibe-Kanban + OpenCode 在 Ubuntu Server 上安装与管理指南** — 在 Ubuntu Server 上使用 shenwei 用户安装 Node 20、Vibe-Kanban 与 OpenCode，并通过 pm2 管理进程的完整指南 diff --git a/wiki/sources/daily-youtube-digest.md b/wiki/sources/daily-youtube-digest.md new file mode 100644 index 00000000..1a55d58c --- /dev/null +++ b/wiki/sources/daily-youtube-digest.md @@ -0,0 +1,44 @@ +--- +title: "Daily YouTube Digest" +type: source +tags: [agent-use-case, youtube, automation] +date: 2026-04-17 +--- + +## Source File +- [[raw/Agent/usecases/daily-youtube-digest.md]] + +## Summary +- 核心主题：AI Agent 自动从订阅的 YouTube 频道获取最新视频并生成每日摘要 +- 问题域：YouTube 通知不可靠、内容分发效率低、个性化内容获取困难 +- 方法/机制：youtube-full skill + TranscriptAPI 获取视频 Transcript 并用 AI 总结 +- 结论/价值：每天早晨获得个性化内容简报，避免算法推荐的信息茧房 + +## Key Claims +- YouTube 通知不可靠，即使订阅了频道，新视频也不会出现在首页推荐中 +- youtube-full skill 集成 TranscriptAPI.com 比 yt-dlp 更可靠（不需二进制、跨平台工作、不被拦截） +- `channel/latest` 和 `channel/resolve` 免费检查新上传，仅 Transcript 消耗积分 +- 关键词追踪模式通过 seen-videos.txt 避免重复获取，节省积分 + +## Key Quotes +> "You subscribe to channels, but their new videos never show up in your home feed. They're not in notifications. They just... disappear." — 核心痛点描述 +> "It's fun to start the day with curated content insights instead of doom-scrolling a recommendation feed." — 价值主张 + +## Key Concepts +- [[YouTube-Digest]]：AI Agent 自动获取订阅频道最新视频并生成摘要的工作流 +- [[TranscriptAPI]]：提供视频 Transcript 的 API 服务 +- [[Agent-Chain]]: 多个 AI Agent 串联工作，各自负责不同阶段（获取→总结→推送） + +## Key Entities +- [[OpenClaw]]：AI Agent 管理工具，用于执行自动化工作流 +- [[TranscriptAPI]]：视频 Transcript API 服务商，提供 100 免费积分 +- [[Recapio]]：同类产品，提供 Daily YouTube Recap 功能 + +## Connections +- [[YouTube-Digest]] ← uses ← [[youtube-full-skill]] +- [[youtube-full-skill]] ← integrates ← [[TranscriptAPI]] +- [[OpenClaw]] ← runs ← [[Agent-Chain]] +- [[Recapio]] ← competes_with ← [[YouTube-Digest]] + +## Contradictions +- 与 Recapio 功能重叠，但此方案是可自托管的开源方案 \ No newline at end of file diff --git a/wiki/sources/health-symptom-tracker.md b/wiki/sources/health-symptom-tracker.md new file mode 100644 index 00000000..b491f218 --- /dev/null +++ b/wiki/sources/health-symptom-tracker.md @@ -0,0 +1,38 @@ +--- +title: "Health & Symptom Tracker" +type: source +tags: [AI Agent, OpenClaw, 健康管理] +date: 2026-04-17 +--- + +## Source File +- [[raw/Agent/usecases/health-symptom-tracker.md]] + +## Summary +- **核心主题**：使用 AI Agent 自动追踪食物和症状，识别食物敏感度 +- **问题域**：个人健康管理、食物敏感度检测 +- **方法/机制**：Telegram 消息主题 + OpenClaw 解析日志 + Cron Jobs 定时提醒 + 模式分析 +- **结论/价值**：将繁琐的手动记录转化为自动化工作流，AI 分析帮助发现潜在诱因 + +## Key Claims +- OpenClaw 通过 Telegram 主题自动解析食物和症状消息并记录时间戳 +- 3 次/日定时提醒（早餐、午餐、晚餐）确保记录持续性 +- 每周日自动分析一周数据，识别食物与症状的关联模式 + +## Key Quotes +> "Identifying food sensitivities requires consistent logging over time, which is tedious to maintain. You need reminders to log and analysis to spot patterns." + +## Key Concepts +- [[Cron Jobs]]：Linux 定时任务调度机制，用于设置每日提醒 +- [[上下文记忆]]：OpenClaw 追踪已知诱因并随着模式发现更新记忆的能力 + +## Key Entities +- [[OpenClaw]]：AI Agent 管理工具，执行消息解析、日志记录、提醒和分析任务 + +## Connections +- [[OpenClaw]] ← uses ← [[Telegram]] +- [[Cron Jobs]] ← schedules ← [[health-tracker reminders]] +- [[Health & Symptom Tracker]] ← enables ← [[食物敏感度检测]] + +## Contradictions +（暂无） \ No newline at end of file diff --git a/wiki/sources/multi-agent-content-factory.md b/wiki/sources/multi-agent-content-factory.md new file mode 100644 index 00000000..be2fa0d9 --- /dev/null +++ b/wiki/sources/multi-agent-content-factory.md @@ -0,0 +1,50 @@ +--- +title: "Multi-Agent Content Factory" +type: source +tags: [agent, workflow, automation] +date: 2026-04-17 +--- + +## Source File +- [[raw/Agent/usecases/content-factory.md]] + +## Summary +- 核心主题：多 Agent 内容工厂流水线 +- 问题域：内容创作效率提升 +- 方法/机制：通过 Discord 频道隔离不同 Agent（Research、Writing、Thumbnail），实现研究→写作→设计的自动化流水线 +- 结论/价值：无需逐个 prompt，让 Agent 自动协同工作，早上醒来内容已生成 + +## Key Claims +- 链式 Agent（Chained Agents）是核心 —— 研究投喂写作，写作投喂设计，全流程无需手动干预 +- Discord 频道隔离使每阶段工作可单独审查和反馈 +- 支持任意内容格式：tweet threads、 newsletters、LinkedIn posts、podcast outlines、blog articles +- 本地模型图像生成（如 Mac Studio 上的 Nano Banana）可降低成本并增强控制 + +## Key Quotes +> "Each agent works in its own Discord channel, keeping everything organized and reviewable" — 频道隔离设计 +> "The power is in the chained agents — research feeds writing, writing feeds thumbnails" — 核心价值主张 + +## Key Concepts +- [[Agent-Chain]]：多个 Agent 串联工作，各自负责不同阶段的流水线架构 +- [[工作流自动化]]：预定义自动化流程，与 AI Agent 互补 +- [[上下文记忆]]：AI Agent 保留对话历史的能力 +- [[sessions_spawn]]：OpenClaw 多 Agent 并发生成 +- [[sessions_send]]：OpenClaw 多 Agent 消息发送 + +## Key Entities +- [[OpenClaw]]：AI Agent 管理工具，支持多 Agent 编排 +- [[Discord]]：社区通讯平台，作为 Agent 工作流界面 +- [x-research-v2](https://clawhub.ai)：社交媒体研究工具 +- [Nano Banana]：Mac 本地图像生成工具 +- [knowledge-base](https://clawhub.ai)：RAG 驱动的知识库研究技能 +- [Alex Finn]：YouTube 教程作者，激发此工作流灵感 + +## Connections +- [[Multi-Agent Content Factory]] ← extends ← [[Agent-Chain]] +- [[Podcast Production Pipeline]] ← similar_to ← [[Multi-Agent Content Factory]] +- [[Daily YouTube Digest]] ← similar_to ← [[Multi-Agent Content Factory]] +- [[Agent-Chain]] ← uses ← [[sessions_spawn]] +- [[Agent-Chain]] ← uses ← [[sessions_send]] + +## Contradictions +- （暂无） \ No newline at end of file diff --git a/wiki/sources/multi-agent-team.md b/wiki/sources/multi-agent-team.md new file mode 100644 index 00000000..c42b6816 --- /dev/null +++ b/wiki/sources/multi-agent-team.md @@ -0,0 +1,52 @@ +--- +title: "Multi-Agent Specialized Team (Solo Founder Setup)" +type: source +tags: [] +date: 2026-04-17 +--- + +## Source File +- [[raw/Agent/usecases/multi-agent-team.md]] + +## Summary +- 核心主题：Solo founder（一人创始人）通过多 Agent specialized team 实现高效工作模式 +- 问题域：一人创始人需要在战略、开发、营销、销售、运营等多角色间切换，上下文切换破坏深度工作 +- 方法/机制：每个 Agent 有独立角色、人格、优化的模型，通过共享内存+私有上下文+单一 Telegram 控制平面+定时任务实现协同 +- 结论/价值：Agent 需有鲜明人格，共享内存+私有上下文组合是关键，便宜模型做简单任务，定时任务是飞轮，建议从2个Agent开始 + +## Key Claims +- 单个 Agent 无法同时做好所有事情：单一 Agent 的上下文窗口在同时处理策略、代码、营销研究、商业分析时快速填满 +- 通用提示产生通用输出：编码 Agent 不应该同时撰写营销文案 +- 需求团队而非另一个工具：Agent 应在后台工作并呈现结果，而非需要持续照料 + +## Key Quotes +> "Give agents distinct names and communication styles makes it natural to 'talk to your team' rather than wrestle with a generic AI" — 鲜明人格让与 Agent 交互更像与团队对话 +> "Shared memory + private context: The combination is critical — agents need common ground (goals, decisions) but also their own space to accumulate domain expertise" — 共享内存与私有上下文组合是关键 +> "Right model for the right job: Don't use an expensive reasoning model for keyword monitoring" — 匹配模型能力与任务复杂度 +> "Start with 2, not 4: Begin with a lead + one specialist, then add agents as you identify bottlenecks" — 从2个开始逐步扩展 + +## Key Concepts +- [[Multi-Agent Team]]：多 Agent 协作架构，每个 Agent 有独立角色、人格、优化的模型 +- [[Shared Memory]]：团队共享的文档、目标、关键决策，所有 Agent 可访问 +- [[Private Context]]：每个 Agent 维护自己的对话历史和领域特定的笔记 +- [[Scheduled Tasks]]：Agent 主动工作而非被动响应，定时执行任务产生飞轮效应 + +## Key Entities +- [[OpenClaw]]：AI Agent 管理工具，支持多 Agent 协调 +- [[Telegram]]：单一控制平面，通过 @tag 触发特定 Agent +- [[Claude Opus]]：用于复杂推理任务（如 Strategy Lead） +- [[Claude Sonnet]]：用于快速分析任务（如 Business Analyst） +- [[Gemini]]：用于网络研究和长上下文分析（如 Marketing Agent） +- [[Trebuh]]：X 用户，实践4个 OpenClaw Agent 的 solo founder + +## Connections +- [[OpenClaw]] ← enables ← [[Multi-Agent Team]] +- [[Telegram]] ← routes ← [[Multi-Agent Team]] +- [[Vibe-Kanban]] ← similar_role ← [[Multi-Agent Team]]（AI Agent 管理工具） +- [[n8n]] ← integrates_with ← [[Agent Chain]]（工作流自动化与 Agent 协同） + +## Contradictions +- 与 [[Vibe-Kanban]] 对比： + - 冲突点：两者都是 AI Agent 管理工具，但架构不同 + - 当前观点：Multi-Agent Team 强调多 Agent 并行、共享记忆、Telegram 控制 + - 对方观点：Vibe-Kanban 强调单 Agent 事件驱动、自然语言交互 \ No newline at end of file diff --git a/wiki/sources/project-state-management.md b/wiki/sources/project-state-management.md new file mode 100644 index 00000000..f7cd8298 --- /dev/null +++ b/wiki/sources/project-state-management.md @@ -0,0 +1,49 @@ +--- +title: "Project State Management System: Event-Driven Alternative to Kanban" +type: source +tags: [project-state, AI-Agent] +date: 2026-04-17 +--- + +## Source File +- [[raw/Agent/usecases/project-state-management.md]] + +## Summary +- 核心主题：使用事件驱动系统替代传统 Kanban 看板进行项目状态管理 +- 问题域：手动更新看板导致的信息丢失、上下文丢失、项目漂移 +- 方法/机制：数据库存储项目状态 + AI Agent 自然语言交互 + Git 集成自动关联 +- 结论/价值：通过自然语言对话自动追踪项目进度、保留决策上下文、生成每日站会摘要 + +## Key Claims +- 事件驱动系统可替代静态 Kanban 看板，解决卡片过期和上下文丢失问题 +- AI Agent 通过自然语言对话自动记录事件、更新项目状态、回答状态查询 +- Git 提交自动扫描并关联到项目，实现代码变更与项目进度的可追溯性 +- 每日站会摘要由系统自动生成，涵盖昨日进展、今日计划、当前阻碍 + +## Key Quotes +> "Traditional Kanban boards are static and require manual updates. You forget to move cards, lose context between sessions, and can't track the 'why' behind state changes." — 描述 Kanban 看板的核心痛点 + +> "Instead of dragging cards, you chat with your assistant: 'Finished the auth flow, starting on the dashboard.' The system logs the event, updates project state, and preserves context." — 事件驱动系统的工作方式 + +## Key Concepts +- [[事件驱动]]：通过自然语言事件更新自动触发状态转换的机制 +- [[项目状态数据库]]：存储项目信息、历史事件和阻碍项的关系型数据库 +- [[每日站会摘要]]：基于事件和 Git 提交自动生成的每日进度报告 +- [[Git 集成]]：自动扫描 Git 提交并关联到对应项目的机制 + +## Key Entities +- [[PostgreSQL]]：项目状态数据库的推荐技术栈（也支持 SQLite） +- [[GitHub]]：通过 gh CLI 进行提交追踪 +- [[Discord]]：项目更新和查询的交互渠道 +- [[Cron Jobs]]：每日摘要的定时触发机制 + +## Connections +- [[Event Sourcing]] ← 理论基础 ← [[Project State Management]] +- [[Kanban]] ← 被替代 ← [[Project State Management]] +- [[AI ChatOps]] ← 实现方式 ← [[Project State Management]] + +## Contradictions +- 与 [[Kanban]] 看板方法冲突： + - 冲突点：静态看板需要手动更新，事件驱动系统自动追踪 + - 当前观点：事件驱动系统通过自然语言自动记录，避免手动操作和信息丢失 + - 对方观点：Kanban 看板可视化程度高，适合团队协作和任务分配 \ No newline at end of file diff --git a/wiki/sources/self-healing-home-server-infrastructure-management.md b/wiki/sources/self-healing-home-server-infrastructure-management.md new file mode 100644 index 00000000..c00b3c9d --- /dev/null +++ b/wiki/sources/self-healing-home-server-infrastructure-management.md @@ -0,0 +1,59 @@ +--- +title: "Self-Healing Home Server & Infrastructure Management" +type: source +tags: [openclaw, home-server, automation, self-healing, infrastructure] +sources: [] +last_updated: 2026-04-17 +--- + +## Source File +- [[raw/Agent/usecases/self-healing-home-server.md]] + +## Summary +- 核心主题：AI Agent 作为家庭基础设施的自动化运维代理 +- 问题域：家庭实验室运维的 24/7 待命负担、服务故障、证书过期、磁盘满、Pod 崩溃循环 +- 方法/机制：OpenClaw 定时任务系统、健康监控、自愈修复、基础设施代码管理、每日简报、邮件分类、知识提取、安全审计 +- 结论/价值：将 AI Agent 转变为持续运行的基础设施管理代理，在问题发生前主动检测、诊断和修复 + +## Key Claims +- 运行家庭服务器意味着 24/7 随时待命处理基础设施问题 +- AI Agent 可以通过 SSH、Terraform、Ansible、kubectl 命令自动修复基础设施问题 +- AI 会硬编码 secrets —— 这是首要安全风险，必须强制执行预提交钩子和 secret 扫描 +- 本地优先 Git 工作流至关重要 —— 永远不要让 Agent 直接推送到公共仓库 +- Cron 作业是真正产品 —— 定时自动化比临时命令提供更多日常价值 + +## Key Quotes +> "I can't believe I have a self-healing server now" — Agent 可以在问题发生前自动修复 +> "AI assistants will happily hardcode secrets. They sometimes don't have the same instincts humans do." — 防御性安全设置至关重要 + +## Key Concepts +- [[Self-Healing Systems]]：主动检测异常并自动修复的系统 +- [[Infrastructure as Code (IaC)]]：通过代码管理基础设施 +- [[Agentic AI]]：具备自主决策和任务执行能力的 AI 系统 +- [[K3s]]：轻量级 Kubernetes，用于家庭实验室 +- [[TruffleHog]]：Secret 扫描工具，检测代码中的硬编码密钥 +- [[Gitea]]：自托管 Git 服务，本地优先工作流 +- [[ArgoCD]]：GitOps 持续交付工具 +- [[Loki]]：日志聚合系统 + +## Key Entities +- [[OpenClaw]]：AI Agent 管理工具，本用例的核心平台 +- [[Obsidian]]：知识库管理，用于知识提取 +- [[K3s]]：轻量级 Kubernetes 发行版，家庭集群 +- [[1Password]]：密码管理，AI 专用保险库 +- [[gog]]：Gmail CLI 工具，用于邮件分类 +- [[TruffleHog]]：Secret 扫描工具 + +## Connections +- [[OpenClaw]] ← manages ← [[Self-Healing Systems]]：OpenClaw 作为自愈系统的管理平台 +- [[K3s]] ← hosts ← [[ArgoCD]]：K3s 集群运行 ArgoCD 进行部署管理 +- [[TruffleHog]] ← blocks ← [[Hardcoded Secrets]]：预推送钩子阻止硬编码密钥 +- [[Gitea]] ← stages ← [[Git Workflow]]：本地 Git 推送前的中转站 +- [[Obsidian]] ← provides ← [[Knowledge Base]]：知识提取的来源 + +## Contradictions +- （暂无） + +## Inspired By +- Nathan 的 OpenClaw 案例 "Reef"：运行 15 个活跃 cron 作业、24 个自定义脚本，自主构建和部署应用 +- @georgedagg_ 的部署监控、日志审查、配置修复、PR 提交案例 \ No newline at end of file