阿里云JVS智能体套件对接使用完全指南：从架构解析到生产级集成

apphuang2026年07月10日 12:02:359

1. JVS智能体套件：企业级AI智能体的全新范式

在人工智能技术飞速演进的今天，企业对于AI的需求早已超越单纯的对话问答，而是希望AI能够真正"动手做事"——操作应用、处理文档、执行复杂任务。阿里云JVS智能体套件正是在这一背景下应运而生。JVS是阿里云推出的企业级AI智能体一体化产品家族，依托无影云电脑、百炼大模型平台及自研AgentBay Sandbox沙箱技术，为企业提供标准化的智能体开发、部署与运行环境。

JVS智能体套件采用Harness分布式架构，由三款互补产品组成：

JVS Claw：面向消费端与开发者，提供开箱即用的AI助理体验，支持自然语言驱动Clawbot在安全CloudSpace中自动执行任务，具备可视化操作、5000+自进化技能、云端/本地双模部署、金融级隔离等特性。
JVS Crew：面向企业端与ISV，是全托管的企业级智能体底座，提供开放集成、中心管控、安全审计能力。
JVS Mobile：面向移动端场景，提供云端Android环境下的智能自动化能力。

这三款产品共用同一套Harness架构核心——Agent执行层本质没有区别，区别只在外围的多租户、权限、审计与计费模块。

需要先登录阿里云控制台，点击：阿里云控制台

2. JVS的技术内核：Harness架构与"环境范式"

理解JVS的对接与使用，首先需要理解其背后的技术哲学。JVS Crew团队摒弃了传统的智能体编排范式，首创了"环境范式"——智能在模型，执行在沙箱。这一理念的核心在于：将模型的推理决策能力与实际的执行环境进行分离，模型负责"思考"，沙箱环境负责"执行"，两者通过标准化的接口进行通信。

Harness四层架构是实现这一理念的技术底座：

第一层：统一接入层——负责接收来自网页、客户端、IM渠道等多种来源的请求，进行身份认证与路由分发。
第二层：智能体运行时层——承载Agent的生命周期管理、模型调度、上下文维护与决策引擎。
第三层：安全沙箱层——基于AgentBay Sandbox技术提供隔离的执行环境，确保代码运行、文件操作、网络请求等行为不会影响宿主系统或其他租户。
第四层：数据层——负责会话持久化、知识库存储、用户配置与审计日志的管理。

这一架构设计带来的核心优势在于三点：安全隔离——每个Agent运行在独立的沙箱中，数据全程在云端处理，本地不留存；动态决策——模型根据实时上下文动态决定下一步行动，而非遵循僵化的预设流程；全链路可观测——所有操作均可审计、可溯源，满足企业级合规要求。

3. 对接前的准备工作

在正式开始使用JVS智能体套件之前，需要完成以下准备工作。

3.1 账号注册与认证

首先，注册阿里云账号并完成个人实名认证或企业实名认证。这是使用任何阿里云服务的基础前提。对于JVS Crew的企业用户，还需要提前规划好组织架构与权限策略。

3.2 产品选择与权限配置

根据使用场景选择合适的产品。个人开发者或小型团队可以从JVS Claw入手，它提供7天免费体验版；企业级部署则需要使用JVS Crew，通过主账号或获得AliyunAgentBayFullAccess权限的RAM子账号进行操作。对于JVS Mobile，则需要获得AliyunECDFullAccess权限的RAM子账号。

3.3 理解产品定位

JVS Claw面向个人和开发者的开箱即用AI助理，对话即触发、执行可视化，适合轻量场景。JVS Crew面向企业和ISV的全托管智能体底座，提供开放集成、中心管控、安全审计能力，适合企业级部署。JVS Mobile则专注于移动端场景，提供云端Android环境下的智能自动化。

4. JVS Claw的对接与使用

JVS Claw是JVS智能体套件中门槛最低、上手最快的产品。用户可通过网页端、桌面客户端（Windows/macOS/Linux）或移动端APP（iOS/Android）访问。

4.1 创建Clawbot

Clawbot是JVS Claw中的智能体实例，每个Clawbot对应一个独立的AI助理。创建流程如下：

