CoPAW（QwenPaw）：开源桌面Agent平台（下）

ftpeak

338人浏览 · 2026-05-29 14:00:00

ftpeak · 2026-05-29 14:00:00 发布

五、频道配置：全域触达

5.1 频道概念

频道（Channel） 是你和 QwenPaw 对话的「地方」。接钉钉就在钉钉里回复，接飞书就在飞书里回复。

┌─────────────────────────────────────────────────────────┐
│                    频道架构示意                          │
├─────────────────────────────────────────────────────────┤
│                                                         │
│   用户在钉钉发消息 ──→ QwenPaw 接收 ──→ 处理后回复到钉钉  │
│                                                         │
│   用户在飞书发消息 ──→ QwenPaw 接收 ──→ 处理后回复到飞书  │
│                                                         │
│   用户在微信发消息 ──→ QwenPaw 接收 ──→ 处理后回复到微信  │
│                                                         │
└─────────────────────────────────────────────────────────┘

配置方式

有两种配置频道的方式：

控制台配置（推荐）：在「控制 → 频道」页面，点击频道卡片，填写鉴权信息
手动编辑配置文件：修改 agent.json 中的 channels 字段

5.2 钉钉频道配置

钉钉是最推荐的频道，配置简单，功能完整。

5.2.1 创建钉钉应用

步骤一：打开钉钉开发者后台

访问钉钉开发者后台

步骤二：创建应用

进入「应用开发 → 企业内部应用 → 钉钉应用」
点击「创建应用」
填写应用名称和描述

步骤三：添加机器人能力

进入「应用能力 → 添加应用能力」
选择「机器人」
配置机器人基础信息
设置消息接收模式为 Stream 模式（流式接收）
点击发布

步骤四：获取凭证

在「基础信息 → 凭证与基础信息」中获取：

Client ID（即 AppKey）
Client Secret（即 AppSecret）

步骤五：配置服务器 IP 白名单（可选）

如果需要下载用户发送的图片和文件，需要配置 IP 白名单：

进入「安全设置 → 服务器出口 IP」
添加运行 QwenPaw 的机器的公网 IP
可在终端执行 curl ifconfig.me 查看公网 IP

5.2.2 绑定应用到 QwenPaw

方法一：控制台配置

进入「控制 → 频道」
找到「DingTalk」卡片
填入 Client ID 和 Client Secret
保存

方法二：修改配置文件

编辑 ~/.qwenpaw/workspaces/default/agent.json：

{
  "channels": {
    "dingtalk": {
      "enabled": true,
      "bot_prefix": "[BOT]",
      "client_id": "你的 Client ID",
      "client_secret": "你的 Client Secret",
      "filter_tool_messages": false
    }
  }
}

5.2.3 钉钉专属配置字段

字段	类型	默认值	说明
`client_id`	string	""（必填）	钉钉应用 Client ID（即 AppKey）
`client_secret`	string	""（必填）	钉钉应用 Client Secret（即 AppSecret）
`message_type`	string	"markdown"	消息类型：`markdown` 或 `card`（AI 卡片）
`card_template_id`	string	""	AI 卡片模板 ID
`card_template_key`	string	"content"	AI 卡片模板变量名
`robot_code`	string	""	机器人编码（群聊场景建议配置）
`media_dir`	string	null	媒体文件下载目录

5.2.4 找到创建的机器人

点击钉钉「消息」栏的搜索框
搜索机器人的名称
在「功能」下找到机器人
点击进入对话框

添加到群聊：在钉钉群中通过「群设置 → 机器人 → 添加机器人」将机器人添加到群聊。

5.3 飞书频道配置

飞书频道通过 WebSocket 长连接 接收消息，无需公网 IP 或 webhook。

5.3.1 创建飞书应用

步骤一：打开飞书开放平台

访问飞书开放平台，创建企业自建应用。

步骤二：获取凭证

在「凭证与基础信息」中获取：

App ID
App Secret

步骤三：启用机器人能力

在「能力」中启用「机器人」。

步骤四：配置权限

在「权限管理」中批量导入以下权限：

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "aily:message:read",
      "aily:message:write",
      "corehr:file:download",
      "im:chat",
      "im:message",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message.reactions:read",
      "im:resource",
      "contact:user.base:readonly"
    ],
    "user": []
  }
}

