AGENT SKILL

install-qwenpaw

在 Alibaba Cloud Linux 4 (Alinux 4) 服务器上完成 QwenPaw AI 助理的安装部署,包括脚本安装、直接写入配置文件、百炼模型 API Key 配置、钉钉频道接入。当用户需要安装 QwenPaw、部署 AI 助理、配置钉钉机器人或百炼模型时使用此技能。

使用场景运维与部署
License 许可
Apache-2.0
最近更新
2026-11-14
Stars
★ 665
Forks
195

01 前言 Front Matter

name
install-qwenpaw
layer
application
version
1.0.0
lifecycle
usage
description
在 Alibaba Cloud Linux 4 (Alinux 4) 服务器上完成 QwenPaw AI 助理的安装部署,包括脚本安装、直接写入配置文件、百炼模型 API Key 配置、钉钉频道接入。当用户需要安装 QwenPaw、部署 AI 助理、配置钉钉机器人或百炼模型时使用此技能。

02 资源文件 10

03 SKILL.md 正文

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:

替换:
  {DINGTALK_CLIENT_ID} → 用户的钉钉 Client ID
  {DINGTALK_CLIENT_SECRET} → 用户的钉钉 Client Secret

钉钉已预设 "enabled": true。qwenpaw app 启动时会自动迁移生成 agent.json 等文件。

3b: dashscope.json

读取 reference/dashscope.json,替换后写入 ~/.qwenpaw.secret/providers/builtin/dashscope.json:

替换: {DASHSCOPE_API_KEY} → 用户的百炼 API Key
chmod 600 ~/.qwenpaw.secret/providers/builtin/dashscope.json

3c: active_model.json

读取 reference/active_model.json,替换后写入 ~/.qwenpaw.secret/providers/active_model.json:

替换: {MODEL_NAME} → 用户指定的模型(默认 qwen3-max)
chmod 600 ~/.qwenpaw.secret/providers/active_model.json

3d: Markdown 文件

原样复制到 ~/.qwenpaw/(无占位符):

reference/AGENTS.md    → ~/.qwenpaw/AGENTS.md
reference/SOUL.md      → ~/.qwenpaw/SOUL.md
reference/PROFILE.md   → ~/.qwenpaw/PROFILE.md
reference/MEMORY.md    → ~/.qwenpaw/MEMORY.md
reference/BOOTSTRAP.md → ~/.qwenpaw/BOOTSTRAP.md
reference/HEARTBEAT.md → ~/.qwenpaw/HEARTBEAT.md

3e: 验证文件完整性

for f in \
  ~/.qwenpaw/config.json \
  ~/.qwenpaw.secret/providers/builtin/dashscope.json \
  ~/.qwenpaw.secret/providers/active_model.json \
  ~/.qwenpaw/AGENTS.md \
  ~/.qwenpaw/SOUL.md \
  ~/.qwenpaw/PROFILE.md \
  ~/.qwenpaw/MEMORY.md \
  ~/.qwenpaw/BOOTSTRAP.md \
  ~/.qwenpaw/HEARTBEAT.md; do
  [ -f "$f" ] && echo "OK: $f" || echo "MISSING: $f"
done

步骤 5: 启动服务

nohup qwenpaw app --host 0.0.0.0 --port 8088 > ~/.qwenpaw/qwenpaw.log 2>&1 &
echo "QwenPaw PID: $!"
sleep 5

--host 0.0.0.0 使外部可访问。仅本机访问用 127.0.0.1。

步骤 6: 验证部署

curl -s -N -X POST "http://localhost:8088/api/agent/process" \
  -H "Content-Type: application/json" \
  -d '{"input":[{"role":"user","content":[{"type":"text","text":"你好"}]}],"session_id":"test123"}' \
  | head -c 500

返回 SSE 流式数据(data: 开头)表示服务正常。

qwenpaw channels list

确认 dingtalk 显示 enabled: True。


故障排查

qwenpaw 命令找不到

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

模型返回错误

cat ~/.qwenpaw.secret/providers/builtin/dashscope.json | python3 -m json.tool
cat ~/.qwenpaw.secret/providers/active_model.json | python3 -m json.tool

确认 api_key 以 sk- 开头,model 字段有值。

钉钉机器人不回复

python3 -c "
import json
with open('$HOME/.qwenpaw/config.json') as f:
    c = json.load(f)
print(json.dumps(c.get('channels',{}).get('dingtalk',{}), indent=2, ensure_ascii=False))
"
tail -100 ~/.qwenpaw/qwenpaw.log | grep -i dingtalk

