mcpField
H
huawei-cloud-openviking-agent-integration

huawei-cloud-openviking-agent-integration

github.com/huaweicloudAgent 工作流5916.2k 次安装2 天前更新
代码仓库

关于 huawei-cloud-openviking-agent-integration

此 Agent skill 用于在 bwrap 沙箱中的编码 Agent 与 OpenViking 长期记忆之间集成、解绑和验证。它通过各 Agent 原生配置机制注入设置，并将配置持久化到模板，以便沙箱重启后保留。

主要功能

  1. 01集成或解绑 8 种 Agent
  2. 02检查集成状态并验证 MCP
  3. 03支持预演与批量操作
  4. 04配置写入模板以跨重启保留
  5. 05备份配置并保护 API 密钥

适用场景

  1. 01为编码 Agent 接入 OpenViking 长期记忆
  2. 02重启沙箱后保留集成配置
  3. 03排查 MCP 握手或服务健康问题

MCP 相关

该 skill 为支持 MCP 的 Agent 配置 OpenViking，并提供 MCP 握手验证。不同 Agent 也可通过原生插件或 HTTP 记忆提供方接入。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/huaweicloud/huaweicloud-skills --skill huawei-cloud-openviking-agent-integration

安装后在 Claude Code 中输入/huawei-cloud-openviking-agent-integration确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

.skillspectorignore
references/
agent-configs.md
notes.md
scripts/
integrate.sh
scripts/agents/
codearts.sh
deepseek_harness.sh
hermes.sh
kimicode.sh
openclaw.sh
opencode.sh
prime_agent.sh
workswarm.sh
scripts/lib/
base.sh
entrypoint.sh
json.sh
ov_jw_mutate.py
ov_kimi_hook.sh
plugins.sh
registry.sh
ui.sh
scripts/py/
ov_common.py
ov_health.py
scripts/py/agents/
ov_codearts.py
ov_deepseek_harness.py
ov_hermes.py
ov_kimicode.py
ov_openclaw.py
ov_opencode.py
ov_prime_agent.py
ov_workswarm.py

详细介绍

华为云 Agent 集成（OpenViking 长期记忆）

为运行在 bwrap 沙箱（/root/job-envs/sandboxes/）中的编码 Agent 集成或解绑 OpenViking 长期记忆。每个 Agent 都使用其原生机制（MCP、HTTP 记忆提供程序、TS 扩展钩子、settings.json），因此集成在 Agent 升级后仍然有效。写入配置会持久保存在模板级别：配置注入到 /root/template/<agent>/start.sh，因此沙箱 stop + start 后集成仍会保留。

支持的 Agent

Agent机制
CodeArts CLI@openviking/opencode-plugin → .codeartsdoer/
OpenCode@openviking/opencode-plugin（npm 镜像 → GitHub 回退）
OpenClawclawhub:@openviking/openclaw-plugin + contextEngine 插槽（禁用 session-memory 钩子，拒绝 memory_search）
Hermes内置 memory.provider: openviking（HTTP REST，无 MCP）
WorkSwarm双通道：原生提供程序 + MCP（15 个工具）+ code-mode 补丁
KimiCode钩子 + MCP（会话生命周期）— config.toml [[hooks]] → ov-kimi-hook.sh + 通过 mcp.json 配置 MCP
DeepSeek Harness@openviking/dsh-memory-plugin 包（按需从 GitHub 获取）
Prime Agent@openviking/pi-coding-agent-extension（按需从 GitHub 获取）

各 Agent 的配置路径和详情：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 沙箱操作。

参数 (Parameters)

标志必需含义
--agent <name>是（除非指定 --all）目标 Agent
--all是（除非指定 --agent）对全部 8 个 Agent 执行操作
--endpoint <url>否OpenViking URL（默认 http://127.0.0.1:1933）
--api-key <key>否用于启用身份验证的服务。绝不能在聊天中回显。必须由 Agent 配置或 verify_mcp.sh 使用；未被使用的 --api-key 会作为警告报告。
--dry-run否显示变更但不应用
--yes / -y否跳过确认（仅用于自动化）
--json否status.sh：输出机器可读内容

核心命令

功能命令
查看状态scripts/status.sh（--json / --agent <name>）
验证 MCPscripts/verify_mcp.sh
集成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          # per-agent: template+live / template only / live only / none
$SKILL_DIR/scripts/verify_mcp.sh      # full MCP handshake (initialize → tools/list → health)
$SKILL_DIR/scripts/integrate.sh --agent <name> [--yes]
$SKILL_DIR/scripts/unbind.sh  --agent <name> [--yes]
  1. 先检查状态 — 在 status.sh 确认之前，绝不能声称已集成（不得捏造状态）。
  2. 验证 MCP — 集成前运行 verify_mcp.sh。
  3. 集成 / 解绑 — 每项操作都需要明确的 confirm（或 --yes）；--dry-run 可安全预览变更。
  4. 状态：template + live = 已启用；template only = 重启后启用；live only = 重启后丢失（提醒用户）。

授权与安全

  • integrate.sh / unbind.sh 需要明确确认；绝不能直接编辑 Agent 配置 — 应通过技能脚本操作。
  • 每次修改配置都会创建 .bak.<timestamp>（保留 5 个），以便回滚。
  • --api-key 的值绝不能出现在输出中。

能力边界（Cannot Do）

本技能只做"OpenViking 记忆 ↔ 编码 agent 的集成/解绑/状态/验证"。以下操作明确不做，遇到请改走对应路径或明确报错：

  • 不直接读写 agent 配置文件、sandbox 内业务数据或用户代码——一律通过 scripts/integrate.sh / unbind.sh 等入口执行。
  • 不删除、不修改用户自装的第三方包/目录/数据。卸载只清理 OpenViking 自身产物（@openviking/* 插件、注入的配置段、OV 专属目录）；node_modules 整目录删除等越界行为是缺陷，不执行。
  • 服务器不可达/健康检查失败时不报告成功：integrate.sh、unbind.sh、verify_mcp.sh 均先做健康门禁，失败即失败（exit 非 0），绝不假成功。
  • --dry-run 只预览改动，不写任何持久文件；预览后续真实执行仍需确认。
  • --api-key 必须被某个 agent 配置或验证流程实际消费；若传入却无处消费，脚本会告警（而非静默忽略）。
  • 不做 embedding 模型切换、向量库重建、服务器自身配置变更——那是 huawei-cloud-openviking-embedding-switch 等技能的范围。
  • 不支持在集成/解绑过程中创建或修改 OpenViking 账号、用户、权限体系。
  • 不承诺"查看 → 已集成"：一律以 status.sh 实测结果为准，禁止凭模板猜测 live 状态。

References

DocumentWhen to read
agent-configs.mdPer-agent config paths/formats, MCP tools, server info
notes.mdGuardrails, env vars, sandbox restart, plugin sources, troubleshooting, adding a new agent

评论

支持 Markdown