⚡ OPC Agent

让每个人都有自己的 AI 员工

English

为什么做 OPC Agent？

AI Agent 越来越强，但普通人用不起来：

• 太贵 — 云端 Agent 按 token 收费，聊几句就是钱
• 不记事 — 每次对话都从零开始，不会越用越聪明
• 数据不安全 — 你的聊天记录、文档、知识全在别人的服务器上
• 只会聊天 — 不能读文件、不能搜网页、不能执行代码，什么活都干不了

OPC Agent 解决这些问题：

✅ 本地运行，零成本（Ollama 驱动） ✅ 越用越聪明（自动学习和进化） ✅ 数据全在你电脑上 ✅ 能读写文件、搜索网页、执行代码、操作工具

🚀 安装

选择你的系统，复制一行就够了：

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/Deepleaper/opc-agent/main/install.sh | bash

Windows

irm https://raw.githubusercontent.com/Deepleaper/opc-agent/main/install.ps1 | iex

安装脚本会自动帮你装好 Node.js、OPC Agent、Ollama 和适合你电脑的 AI 模型。全程不需要手动操作。

手动安装

如果你是开发者，也可以手动装：

npm install -g opc-agent@alpha

⚡ 30 秒上手

第一步：创建你的 AI 员工

opc init my-agent
cd my-agent

第二步：开始对话

opc chat

就这样。你的 AI 员工已经在工作了。

更多用法

opc studio        # 打开网页管理后台（localhost:4000）
opc run           # 启动所有服务（对话 + Telegram + 网页 + 管理后台）

它能干什么？

OPC Agent 不只是聊天机器人。它是一个能干活的 AI 员工：

| 能力 | 说明 | |------|------| | 💬 对话 | 终端聊天、网页聊天 | | 📁 读写文件 | 读取你的文档、写报告、整理笔记 | | 🔍 搜索互联网 | 实时搜索，获取最新信息 | | 🌐 读取网页 | 抓取网页内容并总结 | | 💻 执行代码 | 运行 JavaScript、TypeScript、Python | | 🧠 记忆 | 自动记住聊过的内容，越用越聪明 | | 🔧 MCP 工具扩展 | 接入 GitHub、数据库、飞书等外部工具 | | 📱 Telegram 机器人 | 配好 Bot Token 就能在 Telegram 里用 | | 🎙 语音合成 | 文字转语音（edge-tts） | | 👥 子代理 | 让 Agent 派出多个子任务并行工作 | | 🔄 Provider 故障转移 | 熔断器保护，自动重试并切换备用模型 | | 📋 20 个工作站角色 | 预置模板：客服、工程师、分析师、高管... | | ⏰ 定时任务 | 从模板自动注册 Cron 任务 |

🧠 越用越聪明

这是 OPC Agent 和其他 AI 框架最大的区别：它会自己进化。

你和 AI 对话
    ↓
AI 从对话中提取知识       ← 自动的，你不需要操心
    ↓
知识沉淀到本地数据库      ← 数据在你电脑上
    ↓
下次对话自动引用知识      ← 它记住了你说过的话
    ↓
知识逐渐精炼升级         ← 越用越精准

所有学习过程用本地 Ollama 模型，零成本。

知识分三层组织：行业 → 岗位 → 工作站——每个角色都有精准的上下文支撑。

🎨 Studio 管理后台

opc studio

打开浏览器访问 localhost:4000，你可以：

• 模型配置 — 切换 AI 模型，本地或云端都行
• 渠道配置 — 配置 Telegram Bot Token
• 知识库管理 — 查看 Agent 学到了什么
• Agent 设置 — 修改性格、技能、行为

📖 模型支持

本地（零成本）

安装时自动根据你电脑内存推荐最合适的模型：

| 内存 | 推荐模型 | 下载大小 | |------|---------|---------| | ≤3 GB | qwen2.5:0.5b | 400MB | | ≤7 GB | qwen2.5:1.5b | 1.0GB | | ≤15 GB | qwen2.5:7b | 4.7GB | | ≤31 GB | qwen2.5:14b | 9.0GB | | 32+ GB | qwen2.5:32b | 19GB |

云端（可选）

在 Studio 后台添加 API Key 即可使用：OpenAI、DeepSeek、Anthropic、通义千问、Google Gemini

支持熔断器自动故障转移——一个模型挂了，立即切到下一个。

📋 常用命令

| 命令 | 干什么 | |------|--------| | opc init [名字] | 创建 AI 员工 | | opc chat | 终端对话 | | opc studio | 打开管理后台 | | opc run | 一键启动所有服务 | | opc brain stats | 查看知识库状态 | | opc brain recall "问题" | 搜索知识库 | | opc brain learn 文件.md | 导入文档到知识库 | | opc voice test "你好" | 测试语音合成 | | opc mcp list | 查看已接入的外部工具 | | opc doctor | 诊断安装问题 | | opc init --role <名字> | 从工作站模板创建 Agent | | opc init --list-roles | 查看可用角色列表 | | opc template check <路径> | 验证模板质量 | | opc template test <路径> | 运行模板测试 |

🏗 Workstation 模板

用模板可以一键创建特定角色的 AI 员工：

opc init --template ceo-coach-socratic

模板包含：人格定义、技能配置、知识库、测试用例。拿来就能用。

🔒 隐私

• 所有数据存在你自己的电脑上
• 不上传任何遥测数据
• 本地 Ollama 模型不经过任何云端
• 你的知识库、对话记录、文件全部本地

🤝 参与开发

git clone https://github.com/Deepleaper/opc-agent.git
cd opc-agent
npm install
npx tsc                    # 构建
npx vitest run             # 跑测试

📄 开源协议

Apache-2.0 © 跃盟科技 Deepleaper

由 跃盟科技 出品

⭐ 如果对你有用，请给个 Star