华为云 AI Shell × Paseo：随时随地用手机控制你的云端开发

本教程介绍如何将华为云 AI Shell (HWC AI Shell) 接入 Paseo，实现通过手机 App 或网页远程控制 AI Shell 进行云端开发运维。

1. 华为云 AI Shell 简介

华为云 AI Shell 是华为云推出的云端开发环境，通过浏览器访问 devstation.connect.huaweicloud.com/aishell 即可进入一个 ARM 虚拟机（容器），无需本地安装任何软件。

环境中预装了 HWC AI CLI（hwcloud），通过 hwcloud chat 命令启动华为云 AI 智能助手，支持用自然语言完成华为云资源的查询、创建和管理。本教程中 Paseo 对接的就是这个 AI CLI。

内置技能（Skills）

分类	技能	能力
计算	Computing Query	查询 ECS/BMS/IMS/AS 实例、规格、镜像、伸缩组
网络	Network Query	查询 VPC/子网/安全组/EIP/ELB/NAT/VPN/DNS
存储	Storage Query	查询 EVS 云硬盘/OBS 桶/SFS 文件系统/CBR 备份
存储	OBS Bucket Create	创建 OBS 存储桶
存储	OBS Upload	上传文件/目录到 OBS，支持定时同步
存储	OBS Stats	查询 OBS 流量/请求量及环比
存储	OBS Website Host	配置 OBS 静态网站托管及自定义域名
监控	Monitoring Query	查询 CES 告警规则/历史/仪表盘/企业项目
计费	Billing Scout	余额/账单/代金券/储值卡/企业账务查询
计费	Business Support Query	费用/订单/退款/成本/资源用量查询
IAM	IAM Query	用户/组/策略/委托/AK/SK/MFA 查询
容器	CCI Instance Management	CCI 云容器实例全生命周期管理（namespace/deployment/pod）
函数	FunctionGraph Create	创建和部署 FunctionGraph 函数
函数	FunctionGraph Trigger	创建定时触发器（Cron）
IaC	Terraform Generator	生成华为云 Terraform 配置并部署
IaC	Terraform Installer	安装 Terraform CLI（华为云镜像加速）
开发	CodeArts Code Gen	代码生成（对接 CodeArts/码道）
发现	Find Skills	搜索/浏览/安装华为云 Agent Skills
反馈	VOD Collector	开发者体验反馈收集

2. Paseo 简介

Paseo 是一个开源的 AI Coding Agent 管理平台，提供：

🖥️ 服务端（Daemon）：运行在开发机上，管理多个 AI Agent 的创建、运行和生命周期
📱 手机 App / 网页端：远程查看 Agent 状态、发送指令、查看实时输出
🔌 多 Provider 支持：通过 ACP 协议对接 Claude Code、Codex、Copilot、Pi 等多种 Agent
🔐 安全配对：二维码扫码连接，端到端加密

💡 简单说：Paseo 让你出门在外时，用手机就能给开发机上的 AI Shell 派活并看到结果。

3. 配置步骤

3.1 安装 Paseo

在 AI Shell 终端中执行：

# 安装 Paseo 服务端
npm install -g @getpaseo/cli

💡 华为云 AI Shell 已预装 Node.js 和 hwcloud，无需额外安装或登录。

3.2 添加 AI Shell 到 Paseo

Paseo 通过 ACP（Agent Client Protocol） 协议与 Agent 通信——这是一个标准的 AI Agent 通信协议，AI Shell 原生支持。

编辑 Paseo 配置文件 ~/.paseo/config.json，在 agents.providers 下添加：

{
  "agents": {
    "providers": {
      "hwcloud": {
        "extends": "acp",
        "label": "HWC AI Shell",
        "description": "Huawei Cloud CLI coding agent",
        "command": ["hwcloud", "acp"]
      }
    }
  }
}

原理说明：

┌──────────┐    ACP/stdio     ┌──────────────┐    内部调用     ┌──────────┐
│  Paseo   │ ◄──────────────► │  hwcloud acp │ ─────────────► │  AI Shell │
│  Daemon  │   ndjson-rpc     │  (ACP Server) │                │  Engine   │
└──────────┘                  └──────────────┘                └──────────┘

extends: "acp" — 告诉 Paseo 这是一个标准 ACP 协议的 Agent
command: ["hwcloud", "acp"] — Paseo 启动 Agent 时执行的命令，hwcloud acp 以 ACP Server 模式运行
Paseo 自动管理进程生命周期：创建会话时 spawn 进程，结束后回收

# 重启 Paseo Daemon 使配置生效
paseo restart

3.3 启动 Paseo 并连接

# 启动 Paseo（首次运行自动进入配对流程）
paseo onboard

执行后会显示 二维码 和 控制面 URL：

📱 手机 App：安装 Paseo App 扫码连接
🌐 网页端：浏览器直接打开 URL 即可进入控制面板

# 后续日常启动
paseo start

# 查看服务状态
paseo status

# 验证 AI Shell 已接入
paseo provider ls
# 应显示：hwcloud  HWC AI Shell  available

4. 使用示例

# 创建 AI Shell Agent 并查询云资源
paseo run --provider hwcloud "查询我的华为云账户余额和最近消费"

# 列出当前所有 Agent
paseo ls

# 查看 Agent 实时输出
paseo attach <agent-id>

# 向运行中的 Agent 追加指令
paseo send <agent-id> "再看看 OBS 的流量情况"

5. 注意事项

模型切换：AI Shell 的模型在 ~/.huawei/hwcloud/settings.json 中配置，当前默认模型为 glm-5
安全：Paseo Daemon 默认监听 127.0.0.1:6767，仅本地访问；手机通过 Relay 中转连接，端到端加密
日志：~/.paseo/daemon.log 可查看 Paseo 运行日志

📦 本文配图来自 paseo.sh