步骤五：配置事件订阅

进入「事件与回调 → 事件配置」
选择订阅方式为「长连接（WebSocket）」模式
添加事件：搜索「接收消息」，订阅「接收消息 v2.0」

步骤六：配置回调

进入「事件与回调 → 回调配置」
选择订阅方式为「长连接（WebSocket）」模式
添加回调：搜索「卡片回传交互」，订阅「卡片回传交互」

步骤七：发布应用

在「应用发布 → 版本管理与发布」中创建版本并发布。

5.3.2 绑定应用到 QwenPaw

编辑 agent.json：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "bot_prefix": "[BOT]",
      "app_id": "cli_xxxxx",
      "app_secret": "你的 App Secret",
      "domain": "feishu"
    }
  }
}

5.3.3 飞书专属配置字段

字段	类型	默认值	说明
`app_id`	string	""（必填）	飞书应用 App ID
`app_secret`	string	""（必填）	飞书应用 App Secret
`domain`	string	"feishu"	`feishu`（国内）或 `lark`（国际版）
`encrypt_key`	string	""	消息加密密钥（可选）
`verification_token`	string	""	验证 Token（可选）
`media_dir`	string	null	媒体文件下载目录

依赖安装：

pip install lark-oapi

如果使用 SOCKS 代理，还需安装：

pip install python-socks

5.4 其他频道配置

QwenPaw 还支持多种其他频道：

微信

通过企业微信或个人微信接口接入，需要配置相应的 Token 和 EncodingAESKey。

Discord

通过 Bot Token 接入，需要在 Discord 开发者平台创建应用。

通过 Bot Token 接入，需要在 BotFather 创建机器人。

QQ

通过 go-cqhttp 等 QQ 协议实现接入。

详细配置请参考官方文档。

5.5 访问控制

QwenPaw v1.1.9 引入了统一的访问控制机制，支持每个频道独立配置：

控制模式

模式	说明
白名单	只有列表中的用户可以访问
黑名单	列表中的用户被禁止访问
待审批	新用户需要管理员审批后才能访问

配置方式

在控制台的「控制 → 频道」页面，点击频道卡片，在抽屉中配置访问控制。

六、MCP 与内置工具

6.1 MCP 协议简介

MCP（Model Context Protocol，模型上下文协议） 是一种让 AI 模型连接外部服务的标准协议。通过 MCP，QwenPaw 可以：

访问文件系统
连接数据库
调用外部 API
使用各种工具和服务

┌─────────────────────────────────────────────────────────┐
│                    MCP 架构示意                          │
├─────────────────────────────────────────────────────────┤
│                                                         │
│   QwenPaw ←──→ MCP 客户端 ←──→ MCP 服务器               │
│                     │                                   │
│                     ├── 文件系统服务器                   │
│                     ├── 数据库服务器                     │
│                     ├── 搜索服务器（Tavily）             │
│                     └── 自定义服务器                     │
│                                                         │
└─────────────────────────────────────────────────────────┘

6.2 配置 MCP 客户端

6.2.1 前置要求

使用本地 MCP 服务器需要 Node.js 18+：

node --version  # 检查版本

远程 MCP 服务器无需本地依赖。

6.2.2 添加 MCP 客户端

打开控制台，进入「智能体 → MCP」
点击「+ 创建」按钮
粘贴 MCP 客户端的 JSON 配置
点击「创建」完成导入

6.2.3 配置格式

QwenPaw 支持三种 JSON 格式：

格式一：标准 mcpServers 格式（推荐）

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/folder"
      ],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

格式二：直接键值对格式

{
  "filesystem": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/folder"]
  }
}

格式三：单个客户端格式

{
  "key": "filesystem",
  "name": "文件系统访问",
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/folder"]
}

6.2.4 常用 MCP 服务器配置示例

文件系统访问：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Documents"
      ]
    }
  }
}

网络搜索（Tavily）：

{
  "mcpServers": {
    "tavily": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {
        "TAVILY_API_KEY": "tvly-xxxxxxxxxxxxx"
      }
    }
  }
}

远程 MCP 服务：

