f98293d4e8
refactor: 将 agent 角色模板移到 config/agent-templates/，在 Step 6 集成部署
...
- 移除了顶层 agent-templates/ 目录
- 角色模板移到 config/agent-templates/，属于 agent 配置范畴
- Step 6 新增 6.2 子步：复制角色模板 + 替换占位符
- Step 7.4 验证也覆盖角色模板的占位符
- config/agent-templates/README.md 更新为引用 Step 6.2
2026-05-04 20:28:27 +08:00
fdd5b55a82
feat: 添加 QQ-agent 角色文件模板（脱敏版）
...
- agent-templates/: AGENTS.md, SOUL.md, IDENTITY.md, USER.md, TOOLS.md, HEARTBEAT.md
- 所有个人标识已替换为占位符（ADMIN_QQ, ADMIN_NAME, AGENT_WORKSPACE）
- 配 README 说明替换方法和安全注意事项
2026-05-04 20:16:10 +08:00
3341ac9f80
docs: 新增 Step 8 重启 Gateway 前的顺序警告
...
⚠️ 提醒 agent 必须先完成前 7 步再重启，否则 Gateway 重启会打断安装过程。
2026-05-04 20:08:22 +08:00
3b3ad882a4
fix: 变量持久化 heredoc 改用无引号模式
...
致命 Bug：Step 1.1 的 cat > /tmp/env_vars.sh 使用 << 'VFEOF'
（单引号 heredoc），导致 ${VARIABLE} 全部写为字面量。
后续 source 后所有变量为空字符串。
修复：<< VFEOF → << EOF（无引号），bash 在写入时即展开
变量值为实际字符串（如 'qq-agent' 而非文字 '${NEW_AGENT_ID}'）。
2026-05-04 20:02:46 +08:00
7534552d75
chore: 清理遗留的凭据提示注释残留
2026-05-04 20:01:09 +08:00
428aaea900
fix: 移除 HTTPS clone/wget 的凭据警告
...
jianfgit.xyz 的 HTTPS URL 无需认证即可读取（只读），
git clone 和 wget 下载 qqrebot 均正常通过。
移除 README 中多余的请用户提供凭据提示。
2026-05-04 20:00:55 +08:00
df6a812520
refactor: README 重构为 agent 全自动执行流程
...
解决 5 个自主部署阻塞问题：
1. 🧩 步骤重排 — clone 仓库提前到新 Step 3（原 Step 6.1）
确保 Step 5（打包插件）有源码可用
2. 🔄 变量持久化 — 用 /tmp/env_vars.sh 替代 export
每个 bash 代码块首行加 source，跨 exec 调用变量不丢失
3. 🛠 前置依赖自动检测 — 检查 git/wget/docker/python3-venv
缺失即提示安装，防止脚本跑到一半报错
4. 👷 扫码登录人工介入协议 — 明确标注无法由 AI agent 自动完成
agent 知悉：此处需暂停并请用户操作，确认后再继续
5. 🔑 私有仓库凭据提示 — git clone 和 wget 均标注需 SSH/HTTP 凭据
失败时 agent 应引导用户手动操作
2026-05-04 19:59:41 +08:00
90643348b1
fix: 补充修复 heredoc 单引号和 venv 强制要求
...
- Bug4: heredoc 单引号 'ONEBOTEOF' → ONEBOTEOF
让 ${QQREBOT_HOST} 被 bash 自动展开，无需手动替换
同时更新了 README 中的说明文字
- Bug10: 添加 venv 创建步骤到打包环节
严禁 --break-system-packages
自动检测并 apt install python3-venv 兜底
2026-05-04 19:54:03 +08:00
9dff73e7bc
fix: 通过本地完整测试发现的 11 个 bug
...
🔴 致命（5个）:
- Bug1: onebot11.json 格式错误（旧 {http:{},ws:{}} → network.httpServers/httppClients）
- Bug2: 端口映射错位（WebUI 6099, OneBot API 6097 独立端口）
- Bug3: 变量名含空格 NAP CAT_HOST → NAPCAT_HOST（14脚本+2SKILL+README）
- Bug4: heredoc 单引号阻止变量展开
- Bug5: process.py 缺失 _get_high_risk_words() 方法
🟡 重要（3个）:
- Bug6: onebot11.json 默认不存在（cat > 而非 edit）
- Bug7: API 须登录后才响应（新增扫码引导步骤）
- Bug8: qqrebot systemd 依赖 napcat 服务
🟢 中等（3个）:
- Bug9: Skills 占位符缺 YOUR_NAPCAT_HOST sed 覆盖
- Bug10: venv 不可用需降级方案
- Bug11: 端口 25580 冲突处理
已验证全链路：NapCat + qqrebot + 插件 + OpenClaw Gateway + AI 回复
2026-05-04 19:47:26 +08:00
79ea8175c4
fix: 修复文件发送容器路径 /app/files→/app/napcat/share + Skills补充共享目录替换
...
源码修正：
- qq_send_file.py#101: file_uri 路径 /app/files → /app/napcat/share (Docker volume真实挂载点)
- qq_ocr_image.py#10,47: 注释+CONTAINER_FILES常量同步修正
- qq-napcat-extras/SKILL.md#12 : 跨主机传递图同步修正
- qq-messenger/SKILL.md#102 : 注意事项容器路径同步修正
README 更新：
- 6.4 Skills替换新增 sed -i YOUR_SHARED_DIR（之前漏了）
- 新增全链路路径转换示意图（agent工作区→共享目录→容器内→NapCat API→QQ）
- 新增手动测试命令：复制文件→qq_send_file.py→确认管理员收到
- 变量速查表 YOUR_SHARED_DIR 添加 SKILL.md 出现位置
2026-05-04 19:25:00 +08:00
070e48790c
docs: Step 1改为自动推导，仅向用户索要两个必填项
...
- 移除NAPCAT_HOST/QQREBOT_HOST/NEW_AGENT_ID/SHARED_DIR 的询问
- 全部使用默认值：qq-agent, 127.0.0.1, 172.17.0.1:25580, /opt/napcat_shared
- GATEWAY_TOKEN 自动从 ~/.openclaw/openclaw.json 读取
- 仅保留 ADMIN_QQ 和（自动读取失败时的）GATEWAY_TOKEN 两个询问项
- 跨机部署场景留注释说明
2026-05-04 19:14:26 +08:00
0efe9970f5
docs: 补充脚本部署细节，明确clone路径和占位符验证
...
- Step 6 拆分为6.1-6.5子步骤
- 6.1 新增：在目标服务器上克隆仓库（git clone + 拷贝两种方式说明）
- 6.2 新增：完整脚本清单表（26个脚本分5组，含用途说明）
- 6.3 新增：Skills引用说明（YOUR_WORKSPACE_PATH/scripts/ 路径映射关系）
- 6.4 拆分脚本替换和Skills替换为两个独立代码块
- 6.5 新增：完整性验证命令（数量检查 + 占位符残留检查）
2026-05-04 19:09:18 +08:00
5a69db8af9
fix: 修正NapCat通信架构说明（纯HTTP，非WebSocket）
...
- 移除所有WebSocket/3001端口的错误引用
- NapCat→qqrebot 使用 httpPost 数组配置HTTP POST事件推送
- onebot11.json 配置修正：httpPost而非WS Server模式
- 架构图标注所有链路为HTTP POST，标注各端口用途
- 增加 QQREBOT_HOST 变量说明Docker网关地址(172.17.0.1)
- 端口映射表标清 6099 必开 / 3001免费 / 9000按需
- send_url 指向 NapCat :6099
2026-05-04 19:06:15 +08:00
2dbe121446
docs: 增加NapCat Docker部署 + 脚本适配说明
...
- NapCat Docker 部署：目录创建、容器启动、首次扫码登录、OneBot配置
- 端口映射表：6099(HTTP) / 3001(WS) / 9000(WebUI)
- 脚本适配说明表：NapCat vs go-cqhttp 差异、文件发送适配、变量速查
- 前提条件改为 NapCat 由本仓库部署
- 架构图标注端口号
2026-05-04 18:59:02 +08:00
48e836e697
docs: 重写为AI agent可执行的完整部署指南
...
- 架构拓扑 + 前提条件清单（NapCat假设已运行）
- 7步部署流程：询问用户信息 → qqrebot → 插件 → 创建agent → 脚本/skills → 重启 → 验证
- 安全模块详细说明（高危词/白名单/消息过滤/上报/脱敏）
- 所有配置用占位符，无任何个人信息
- 明确指示部署agent向用户询问必填参数
2026-05-04 18:56:40 +08:00
de17beacf6
fix: 修正仓库链接（github占位符 → jianfgit正确地址）
2026-05-04 18:50:04 +08:00
e1fbd31c64
完整 AgentSkill：词库外部化 + 全部脚本/Skill 脱敏上传
...
- 高危词库从 process.py 抽到 config.toml [security] section
- process.py 改为 _get_high_risk_words() 动态加载（配置优先）
- 新增 15 个 QQ 操作脚本（已脱敏：QQ号/IP/Token → 占位符）
- 新增 8 个 SKILL.md（qq-messenger/management/resolver/napcat-extras 等）
- 新增 SKILL.md 入口（完整部署方案文档）
- 保留 SDK 框架（plugin_modules.py, file_store_api.py, package.py 等）
2026-05-04 16:23:59 +08:00
d7d33c39a4
清除个人信息和敏感令牌
...
- test.py: 2198972886 → your_admin_qq
- README.md: jianf/qqrebot 链接 → 通用描述
- README.md: 示例配置 2198972886 → your_admin_qq
2026-05-04 16:15:26 +08:00
8c4c5074f2
重构为 openclaw_bridge 模板插件
...
- 将 process.py 替换为 OpenClaw Gateway QQ AI Reply 插件
- 新增 config/openclawbridge/config.toml（SDK 标准路径）
- 遵循 SDK 官方配置方式，移除硬编码默认值
- 内置高危词检测、管理员白名单、MC指令过滤
- 完善的 README.md 文档（使用说明+架构图+安全特性）
- packup.sh 增加『必须在目标主机打包』警告
- 保留 SDK 框架文件（plugin_modules.py, file_store_api.py 等）
- 更新 test.py 适配 openclaw_bridge 测试
注意：打包必须在目标主机执行，避免 C 扩展兼容性问题
2026-05-04 16:14:42 +08:00
b88e868160
modified: src/process.py
2026-01-21 22:56:09 +08:00
0e9bf54d1f
modified: src/process.py
2026-01-21 22:50:07 +08:00
f15fac8b14
修复递归导致的栈溢出
2026-01-21 22:43:23 +08:00
85ca0e7589
new file: dependence.py
...
new file: package.py
new file: packup.bat
new file: packup.sh
new file: requirements.txt
new file: scripts/__init__.py
new file: scripts/file_store_api.py
new file: src/__init__.py
new file: src/config.toml
new file: src/modules/__init__.py
new file: src/modules/plugin_modules.py
new file: src/modules/user_module.py
new file: src/process.py
new file: test.py
2025-08-14 16:01:37 +08:00
16c694e1ec
更新 README.md
2025-08-14 08:00:02 +00:00
65a6960302
Initial commit
2025-08-14 07:58:07 +00:00
