opc-agent 4.1.23 → 4.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +59 -119
- package/COMPETITIVE-GAP.md +92 -92
- package/CONTRIBUTING.md +36 -36
- package/README.md +290 -290
- package/README.zh-CN.md +269 -269
- package/dist/channels/telegram.d.ts +0 -5
- package/dist/channels/telegram.d.ts.map +1 -1
- package/dist/channels/telegram.js +0 -108
- package/dist/channels/telegram.js.map +1 -1
- package/dist/channels/voice.d.ts +97 -71
- package/dist/channels/voice.d.ts.map +1 -1
- package/dist/channels/voice.js +347 -369
- package/dist/channels/voice.js.map +1 -1
- package/dist/channels/web.d.ts.map +1 -1
- package/dist/channels/web.js +2 -8
- package/dist/channels/web.js.map +1 -1
- package/dist/channels/wechat.js +6 -6
- package/dist/cli/chat.d.ts +1 -4
- package/dist/cli/chat.d.ts.map +1 -1
- package/dist/cli/chat.js +73 -680
- package/dist/cli/chat.js.map +1 -1
- package/dist/cli/setup.js +1 -1
- package/dist/cli/setup.js.map +1 -1
- package/dist/cli.js +280 -373
- package/dist/cli.js.map +1 -1
- package/dist/core/agent.d.ts +0 -1
- package/dist/core/agent.d.ts.map +1 -1
- package/dist/core/agent.js +0 -3
- package/dist/core/agent.js.map +1 -1
- package/dist/core/runtime.d.ts.map +1 -1
- package/dist/core/runtime.js +22 -192
- package/dist/core/runtime.js.map +1 -1
- package/dist/deploy/index.js +56 -56
- package/dist/doctor.d.ts +0 -1
- package/dist/doctor.d.ts.map +1 -1
- package/dist/doctor.js +10 -155
- package/dist/doctor.js.map +1 -1
- package/dist/index.d.ts +3 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +9 -9
- package/dist/index.js.map +1 -1
- package/dist/memory/deepbrain.d.ts +1 -1
- package/dist/memory/deepbrain.d.ts.map +1 -1
- package/dist/memory/deepbrain.js +4 -95
- package/dist/memory/deepbrain.js.map +1 -1
- package/dist/memory/index.d.ts +0 -2
- package/dist/memory/index.d.ts.map +1 -1
- package/dist/memory/index.js +1 -3
- package/dist/memory/index.js.map +1 -1
- package/dist/memory/user-profiler.d.ts +0 -8
- package/dist/memory/user-profiler.d.ts.map +1 -1
- package/dist/memory/user-profiler.js +0 -89
- package/dist/memory/user-profiler.js.map +1 -1
- package/dist/scheduler/cron-engine.d.ts.map +1 -1
- package/dist/scheduler/cron-engine.js +36 -3
- package/dist/scheduler/cron-engine.js.map +1 -1
- package/dist/skills/auto-learn.d.ts.map +1 -1
- package/dist/skills/auto-learn.js +11 -65
- package/dist/skills/auto-learn.js.map +1 -1
- package/dist/skills/builtin/index.d.ts.map +1 -1
- package/dist/skills/builtin/index.js +30 -163
- package/dist/skills/builtin/index.js.map +1 -1
- package/dist/skills/types.d.ts +1 -1
- package/dist/skills/types.d.ts.map +1 -1
- package/dist/skills/types.js +0 -1
- package/dist/skills/types.js.map +1 -1
- package/dist/studio/server.d.ts +0 -1
- package/dist/studio/server.d.ts.map +1 -1
- package/dist/studio/server.js +12 -142
- package/dist/studio/server.js.map +1 -1
- package/dist/studio-ui/index.html +26 -365
- package/dist/ui/components.js +105 -105
- package/examples/README.md +22 -22
- package/examples/basic-agent.ts +90 -90
- package/examples/brain-integration.ts +71 -71
- package/examples/multi-channel.ts +74 -74
- package/install.ps1 +127 -127
- package/install.sh +154 -154
- package/models.json +164 -164
- package/package.json +63 -66
- package/scripts/install.ps1 +31 -31
- package/scripts/install.sh +40 -40
- package/templates/ecommerce-assistant/README.md +45 -45
- package/templates/ecommerce-assistant/oad.yaml +47 -47
- package/templates/tech-support/README.md +43 -43
- package/templates/tech-support/oad.yaml +45 -45
- package/.opc/memory.db +0 -0
- package/dist/core/model-recommender.d.ts +0 -40
- package/dist/core/model-recommender.d.ts.map +0 -1
- package/dist/core/model-recommender.js +0 -186
- package/dist/core/model-recommender.js.map +0 -1
- package/dist/memory/evolve-engine.d.ts +0 -113
- package/dist/memory/evolve-engine.d.ts.map +0 -1
- package/dist/memory/evolve-engine.js +0 -549
- package/dist/memory/evolve-engine.js.map +0 -1
- package/dist/memory/sqlite-store.d.ts +0 -40
- package/dist/memory/sqlite-store.d.ts.map +0 -1
- package/dist/memory/sqlite-store.js +0 -269
- package/dist/memory/sqlite-store.js.map +0 -1
- package/dist/scheduler/proactive.d.ts +0 -62
- package/dist/scheduler/proactive.d.ts.map +0 -1
- package/dist/scheduler/proactive.js +0 -185
- package/dist/scheduler/proactive.js.map +0 -1
package/README.zh-CN.md
CHANGED
|
@@ -1,269 +1,269 @@
|
|
|
1
|
-
<div align="center">
|
|
2
|
-
|
|
3
|
-
# ⚡ OPC Agent
|
|
4
|
-
|
|
5
|
-
**开源 AI Agent 框架 — 从终端构建、运行、进化你的 AI 智能体**
|
|
6
|
-
|
|
7
|
-
[](https://www.npmjs.com/package/opc-agent)
|
|
8
|
-
[](LICENSE)
|
|
9
|
-
[](https://nodejs.org/)
|
|
10
|
-
|
|
11
|
-
[快速开始](#-快速开始) · [核心特性](#-核心特性) · [架构](#-架构) · [配置](#-配置) · [CLI 命令](#-cli-命令) · [English](README.md)
|
|
12
|
-
|
|
13
|
-
</div>
|
|
14
|
-
|
|
15
|
-
---
|
|
16
|
-
|
|
17
|
-
## 🚀 快速开始
|
|
18
|
-
|
|
19
|
-
```bash
|
|
20
|
-
npm install -g opc-agent
|
|
21
|
-
opc init
|
|
22
|
-
opc run
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
一键安装(自动配置 Node.js,可选 Ollama 本地模型):
|
|
26
|
-
|
|
27
|
-
```bash
|
|
28
|
-
# macOS / Linux
|
|
29
|
-
curl -fsSL https://raw.githubusercontent.com/Deepleaper/opc-agent/main/install.sh | bash
|
|
30
|
-
|
|
31
|
-
# Windows PowerShell
|
|
32
|
-
irm https://raw.githubusercontent.com/Deepleaper/opc-agent/main/install.ps1 | iex
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
启动后打开 **http://localhost:4000** 进入 Studio,或直接终端对话:
|
|
36
|
-
|
|
37
|
-
```bash
|
|
38
|
-
opc chat
|
|
39
|
-
```
|
|
40
|
-
|
|
41
|
-
---
|
|
42
|
-
|
|
43
|
-
## ✨ 核心特性
|
|
44
|
-
|
|
45
|
-
| | 特性 | 说明 |
|
|
46
|
-
|---|---|---|
|
|
47
|
-
| 🤖 | **53 个内置工具** | 文件、Shell、网页、浏览器、视觉、GitHub、Jira、Slack 等 |
|
|
48
|
-
| 🎨 | **Studio 可视化管理** | `http://localhost:4000`,一键管理 Agent |
|
|
49
|
-
| 💬 | **TUI 终端对话** | 流式输出、Markdown 渲染、斜杠命令 |
|
|
50
|
-
| 🧠 | **知识进化引擎** | 本地 Ollama 驱动,零成本知识蒸馏 |
|
|
51
|
-
| 📱 | **15+ 渠道接入** | Telegram、Discord、Slack、微信、邮件、WhatsApp、飞书… |
|
|
52
|
-
| 🔧 | **40 个内置技能** | 效率、知识、创意、开发者技能包 |
|
|
53
|
-
| 📋 | **OAD 声明式配置** | 一个 `oad.yaml` 定义整个 Agent |
|
|
54
|
-
| 🏥 | **Doctor 健康检查** | 13 项检查:模型、工具、渠道、记忆 |
|
|
55
|
-
| ⏰ | **定时调度** | Cron 任务 + 主动式 Agent 触发 |
|
|
56
|
-
| 🔌 | **MCP 协议** | Model Context Protocol 服务端和客户端 |
|
|
57
|
-
| 🗣️ | **语音交互** | Whisper、Azure Speech、火山引擎 STT/TTS |
|
|
58
|
-
| 📊 | **A2A 协议** | Google Agent-to-Agent 互操作 |
|
|
59
|
-
|
|
60
|
-
---
|
|
61
|
-
|
|
62
|
-
## 🏗️ 架构
|
|
63
|
-
|
|
64
|
-
```
|
|
65
|
-
┌─────────────────────────────────────────────────┐
|
|
66
|
-
│ 渠道层 │
|
|
67
|
-
│ Telegram · Discord · Slack · 微信 · 邮件 … │
|
|
68
|
-
└──────────────────────┬──────────────────────────┘
|
|
69
|
-
│
|
|
70
|
-
┌──────────────────────▼──────────────────────────┐
|
|
71
|
-
│ OPC Agent 运行时 │
|
|
72
|
-
│ ┌──────────┐ ┌──────────┐ ┌──────────────┐ │
|
|
73
|
-
│ │ 工具执行 │ │ 技能 │ │ 记忆/知识进化 │ │
|
|
74
|
-
│ │ (53 工具) │ │(40 技能) │ │ 引擎 │ │
|
|
75
|
-
│ └──────────┘ └──────────┘ └──────────────┘ │
|
|
76
|
-
│ ┌──────────┐ ┌──────────┐ ┌──────────────┐ │
|
|
77
|
-
│ │ 定时调度 │ │ 语音 │ │ MCP / A2A │ │
|
|
78
|
-
│ └──────────┘ └──────────┘ └──────────────┘ │
|
|
79
|
-
└──────────────────────┬──────────────────────────┘
|
|
80
|
-
│
|
|
81
|
-
┌──────────────────────▼──────────────────────────┐
|
|
82
|
-
│ 模型提供商 │
|
|
83
|
-
│ OpenAI · Anthropic · Ollama · Azure · Gemini │
|
|
84
|
-
└─────────────────────────────────────────────────┘
|
|
85
|
-
```
|
|
86
|
-
|
|
87
|
-
---
|
|
88
|
-
|
|
89
|
-
## ⚙️ 配置
|
|
90
|
-
|
|
91
|
-
用一个 `oad.yaml` 文件定义 Agent:
|
|
92
|
-
|
|
93
|
-
```yaml
|
|
94
|
-
name: my-agent
|
|
95
|
-
description: 客服助手
|
|
96
|
-
model:
|
|
97
|
-
provider: ollama
|
|
98
|
-
model: llama3.1
|
|
99
|
-
channels:
|
|
100
|
-
- type: telegram
|
|
101
|
-
token: ${TELEGRAM_BOT_TOKEN}
|
|
102
|
-
- type: web
|
|
103
|
-
port: 4000
|
|
104
|
-
tools:
|
|
105
|
-
- file
|
|
106
|
-
- shell
|
|
107
|
-
- web-fetch
|
|
108
|
-
- browser
|
|
109
|
-
skills:
|
|
110
|
-
- weather
|
|
111
|
-
- github
|
|
112
|
-
memory:
|
|
113
|
-
provider: sqlite
|
|
114
|
-
cron:
|
|
115
|
-
- schedule: "0 9 * * *"
|
|
116
|
-
task: "检查并汇总隔夜邮件"
|
|
117
|
-
```
|
|
118
|
-
|
|
119
|
-
---
|
|
120
|
-
|
|
121
|
-
## 🖥️ CLI 命令
|
|
122
|
-
|
|
123
|
-
| 命令 | 说明 |
|
|
124
|
-
|------|------|
|
|
125
|
-
| `opc init [name]` | 创建新 Agent 项目 |
|
|
126
|
-
| `opc run` | 启动 Agent(所有已配置渠道) |
|
|
127
|
-
| `opc chat` | 终端交互对话 |
|
|
128
|
-
| `opc studio` | 启动 Studio GUI(端口 4000) |
|
|
129
|
-
| `opc doctor` | 运行 13 项健康检查 |
|
|
130
|
-
| `opc setup` | 配置模型和 API Key |
|
|
131
|
-
| `opc eval` | 运行评估测试 |
|
|
132
|
-
| `opc traces` | 查看调用链路 |
|
|
133
|
-
| `opc publish` | 发布 Agent 到 npm |
|
|
134
|
-
| `opc skill list` | 列出可用技能 |
|
|
135
|
-
| `opc cron list` | 列出定时任务 |
|
|
136
|
-
|
|
137
|
-
---
|
|
138
|
-
|
|
139
|
-
## 📱 渠道支持
|
|
140
|
-
|
|
141
|
-
| 渠道 | 状态 | 渠道 | 状态 |
|
|
142
|
-
|------|------|------|------|
|
|
143
|
-
| Telegram | ✅ | Discord | ✅ |
|
|
144
|
-
| Slack | ✅ | 微信 | ✅ |
|
|
145
|
-
| 邮件 (IMAP/SMTP) | ✅ | WhatsApp | ✅ |
|
|
146
|
-
| LINE | ✅ | Teams | ✅ |
|
|
147
|
-
| 飞书 | ✅ | 钉钉 | ✅ |
|
|
148
|
-
| Web UI | ✅ | WebSocket | ✅ |
|
|
149
|
-
| Webhook | ✅ | REST API | ✅ |
|
|
150
|
-
| 语音 | ✅ | SMS (Twilio) | ✅ |
|
|
151
|
-
|
|
152
|
-
---
|
|
153
|
-
|
|
154
|
-
## 🔧 工具(53 个)
|
|
155
|
-
|
|
156
|
-
- **核心(8)**:文件读写、Shell、网页抓取、搜索、浏览器、视觉
|
|
157
|
-
- **开发(12)**:Git、GitHub、npm、代码分析、测试、部署、Docker
|
|
158
|
-
- **效率(8)**:日历、邮件、提醒、笔记、待办、翻译
|
|
159
|
-
- **集成(13)**:Jira、Slack、Notion、Linear、Confluence、Trello、Asana、Zendesk、HubSpot、Salesforce
|
|
160
|
-
- **知识(7)**:记忆存取、知识学习/进化、RAG 查询、向量化、摘要
|
|
161
|
-
- **媒体(5)**:图片生成/描述、语音转文字、TTS、截图
|
|
162
|
-
|
|
163
|
-
---
|
|
164
|
-
|
|
165
|
-
## 📊 对比
|
|
166
|
-
|
|
167
|
-
| 特性 | OPC Agent | Hermes Agent | OpenClaw |
|
|
168
|
-
|------|-----------|-------------|----------|
|
|
169
|
-
| 内置工具 | 53 | ~10 | 30+ |
|
|
170
|
-
| GUI 管理 | ✅ | ❌ | ✅ |
|
|
171
|
-
| 终端对话 | ✅ | ❌ | ✅ |
|
|
172
|
-
| 渠道数 | 15+ | 3 | 15+ |
|
|
173
|
-
| 内置技能 | 40 | ❌ | 40 |
|
|
174
|
-
| 知识进化 | ✅ | ❌ | ✅ |
|
|
175
|
-
| 语音交互 | ✅ | ❌ | ✅ |
|
|
176
|
-
| MCP 协议 | ✅ | ✅ | ✅ |
|
|
177
|
-
| A2A 协议 | ✅ | ❌ | ✅ |
|
|
178
|
-
| 本地优先 | ✅ | ❌ | ✅ |
|
|
179
|
-
| 开源 | Apache-2.0 | 商业 | Apache-2.0 |
|
|
180
|
-
|
|
181
|
-
> **OPC Agent** 是开源核心运行时,**OpenClaw** 是基于它构建的完整平台。
|
|
182
|
-
|
|
183
|
-
---
|
|
184
|
-
|
|
185
|
-
## 🧠 知识进化引擎
|
|
186
|
-
|
|
187
|
-
OPC Agent 内置知识进化流水线,**完全本地运行**,使用 Ollama:
|
|
188
|
-
|
|
189
|
-
```
|
|
190
|
-
对话 → 学习 → 聚类 → 去重 → 蒸馏 → 进化知识
|
|
191
|
-
```
|
|
192
|
-
|
|
193
|
-
- **零 API 成本** — 本地 Ollama 模型驱动蒸馏
|
|
194
|
-
- **自动运行** — 从每次对话中学习,按计划进化
|
|
195
|
-
- **分层记忆** — 短期(对话)→ 长期(蒸馏)→ 进化(精炼)
|
|
196
|
-
- **全文搜索** — SQLite FTS5 即时检索所有记忆
|
|
197
|
-
|
|
198
|
-
```bash
|
|
199
|
-
opc knowledge evolve # 手动触发进化
|
|
200
|
-
opc knowledge stats # 查看知识库统计
|
|
201
|
-
opc knowledge search "查询" # 搜索知识
|
|
202
|
-
```
|
|
203
|
-
|
|
204
|
-
---
|
|
205
|
-
|
|
206
|
-
## 🎨 Studio 可视化
|
|
207
|
-
|
|
208
|
-
```bash
|
|
209
|
-
opc studio
|
|
210
|
-
```
|
|
211
|
-
|
|
212
|
-
Studio 功能:
|
|
213
|
-
- **Agent 概览** — 状态、模型、渠道、工具一目了然
|
|
214
|
-
- **在线对话** — 浏览器中测试 Agent
|
|
215
|
-
- **配置编辑** — 可视化编辑 `oad.yaml`
|
|
216
|
-
- **日志与追踪** — 实时日志流 + OpenTelemetry 追踪
|
|
217
|
-
- **技能浏览器** — 发现和安装技能
|
|
218
|
-
- **定时任务管理** — 创建和监控 Cron 任务
|
|
219
|
-
|
|
220
|
-
---
|
|
221
|
-
|
|
222
|
-
## 🏥 Doctor 健康检查
|
|
223
|
-
|
|
224
|
-
```bash
|
|
225
|
-
opc doctor
|
|
226
|
-
```
|
|
227
|
-
|
|
228
|
-
```
|
|
229
|
-
✅ 模型连接正常 (ollama/llama3.1)
|
|
230
|
-
✅ 53/53 工具可用
|
|
231
|
-
✅ 记忆存储正常 (SQLite, 1,247 条)
|
|
232
|
-
✅ Telegram 渠道已连接
|
|
233
|
-
✅ 定时调度运行中 (3 个任务)
|
|
234
|
-
⚠️ 未配置 TTS 语音
|
|
235
|
-
✅ 磁盘空间充足 (12.3 GB)
|
|
236
|
-
...
|
|
237
|
-
```
|
|
238
|
-
|
|
239
|
-
13 项检查覆盖:模型连接、工具状态、渠道连接、记忆健康、磁盘空间、Node.js 版本、包更新等。
|
|
240
|
-
|
|
241
|
-
---
|
|
242
|
-
|
|
243
|
-
## 🤝 参与贡献
|
|
244
|
-
|
|
245
|
-
欢迎贡献!查看 [CONTRIBUTING.md](CONTRIBUTING.md) 了解详情。
|
|
246
|
-
|
|
247
|
-
```bash
|
|
248
|
-
git clone https://github.com/Deepleaper/opc-agent.git
|
|
249
|
-
cd opc-agent
|
|
250
|
-
npm install
|
|
251
|
-
npm run build
|
|
252
|
-
npm test
|
|
253
|
-
```
|
|
254
|
-
|
|
255
|
-
---
|
|
256
|
-
|
|
257
|
-
## 📄 许可证
|
|
258
|
-
|
|
259
|
-
[Apache-2.0](LICENSE) © [Deepleaper 跃盟科技](https://github.com/Deepleaper)
|
|
260
|
-
|
|
261
|
-
---
|
|
262
|
-
|
|
263
|
-
<div align="center">
|
|
264
|
-
|
|
265
|
-
**觉得有用?给个 ⭐ 支持一下**
|
|
266
|
-
|
|
267
|
-
[GitHub](https://github.com/Deepleaper/opc-agent) · [npm](https://www.npmjs.com/package/opc-agent) · [文档](https://opc-agent.dev)
|
|
268
|
-
|
|
269
|
-
</div>
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
3
|
+
# ⚡ OPC Agent
|
|
4
|
+
|
|
5
|
+
**开源 AI Agent 框架 — 从终端构建、运行、进化你的 AI 智能体**
|
|
6
|
+
|
|
7
|
+
[](https://www.npmjs.com/package/opc-agent)
|
|
8
|
+
[](LICENSE)
|
|
9
|
+
[](https://nodejs.org/)
|
|
10
|
+
|
|
11
|
+
[快速开始](#-快速开始) · [核心特性](#-核心特性) · [架构](#-架构) · [配置](#-配置) · [CLI 命令](#-cli-命令) · [English](README.md)
|
|
12
|
+
|
|
13
|
+
</div>
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## 🚀 快速开始
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
npm install -g opc-agent
|
|
21
|
+
opc init
|
|
22
|
+
opc run
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
一键安装(自动配置 Node.js,可选 Ollama 本地模型):
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
# macOS / Linux
|
|
29
|
+
curl -fsSL https://raw.githubusercontent.com/Deepleaper/opc-agent/main/install.sh | bash
|
|
30
|
+
|
|
31
|
+
# Windows PowerShell
|
|
32
|
+
irm https://raw.githubusercontent.com/Deepleaper/opc-agent/main/install.ps1 | iex
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
启动后打开 **http://localhost:4000** 进入 Studio,或直接终端对话:
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
opc chat
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
## ✨ 核心特性
|
|
44
|
+
|
|
45
|
+
| | 特性 | 说明 |
|
|
46
|
+
|---|---|---|
|
|
47
|
+
| 🤖 | **53 个内置工具** | 文件、Shell、网页、浏览器、视觉、GitHub、Jira、Slack 等 |
|
|
48
|
+
| 🎨 | **Studio 可视化管理** | `http://localhost:4000`,一键管理 Agent |
|
|
49
|
+
| 💬 | **TUI 终端对话** | 流式输出、Markdown 渲染、斜杠命令 |
|
|
50
|
+
| 🧠 | **知识进化引擎** | 本地 Ollama 驱动,零成本知识蒸馏 |
|
|
51
|
+
| 📱 | **15+ 渠道接入** | Telegram、Discord、Slack、微信、邮件、WhatsApp、飞书… |
|
|
52
|
+
| 🔧 | **40 个内置技能** | 效率、知识、创意、开发者技能包 |
|
|
53
|
+
| 📋 | **OAD 声明式配置** | 一个 `oad.yaml` 定义整个 Agent |
|
|
54
|
+
| 🏥 | **Doctor 健康检查** | 13 项检查:模型、工具、渠道、记忆 |
|
|
55
|
+
| ⏰ | **定时调度** | Cron 任务 + 主动式 Agent 触发 |
|
|
56
|
+
| 🔌 | **MCP 协议** | Model Context Protocol 服务端和客户端 |
|
|
57
|
+
| 🗣️ | **语音交互** | Whisper、Azure Speech、火山引擎 STT/TTS |
|
|
58
|
+
| 📊 | **A2A 协议** | Google Agent-to-Agent 互操作 |
|
|
59
|
+
|
|
60
|
+
---
|
|
61
|
+
|
|
62
|
+
## 🏗️ 架构
|
|
63
|
+
|
|
64
|
+
```
|
|
65
|
+
┌─────────────────────────────────────────────────┐
|
|
66
|
+
│ 渠道层 │
|
|
67
|
+
│ Telegram · Discord · Slack · 微信 · 邮件 … │
|
|
68
|
+
└──────────────────────┬──────────────────────────┘
|
|
69
|
+
│
|
|
70
|
+
┌──────────────────────▼──────────────────────────┐
|
|
71
|
+
│ OPC Agent 运行时 │
|
|
72
|
+
│ ┌──────────┐ ┌──────────┐ ┌──────────────┐ │
|
|
73
|
+
│ │ 工具执行 │ │ 技能 │ │ 记忆/知识进化 │ │
|
|
74
|
+
│ │ (53 工具) │ │(40 技能) │ │ 引擎 │ │
|
|
75
|
+
│ └──────────┘ └──────────┘ └──────────────┘ │
|
|
76
|
+
│ ┌──────────┐ ┌──────────┐ ┌──────────────┐ │
|
|
77
|
+
│ │ 定时调度 │ │ 语音 │ │ MCP / A2A │ │
|
|
78
|
+
│ └──────────┘ └──────────┘ └──────────────┘ │
|
|
79
|
+
└──────────────────────┬──────────────────────────┘
|
|
80
|
+
│
|
|
81
|
+
┌──────────────────────▼──────────────────────────┐
|
|
82
|
+
│ 模型提供商 │
|
|
83
|
+
│ OpenAI · Anthropic · Ollama · Azure · Gemini │
|
|
84
|
+
└─────────────────────────────────────────────────┘
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
---
|
|
88
|
+
|
|
89
|
+
## ⚙️ 配置
|
|
90
|
+
|
|
91
|
+
用一个 `oad.yaml` 文件定义 Agent:
|
|
92
|
+
|
|
93
|
+
```yaml
|
|
94
|
+
name: my-agent
|
|
95
|
+
description: 客服助手
|
|
96
|
+
model:
|
|
97
|
+
provider: ollama
|
|
98
|
+
model: llama3.1
|
|
99
|
+
channels:
|
|
100
|
+
- type: telegram
|
|
101
|
+
token: ${TELEGRAM_BOT_TOKEN}
|
|
102
|
+
- type: web
|
|
103
|
+
port: 4000
|
|
104
|
+
tools:
|
|
105
|
+
- file
|
|
106
|
+
- shell
|
|
107
|
+
- web-fetch
|
|
108
|
+
- browser
|
|
109
|
+
skills:
|
|
110
|
+
- weather
|
|
111
|
+
- github
|
|
112
|
+
memory:
|
|
113
|
+
provider: sqlite
|
|
114
|
+
cron:
|
|
115
|
+
- schedule: "0 9 * * *"
|
|
116
|
+
task: "检查并汇总隔夜邮件"
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
---
|
|
120
|
+
|
|
121
|
+
## 🖥️ CLI 命令
|
|
122
|
+
|
|
123
|
+
| 命令 | 说明 |
|
|
124
|
+
|------|------|
|
|
125
|
+
| `opc init [name]` | 创建新 Agent 项目 |
|
|
126
|
+
| `opc run` | 启动 Agent(所有已配置渠道) |
|
|
127
|
+
| `opc chat` | 终端交互对话 |
|
|
128
|
+
| `opc studio` | 启动 Studio GUI(端口 4000) |
|
|
129
|
+
| `opc doctor` | 运行 13 项健康检查 |
|
|
130
|
+
| `opc setup` | 配置模型和 API Key |
|
|
131
|
+
| `opc eval` | 运行评估测试 |
|
|
132
|
+
| `opc traces` | 查看调用链路 |
|
|
133
|
+
| `opc publish` | 发布 Agent 到 npm |
|
|
134
|
+
| `opc skill list` | 列出可用技能 |
|
|
135
|
+
| `opc cron list` | 列出定时任务 |
|
|
136
|
+
|
|
137
|
+
---
|
|
138
|
+
|
|
139
|
+
## 📱 渠道支持
|
|
140
|
+
|
|
141
|
+
| 渠道 | 状态 | 渠道 | 状态 |
|
|
142
|
+
|------|------|------|------|
|
|
143
|
+
| Telegram | ✅ | Discord | ✅ |
|
|
144
|
+
| Slack | ✅ | 微信 | ✅ |
|
|
145
|
+
| 邮件 (IMAP/SMTP) | ✅ | WhatsApp | ✅ |
|
|
146
|
+
| LINE | ✅ | Teams | ✅ |
|
|
147
|
+
| 飞书 | ✅ | 钉钉 | ✅ |
|
|
148
|
+
| Web UI | ✅ | WebSocket | ✅ |
|
|
149
|
+
| Webhook | ✅ | REST API | ✅ |
|
|
150
|
+
| 语音 | ✅ | SMS (Twilio) | ✅ |
|
|
151
|
+
|
|
152
|
+
---
|
|
153
|
+
|
|
154
|
+
## 🔧 工具(53 个)
|
|
155
|
+
|
|
156
|
+
- **核心(8)**:文件读写、Shell、网页抓取、搜索、浏览器、视觉
|
|
157
|
+
- **开发(12)**:Git、GitHub、npm、代码分析、测试、部署、Docker
|
|
158
|
+
- **效率(8)**:日历、邮件、提醒、笔记、待办、翻译
|
|
159
|
+
- **集成(13)**:Jira、Slack、Notion、Linear、Confluence、Trello、Asana、Zendesk、HubSpot、Salesforce
|
|
160
|
+
- **知识(7)**:记忆存取、知识学习/进化、RAG 查询、向量化、摘要
|
|
161
|
+
- **媒体(5)**:图片生成/描述、语音转文字、TTS、截图
|
|
162
|
+
|
|
163
|
+
---
|
|
164
|
+
|
|
165
|
+
## 📊 对比
|
|
166
|
+
|
|
167
|
+
| 特性 | OPC Agent | Hermes Agent | OpenClaw |
|
|
168
|
+
|------|-----------|-------------|----------|
|
|
169
|
+
| 内置工具 | 53 | ~10 | 30+ |
|
|
170
|
+
| GUI 管理 | ✅ | ❌ | ✅ |
|
|
171
|
+
| 终端对话 | ✅ | ❌ | ✅ |
|
|
172
|
+
| 渠道数 | 15+ | 3 | 15+ |
|
|
173
|
+
| 内置技能 | 40 | ❌ | 40 |
|
|
174
|
+
| 知识进化 | ✅ | ❌ | ✅ |
|
|
175
|
+
| 语音交互 | ✅ | ❌ | ✅ |
|
|
176
|
+
| MCP 协议 | ✅ | ✅ | ✅ |
|
|
177
|
+
| A2A 协议 | ✅ | ❌ | ✅ |
|
|
178
|
+
| 本地优先 | ✅ | ❌ | ✅ |
|
|
179
|
+
| 开源 | Apache-2.0 | 商业 | Apache-2.0 |
|
|
180
|
+
|
|
181
|
+
> **OPC Agent** 是开源核心运行时,**OpenClaw** 是基于它构建的完整平台。
|
|
182
|
+
|
|
183
|
+
---
|
|
184
|
+
|
|
185
|
+
## 🧠 知识进化引擎
|
|
186
|
+
|
|
187
|
+
OPC Agent 内置知识进化流水线,**完全本地运行**,使用 Ollama:
|
|
188
|
+
|
|
189
|
+
```
|
|
190
|
+
对话 → 学习 → 聚类 → 去重 → 蒸馏 → 进化知识
|
|
191
|
+
```
|
|
192
|
+
|
|
193
|
+
- **零 API 成本** — 本地 Ollama 模型驱动蒸馏
|
|
194
|
+
- **自动运行** — 从每次对话中学习,按计划进化
|
|
195
|
+
- **分层记忆** — 短期(对话)→ 长期(蒸馏)→ 进化(精炼)
|
|
196
|
+
- **全文搜索** — SQLite FTS5 即时检索所有记忆
|
|
197
|
+
|
|
198
|
+
```bash
|
|
199
|
+
opc knowledge evolve # 手动触发进化
|
|
200
|
+
opc knowledge stats # 查看知识库统计
|
|
201
|
+
opc knowledge search "查询" # 搜索知识
|
|
202
|
+
```
|
|
203
|
+
|
|
204
|
+
---
|
|
205
|
+
|
|
206
|
+
## 🎨 Studio 可视化
|
|
207
|
+
|
|
208
|
+
```bash
|
|
209
|
+
opc studio
|
|
210
|
+
```
|
|
211
|
+
|
|
212
|
+
Studio 功能:
|
|
213
|
+
- **Agent 概览** — 状态、模型、渠道、工具一目了然
|
|
214
|
+
- **在线对话** — 浏览器中测试 Agent
|
|
215
|
+
- **配置编辑** — 可视化编辑 `oad.yaml`
|
|
216
|
+
- **日志与追踪** — 实时日志流 + OpenTelemetry 追踪
|
|
217
|
+
- **技能浏览器** — 发现和安装技能
|
|
218
|
+
- **定时任务管理** — 创建和监控 Cron 任务
|
|
219
|
+
|
|
220
|
+
---
|
|
221
|
+
|
|
222
|
+
## 🏥 Doctor 健康检查
|
|
223
|
+
|
|
224
|
+
```bash
|
|
225
|
+
opc doctor
|
|
226
|
+
```
|
|
227
|
+
|
|
228
|
+
```
|
|
229
|
+
✅ 模型连接正常 (ollama/llama3.1)
|
|
230
|
+
✅ 53/53 工具可用
|
|
231
|
+
✅ 记忆存储正常 (SQLite, 1,247 条)
|
|
232
|
+
✅ Telegram 渠道已连接
|
|
233
|
+
✅ 定时调度运行中 (3 个任务)
|
|
234
|
+
⚠️ 未配置 TTS 语音
|
|
235
|
+
✅ 磁盘空间充足 (12.3 GB)
|
|
236
|
+
...
|
|
237
|
+
```
|
|
238
|
+
|
|
239
|
+
13 项检查覆盖:模型连接、工具状态、渠道连接、记忆健康、磁盘空间、Node.js 版本、包更新等。
|
|
240
|
+
|
|
241
|
+
---
|
|
242
|
+
|
|
243
|
+
## 🤝 参与贡献
|
|
244
|
+
|
|
245
|
+
欢迎贡献!查看 [CONTRIBUTING.md](CONTRIBUTING.md) 了解详情。
|
|
246
|
+
|
|
247
|
+
```bash
|
|
248
|
+
git clone https://github.com/Deepleaper/opc-agent.git
|
|
249
|
+
cd opc-agent
|
|
250
|
+
npm install
|
|
251
|
+
npm run build
|
|
252
|
+
npm test
|
|
253
|
+
```
|
|
254
|
+
|
|
255
|
+
---
|
|
256
|
+
|
|
257
|
+
## 📄 许可证
|
|
258
|
+
|
|
259
|
+
[Apache-2.0](LICENSE) © [Deepleaper 跃盟科技](https://github.com/Deepleaper)
|
|
260
|
+
|
|
261
|
+
---
|
|
262
|
+
|
|
263
|
+
<div align="center">
|
|
264
|
+
|
|
265
|
+
**觉得有用?给个 ⭐ 支持一下**
|
|
266
|
+
|
|
267
|
+
[GitHub](https://github.com/Deepleaper/opc-agent) · [npm](https://www.npmjs.com/package/opc-agent) · [文档](https://opc-agent.dev)
|
|
268
|
+
|
|
269
|
+
</div>
|
|
@@ -29,7 +29,6 @@ export interface TelegramChannelConfig {
|
|
|
29
29
|
textChunkLimit?: number;
|
|
30
30
|
requireMention?: boolean;
|
|
31
31
|
botUsername?: string;
|
|
32
|
-
voiceReply?: boolean;
|
|
33
32
|
}
|
|
34
33
|
export declare class TelegramChannel extends BaseChannel {
|
|
35
34
|
readonly type = "telegram";
|
|
@@ -49,8 +48,6 @@ export declare class TelegramChannel extends BaseChannel {
|
|
|
49
48
|
private polling;
|
|
50
49
|
private server;
|
|
51
50
|
private streamHandler?;
|
|
52
|
-
private voice;
|
|
53
|
-
private voiceReply;
|
|
54
51
|
constructor(config?: TelegramChannelConfig);
|
|
55
52
|
setStreamHandler(handler: (msg: Message) => AsyncIterable<string>): void;
|
|
56
53
|
start(): Promise<void>;
|
|
@@ -66,8 +63,6 @@ export declare class TelegramChannel extends BaseChannel {
|
|
|
66
63
|
private streamResponse;
|
|
67
64
|
sendFormattedMessage(chatId: number | string, text: string, replyTo?: number, threadId?: number): Promise<any>;
|
|
68
65
|
sendMessage(chatId: number | string, text: string): Promise<void>;
|
|
69
|
-
/** Send a voice message (TTS) alongside or instead of text */
|
|
70
|
-
sendVoiceMessage(chatId: number | string, text: string, replyTo?: number): Promise<boolean>;
|
|
71
66
|
private setReaction;
|
|
72
67
|
private sendTyping;
|
|
73
68
|
private isGroupChat;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/channels/telegram.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;
|
|
1
|
+
{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/channels/telegram.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,SAAS,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,SAAS,CAAC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,QAAQ,CAAC,IAAI,cAAc;IAC3B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,IAAI,CAAwB;IACpC,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,OAAO,CAAa;IAG5B,OAAO,CAAC,gBAAgB,CAAU;IAClC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,cAAc,CAAU;IAGhC,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,OAAO,CAAkB;IAGjC,OAAO,CAAC,MAAM,CAAsC;IAGpD,OAAO,CAAC,aAAa,CAAC,CAA0C;gBAEpD,MAAM,GAAE,qBAA0B;IAiB9C,gBAAgB,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI;IAIlE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAUb,YAAY;YAOZ,IAAI;YAmBJ,UAAU;YAmBV,YAAY;YA4CZ,WAAW;YASX,aAAa;YA+Eb,aAAa;YA0Cb,mBAAmB;YAkCnB,cAAc;IAmEtB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IA2C9G,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAMzD,WAAW;YAcX,UAAU;IAUxB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,UAAU;IAQlB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAuBtB;;;OAGG;IACH,OAAO,CAAC,UAAU;YA0BJ,OAAO;CAqBtB"}
|