{
  "mcpServers": {
    "remote-api": {
      "transport": "streamable_http",
      "url": "https://api.example.com/mcp",
      "headers": {
        "Authorization": "Bearer your-token"
      }
    }
  }
}

6.2.5 配置字段说明

字段	类型	默认值	说明
`name`	string	-	客户端名称（必填）
`description`	string	""	客户端描述
`enabled`	bool	true	是否启用
`transport`	string	"stdio"	传输方式：stdio / streamable_http / sse
`url`	string	""	远程 MCP 服务器地址
`headers`	object	{}	HTTP 请求头
`command`	string	""	启动命令（stdio 模式）
`args`	string[]	[]	命令参数
`env`	object	{}	环境变量
`cwd`	string	""	工作目录

6.3 内置工具详解

QwenPaw 提供了一组开箱即用的内置工具，智能体可以直接调用。

6.3.1 工具列表

类型	工具名称	功能说明
文件操作	`read_file`	读取文件内容，支持按行范围读取
文件操作	`write_file`	创建或覆盖文件
文件操作	`edit_file`	使用查找替换修改文件内容
文件操作	`append_file`	追加内容到文件末尾
文件搜索	`grep_search`	按内容搜索文件，支持正则表达式
文件搜索	`glob_search`	按文件名模式查找文件
命令执行	`execute_shell_command`	执行 Shell 命令，支持异步执行
智能体委托	`delegate_external_agent`	通过 ACP 将任务委托给外部智能体
浏览器自动化	`browser_use`	浏览器自动化，支持 30+ 种操作
截图	`desktop_screenshot`	捕获桌面或窗口截图
图像分析	`view_image`	加载图片到上下文供模型分析
文件传输	`send_file_to_user`	发送文件给用户
记忆搜索	`memory_search`	在 MEMORY.md 中语义搜索
时间	`get_current_time`	获取当前时间和时区
时间	`set_user_timezone`	设置用户时区偏好
统计	`get_token_usage`	查询 LLM Token 使用量统计

6.3.2 文件操作工具详解

read_file - 读取文件

# 参数说明
{
  "path": "/path/to/file",      # 文件路径
  "start_line": 1,              # 起始行号（可选）
  "end_line": 100               # 结束行号（可选）
}

特点：

大文件会自动截断（默认 50KB）
截断时会提示使用 start_line 继续读取
显示文件总行数和下一次读取的起始行号

edit_file - 编辑文件

# 参数说明
{
  "path": "/path/to/file",
  "old_str": "要替换的内容",
  "new_str": "新内容"
}

特点：

全文查找替换所有匹配项
适合精确修改

append_file - 追加内容

# 参数说明
{
  "path": "/path/to/file",
  "content": "要追加的内容"
}

特点：

不会覆盖原有内容
适合追加日志、累积数据
文件不存在会自动创建

6.3.3 文件搜索工具详解

grep_search - 内容搜索

# 参数说明
{
  "pattern": "搜索内容",         # 搜索字符串或正则表达式
  "path": "/path/to/search",    # 搜索路径（可选）
  "is_regex": false,            # 是否为正则表达式
  "case_sensitive": true,       # 是否区分大小写
  "context_lines": 0,           # 上下文行数（最大 5）
  "include_pattern": "*.py"     # 文件名筛选
}

glob_search - 文件名搜索

# 参数说明
{
  "pattern": "**/*.json"        # glob 模式
}