登录JVS Claw控制台（网页端）或打开JVS Claw客户端。
在左侧导航栏选择"Clawbots"，进入Clawbot管理页面。
单击左上角"创建云端Clawbot"卡片，进入创建页面。
输入Clawbot名称，选择风格，单击"下一步"。
选择节点资源类型（云端或本地设备），单击"创建Clawbot"。

JVS Claw支持两种部署模式：

云端Clawbot：运行在阿里云提供的CloudSpace云端环境中，AI的所有操作（浏览网页、下载文件、运行代码）都在云端隔离环境中完成，避免病毒入侵本地或误删本地文件。
本地Clawbot：运行在用户本地设备上，适合对数据本地化有要求的场景。

4.2 模型配置

创建Clawbot后，需要为其配置底层大模型。JVS Claw支持配置并使用第三方模型，使用自定义模型时不会消耗积分。在Clawbot管理页面，单击目标Clawbot卡片进入详情页，在模型配置区域选择所需模型并进行检测。

4.3 Skill管理

创建Clawbot时，系统会根据智能体的定位自动添加一组默认Skill，覆盖搜索、工具调用、文件处理等常见场景。用户也可以在创建后随时添加、开启或关闭Skill。JVS Claw内置了5000+自进化技能库，支持复杂任务如数据分析、代码生成等。

对于开发者，JVS Claw支持自定义Skill开发：

准备3个md文件作为Skill的定义文件。
通过Skill中心上传自定义Skill，系统自动执行安全扫描。
通过后在Clawbot中启用该Skill。

4.4 IM渠道接入

JVS Claw的一大亮点是支持将Clawbot接入各类IM平台，用户可在微信、企业微信、钉钉、飞书、QQ等平台中与AI对话，驱动其执行任务。

微信接入步骤：

前往JVS Claw控制台，在左侧导航栏选择"Clawbots"。
点击目标Clawbot的图标，进入详情页。
在IM通道列表页面点击"微信卡片"，点击"立即绑定"。
使用微信扫描二维码完成JVS Claw微信通道配置。
配置完成后，在IM通道配置页面确认微信通道状态为"已绑定"。

接入完成后，用户可在微信顶部搜索框中搜索"微信ClawBot"直接使用，发送消息即可与机器人进行对话。

企业微信接入步骤：

前往JVS Claw控制台，在左侧导航栏选择"Clawbots"。
点击目标Clawbot的图标，进入详情页。
在IM通道列表页面点击"企业微信卡片"，点击"立即绑定"。
输入企业微信智能机器人的Bot ID和Secret，单击"完成配置"。

钉钉接入步骤：

在钉钉开放平台创建钉钉应用，记录Client ID及Client Secret。
返回JVS Crew的消息渠道页面，开启钉钉卡片下方的"立即接入"。
将Client ID和Client Secret分别填入App ID及App Secret中，开启启用开关。
创建钉钉机器人，消息接收模式选择Stream模式。
发布应用后，在钉钉群聊中添加机器人，通过@机器人实现自动回复。

接入多渠道IM后，企业员工可以在日常使用的沟通工具中直接与AI智能体交互，无需切换应用，大幅降低使用门槛。

5. JVS Crew的企业级部署

JVS Crew是面向企业端与ISV的全托管智能体底座，提供智能体云上构建部署、资源弹性伸缩、多租户隔离与沙箱化运行、多重安全防护及全链路可观测等核心能力。它以"被集成"为设计理念，企业可将其快速嵌入现有App、SaaS服务或智能硬件，零门槛获得生产级AI Agent构建能力。

5.1 Agent配置

在JVS Crew控制台中配置Agent主要包括以下步骤：

角色设定：在左侧菜单栏选择"角色设定"，点击"添加文件"添加自定义的角色设定。JVS Crew已配置默认的AGENT.md、PROFILE.md以及SOUL.md，可使用默认配置。

模型配置：在左侧菜单栏点击"模型配置"，勾选STANDARD配置并点击"生效配置"。

调试Agent：在控制台调试入口可以直接与模型对话，实时体验已经配置完成的Agent使用效果。

5.2 多租户与权限管理

JVS Crew支持多租户隔离，企业管理员可以一站式创建、配置、下发和回收Agent实例，统一管理底层模型与权限策略。企业管理员通过Agent管理中心可以：

