Commit Graph

20 Commits

Author SHA1 Message Date
42b5e022e1 feat: AGENT_NAME 占位符 + Step 6.2 自动获取 QQ 昵称
- AGENTS.md/SOUL.md/IDENTITY.md 中 'the Real' → AGENT_NAME 占位符
- Step 6.2 新增 NapCat /get_login_info 接口自动获取登录 QQ 昵称
- 获取失败时回退到 ADMIN_NAME
- sed 替换新增 AGENT_NAME 占位符替换
- config/agent-templates/README.md 同步更新
2026-05-04 20:32:24 +08:00
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
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
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
16c694e1ec 更新 README.md 2025-08-14 08:00:02 +00:00
65a6960302 Initial commit 2025-08-14 07:58:07 +00:00