用途：为运行在 bwrap 沙箱（/root/job-envs/sandboxes/）中的编码智能体集成或解绑 OpenViking 长期记忆。每个智能体使用其原生机制（MCP、HTTP memory provider、TS 扩展钩子、settings.json），因此集成可跨智能体升级保留；配置注入 /root/template/<agent>/start.sh，沙箱停止再启动后集成仍有效。
支持的智能体与机制：CodeArts CLI 用 @openviking/opencode-plugin 写入 .codeartsdoer/；OpenCode 用 @openviking/opencode-plugin（npm 镜像，失败回退 GitHub）；OpenClaw 用 clawhub:@openviking/openclaw-plugin 加 contextEngine 槽位（禁用 session-memory 钩子、拒绝 memory_search）；Hermes 用内置 memory.provider: openviking（HTTP REST，无 MCP）；WorkSwarm 双通道：原生 provider + MCP（15 个工具）+ code-mode 补丁；KimiCode 用 hooks + MCP（会话生命周期），config.toml [[hooks]] → ov-kimi-hook.sh，MCP 经 mcp.json；DeepSeek Harness 用 @openviking/dsh-memory-plugin 包（按需从 GitHub 获取）；Prime Agent 用 @openviking/pi-coding-agent-extension（按需从 GitHub 获取）。各智能体配置路径见 references/agent-configs.md。
前提条件：OpenViking 服务健康，curl -s http://127.0.0.1:1933/health 返回 healthy；目标沙箱存在于 /root/job-envs/sandboxes/；主机需 curl、python3、bash，OpenCode/OpenClaw 需 npm，verify_mcp.sh 需 pip install --upgrade "mcp>=2.0"；无需华为云 IAM，仅操作本地 bwrap 沙箱。
参数：--agent <name> 指定目标智能体（与 --all 二选一）；--all 操作全部 8 个智能体；--endpoint <url> 指定 OpenViking 地址（默认 http://127.0.0.1:1933）；--api-key <key> 用于鉴权模式服务，不得在对话中回显，必须被某智能体配置或 verify_mcp.sh 实际消费，否则告警；--dry-run 仅预览不应用；--yes/-y 跳过确认（仅自动化用）；--json 让 status.sh 输出机器可读结果。
核心命令：scripts/status.sh（--json / --agent <name>）查看状态；scripts/verify_mcp.sh 验证 MCP；scripts/integrate.sh --agent <name> [--endpoint URL] [--dry-run] [--yes]（或 --all）集成；scripts/unbind.sh --agent <name> [--dry-run] [--yes]（或 --all）解绑。
工作流：先设 SKILL_DIR=/root/.agents/skills/huawei-cloud-openviking-agent-integration，运行 $SKILL_DIR/scripts/status.sh 查看每个智能体状态（template+live / 仅 template / 仅 live / 无），再运行 $SKILL_DIR/scripts/verify_mcp.sh 做完整 MCP 握手（initialize → tools/list → health），然后执行 integrate.sh 或 unbind.sh。状态须以 status.sh 实测为准，不得凭模板猜测 live 状态。状态含义：template + live 为生效；仅 template 表示重启后生效；仅 live 表示重启后丢失（需提醒用户）。
授权与安全：integrate.sh / unbind.sh 需显式确认；不得直接编辑智能体配置，须经技能脚本；每次配置修改生成 .bak.<timestamp>（保留 5 个）用于回滚；--api-key 值不得出现在输出中。
能力边界：本技能只做 OpenViking 记忆与编码智能体的集成、解绑、状态与验证。不直接读写智能体配置文件、沙箱内业务数据或用户代码；不删除或修改用户自装的第三方包、目录、数据，卸载只清理 OpenViking 自身产物（@openviking/* 插件、注入的配置段、OV 专属目录）；服务器不可达或健康检查失败时不报告成功，脚本先做健康门禁，失败即非 0 退出；--dry-run 只预览不写持久文件；不做 embedding 模型切换、向量库重建、服务器自身配置变更（属 huawei-cloud-openviking-embedding-switch 等技能范围）；不支持在集成/解绑过程中创建或修改 OpenViking 账号、用户、权限体系。