支持递归模式，如 **/*.json 搜索所有子目录中的 JSON 文件。

6.3.4 命令执行工具详解

execute_shell_command - 执行命令

# 参数说明
{
  "command": "ls -la",          # 要执行的命令
  "timeout": 60,                # 超时时间（秒）
  "cwd": "/path/to/workdir"     # 工作目录（可选）
}

特点：

跨平台支持（Windows 使用 cmd.exe，Linux/macOS 使用 bash）
支持异步执行模式

异步执行：

启用异步执行后，智能体会自动获得额外工具：

list_background_tasks - 查看所有正在运行的任务
get_task_output - 获取任务的输出结果
cancel_task - 取消正在运行的任务

6.3.5 浏览器自动化工具详解

browser_use - 浏览器操作

支持 30+ 种操作：

操作类型	具体操作
基础导航	start, stop, open, navigate, navigate_back, close
页面交互	click, type, hover, drag, select_option
页面分析	snapshot, screenshot, console_messages, network_requests
表单操作	fill_form, file_upload, press_key
JavaScript	eval, evaluate, run_code
高级功能	cookies_get, cookies_set, cookies_clear, tabs, wait_for, pdf

使用示例：

# 启动浏览器
{
  "action": "start",
  "headed": true              # 显示浏览器窗口
}

# 导航到网页
{
  "action": "navigate",
  "url": "https://example.com"
}

# 截图
{
  "action": "screenshot"
}

# 关闭浏览器
{
  "action": "stop"
}

CDP 模式（高级功能）：

通过 Chrome DevTools Protocol (CDP) 连接到已运行的 Chrome 浏览器：

# 启动时暴露 CDP 端口
{
  "action": "start",
  "cdp_port": 9222
}

# 连接到外部浏览器
{
  "action": "connect_cdp",
  "cdp_url": "http://localhost:9222"
}

适用场景：

连接用户手动打开的 Chrome（保持登录状态、书签、插件）
与外部调试工具配合使用

6.3.6 智能体委托工具详解

delegate_external_agent - 委托外部智能体

通过 ACP（Agent Client Protocol）与外部智能体 runner 建立会话：

# 参数说明
{
  "action": "start",           # start / message / respond / close
  "runner": "claude_code",     # qwen_code / claude_code / codex / opencode
  "message": "帮我分析代码",    # 发送的消息
  "cwd": "/path/to/workdir"    # 工作目录
}

使用流程：

在「智能体 → 工具」页面开启 delegate_external_agent 工具
在对话中提出需求：「请使用外部智能体 claude code 帮我分析代码」
QwenPaw 会与外部智能体建立连续对话
中间进度和结果会回传到当前会话

6.4 工具配置与管理

6.4.1 启用和禁用工具

打开控制台，进入「智能体 → 工具」
查看所有内置工具及其状态
使用卡片右下角的开关按钮单独启用或禁用工具
使用页面顶部的「全部启用」或「全部禁用」按钮进行批量操作

建议：只启用实际需要的工具，以减少上下文占用，加快响应速度。

6.4.2 工具配置字段

每个工具支持以下配置：

字段	类型	默认值	说明
`name`	string	-	工具函数名
`enabled`	bool	true	是否启用
`display_to_user`	bool	true	工具输出是否显示给用户
`async_execution`	bool	false	是否异步执行

6.4.3 配置示例

{
  "tools": {
    "builtin_tools": {
      "execute_shell_command": {
        "name": "execute_shell_command",
        "enabled": true,
        "display_to_user": true,
        "async_execution": false
      },
      "read_file": {
        "name": "read_file",
        "enabled": true,
        "display_to_user": true
      }
    }
  }
}

七、定时任务与计划模式

7.1 定时任务（Cron Job）

定时任务让 QwenPaw 在指定时间自动执行动作。

7.1.1 任务类型

类型	说明	示例
循环任务	每隔多久执行一次	每 15 分钟、每天 9:00
日程任务	在指定日历时间执行	2026 年 1 月 1 日 9:00

7.1.2 创建定时任务

方式一：对话创建（最简单）

用户：「未来七天内，每天早上八点为我查询当天天气」
QwenPaw：「好的，已创建定时任务...」

方式二：控制台创建

进入「控制 → 定时任务」
点击「创建任务」
填写信息：
- 基本信息：任务名称、启用开关
- 运行结果是否入收件箱
- 调度：选择循环任务或日程任务
- 任务类型：text（固定文本）或 agent（向 QwenPaw 发送请求）
- 投递：目标频道、用户 ID、会话 ID
- 共用会话：是否与目标用户共用会话
点击「保存」

方式三：CLI 创建

# 每天 9 点发固定文本
qwenpaw cron create \
  --agent-id default \
  --type text \
  --schedule-type cron \
  --name "每日早安" \
  --cron "0 9 * * *" \
  --channel dingtalk \
  --target-user "你的用户ID" \
  --target-session "你的会话ID" \
  --text "早上好，记得查看今天待办。"

# 日程一次性任务
qwenpaw cron create \
  --agent-id default \
  --type text \
  --schedule-type scheduled \
  --name "明早组会提醒" \
  --run-at "2026-05-13T09:00:00+08:00" \
  --channel dingtalk \
  --target-user "你的用户ID" \
  --text "9 点组会提醒"

7.1.3 Cron 表达式速查

QwenPaw 使用五段式 Cron：分时日月周（无秒）。

表达式	含义
`0 9 * * *`	每天 9:00
`0 /2 * *`	每 2 小时整点
`30 8 * * 1-5`	工作日 8:30
`0 10 * * 1`	每周一 10:00
`0 9 1 * *`	每月 1 号 9:00
`/15 * * *`	每 15 分钟

7.1.4 日历视图

新增日历视图，所有日程任务会按日期展示在日历中，方便快速查看当天安排。

7.2 计划模式（Plan Mode）

计划模式让智能体把复杂请求拆成可追踪的步骤，在确认后逐步执行。

7.2.1 启用计划模式

方式一：控制台启用

进入「设置 → 智能体」
展开对应智能体的配置卡片
打开「Plan Mode（计划模式）」开关

方式二：修改配置文件

{
  "plan": {
    "enabled": true
  }
}

7.2.2 使用计划模式

在对话中使用 /plan 命令：

/plan 整理项目的 README 和 API 文档，确保内容准确并补全缺失章节

执行流程：

智能体生成包含若干子任务的结构化计划
展示计划并等待用户确认
确认后逐步执行子任务
每个子任务完成后记录结果
所有子任务完成后标记计划为「完成」

7.2.3 子任务状态

状态	含义
`todo`	尚未开始
`in_progress`	当前正在执行
`done`	已完成
`abandoned`	放弃

7.2.4 Plan 面板

开启计划模式后，聊天工具栏会出现 Plan 图标，点击后打开抽屉面板：

当前计划的名称、描述与整体状态
子任务列表（名称、描述、状态、结果）
总体进度条

7.3 心跳机制（Heartbeat）

心跳是固定周期的自检/摘要机制，让智能体定期主动服务。

典型用途

定期检查待办事项
自动汇总当天工作
主动提醒重要事项

八、记忆系统

8.1 记忆文件结构

QwenPaw 的记忆系统基于 Markdown 文件：

~/.qwenpaw/workspaces/{agent_id}/
├── MEMORY.md              # 长期记忆（重要决策、用户偏好）
└── memory/
    ├── 2026-05-27.md      # 每日记忆
    ├── 2026-05-28.md
    └── ...

MEMORY.md - 长期记忆

存储经过提炼的长期记忆：

重要决策和结论
用户偏好和习惯
经验教训
关键信息

memory/*.md - 每日记忆

按日期存储交互摘要：

当天的重要对话
完成的任务
学习到的新信息

8.2 记忆管理功能

8.2.1 启用记忆管理

在「智能体 → 运行配置」中启用「记忆管理」功能。

8.2.2 记忆搜索

使用 memory_search 工具在记忆中语义搜索：

# 参数说明
{
  "query": "用户喜欢什么",      # 语义搜索查询
  "max_results": 5,           # 最多返回结果数
  "min_score": 0.1            # 最低相似度阈值
}

搜索范围：当前智能体工作区根目录下的 MEMORY.md 和 memory/*.md 文件。

8.3 记忆进化与主动交互

8.3.1 学习与记忆

智能体会从交互中学习：

记住你的偏好和习惯
记住重要决策和结论
记住你的背景信息

8.3.2 反思与进化

智能体会定期反思：

整理和归纳记忆内容
提炼重要信息到长期记忆
优化自己的行为

8.3.3 主动服务

智能体会在合适的时机主动提供帮助：

提醒重要事项
推荐相关内容
提供个性化建议

九、安全特性

9.1 多层安全架构

QwenPaw 提供多层安全防护：

┌─────────────────────────────────────────────────────────┐
│                    安全架构示意                          │
├─────────────────────────────────────────────────────────┤
│                                                         │
│   第一层：工具防护                                        │
│   ├── 限制可调用的工具                                   │
│   └── 敏感操作需要确认                                   │
│                                                         │
│   第二层：文件访问控制                                    │
│   ├── 限制可访问的目录                                   │
│   └── 防止越权访问                                       │
│                                                         │
│   第三层：技能安全扫描                                    │
│   ├── 检测潜在风险代码                                   │
│   └── 阻止危险操作                                       │
│                                                         │
│   第四层：权限审批                                        │
│   ├── 敏感操作需用户确认                                 │
│   └── 可配置审批策略                                     │
│                                                         │
└─────────────────────────────────────────────────────────┘

9.2 工具防护

9.2.1 工具启用控制

可以单独启用/禁用每个工具
建议只启用实际需要的工具

9.2.2 敏感操作确认

对于敏感操作（如删除文件、执行危险命令），需要用户确认。

9.3 文件访问控制

9.3.1 目录限制

9.3.2 路径穿越防护

防止通过 ../ 等方式越权访问其他目录。

9.4 技能安全扫描

9.4.1 扫描内容

检测危险代码模式
检测敏感信息泄露风险
检测恶意行为

9.4.2 处理方式

高风险：阻止加载
中风险：警告提示
低风险：记录日志

十、最佳实践

10.1 人设设计建议

10.1.1 AGENTS.md 设计

明确工作流程和规则
定义清晰的边界和底线
提供具体的操作指南

10.1.2 SOUL.md 设计

定义清晰的个性特征
保持一致的风格和语气
设置合理的行为边界

10.1.3 PROFILE.md 设计

准确记录用户信息
及时更新用户偏好
保持信息的时效性

10.2 技能开发指南

10.2.1 技能结构

skills/
└── my_skill/
    ├── SKILL.md          # 技能描述和使用说明
    ├── skill.py          # 技能实现
    └── requirements.txt  # 依赖（可选）

10.2.2 SKILL.md 格式

---
name: my_skill
description: 技能描述
---

# 使用说明

详细的使用说明...

10.3 性能优化建议

10.3.1 模型选择

简单任务：使用小模型（如 QwenPaw-Flash-2B）
复杂任务：使用大模型（如 QwenPaw-Flash-9B）
追求质量：使用云端模型

10.3.2 上下文管理

定期清理不需要的对话历史
使用记忆系统存储重要信息
避免加载过多的人设文件

10.3.3 工具配置

只启用需要的工具
禁用不常用的工具
使用异步执行处理长时间任务

10.4 常见问题与解决方案

问题 1：模型连接失败

可能原因：

API Key 错误
网络问题
模型服务未启动

解决方案：

检查 API Key 是否正确
检查网络连接
使用「测试连接」功能验证

问题 2：定时任务不执行

可能原因：

任务未启用
时间配置错误
目标频道未配置

解决方案：

检查任务是否启用
验证 Cron 表达式或日程时间
检查频道配置

问题 3：频道消息不回复

可能原因：

频道未启用
凭证配置错误
权限不足

解决方案：

检查频道是否启用
验证凭证是否正确
检查应用权限配置

十一、总结与展望

11.1 QwenPaw 的核心价值

QwenPaw 是一个真正属于你的 AI 助理：

数据由你掌控：本地部署，隐私保护
能力由你定义：开源可扩展，技能自定义
平台由你选择：10+ 频道，全域触达
智能持续进化：记忆学习，主动服务

11.2 适用场景

场景	使用方式
个人助理	本地部署，日常对话，任务管理
团队协作	云端部署，多频道接入，多智能体协作
开发测试	Docker 部署，自定义技能开发
企业应用	阿里云 ECS 部署，安全合规

11.3 未来展望

QwenPaw 团队持续迭代，未来计划：

更多频道支持
更强大的多智能体协作
更丰富的技能生态
更完善的开发者工具

附录：快速参考

常用命令

# 安装
pip install qwenpaw

# 初始化
qwenpaw init --defaults

# 启动
qwenpaw app

# 定时任务
qwenpaw cron list
qwenpaw cron create ...

# 卸载
qwenpaw uninstall          # 保留配置和数据
qwenpaw uninstall --purge  # 删除所有内容

配置文件位置

文件	位置
工作目录	`~/.qwenpaw/`
智能体配置	`~/.qwenpaw/workspaces/{agent_id}/agent.json`
人设文件	`~/.qwenpaw/workspaces/{agent_id}/*.md`
模型配置	`~/.qwenpaw.secret/providers/`

支持的频道

频道	特点
钉钉	推荐，功能完整
飞书	WebSocket 长连接
微信	企业微信/个人微信
Discord	国际平台
Telegram	国际平台
QQ	go-cqhttp

支持的模型提供商

类型	提供商
本地	QwenPaw Local、Ollama、LM Studio
云端	DashScope、OpenAI、Anthropic、Google Gemini、DeepSeek、Kimi、Zhipu、SiliconFlow

参考资料：

（全文完）

AtomGit开源社区

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。

更多推荐

[Dify x EdgeOne] 论文猎手——用 Dify + EdgeOne Pages 给科研人造一个每日 arXiv 速读助手

AtomGit开源社区

消息跨端架构演进：基于 C++ 的多端一致性研发框架实践

跨端不是追求 100% 代码复用。核心是在"一致性"与"平台最优体验"之间找到平衡点。对于强交互场景（如键盘区域），保留 Native 实现往往是更好的选择。容器框架的抽象层级要足够精简。过度设计会导致理解成本反增。我们的 BizLogicProtocol 只有 7 个核心方法，足以覆盖所有业务场景。全链路质量监控是成功落地的关键保障。跨端方案最怕的不是技术问题，而是出了问题找不到原因。架构合理性

AtomGit开源社区

ZeroTier 深度解析：从架构原理到企业组网实战

AtomGit开源社区

所有评论(0)

查看更多评论

ftpeak

@weixin_43033268

已为社区贡献35条内容

CoPAW（QwenPaw）：开源桌面Agent平台（下）

ftpeak

五、频道配置：全域触达

5.1 频道概念

配置方式

5.2 钉钉频道配置

5.2.1 创建钉钉应用

5.2.2 绑定应用到 QwenPaw

5.2.3 钉钉专属配置字段

5.2.4 找到创建的机器人

5.3 飞书频道配置

5.3.1 创建飞书应用

5.3.2 绑定应用到 QwenPaw

5.3.3 飞书专属配置字段

5.4 其他频道配置

微信

Discord

Telegram

QQ

5.5 访问控制

控制模式

配置方式

六、MCP 与内置工具

6.1 MCP 协议简介

6.2 配置 MCP 客户端

6.2.1 前置要求

6.2.2 添加 MCP 客户端

6.2.3 配置格式

6.2.4 常用 MCP 服务器配置示例

6.2.5 配置字段说明

6.3 内置工具详解

6.3.1 工具列表

6.3.2 文件操作工具详解

6.3.3 文件搜索工具详解

6.3.4 命令执行工具详解

6.3.5 浏览器自动化工具详解

6.3.6 智能体委托工具详解

6.4 工具配置与管理

6.4.1 启用和禁用工具

6.4.2 工具配置字段

6.4.3 配置示例

七、定时任务与计划模式

7.1 定时任务（Cron Job）

7.1.1 任务类型

7.1.2 创建定时任务

7.1.3 Cron 表达式速查

7.1.4 日历视图

7.2 计划模式（Plan Mode）

7.2.1 启用计划模式

7.2.2 使用计划模式

7.2.3 子任务状态

7.2.4 Plan 面板

7.3 心跳机制（Heartbeat）

典型用途

八、记忆系统

8.1 记忆文件结构

MEMORY.md - 长期记忆

memory/*.md - 每日记忆

8.2 记忆管理功能

8.2.1 启用记忆管理

8.2.2 记忆搜索

8.3 记忆进化与主动交互

8.3.1 学习与记忆

8.3.2 反思与进化

8.3.3 主动服务

九、安全特性

9.1 多层安全架构

9.2 工具防护

9.2.1 工具启用控制

9.2.2 敏感操作确认

9.3 文件访问控制

9.3.1 目录限制

9.3.2 路径穿越防护

9.4 技能安全扫描

9.4.1 扫描内容

9.4.2 处理方式

十、最佳实践

10.1 人设设计建议

10.1.1 AGENTS.md 设计

10.1.2 SOUL.md 设计