统一创建Agent云电脑实例。
配置底层模型与权限策略。
分配Agent给终端用户使用。
监控Agent运行状态与用量。

5.3 工作空间管理

JVS Crew提供工作空间管理能力，支持同步、列举、下载和清理用户工作空间数据。每个Agent拥有独立的工作空间，数据相互隔离，确保企业数据安全。

6. JVS Mobile的移动端自动化

JVS Mobile提供云端Android环境下的智能自动化能力，每个节点对应一台JVS Mobile实例，可用于运行智能体任务。

6.1 创建节点

创建JVS Mobile节点的流程如下：

在左侧菜单栏选择"节点"，然后单击"创建节点"。
选择套餐版本（高级版或旗舰版）并配置购买数量。
配置带宽包（支持最小5Mbps最大3072Mbps）。
如需补充积分，可购买积分加油包。
单击"立即购买"完成创建。

6.2 与JVS Mobile对话

创建节点后，可前往对话页与JVS Mobile下发指令：

在左侧菜单栏选择"对话"。
在消息框左下角选择一个节点。
点击右侧下拉菜单选择OpenClaw智能体。
发送指令或任务。

例如，发送指令"帮我下载应用宝并安装淘宝"后，左侧手机模拟器将展示应用宝中淘宝的详情页，右侧聊天区域中OpenClaw智能体返回任务执行结果。

7. API深度集成：将JVS Crew嵌入自有应用

JVS Crew提供完整的REST API，开发者可将JVS Crew的AI对话能力集成到自己的应用中。API分为十大类：会话交互、技能管理、用户MCP管理、会话管理、环境变量、定时任务、计费查询、工作空间管理、模板管理、渠道管理。

7.1 认证机制

JVS Crew API使用两种认证方式：

AK/SK签名认证：适用于GetAccessToken、ListSkills、SyncWorkspaceFiles等管理类接口。使用阿里云AccessKey进行POP V1签名。
JWT令牌认证：适用于Chat、ListSessions、DeleteSession等对话类接口。先调用GetAccessToken获取AccessToken，放入Query参数Authorization=Bearer <token>。

7.2 API基础信息

协议：HTTPS
生产Base URL：https://wuyingai.cn-shanghai.aliyuncs.com
API版本：2026-03-11

7.3 Python完整集成示例

以下是一个完整的Python示例，展示如何将JVS Crew的AI对话能力集成到自有应用中：

import requests
import json
import hmac
import hashlib
import base64
import time
import uuid

# ==================== 配置区域 ====================
ACCESS_KEY_ID = "your-access-key-id"
ACCESS_KEY_SECRET = "your-access-key-secret"
EXTERNAL_USER_ID = "user-001"  # 你的系统中用户的唯一标识
BASE_URL = "https://wuyingai.cn-shanghai.aliyuncs.com"
API_VERSION = "2026-03-11"

# ==================== AK/SK 签名工具 ====================
def sign_request(access_key_secret, action, params):
    """生成POP V1签名"""
    sorted_params = sorted(params.items())
    query_string = "&".join([f"{k}={v}" for k, v in sorted_params])
    string_to_sign = f"POST&%2F&{query_string}"
    signature = base64.b64encode(
        hmac.new(
            access_key_secret.encode("utf-8"),
            string_to_sign.encode("utf-8"),
            hashlib.sha1
        ).digest()
    ).decode("utf-8")
    return signature

# ==================== 步骤1：获取AccessToken ====================
def get_access_token():
    """调用GetAccessToken接口获取JWT令牌"""
    timestamp = time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime())
    nonce = str(uuid.uuid4())
    
    params = {
        "Action": "GetAccessToken",
        "ExternalUserId": EXTERNAL_USER_ID,
        "Timestamp": timestamp,
        "SignatureNonce": nonce,
        "SignatureMethod": "HMAC-SHA1",
        "SignatureVersion": "1.0",
        "AccessKeyId": ACCESS_KEY_ID,
        "Format": "JSON",
        "Version": API_VERSION
    }
    
    signature = sign_request(ACCESS_KEY_SECRET, "GetAccessToken", params)
    params["Signature"] = signature
    
    response = requests.post(BASE_URL, params=params)
    result = response.json()
    
    if "AccessToken" in result:
        print(f"✓ 获取AccessToken成功")
        return result["AccessToken"]
    else:
        print(f"✗ 获取AccessToken失败: {result}")
        return None

