by 安全扫描
OpenClaw
安全
high confidence该技能的说明、要求和安装指南与使用 Membrane CLI 的 KiotViet 集成保持一致；所请求的内容与该目的相称。
评估建议
该技能逻辑一致：它引导你使用官方 Membrane CLI 连接 KiotViet，且不会索要 API key。安装前，请验证 @membranehq/cli 包源（如不想全局安装，可用 npx），确认你信任 getmembrane.com/github 仓库，并准备好完成浏览器登录流程。切勿在聊天中粘贴机密；技能由 Membrane 在服务端管理凭据。如需更严格管控，建议用 npx 本地运行 CLI，而非全局 npm install。...详细分析 ▾
✓ 用途与能力
名称/描述表明这是 KiotViet 集成，SKILL.md 始终指示使用 Membrane CLI 连接 'kiotviet' 连接器、发现并执行操作，未请求无关凭据、二进制文件或系统访问。
✓ 指令范围
运行时指令仅限于安装/使用 Membrane CLI、登录、创建/连接连接、列出并运行操作、轮询操作构建状态。文档明确禁止向用户索要 API 密钥，也不允许读取任意系统文件或无关的环境变量。
ℹ 安装机制
该技能仅提供指令（无安装规范）。它建议通过 npm -g 安装 @membranehq/cli 或使用 npx。推荐全局安装 npm CLI 属常规做法，但需承担运行第三方 npm 包带来的信任风险；对于所述工作流程，这是可预期的。
✓ 凭证需求
该 skill 未声明任何必需的环境变量或凭据，说明依赖 Membrane 在服务端完成认证，符合既定目标；没有无关的 secret/token 请求。
✓ 持久化与权限
该技能不要求常驻，也不包含修改其他技能或系统级配置的指令。平台默认允许智能体自主调用，但该技能本身不会提升持久化或权限。
安全有层次，运行前请审查代码。
运行时依赖
无特殊依赖
版本
latestv1.0.02026/4/23
从 membranedev/application-skills 自动同步
● 无害
安装命令
点击复制官方npx clawhub@latest install kiotviet
镜像加速npx clawhub@latest install kiotviet --registry https://cn.longxiaskill.com
技能文档
KiotViet 是一个数据管理平台。使用可用操作探索其全部功能。 官方文档：https://open.kiotviet.vn/
KiotViet 概览
- Records — KiotViet 中的核心数据
- 操作：创建、读取、更新、删除、列出
使用 KiotViet
本技能通过 Membrane CLI 与 KiotViet 交互。Membrane 自动处理身份验证与凭证刷新——你只需关注集成逻辑，无需操心认证细节。安装 CLI
安装 Membrane CLI，以便在终端运行membrane：
``bash
npm install -g @membranehq/cli@latest
` 认证
`bash
membrane login --tenant --clientName=
`
根据是否支持交互模式，命令会打开浏览器或打印授权 URL。 无头环境： 命令将打印授权 URL。请用户用浏览器打开，登录后获得代码，再执行：
`bash
membrane login complete
`
任何命令后加 --json 可输出机器可读 JSON。
Agent 类型：claude、openclaw、codex、warp、windsurf 等，用于最佳适配你的运行环境。
连接 KiotViet
连接 KiotViet
使用 connection connect 创建新连接：
`bash
membrane connect --connectorKey kiotviet
`
用户在浏览器完成认证，输出包含新连接 id。 列出已有连接
`bash
membrane connection list --json
` 搜索操作
用自然语言描述需求来搜索操作：
`bash
membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json
`
务必在特定连接上下文中搜索。每个结果包含 id、name、description、inputSchema、outputSchema。 常用操作
用以下命令发现可用操作：
`bash
npx @membranehq/cli@latest action list --intent=QUERY --connectionId=CONNECTION_ID --json
` 创建操作（若无现成）
若无合适操作，描述需求，Membrane 将自动构建：
`bash
membrane action create "DESCRIPTION" --connectionId=CONNECTION_ID --json
`
操作初始状态为 BUILDING，轮询直至就绪：
`bash
membrane action get --wait --json
`
--wait 最长轮询 --timeout 秒（默认 30），直到状态变化。
— 构建完成，可运行。
或 SETUP_FAILED — 出错，查看 error 字段。
运行操作
`bash
membrane action run --connectionId=CONNECTION_ID --json
`
传递 JSON 参数：
`bash
membrane action run --connectionId=CONNECTION_ID --input '{"key": "value"}' --json
`
结果在响应的 output 字段中。 最佳实践
- 优先用 Membrane 与外部应用通信 — Membrane 提供预置操作，内置认证、分页与错误处理，省 token 且更安全。
先发现再构建 — 运行 membrane action list --intent=QUERY` 找现成操作，避免手写 API 调用。预置操作已处理分页、字段映射及边界情况。 - 让 Membrane 管理凭证 — 绝不向用户索要 API key 或 token。创建连接即可，Membrane 在服务端全程托管认证生命周期，本地无秘密。