task-cc-extend-26645 / session.md

任务 ID: task-cc-extend-26645 | 文件: session.md | 最后修改: 2026-02-28 09:45:03

Session Log — task-cc-extend-26645 — Claude Code 二开/扩展实现 OpenClaw 级体验调研

研究大纲（4个核心问题）

去重检查结果

查询词列表

Round 1 — SearXNG 广度搜索

SearXNG 查询1：Claude Agent SDK extension personal assistant 2025 → 28 条
不可用引擎：duckduckgo (CAPTCHA), startpage (parsing error)
关键命中：claude.com/blog/building-agents-with-the-claude-agent-sdk、platform.claude.com/docs/agent-sdk/overview、Medium SDK Terminal 教程、DataCamp SDK 教程

SearXNG 查询2：claude code sdk persistent memory telegram notification cron job → 31 条
关键命中：
- github.com/RichardAtCT/claude-code-telegram (Telegram bot + cron + session persistence)
- github.com/khaterdev/kirie (官方 Agent SDK + Telegram/Discord/Slack + 持久记忆 + 后台任务)
- github.com/PleasePrompto/ductor (Claude Code + Codex via Telegram + cron + Docker沙箱)
- github.com/mtzanidakis/praktor (多agent Claude Code编排器 + Telegram I/O + Docker)
- github.com/seedprod/claude-code-telegram (Telegram个人助理)
- github.com/godagoo/claude-telegram-relay (极简daemon + 持久记忆)
- dev.to: mem0 + Claude Agent SDK Memory 提醒 agent
- Reddit: r/ClaudeCode 社区讨论

SearXNG 查询3：claude code API relay proxy compliance anthropic ToS → 25 条
关键命中：
- theregister.com: Anthropic 明确禁止 OAuth token 用于 Agent SDK（2026-02-20）
- code.claude.com/docs/en/legal-and-compliance: 官方合规文档
- natural20.com: Anthropic 封锁 OpenClaw OAuth 详细报道
- venturebeat.com: Anthropic 打击未授权使用
- github.com/ruvnet/claude-flow/issues/605: Claude Max OAuth + LiteLLM Proxy 讨论
- github.com/badrisnarayanan/antigravity-claude-proxy: Claude/Gemini proxy 暴露 Anthropic 兼容 API

SearXNG 查询4：claude code agent sdk MCP multi-agent open source framework 2025 → 28 条
关键命中：
- github.com/ruvnet/claude-flow (多agent编排平台，带swarm/RAG/Claude Code集成)
- github.com/bobmatnyc/claude-mpm (Claude Multi-Agent Project Manager)
- github.com/wshobson/agents (multi-agent Claude Code 编排)
- claudecode.run/ (Claude Code Agentrooms，多agent开发工作区)
- clickhouse.com: 12个agent框架对比，含 Claude Agent SDK
- platform.claude.com/docs/en/agent-sdk/mcp (官方 MCP 集成文档)

Round 2 — 关键页面 web_fetch

theregister.com 2026-02-20 文章精读：
- Anthropic 2026-02-18 更新 Legal Compliance 页面，明确 OAuth token 只能用于 Claude.ai 和 Claude Code 官方客户端
- 引用原文："Using OAuth tokens obtained through Claude Free, Pro, or Max accounts in any other product, tool, or service — including the Agent SDK — is not permitted"
- 关键点：Agent SDK 也不允许使用 OAuth token！必须使用 Console API Key 或 Bedrock/Vertex 授权渠道
- OpenCode 已在 2026-02-20 提交代码移除 Claude Pro/Max OAuth 支持

官方 Agent SDK overview 精读：
- SDK 认证方式：ANTHROPIC_API_KEY（Console），或 Bedrock/Vertex/Azure
- 官方明确："Unless previously approved, Anthropic does not allow third party developers to offer claude.ai login or rate limits for their products, including agents built on the Claude Agent SDK"
- SDK 功能：Skills（Markdown定义能力）、Slash commands、Memory（CLAUDE.md）、Plugins（MCP servers）
- SDK = Claude Code 的所有能力，可编程方式调用（Python/TypeScript）
- 商业条款：适用 Anthropic Commercial ToS，支持二次分发给自己的用户

