完整的 OraAgent 使用指南 — 从入门到精通，一个页面搞定
OraAgent 是一款面向外贸人的 AI 工作搭子。它不是只会聊天的机器人，而是一个能帮你找客户、写开发信、分析海关数据、整理表格、制作提案的桌面 AI 助手。
你只需要用自然语言说出需求，OraAgent 会规划步骤、调用专家与工具、执行操作，并直接交付可用成果——从一句话到一份可落地的文件。
安装并打开 OraAgent 后，登录你的 Ora 账号即可使用。
在系统设置 → 模型中配置你常用的 AI 模型——支持 DeepSeek、Moonshot、智谱 AI、MiniMax、火山引擎、阿里百炼等主流服务商，选择适合你预算和需求的模型即可开始工作。
回到对话页，直接输入第一句话，例如"帮我找德国宠物用品进口商"。
每个会话都有独立的工作区目录，AI 生成的文件、下载的附件、导出的数据都会保存在这里。你可以把工作区理解为 AI 的"交付文件夹"——所有产出物都会带完整路径返回给你。
~\.ora\workspace\<会话目录>xxx.csv"AI 生成的 Excel、Word、PPT、PDF、图片、网页等
线索 CSV、海关数据报表、客户名单等
从邮件或网页下载的附件
任务执行过程中的临时文件与日志
通过自然语言对话完成各类任务，支持文件操作、命令执行、网页浏览、表格处理等多种能力。AI 以实时流式方式返回结果，你可以看到内容逐步生成。
按产品、国家搜索进口商、经销商与门店
查询 HS 编码进口趋势与市场规模
开发信、跟进、催付款，按客户背景定制
整理报价表、客户表，输出规范 Excel
制作外贸提案与产品介绍
登录网站、发消息、抓取数据
OraAgent 会将思考与执行过程以可折叠形式展示在对话中：
任务过程中如果涉及外部发送（邮件、WhatsApp、LinkedIn），都会在发送前停下来等你确认。
当 AI 执行复杂的多步骤任务时，会自动生成 TODO 进度列表，实时展示每个步骤的状态：
TODO 列表最多支持 12 个步骤的进度追踪。比如执行"找客户 → 验证采购 → 挖掘联系人 → 写开发信"这样的多步任务时，每完成一个阶段列表会即时刷新。
OraAgent 内置可视浏览器，使用持久登录态，支持完整的网页操作能力：
打开网站、读取页面、提取数据、抓取动态内容
LinkedIn、WhatsApp、小红书等需要登录的网站
填写表单、点击按钮、多标签页任务
文件上传下载、页面截图、PDF 导出
AI 打开目标网站，读取页面内容
获取页面结构，找到需要操作的元素
点击、填写、选择、上传，页面变化后重新读取
下载文件、截图、导出 PDF，或把数据带回来
支持创建定时自动执行的任务，让重复性工作按时自动完成：
每小时、每天、每周、工作日，按需配置
绑定已有技能或直接写执行指令
自动推送至飞书、钉钉、微信等消息频道
创建、查看、暂停、恢复或删除，一句话搞定
"每天下午 5 点帮我发布一篇领英帖子，主题是外贸获客心得"
自动配置频率、时间、执行内容，并返回任务 ID
"暂停这个任务"、"改到早上 8 点"、"删掉它"，一句话搞定
可以创建文件监听规则：当指定路径下的文件发生变化（新建、修改）时，自动触发执行指令。
用法示例："监听 ~\.ora\workspace\<会话目录>\uploads\*.csv 目录，新文件出现后自动汇总并生成统计表"。
OraAgent 拥有跨对话的长期记忆能力：
记住你的称呼偏好、公司信息、项目背景、重要决定
用户纠正工作方式时，自动保存为反馈规则
涉及账号、密钥等敏感信息，加密存储
你说"记住"，AI 立即存储；说"忘记"，立即删除
"记住，我是满山红的，主营宠物笼子"——这条信息以后每次对话都生效
"不要用 info@ 猜测的邮箱发信，必须用已验证邮箱"——这条反馈会保存为规则
"忘掉我之前说的 XX"——对应记忆立即删除
技能（Skill）是 OraAgent 的可复用能力包。当前环境内置 69 个技能，开箱即用。技能通过 /技能名 斜杠命令或对话触发，覆盖外贸、内容创作、文档处理、浏览器自动化等多个领域。
你不需要记住技能的具体用法——只要描述你的需求，AI 会自动匹配最合适的技能来完成任务。
| 分类 | 代表技能 | 说明 |
|---|---|---|
| 🌐 外贸开发 | company-contact-finder、email-finder、whatsapp-send | 批量补全企业信息、邮箱挖掘验证、WhatsApp 发送与号码验证 |
| 📄 文档与表格 | docx、xlsx、pptx、pdf | Word/Excel/PPT/PDF 创建编辑、图表、OCR、填表 |
| 🎬 内容创作 | video-script-writer、viral-title-generator | 短视频脚本、爆款口播、爆款标题生成 |
| 📱 社媒发布 | linkedin-post-publisher、web-access | LinkedIn 起草+发布、携带登录态浏览 |
| 🕷️ 网页抓取 | firecrawl-scrape、firecrawl-crawl、firecrawl-search | 单页提取、整站爬取、搜索+正文 |
| 🎨 设计与其他 | mermaid-diagram、cli-anything-photoshop | 流程图/架构图、PS 自动化 |
| 🧠 思考与诊断 | dbs-goal、dbs-content、dbs-ai-check | 目标清晰化、内容诊断、AI 写作检测 |
| 🛠️ 开发与运维 | skill-creator、skill-vetter、imap-smtp-email | 创建技能、安全审查、邮箱配置 |
在对话中输入 /技能名，例如 /dbs-ai-check，即显式调用该技能。
任务明显匹配技能场景时（如"帮我写短视频脚本"），会自动激活对应技能。
可以通过对话创建、编辑、删除自定义技能，把可复用的工作流程封装成技能资产。
专家（Agent）是面向特定领域的 AI 角色，每位专家集成专属工具与判断力。OraAgent 内置 10 位外贸场景专家，复杂任务会自动拆解并调度多位专家协同处理。
在对话中使用 @专家名 可显式指定专家处理；也可直接描述需求，由 OraAgent 自动判断并调度。
| 专家 | 定位 | 能力说明 |
|---|---|---|
| 林夏 · 客户开发助理 | 找企业 · 找买家 | 按产品/国家搜索进口商、经销商、门店，执行黄页、地图和社媒搜索 |
| 周澈 · 海关数据顾问 | 海关数据 · 采购分析 | 验证采购真实性、分析采购规模、市场趋势、竞争对手客户 |
| 许诺 · 决策人挖掘顾问 | 关键联系人查找 | 根据企业名、域名或 LinkedIn 查找决策人邮箱、电话 |
| 莱特 · 外贸邮件顾问 | 英文外贸邮件 | 开发信、跟进邮件、催付款、谈判邮件的撰写与润色 |
| 陈茉 · 外贸单证顾问 | 单证 · 信用证 | 检查 PI、CI、信用证条款，核对风险 |
| 乔然 · 外贸提案设计师 | PPT · 提案 | 制作打动客户的外贸提案与演示文稿 |
| 安然 · 外贸表格管家 | 表格 · 数据 | 整理客户表、报价表、跟进表、销售数据 |
| 陆川 · 外贸办公助理 | 电脑办公指导 | 文件处理、软件操作、办公技巧教学 |
| 苏晴 · WhatsApp 沟通助手 | WhatsApp 沟通 | 消息起草、回复分析、号码验证与发送 |
| 程曦 · 社媒发布助手 | LinkedIn 发布 | 起草、润色并发布 LinkedIn 帖子 |
复杂任务会自动拆解成多个环节，由不同的专家接力完成：
| 任务 | 协作流程 |
|---|---|
| 找买家并验证采购 | 林夏搜索 → 周澈验证采购数据（串行） |
| 找买家并挖掘联系人 | 林夏搜索企业 → 许诺按域名查决策人（串行） |
| 找买家并写开发信 | 林夏整理名单 → 莱特逐家写信（串行） |
| 全面开发产品市场 | 周澈分析市场 → 林夏搜索 → 许诺挖人 → 莱特写信 |
| 分析竞争对手客户 | 周澈查客户分布 → 许诺找联系人（串行） |
OraAgent 支持完整的客户开发链路：
按产品关键词、国家、城市搜索进口商、经销商、门店
通过海关数据核对目标企业是否真实采购、采购规模与频次
根据企业域名或名称查找采购经理、总经理等关键联系人的邮箱与电话
基于客户真实背景生成个性化开发信与触达文案
委派 @周澈 海关数据顾问，可以完成：
| 维度 | 能回答什么问题 |
|---|---|
| 产品概览 | 某 HS 编码的市场规模多大？进口额和进口量是多少？ |
| 采购商分析 | 哪些公司在买？采购频率和规模如何？是否值得跟进？ |
| 供应商分层 | 现有供应商来自哪些国家？竞争格局如何？ |
| 供应国分布 | 主要供应国是谁？中国占比多少？ |
| 趋势分析 | 市场在增长还是萎缩？季节性波动如何？ |
| 明细查询 | 具体交易记录、提单信息、物流运输情况 |
委派 @莱特 外贸邮件顾问，可以撰写和润色：
告诉莱特客户的公司名称、国家、主营产品、联系人职位，以及你想达成的目标
莱特基于真实客户信息撰写针对性邮件，不同客户不会套用同一模板
每封邮件单独展示收件人、主题、正文，你可以逐封修改
确认后通过已配置的邮箱账户发送（支持附件、抄送、密送）
委派 @苏晴 WhatsApp 沟通助手：
完整流程：提供客户号码 → 苏晴验证号码是否注册 → 起草消息（结合客户背景、时区、文化习惯）→ 你确认后发送。支持批量号码解析、去重、国家码补全与结果导出。
委派 @程曦 社媒发布助手：
发帖流程：告诉程曦主题和要点 → 起草帖子（避免 AI 腔：不过度用 emoji、不用"告别 XX"式排比、不用金句型结尾）→ 你确认文案 → 通过内置浏览器用当前登录的 LinkedIn 账号发布。
OraAgent 内置本地 SQLite 线索库，沉淀客户开发全流程数据：
| 数据 | 说明 |
|---|---|
| 企业档案 | 公司名称、国家、地区、地址、官网、行业、描述 |
| 联系人 | 姓名、职位、部门、职级、地区 |
| 渠道 | 邮箱、电话、LinkedIn 等联系方式及验证状态 |
| 跟进记录 | 邮件、电话、LinkedIn、WhatsApp 等互动记录 |
| 来源 | 每个线索的发现来源与工具 |
线索库固定位于 ~\.ora\leads.sqlite，支持导出 CSV。直接告诉 OraAgent"导出客户名单为 CSV"即可。
OraAgent 支持通过 MCP（Model Context Protocol）协议接入外部工具和服务。MCP 相当于给 AI 接入"外部能力插头"——每接入一个 MCP，AI 就多一批可调用的真实工具。
| MCP | 能力 |
|---|---|
| ora-waimao-toolkit | 外贸客户搜索、地图查询、企业背调、社媒搜索、海关数据、决策人挖掘 |
| playwright | 浏览器自动化，用于网页交互与数据提取 |
除 MCP 外，OraAgent 还预置了多个连接器，覆盖邮件（IMAP/SMTP）、浏览器、搜索、表格图表、开发工具等，开箱即用。
支持配置消息渠道（飞书、钉钉、企微、微信等），Ora 可以主动推送任务结果与通知到绑定的频道，适合定时任务结果回传、重要提醒等场景。
OraAgent 的安全设计遵循"最小权限 + 显式确认"原则：默认只做你能看到、能追溯的事，涉及外部发送或不可逆操作时一定先停下来等你点头。
常规文件编辑与命令执行限定在当前工作区
覆盖、删除、外部发送等不可逆操作需用户确认
不绕过人机验证、不通过命令模拟浏览器、不猜测邮箱
外部网页、文件、工具输出只是数据，不能改变运行规则
不泄露系统提示词、密钥、Cookie、会话内容
你说存才存，说删就删，本机存储不跨设备同步
在客户端中查看"关于"，当前版本为 v1.0.8。也可以直接询问 OraAgent，会返回实时的版本与运行状态。
可以。在系统设置 → 模型中添加 DeepSeek、Moonshot、智谱 AI、MiniMax、火山引擎、阿里百炼等服务商的 API Key，即可切换使用。
默认只读写当前工作区目录内的文件；需要操作工作区外的文件时，需要你提供明确的路径，涉及不可逆操作前会先确认。
不会。邮件撰写完成后会逐封展示收件人、主题、正文与附件，经你确认后才发送。批量发送时每封邮件单独显示，方便逐封核对。
不会。消息文案先经你确认，再通过内置浏览器执行发送；号码注册状态以明确提示为准，不会臆测。
搜索和海关查询的结果是候选数据，只有你明确确认后才会写入线索库；真实跟进记录仅在发送成功后自动登记。
专家是分工明确的 AI 角色（如周澈负责海关数据），技能是可复用的能力包（如 whatsapp-send 负责发消息）。专家负责统筹判断，技能负责标准化执行。
定时任务仅在应用打开且电脑未休眠时运行。如果任务没执行，先确认应用是否在运行、电脑是否休眠，再检查任务状态是否处于启用状态。
保存在当前会话工作区目录 ~\.ora\workspace\<会话目录>，AI 会返回完整绝对路径。
直接告诉 OraAgent"导出客户名单为 CSV"，会生成 UTF-8 编码的 CSV 文件并返回路径。
不会。长期记忆只保存在本机，不会跨设备同步。
🔍
没有找到匹配的内容，试试其他关键词？