Mac 下 QwenPaw 安装记录 - 从零配置 OpenRouter MiniMax 模型

把 QwenPaw（原 CoPaw）装好了，记录一下安装和配置过程。

背景

QwenPaw 是 AgentScope 团队开源的个人 AI 助手，支持钉钉、飞书、微信、Discord 等多渠道，还能本地运行、扩展 Skills。GitHub 星标 15K+。

问题卡点

官方推荐三种安装方式：

1. pip install qwenpaw — 需要 Python 3.10+
2. 安装脚本 curl -fsSL https://qwenpaw.agentscope.io/install.sh | bash — 自动下载 uv
3. Docker

我的系统自带 Python 是 3.9.6，pip 版本也老（21.2.4），而 qwenpaw 要求 Python 3.10-3.14。我平时用 conda 管理 Python 环境，所以直接走 conda 路线。

用 conda 创建环境

# 1. 创建 Python 3.11 虚拟环境
conda create -n qwenpaw python=3.11 -y

# 2. 激活环境
conda activate qwenpaw

# 3. 安装 qwenpaw
pip install qwenpaw

这样就搞定了，不需要额外引入 uv。环境激活后 python 和 pip 都指向 conda 环境内的版本，不会产生污染。

配置 OpenRouter MiniMax 模型

qwenpaw 内置支持 OpenRouter provider，配置很简单。编辑 ~/.copaw/config.json：

{
  "$schema": "https://qwenpaw.agentscope.io/schema.json",
  "model": {
    "models": {
      "minimax-free": {
        "provider": "openrouter",
        "model": "minimax/minimax-m2.5:free",
        "base_url": "https://openrouter.ai/api/v1",
        "api_key": "你的OPENROUTER_KEY",
        "enabled": true
      }
    },
    "default_model": "minimax-free"
  }
}

注意：OpenRouter 的 MiniMax 模型 ID 格式是 minimax/minimax-m2.5:free，用冒号而不是连字符。

启动与验证

# 激活 conda 环境后，qwenpaw 命令可直接使用
conda activate qwenpaw

# 初始化（需要交互式终端）
qwenpaw init

# 或者启动 Web UI
qwenpaw app

启动后打开浏览器访问 http://127.0.0.1:8088/ 进行配置和聊天。

验证安装：

qwenpaw --version
# QwenPaw, version 1.1.3

Agent 配置：让 Agent 理解你是谁

安装完成只是第一步，真正的关键在于记忆文件配置。

核心记忆文件

QwenPaw 的工作区位于 ~/.copaw/workspaces/default/，包含以下文件：

配置流程

1. 首次启动 — Agent 自动读取所有记忆文件，为空则使用默认模板。
2. 手动配置 — 编辑 PROFILE.md 定义身份和偏好，编辑 SOUL.md 定义行为边界。
3. 持续迭代 — Agent 会在每次会话中主动记录重要信息到 memory/YYYY-MM-DD.md，定期提炼到 MEMORY.md。

关键：QwenPaw 不会每次重启都重新初始化。记忆通过文件持久化，会话中断后自动恢复上下文。

依赖规模

qwenpaw 的依赖比较多（约 244 个包），包括：

• agentscope 1.0.19
• playwright 1.58.0（39MB）
• transformers 5.5.4（9.8MB）
• onnxruntime 1.23.2（16MB）
• chromadb 1.5.8（20MB）
• grpcio 1.80.0（11MB）
• pandas 3.0.2（9.5MB）
• 阿里系 SDK（alibabacloud-dingtalk 等）
• 消息渠道 SDK（discord-py、twilio 等）

首次安装需要下载不少内容，耐心等待即可。conda 环境下这些依赖会被隔离在环境目录中，不会影响系统。

相关工具对比

QwenPaw 和 OpenCode 可以通过 ACP（Agent Communication Protocol）互联，默认配置中已开启：

"acp": {
  "agents": {
    "opencode": { "enabled": true },
    "qwen_code": { "enabled": true },
    "claude_code": { "enabled": true }
  }
}

参考资料

• QwenPaw 官网：https://qwenpaw.agentscope.io/
• GitHub：https://github.com/agentscope-ai/QwenPaw
• OpenRouter MiniMax M2.5 Free：https://openrouter.ai/minimax/minimax-m2.5:free