钉钉侧检查:应用已发布、Stream 模式已启用、Client ID/Secret 正确。

端口占用

lsof -i :8088
nohup qwenpaw app --host 0.0.0.0 --port 9090 > ~/.qwenpaw/qwenpaw.log 2>&1 &

停止服务

kill $(pgrep -f "qwenpaw app")

钉钉应用创建指引(提供给用户)

如果用户还没有钉钉应用凭证,告知以下步骤:

  1. 打开 https://open-dev.dingtalk.com/
  2. 进入「应用开发 → 企业内部应用 → 钉钉应用 → 创建应用」
  3. 在「应用能力 → 添加应用能力」中添加「机器人」
  4. 配置机器人:消息接收模式选择 Stream 模式,点击「发布」
  5. 在「应用发布 → 版本管理与发布」中创建新版本并保存
  6. 在「基础信息 → 凭证与基础信息」中复制 Client ID 和 Client Secret
  7. (可选)在「安全设置 → 服务器出口 IP」添加服务器公网 IP(curl ifconfig.me 获取),支持图片/文件下载

文件清单

install-qwenpaw/
├── SKILL.md
├── scripts/
│   └── setup.sh                 # 一键部署脚本
└── reference/
    ├── config.json.example      → ~/.qwenpaw/config.json
    ├── dashscope.json           → ~/.qwenpaw.secret/providers/builtin/dashscope.json
    ├── active_model.json        → ~/.qwenpaw.secret/providers/active_model.json
    ├── AGENTS.md                → ~/.qwenpaw/AGENTS.md
    ├── SOUL.md                  → ~/.qwenpaw/SOUL.md
    ├── PROFILE.md               → ~/.qwenpaw/PROFILE.md
    ├── MEMORY.md                → ~/.qwenpaw/MEMORY.md
    ├── BOOTSTRAP.md             → ~/.qwenpaw/BOOTSTRAP.md
    └── HEARTBEAT.md             → ~/.qwenpaw/HEARTBEAT.md

04 同仓库更多 Skills

agentic-os-org
agentic-os-org/ANOLISA

ws-ckpt

Linux 工作区快照(ws-ckpt)。用户想保存或备份工作区当前状态("保存一下"、"留个底"、"先备份"), 想撤销或恢复文件改动("回滚"、"撤销"、"改回去"、"恢复到之前"、"刚才那版"), 想查看、对比或删除历史版本,或要开启/关闭每回合自动快照、定时快照、快照保留策略时使用。 用户没提"快照"、只表达保存或恢复工作区文件的意图时同样适用;用户点名 git 操作(commit、branch、reset 到某提交)时不适用。

★ 665
agentic-os-org
agentic-os-org/ANOLISA

skillfs-mount

Help users configure, mount, and unmount a skillfs FUSE virtual filesystem on their local machine (e.g. for openclaw). Covers analyzing existing skill usage to suggest view configuration, generating skillfs-views.toml, mounting, and graceful unmount. Use this skill when the user asks to: set up skillfs, configure skill views, mount or unmount skillfs, check if skillfs is running, or get help organizing their skills directory (especially for openclaw users).

Skill与智能体开发
★ 665
agentic-os-org
agentic-os-org/ANOLISA

test-skill

A test skill used in integration tests.

测试与质量Skill与智能体开发
★ 665
agentic-os-org
agentic-os-org/ANOLISA

storage-resize

Linux 磁盘扩容技能(RPM 包管理系统),实现云盘扩容后自动完成分区调整和文件系统扩容。支持系统盘/数据盘在线扩容,适配 XFS/EXT4/Btrfs 文件系统。适用于 RPM 包管理的 Linux 系统(如 Alibaba Cloud Linux)。

★ 665
agentic-os-org
agentic-os-org/ANOLISA

ktuner

内核参数自动调优。分析系统配置,输出调优建议并可一键应用,支持自动回滚。使用场景:系统性能优化、安全加固、内核参数诊断。

★ 665
agentic-os-org
agentic-os-org/ANOLISA

backup-restore

处理所有备份与恢复任务,覆盖四个层面:工作区(项目/数据库/代码)、用户数据(家目录/dotfiles/密钥)、操作系统(全量系统/磁盘镜像/LVM 快照)、阿里云快照(云盘快照/自动策略/跨地域复制/整机镜像)。适用于 RPM 包管理的 Linux 系统(如 Alibaba Cloud Linux)纯命令行环境,使用 yum 包管理器。当用户提到备份、恢复、快照、归档、回滚、克隆、迁移、容灾等任何涉及数据保存或恢复的请求时触发此技能,即使请求看起来很简单也应使用。

★ 665