SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场huawei-cloud-flexus-l-deploy-jiuwenswarm

huawei-cloud-flexus-l-deploy-jiuwenswarm

智能体与模型

查看项目

更新于 10-15 12:33

技能介绍

用途

该技能为华为云 Flexus L 实例上的 JiuwenSwarm（JiuwenClaw）多智能体协作平台提供完整的自动化部署方案，通过分阶段脚本实现从环境准备到消息通道配置的全流程自动化。

主要能力

  • Flexus L 实例创建：调用 Flexus L API 创建实例，支持实例名称、规格、地域等参数。
  • 实例状态查询：通过 KooCLI（hcloud RMS ListAllResources）查询实例状态、公网 IP、实例 ID。
  • COC 远程部署：使用华为云 COC（云运维中心）在实例上远程执行部署脚本。
  • COC 任务状态查询：通过 COC API 查询部署任务执行状态与结果。
  • 系统服务配置：配置 systemd 服务实现开机自启。
  • 模型配置：配置 API_BASE、API_KEY、MODEL_NAME、MODEL_PROVIDER。
  • 消息通道配置：支持小艺（Xiaoyi）、飞书（Feishu）、钉钉（DingTalk）三种消息通道。

使用方式

部署分 7 个阶段依次执行：

  1. 环境准备：验证华为云凭证（AK/SK），设置 PYTHONIOENCODING=utf-8，检查依赖模块 requests、huaweicloudsdkcore、huaweicloudsdkcoc 及 KooCLI（hcloud），校验凭证有效性。
  2. 创建 Flexus L 实例（需客户确认）：未提供 --region 时交互选择地域，展示实例配置与预估费用，等待确认后获取 Project ID、调用创建 API、轮询 RMS 等待完成，获取 instance_id、public_ip、ecs_instance_id。
  3. COC 远程依赖安装：安装 git、curl、vim、wget、net-tools 等基础工具，检查 Python 与 Node.js 环境（约 8 分钟）。
  4. COC 远程 JiuwenSwarm 服务部署：读取部署脚本模板，在实例上执行完整部署脚本，安装 JiuwenSwarm、配置 systemd 服务并启动（约 15 分钟）。
  5. 验证部署结果：查询 COC 任务状态，验证服务运行、.env 配置（FRONTEND_HOST=0.0.0.0）及端口绑定（5173、18092、19000、19001），检查服务健康状态，输出 Web 访问地址。
  6. 模型配置：交互收集 API_BASE、API_KEY、MODEL_NAME、MODEL_PROVIDER，生成 COC 远程执行脚本更新 .env 并重启服务。
  7. 消息通道配置：选择 xiaoyi/feishu/dingtalk，按通道类型收集相应凭证，更新 config.yaml 并重启服务。

核心部署命令示例：

# 1. 环境准备
python scripts/prepare_env.py

# 2. 创建实例（交互确认）
python scripts/create_instance.py --name jiuwenSwarm-<timestamp> --flavor 2c-4g-50g --wait

# 3. 安装依赖
python scripts/install_deps.py --ip <public_ip>

# 4. 部署服务
python scripts/deploy_service.py --ip <public_ip>

# 5. 验证部署
python scripts/verify_deployment.py --ip <public_ip>

# 6. 配置模型
python scripts/config_model.py --ip <public_ip> --interactive

# 7. 配置消息通道
python scripts/config_channel.py --channel xiaoyi --ip <public_ip> --interactive

凭证配置方式（二选一）：

  • hcloud CLI 配置文件（推荐）：存储在 ~/.hcloud/config.json。
  • 环境变量（备选）：HUAWEICLOUD_SDK_AK、HUAWEICLOUD_SDK_SK、HUAWEICLOUD_SDK_SECURITY_TOKEN（仅 STS）、HUAWEICLOUD_REGION（默认 cn-north-4）。

适用场景

  • 需要快速在华为云部署 JiuwenSwarm 多智能体协作平台。
  • 需要在 Flexus L 实例上安装 JiuwenClaw。
  • 需要为 JiuwenSwarm 添加飞书机器人。
  • 需要为 JiuwenSwarm 配置自定义模型。
  • 需要一键部署 JiuwenSwarm 并配置小艺消息通道。

前提条件与限制

  • 需要有效的华为云账号、足够的余额或计费方式，以及目标地域（cn-north-4/cn-east-3/cn-south-1/cn-southwest-2）的 Flexus L 实例配额。
  • 需要具备相应权限的 AK/SK，支持 STS 临时安全凭证；所需 IAM 权限见 references/iam-policies.md。
  • 环境要求 Python 3.8+ 及 pip，建议使用虚拟环境；需安装 requests、huaweicloudsdkcore、huaweicloudsdkcoc；需安装 KooCLI（hcloud）并在 PATH 中可用。
  • 网络需能访问华为云 API，安全组需允许出站 HTTP/HTTPS（80、443）；Web 访问需在部署后开放安全组 5173 端口。
  • 实例最低规格 2c-4g-50g，需公网 IP。
  • 执行任何云资源创建操作前必须获得客户明确确认。
  • 安全执行规则（最高优先级）：所有脚本必须通过 skill action=exec 执行，禁止直接在 shell 中运行；禁止在对话中打印包含 AK/SK/Token 的脚本内容或命令；禁止创建临时脚本文件，优先内联执行（python -c）；禁止与用户交互式收集华为云凭证，凭证只能通过 hcloud CLI 配置文件或环境变量获取。
  • 脚本执行失败时仅返回错误信息，不得重写脚本或打印完整命令。

补充说明

Web UI 访问需两个条件同时满足：服务绑定到 0.0.0.0（通过 .env 中 FRONTEND_HOST=0.0.0.0 配置），以及安全组允许 5173 端口。开放端口后 JiuwenSwarm Web 界面将可被访问，建议仅在需要时临时开放并在使用后关闭。关于计费、具体价格与模型可用平台等未在本资料中完整提供的细节，暂未提供。