install-qwenpaw

QwenPaw Linux 服务器安装部署

前置信息收集

开始前必须向用户获取以下信息，缺一不可：

1. 百炼 API Key — 格式以 sk- 开头，从 https://bailian.console.aliyun.com/ 获取
2. 钉钉 Client ID — 即 AppKey，从钉钉开发者后台获取
3. 钉钉 Client Secret — 即 AppSecret，从钉钉开发者后台获取
4. 模型名称（可选）— 默认 qwen3-max，可选 qwen3-235b-a22b-thinking-2507、deepseek-v3.2 等

---

一键部署（推荐）

本 skill 提供了一键部署脚本 scripts/setup.sh，收集到用户信息后直接执行：

bash scripts/setup.sh <百炼API_KEY> <钉钉CLIENT_ID> <钉钉CLIENT_SECRET> [模型名称]

示例：

bash scripts/setup.sh sk-76f003xxx dingxxxxx your_secret
bash scripts/setup.sh sk-76f003xxx dingxxxxx your_secret qwen3-235b-a22b-thinking-2507

脚本会自动完成：检查 uv → 安装 QwenPaw → 创建目录 → 写入配置（替换占位符）→ 验证文件 → 后台启动服务。

执行前需要先将本 skill 目录上传到服务器，或通过工具将 scripts/setup.sh 和 reference/ 目录写入服务器。

---

手动分步部署

如果脚本不可用，按以下步骤手动操作。

步骤 1: 检查并安装 uv

QwenPaw 依赖 uv 作为 Python 包管理器。优先通过阿里云镜像安装，失败时用官方脚本兜底：

if command -v uv &>/dev/null; then
  echo "uv 已安装: $(uv --version)"
else
  # 方式 1: pip + 阿里云镜像（推荐）
  pip install uv -i https://mirrors.aliyun.com/pypi/simple/
  # 方式 2: 官方安装脚本（pip 不可用时）
  # curl -LsSf https://astral.sh/uv/install.sh | sh
fi

步骤 2: 安装 QwenPaw

# 方式 1: 阿里云镜像（推荐）
uv pip install qwenpaw --index-url https://mirrors.aliyun.com/pypi/simple/

# 方式 2: 官方安装脚本（镜像不可用时）
# curl -fsSL https://qwenpaw.agentscope.io/install.sh | bash
# source ~/.bashrc

验证：

qwenpaw --version

找不到命令时手动加 PATH：

export PATH="$HOME/.qwenpaw/bin:$PATH"
echo 'export PATH="$HOME/.qwenpaw/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

步骤 3: 创建目录结构

mkdir -p ~/.qwenpaw/media
mkdir -p ~/.qwenpaw/active_skills
mkdir -p ~/.qwenpaw/customized_skills
mkdir -p ~/.qwenpaw.secret/providers/builtin
mkdir -p ~/.qwenpaw.secret/providers/custom
chmod 700 ~/.qwenpaw.secret ~/.qwenpaw.secret/providers ~/.qwenpaw.secret/providers/builtin ~/.qwenpaw.secret/providers/custom

步骤 4: 写入配置文件

读取 reference/ 下的模板文件，替换占位符后写入目标路径。

3a: config.json（含钉钉频道配置）

读取 reference/config.json.example，替换后写入 ~/.qwenpaw/config.json：