# 企业知识助手安装说明（供安装智能体执行）

服务：https://aily.xinzhibang168.com
发布版本：0.4.9。用户应先明确要接入 Codex 还是 OpenClaw。

请在目标智能体的实际运行环境安装，仅处理企业知识助手自身配置，保留用户其他插件及配置。OpenClaw 在 WSL、Linux、容器或远程主机时，安装在那个实例的运行用户和主机中，不能装到用户浏览器所在电脑来代替。

1. 确认当前操作系统、运行用户、实际工作区、宿主 CLI 路径及 Node.js 22+ 路径。Codex 桌面优先使用 load_workspace_dependencies 返回的自带 Node；OpenClaw 使用其运行时 Node。不要要求普通员工装 Python、编辑配置或复制令牌。没有可用运行时或没有该实例安装权限时，请给出具体缺少条件，不宣称安装成功。
2. 从 https://aily.xinzhibang168.com/downloads/0.4.9/manifest.json 和 https://aily.xinzhibang168.com/downloads/0.4.9/install.mjs 下载到该用户的临时工作目录。校验 install.mjs 的 SHA-256 与 manifest.files['install.mjs'] 一致，审阅脚本后使用步骤 1 的 Node 执行。
3. 调用参数为 --agent codex 或 --agent openclaw，并传 --workspace 加实际工作区。宿主可执行程序不在 PATH 时传 --host-command 加实际可执行文件；宿主是 JavaScript CLI 时用 --host-entry 加 CLI 的实际入口文件，由同一个 Node 执行。安装器支持 Windows、macOS 和 Linux；Windows 的 codex.cmd/codex.bat 会由安装器通过系统命令解释器调用，不需要员工手动改扩展名。
4. OpenClaw 还必须传 --owner-session 加当前可信所有者会话的实际 session key。不得猜测、通配、取消身份检查或把群聊其他发送者加入授权。当前发布支持配置的所有者会话；多人共用的聊天渠道尚不支持使用安装者身份。
5. 安装脚本创建本用户私有目录 ~/.enterprise-knowledge，自动下载并校验插件组件、设置宿主原生插件和独立离线队列。输出配对链接和配对码。只向用户展示该链接和配对码，让其在网页用公司飞书账号登录、核对设备、选择已有权限的项目。凭据留在本机，不读出、不粘贴到对话、不包含在分享链接里。
6. Codex 安装后在新任务验证工具；非托管钩子按宿主提示由用户审阅和信任，不绕过宿主安全提示。OpenClaw 在配置完成后重启这个实例的 Gateway，然后验证实际工具；不要重启其他实例或系统 Docker 服务。
7. 用一条明确提到知识库的消息，按 knowledge_sync_status、knowledge_search、knowledge_get 的顺序验证 connected、正确项目及 authority=database；同时用一条不含知识库内容的普通消息确认不会注入知识库提示。检索只在用户明确提出知识库需求或点名企业知识助手技能时发生；只有用户明确要求保存到企业知识库或上报知识时，才提交本次指定的已验证内容；不在任务或回复结束时自动上报，也不反复询问是否上报。返回 pending 表示待入库，不能代替员工在网页采纳。
8. 上报时由智能体先从对话中提炼，再整理成规范条目（标题写结论，正文含适用场景、关键要点或步骤、适用边界、验证结果），并用 kind 标注 organization、business 或 project（默认 project）。只上报与组织、业务或项目记忆相关且属于认知或方法论层面的内容。服务端会做前置去重：完全重复返回 duplicate 且不新建条目；相似或疑似冲突仍进入待入库区，并带 related 供审核人核对。

如发现已有旧版企业知识助手，先保留旧配置、设备凭据及队列。完成新插件连接和真实读取后，禁用旧版本，避免两套任务结束钩子重复执行；不删除未完成队列，也不终止其他正在进行的智能体任务。安装遇到宿主策略拒绝时保留错误，使用该宿主提供的正式处理流程，不能添加绕过策略的参数。

当前现场验收目标是 Windows Codex 和本机 Ubuntu OpenClaw。其他系统使用同一无 Python 客户端设计，但在实际环境完成上述检查后才能宣称该设备接入成功。后台重试仅在 MCP 或 OpenClaw 进程运行期间执行，智能体关闭时保留队列，重新运行后继续重试。