# ==================== 步骤2：发起对话 ====================
def chat_with_agent(access_token, user_message, session_id=None):
    """
    携带AccessToken调用Chat接口，通过SSE流接收回复
    """
    if not session_id:
        session_id = str(uuid.uuid4())
    
    url = f"{BASE_URL}/?Authorization=Bearer%20{access_token}"
    
    headers = {
        "x-acs-action": "Chat",
        "x-acs-version": API_VERSION,
        "x-acs-date": time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime()),
        "Content-Type": "application/json"
    }
    
    payload = {
        "SessionId": session_id,
        "Message": user_message,
        "Stream": True  # 启用SSE流式响应
    }
    
    response = requests.post(url, headers=headers, json=payload, stream=True)
    
    if response.status_code == 200:
        print(f"\n用户: {user_message}")
        print("AI: ", end="", flush=True)
        
        # 解析SSE流
        for line in response.iter_lines(decode_unicode=True):
            if line and line.startswith("data:"):
                data = line[5:].strip()
                if data and data != "[DONE]":
                    try:
                        chunk = json.loads(data)
                        if "Content" in chunk:
                            print(chunk["Content"], end="", flush=True)
                    except json.JSONDecodeError:
                        pass
        print("\n")
        return session_id
    else:
        print(f"✗ 对话请求失败: {response.status_code}")
        return None

# ==================== 步骤3：查询会话列表 ====================
def list_sessions(access_token):
    """列举历史会话"""
    url = f"{BASE_URL}/?Authorization=Bearer%20{access_token}"
    
    headers = {
        "x-acs-action": "ListSessions",
        "x-acs-version": API_VERSION,
        "x-acs-date": time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime()),
        "Content-Type": "application/json"
    }
    
    response = requests.post(url, headers=headers, json={})
    result = response.json()
    print(f"会话列表: {json.dumps(result, indent=2, ensure_ascii=False)}")
    return result

# ==================== 主程序 ====================
if __name__ == "__main__":
    # 获取AccessToken
    token = get_access_token()
    if not token:
        exit(1)
    
    # 发起多轮对话
    session_id = chat_with_agent(token, "帮我总结一下今天的热点新闻")
    
    if session_id:
        chat_with_agent(token, "再详细说说第一条新闻", session_id)
    
    # 查询会话列表
    list_sessions(token)

集成JVS Crew最少只需两步：获取令牌——使用AK/SK调用GetAccessToken获取AccessToken；发起对话——携带AccessToken调用Chat，通过SSE流接收回复。

7.4 会话管理API

JVS Crew提供完整的会话管理能力：

ListSessions：列举历史会话
ListSessionHistory：查看会话历史消息
StopSession：停止正在进行的会话
DeleteSession：删除历史会话

7.5 定时任务API

JVS Crew支持创建、管理和监控定时执行任务，开发者可通过API设置Agent在指定时间自动执行任务，适用于日报生成、定时监控、周期性数据抓取等场景。

8. 自定义Skill开发与扩展

JVS智能体套件提供了丰富的扩展能力，开发者可以开发自定义Skill来扩展Agent的能力边界。

8.1 Skill开发流程

自定义Skill的开发主要包括以下步骤：

准备Skill定义：共需3个md文件，定义Skill的功能描述、触发条件和执行逻辑。
上传Skill：通过Skill中心上传自定义Skill，系统自动执行安全扫描。
启用Skill：在Agent模板或Clawbot中启用该Skill。

8.2 Skill类型

JVS支持多种类型的Skill扩展：

RPA自动化流程：使用RPA开发自动化流程，发布为MCP Tool作为Skill的运行时。
API调用Skill：将外部API封装为Skill，让Agent能够调用企业内部的系统接口。
数据处理Skill：封装特定的数据处理逻辑，如数据清洗、格式转换、报表生成等。

8.3 Skill管理

通过SkillTab管理Agent模板关联的Skill，通过Skill中心管理租户级自定义Skill。上传后系统自动执行安全扫描，通过后可在Agent模板中启用。企业还可以建立自建Skill市场，统一管理和一键下发核心业务技能。

9. 安全与合规