SearXNG 查询5：site:github.com claude code telegram bot personal assistant memory → 31 条
关键命中：
- ComposioHQ/open-claude-cowork: 完整个人助理（多平台IM + Claude Code 后端）
- ComposioHQ/secure-openclaw: 'OpenClaw 级' 24x7 助理（WhatsApp/Telegram/Signal/iMessage + 持久记忆 + 定时提醒 + 500+应用集成）
- letta-ai/lettabot: 跨平台持久记忆助理（Telegram/Slack/WhatsApp/Signal，基于 Letta Code SDK）
- PleasePrompto/ductor: Claude Code + Codex via Telegram + cron + Docker + 持久记忆（官方CLI，不违规）
- godagoo/claude-telegram-relay: 极简 Claude Code daemon（Supabase持久化 + 主动触达 + cross-session记忆）
- linuz90/claude-telegram-bot: Claude Code 作为通用agent via Telegram（个人助理）
- harperaa/bastionclaw: 带容器隔离的个人助理
- seedprod/openclaw-prompts-and-skills: 极简内存=文件方案（无向量DB）

SearXNG 查询6：claude agent sdk API key relay server openai compatible endpoint → 32 条
关键命中：
- github.com/RichardAtCT/claude-code-openai-wrapper: Claude Code 暴露 OpenAI 兼容 API（需 claude auth login，即 OAuth!）
- github.com/fuergaosi233/claude-code-proxy: Claude API → OpenAI API 转换（反向，不是中转场景）
- github.com/ben-vargas/ai-cli-proxy-api: 多CLI（Claude Code/Codex/Gemini）代理
- platform.claude.com/docs/en/api/openai-sdk: 官方支持用 OpenAI SDK 调 Anthropic API（用 Console API Key）
- Reddit: r/ClaudeAI 讨论用 Claude 订阅作 API key（即 OAuth 中转）→ 这条路已被 ToS 封锁

RichardAtCT/claude-code-openai-wrapper README精读：
- 核心功能：将 Claude Agent SDK 包装为 OpenAI 兼容 API（/v1/chat/completions + /v1/messages）
- 认证：支持 CLI auth（OAuth）、ANTHROPIC_API_KEY（Console）、Bedrock、Vertex AI
- 合规风险：支持 CLI auth = OAuth token 暴露给第三方，2026-02-18 ToS 更新后违规
- 合规路径：只使用 ANTHROPIC_API_KEY（Console API Key）是合规的！
- v2.2.0，Production Ready，官方 Claude Agent SDK v0.1.18

Stevens (geoffreylitt.com) 文章精读：
- 极简个人助理架构：SQLite 单表存记忆 + cron job 调 Claude API（Console API Key，合规）+ Telegram 推送
- 核心思路：memory = SQL 表的行，cron 拉数据（日历/天气/邮件）→ 早报 via Telegram
- 架构价值：说明不需要复杂框架，Claude API + cron + SQLite 即可实现个人助理核心功能

官方 claude.com/blog 文章精读（Building agents with Claude Agent SDK）：
- Claude Code SDK 已正式改名为 Claude Agent SDK（2025-09-29）
- 官方明确 Agent SDK 用途：个人助理、金融、客服、深度研究等通用 agent
- 核心设计：给 Claude 一台电脑（bash/文件/网络），让它像人一样工作
- 记忆方案：文件系统即记忆（'Conversations' 文件夹），agentic search（grep/tail）优先于向量库
- Agent loop：gather context → take action → verify work → repeat
- Email Agent Demo：存历史对话于文件夹，semantic search 用于加速上下文检索

