← 返回目录

Open Agent SDK (TypeScript)

社区

框架 / SDK

开源 TypeScript Agent SDK，进程内运行完整 Agent 循环，支持 Anthropic 与 OpenAI 兼容 API。

这是用于开发 MCP Server 或 Agent 的框架，不是可以直接连接到客户端的 Server。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 412 / 438
Stars: ★ 2.7k 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js >=18
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 2 个月前
工具数: 35

30FMRS · D

Open Agent SDK (TypeScript) 是一个功能丰富的开源 SDK，提供进程内 Agent 循环、多模型支持、丰富工具和技能系统。但它是第三方实现，非官方维护，使用时需注意安全配置。

最强项 · 文档质量 12/20 最弱项 · 安全与权限 3/20

可靠性

4/20

安全与权限

3/20

维护活跃度

6/20

文档质量

12/20

安装易用性

5/20

查看各项评分依据

可靠性 4/20: 仅依据 README 和仓库元数据，没有源码、CI 或测试可验证。README 声称提供 35+ 工具和完整代理循环，但缺少 server manifest，也没有可复现的 MCP 初始化/工具列表握手证据。错误处理和依赖可控性无法确认。静态校准上限为 12，且证据不足，故给 4 分。
安全与权限 3/20: 触发红线：默认 permissionMode 为 bypassPermissions，且内置 Bash、Write、Edit 等工具，可在无确认的情况下执行不可逆删除、支付、部署类命令。API key 通过环境变量传递是优点，但默认无最小权限、无沙箱，外部网络与文件系统边界不明确，故安全分取 3。
维护活跃度 6/20: 仓库未归档，有 MIT 许可证，有 10 个 open issues，但未看到提交历史、发布记录或 issue 响应证据。星标数只是发现信号，不参与计分。缺少可验证的持续维护与版本管理证据，因此给 6 分。
文档质量 12/20: README 内容较丰富，包含安装、环境变量、API 参考、15 个示例、架构和内置工具表。但没有故障排查章节，没有作为 MCP server 在主流客户端中的接入配置示例，也没有明确披露默认 bypassPermissions 的风险。作为 README 较好，但作为 MCP server 文档存在缺口，故给 12 分。
安装易用性 5/20: SDK 的安装步骤简单（npm install + 环境变量），但缺少将本仓库作为 MCP server 接入主流客户端的配置示例，也没有 server manifest 或可执行入口证据。README 中的示例还需额外依赖 tsx 运行。静态校准要求有可验证执行证据才可高于 15，此处证据不足，故给 5 分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码访问网络

适合谁

需要进程内 Agent 循环的 TypeScript 项目
希望同时支持 Anthropic 和 OpenAI 兼容模型的开发者
需要精细控制工具和权限的应用
希望在云、无服务器或 Docker 环境中运行的 Agent

不适合谁

需要官方 Claude Agent SDK 维护支持的场景
需要 CLI 功能的用户（SDK 旨在移除该依赖）
希望零代码使用 MCP 服务器的用户

所需权限

API 密钥访问（如 CODEANY_API_KEY）
文件系统读写（取决于配置的工具）
网络访问（用于 API 调用和 WebFetch/WebSearch）
环境变量配置

风险与副作用

工具可能执行破坏性操作（如 Bash、Write 等），需谨慎配置权限
API 密钥泄露风险
模型可能产生不准确或有害输出
依赖第三方 API 的可用性和成本

安装接入

准备工作

运行环境：Node.js >=18

CODEANY_API_KEY 必填密钥调用 LLM 提供商所必需的 API 密钥，从您的 API 提供商（Codeany、Anthropic 兼容或 OpenAI 兼容端点）获取。

CODEANY_AUTH_TOKEN 可选密钥可选的替代认证令牌，可代替 API 密钥使用。

其他可选配置项（3 个）

CODEANY_API_TYPE 可选选择 API 协议：anthropic-messages（默认）或 openai-completions；不设置则按模型名称自动检测。

CODEANY_BASE_URL 可选自定义 API 端点，例如 https://api.openrouter.ai/api 或 https://api.openai.com/v1。

CODEANY_MODEL 可选默认模型覆盖，例如 gpt-4o 或 anthropic/claude-sonnet-4。

安装 npm 包：npm install @codeany/open-agent-sdk
设置 API 密钥环境变量：export CODEANY_API_KEY=your-api-key
根据需要配置其他环境变量（如 CODEANY_API_TYPE、CODEANY_BASE_URL、CODEANY_MODEL）。
在你的代码中导入 SDK 并使用 query 或 createAgent 开始交互。

验证是否装好

运行 `npm install @codeany/open-agent-sdk` 并设置 CODEANY_API_KEY 后，运行一个简单的 `query()` 或 `createAgent().prompt()` 调用；如果返回模型文本结果，说明 SDK 与 API 连接正常。

常见排障

检查 API 密钥是否正确设置
确认 API 类型和基础 URL 配置正确
确保 Node.js 版本 >= 18
检查模型名称是否支持自动检测
查看网络连接和代理设置
检查会话持久化的磁盘空间

试试这样问

连接成功后，可以直接对 AI 助手这样说：

读取 package. 并告诉我项目名称。
创建文件 /tmp/hello.txt，内容为 Hello World，然后再读回该文件。
东京现在的天气怎么样？
使用代码审查 agent 审查 src/index.ts 的代码质量。

工具能力 35

Bash 写入

执行 shell 命令

Read 只读

读取文件并显示行号

Write 写入

创建或覆盖文件

Edit 写入

精确字符串替换，编辑文件

Glob 只读

按模式查找文件

Grep 只读

用正则搜索文件内容

WebFetch 只读

获取并解析网页内容

WebSearch 只读

搜索网络

展开其余 27 个工具

NotebookEdit 写入

编辑 Jupyter notebook 单元格

Agent 写入

生成子代理以并行工作

Skill 写入

调用已注册的技能

TaskCreate 写入

创建任务

TaskList 只读

列出任务

TaskUpdate 写入

更新任务

TaskGet 只读

获取任务详情

TaskStop 写入

停止任务

TaskOutput 只读

获取任务输出

TeamCreate 写入

创建多代理团队

TeamDelete 破坏性

删除多代理团队

SendMessage 写入

代理间发送消息

EnterWorktree 写入

进入 Git worktree 隔离环境

ExitWorktree 写入

退出 Git worktree 隔离环境

EnterPlanMode 写入

进入结构化规划模式

ExitPlanMode 写入

退出结构化规划模式

AskUserQuestion 只读

向用户提问获取输入

ToolSearch 只读

发现懒加载工具

ListMcpResources 只读

列出 MCP 资源

ReadMcpResource 只读

读取 MCP 资源

CronCreate 写入

创建定时任务

CronDelete 破坏性

删除定时任务

CronList 只读

列出定时任务

RemoteTrigger 写入

远程代理触发

LSP 只读

语言服务器协议（代码智能）

Config 写入

动态配置

TodoWrite 写入

会话待办列表

使用场景

构建自主 Agent 应用

执行多步工具调用任务

集成 MCP 服务器

开发自定义技能和工具

实现聊天界面或自动化工作流

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

Open Agent SDK (TypeScript) 是一个开源 SDK，让开发者能在自己的应用中直接运行 Agent 循环，无需依赖 CLI 子进程。它支持 Anthropic 消息 API 和 OpenAI 兼容 API（如 OpenAI、DeepSeek、Qwen、Mistral 等），并提供了丰富的内置工具、技能系统、生命周期钩子、子代理、权限控制、会话持久化等功能。该 SDK 可在云端、无服务器、Docker、CI/CD 等环境中部署。