JVS智能体套件从多个层面保障企业数据安全与合规。

9.1 数据安全

数据隔离：数据全程在云端处理，本地不留存。
沙箱隔离：AgentBay沙箱隔离执行环境，每个Agent运行在独立的沙箱中。
权限控制：细粒度访问权限控制。
数据加密：支持数据加密存储和传输。
审计追溯：所有操作可审计、可溯源。

9.2 多租户隔离

JVS Crew支持多租户隔离，不同企业的Agent运行在相互隔离的环境中，确保数据不会跨租户泄露。

9.3 安全最佳实践

使用RAM子账号进行日常操作，遵循最小权限原则。
定期轮换AccessKey。
启用操作审计日志，定期审查。
对于敏感操作，配置审批流程。

10. 计费与成本优化

10.1 计费模式

JVS Claw采用套餐订阅与积分包充值的组合计费模式。用户通过订阅不同档位的套餐获取基础权益与云资源，在积分不足时通过充值积分包补充额度。

套餐规格：

体验版：新用户7天免费体验，包含1个云端Clawbot。
先锋版：基础版套餐，适合轻度用户。
匠心版：每月1600积分，1个云端Clawbot，适合日常自动化工作流。
大师版：每月5600积分，3个云端Clawbot，支持多任务并发处理及高峰优先权。

积分说明：积分是JVS Claw使用的代币，用于抵扣用户调用模型时消耗的token数量。系统根据模型返回及输入的Token数量，实时扣除账户内的对应积分。

积分包规格：

500积分包：¥25.00，有效期6个月
1,000积分包：¥50.00，有效期6个月
2,000积分包：¥100.00，有效期6个月
6,000积分包：¥300.00，有效期6个月
10,000积分包：¥500.00，有效期6个月

10.2 JVS Mobile计费

JVS Mobile仅支持按月购买，支持自动续费。高级版包含1个Agent节点、1000积分；旗舰版包含60个Agent节点、40,000积分。

10.3 成本优化建议

根据实际使用量选择合适的套餐，避免资源浪费。
使用自定义模型（第三方模型）时不消耗积分。
合理规划积分使用，简单任务（信息查询）每次消耗约5积分，中等任务（网页操作）每次消耗约20积分，复杂任务（在线搜索比对）每次消耗约50积分。
关注套餐续费提醒，避免资源过期删除。

11. 常见问题解答

问1：JVS Claw和JVS Crew有什么区别？如何选择？

JVS Claw面向个人和开发者的开箱即用AI助理，对话即触发、执行可视化，适合轻量场景。JVS Crew面向企业和ISV的全托管智能体底座，提供开放集成、中心管控、安全审计能力，适合企业级部署。个人开发者从小型团队建议从JVS Claw入手，企业级项目建议使用JVS Crew。

问2：JVS智能体套件如何保障企业数据安全？

JVS从多个层面保障数据安全：数据全程在云端处理，本地不留存；AgentBay沙箱隔离执行环境；细粒度访问权限控制；所有操作可审计、可溯源；支持数据加密存储和传输。

问3：JVS能否与企业现有系统集成？

支持。JVS Crew提供丰富的REST API和连接器，可与企业OA、ERP、CRM、数据库等系统无缝集成。通过原子化API与SDK，企业可将智能体能力快速嵌入现有App、SaaS服务或智能硬件。

问4：JVS支持哪些终端和渠道？

桌面端支持Windows、macOS、Linux；移动端支持iOS、Android；Web端支持主流浏览器；集成端支持钉钉、企业微信、微信、飞书、QQ等IM平台。

问5：JVS Claw的积分是如何消耗的？积分耗尽后还能使用吗？

积分用于抵扣调用模型时消耗的Token数量。简单任务（信息查询）每次约5积分，中等任务（网页操作）每次约20积分，复杂任务（在线搜索比对）每次约50积分。如果套餐未到期但积分耗尽，Clawbot将无法使用默认模型进行对话，但此时仍可以进入CloudSpace操作云电脑。用户可以通过购买积分包补充额度。

问6：JVS Claw支持配置第三方模型吗？

支持。JVS Claw支持配置并使用第三方模型，使用自定义模型时不会消耗积分。用户可以在Clawbot的模型配置区域选择自定义模型并进行配置。