dev.to: RecallAgent (Mem0 + Claude Agent SDK) 精读：
- 架构：Claude Agent SDK + Mem0 (持久记忆) + SQLite/Supabase（提醒状态）+ Slack 推送 + FastAPI
- 核心设计：事实(提醒状态) 与记忆(用户偏好/行为模式) 分离
- 工程价值：提供了用 Agent SDK 实现个人助理核心功能的完整参考架构
- 认证方式：使用 ANTHROPIC_API_KEY（Console），合规

aimlapi.com 三工具对比文章精读（OpenClaw vs Claude Code vs Claude Cowork）：
- Claude Cowork：2026-01 随 Claude Desktop 发布，无代码任务自动化（PDF/图片/表格），仅 Max/Pro 用户，macOS only
- Claude Code：面向专业开发者，不是个人助理工具，无持久记忆/定时任务
- OpenClaw：TypeScript 编写，作为 harness 调用任意 LLM API（Claude/GPT/Gemini/本地），非 Claude Code 本身
- 核心差异：Claude Code 是编码工具，Claude Agent SDK 是可编程框架，OpenClaw 是 harness

natural20.com 详细报道精读（Anthropic banned OpenClaw OAuth）：
- 时间线：2026-01-09 技术封锁（silent block），2026-02-17/18 正式文档化
- 封锁机制：Anthropic 服务器端识别并拦截非官方客户端的 OAuth token
- 错误信息："This credential is only authorized for use with Claude Code"
- 受影响工具：OpenCode/Roo Code/Cline/IDE 插件 + OpenClaw/NanoClaw（OAuth 路由）
- 未受影响：API Key 或 OpenRouter 用户完全不受影响
- OpenClaw 的 OAuth 逻辑：Login with Claude → 捕获 OAuth token → 路由所有请求（等同于无限 token 使用 Max 订阅）
- Thariq Shihipar（CC 团队）澄清：官方 Agent SDK + Max 订阅用于本地个人实验 OK，商业工具 NO

官方 claude-agent-sdk-demos README精读：
- 官方 Demo 列表：Email Agent（IMAP邮件助理）、Excel Demo、Hello World、Research Agent（多agent并行研究）
- Research Agent：协调子agent并行搜索→综合报告，演示 subagent 活动跟踪
- 前提条件：Bun/Node.js 18+ + ANTHROPIC_API_KEY（Console）
- 注意：官方明确标注 "local development only, NOT for production or scale"
- 这些 Demo 证明了 Agent SDK 可以构建邮件助理/研究助理，功能完整但需要自行扩展

SearXNG 查询7：claude code openai wrapper sdk relay openclaw alternative api key → 32 条
关键发现：
- docs.openclaw.ai/faq：OpenClaw 官方文档明确支持 Console API Key（非 OAuth）运行，合规
- news.ycombinator.com/47069299：HN 讨论 Anthropic 封锁 OAuth，认证方式对比（OAuth vs API Key）
- thenewstack.io：Anthropic 确认 OpenClaw/NanoClaw 用 Console API Key 可以继续使用
- travis.media: 'Anthropic API key (not OAuth) — Go to console.anthropic.com, 这是 Anthropic 明确批准的开发者方法'
- ComposioHQ/secure-openclaw: 完整的 OpenClaw 级别助理参考实现（500+应用集成）

thenewstack.io 精读（Anthropic Agent SDK 合规澄清）：
- Thariq Shihipar（CC 团队）官方澄清：'Nothing is changing about how you can use the Agent SDK and MAX subscriptions!'
- 核心区分：个人实验 = OK（用自己的 Max 账号 + Agent SDK）；商业产品 = 必须用 Console API Key
- 'If you're building a business on top of the Agent SDK, you should use an API key instead.'
- Anthropic 不会取消账户（针对过去 OAuth 使用）

Session Log — task-cc-extend-26645 — Claude Code 二开/扩展实现 OpenClaw 级体验调研

研究大纲（4个核心问题）

去重检查结果

查询词列表

Round 1 — SearXNG 广度搜索

Round 2 — 关键页面 web_fetch

相关性过滤结果

精读页面列表

报告写作阶段

知识缺口分析