本指南用于说明本项目如何以 Noise宝藏阁 名称对外接入，以及当前项目中 OpenClaw 外接模式 与 iLink 内置直连微信模式 的区别、能力范围和使用方式。
1. 对外能力概览
对话接口：
/api/v1/chat/completions（OpenAI 兼容接口，推荐）嵌入脚本：
/super-agent-embed.js动作控制接口：
/api/admin/agent/control可选扩展能力：流程自动化、RSS/Web 检索、改写草稿、智能封面生成
2. 前台嵌入接入（外站）
在外站页面引入：
<script src="https://www.noisevip.cn/super-agent-embed.js"></script>
<script>
window.VipSuperAgent.init({
apiBase: "https://www.noisevip.cn",
title: "Noise宝藏阁",
subtitle: "跟你的龙虾聊",
compactHeader: true,
primaryColor: "#f97316",
anchorSelector: ".scroll-top-btn"
});
</script>
如需第三方 AI 覆盖，可在 init 中传入 apiService/apiToken/apiBaseUrl/apiModel。
3. OpenClaw 对接方式
当前项目支持两种和微信智能体相关的接入方式：
OpenClaw 外接模式：在本地或服务器安装 OpenClaw / Tencent OpenClaw CLI，然后把本项目作为 OpenAI 兼容后端接入。
iLink 内置直连模式：直接在本项目后台扫码接入微信官方插件，无需额外安装外部 CLI。
需要特别说明：
当前项目没有内置
https://github.com/openclaw/openclaw仓库本体。当前项目提供的是 OpenClaw 兼容能力，也就是可作为 OpenClaw 的上游 AI 服务被调用。
同时，项目还实现了 iLink 直连微信 的内置能力，用于替代单独部署扫码桥接程序。
3.1 OpenAI 兼容接口接入（推荐）
Noise宝藏阁提供了标准的 OpenAI 兼容接口，可供 OpenClaw 或其他通用 AI 客户端调用。
接口地址 (Base URL):
https://你的域名/api/v1接口完整地址:
https://你的域名/api/v1/chat/completions模型名称 (Model):
super-agentAPI 密钥 (API Key): 使用后台"智能体控制"页配置的 Webhook Secret
接入步骤：
在运行 OpenClaw 的设备执行：
npx -y @tencent-weixin/openclaw-weixin-cli@latest install按照提示选择 OpenAI 模式，并填入上述参数。
接入成功后，即可在微信中直接与 Noise宝藏阁智能体对话。
适用场景：
你已经在使用 OpenClaw 或 Tencent OpenClaw CLI
你希望继续使用 OpenClaw 自己的多平台路由、守护进程与生态能力
你只需要本项目提供大模型对话、知识检索和动作执行能力
3.2 HTTP 工具型接入
将 OpenClaw 的工具调用指向：
搜索改写草稿封面一条龙：
POST /api/admin/agent/control示例 action：
article.search_rewrite_cover_draft
请求体示例：
{
"action": "article.search_rewrite_cover_draft",
"payload": {
"keyword": "即梦 prompt 优化",
"webUrls": ["https://example.com/news"],
"rssUrls": ["https://example.com/feed.xml"]
}
}
3.3 嵌入对话型接入
在 OpenClaw 的自定义前端容器中嵌入 super-agent-embed.js，并将 apiBase 指向本服务域名。
3.4 iLink 内置直连微信模式
项目后台已提供“微信官方插件扫码接入 (iLink)”面板。该模式下：
无需额外安装 OpenClaw 仓库本体
无需单独运行外部扫码桥接 CLI
由本项目自己完成二维码获取、扫码状态轮询、凭据保存和消息轮询
接入流程：
打开后台“智能体控制”页面
在“微信官方插件扫码接入 (iLink)”面板点击获取二维码
用微信扫码并在微信侧确认授权
系统保存
bot_token、bot_id、baseUrl、userId后台自动启动消息轮询
此后微信消息会直接进入本站智能体处理链路
该模式与 OpenClaw 的关系：
不是把 OpenClaw 主项目内置到本站
而是使用微信官方 iLink 通道，直接把微信消息接入本站智能体
换句话说，OpenClaw 外接模式和 iLink 内置直连模式是两条不同的接入路径
4. 扫码连接后可以做什么
无论是 OpenClaw 外接模式，还是 iLink 内置直连模式，只要最终成功把微信消息送入本项目智能体，当前项目可以提供的能力主要包括：
微信内直接提问，得到 Noise宝藏阁智能体回复
调用站内知识与内容能力进行问答
触发 RSS / Web / 联合检索相关能力
结合热点、信息源与站内内容进行整理、总结、改写
触发部分自动化流程与内容生产链路
在 iLink 内置直连模式 下，当前代码已实现的核心能力是：
接收微信文本消息
将文本消息转交给本站
Super Agent核心处理获取智能体回答
将回答再通过 iLink 发回微信
也就是说，扫码成功后，微信会成为本项目智能体的一个真实聊天入口。
当前边界说明：
当前实现重点是 文本消息收发
已具备接入本站智能体能力，但还不是对
openclaw/openclaw全量功能的完整复刻如果你需要 OpenClaw 的完整多平台控制平面、守护进程、更多渠道生态，则仍建议单独部署 OpenClaw
5. 动作能力清单（可授权）
当前已支持关键动作：
article.cover.generatearticle.search_rewrite_cover_draftarticle.import_rewrite_publishautomation.scheduler.run
权限建议：
admin：全部动作editor：允许内容生成与流程触发author：仅允许草稿链路，不允许直接发布
6. 一条龙流程示例
目标链路：
搜索热点与关键词信息（站内/Web/RSS）
评分筛选高质量素材
生成“即梦 prompt 优化 + 总结建议 + 改写稿”
写入草稿箱
按标题自动生成封面
返回提醒信息
该链路已可通过 article.search_rewrite_cover_draft 执行。
7. 运营可观测建议
建议在 /admin/rss-intel 管理：
RSS 源维护与连通性测试
执行日志看板
质量门控阈值
重试策略参数
建议启用：
ai.agentControl.pipeline.stageGateEnabledai.agentControl.pipeline.autoRetryEnabled
8. 安全建议
对外接口建议开启鉴权与角色限制
对动作类能力限制匿名访问
对第三方 AI Token 使用服务端存储，避免前端明文暴露
