# @agentapprove/openclaw 中文文档

规范地址：https://npmcn.com/package/%40agentapprove/openclaw/

版本：0\.2\.17
npm 元数据更新时间：2026-08-31T02:10:19.580Z
中文译文更新时间：2026-11-06T08:22:54.659Z
软件包许可：SEE LICENSE IN LICENSE

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40agentapprove/openclaw
原文对照：https://npmcn.com/package/%40agentapprove/openclaw/?lang=original
项目主页：https://www.agentapprove.com/

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：78.7 kB，5 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-02-25T08:53:30.048Z
- 最新版本发布：2026-08-31T02:10:19.399Z
- 近 30 天下载量：3879（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：26（近 12 个月 26 个）

## 中文简介

代理批准 OpenClaw 插件 - 批准或拒绝您的 iPhone 和 Apple Watch 的 AI 代理工具呼叫

## 安装

```sh
npm install @agentapprove/openclaw
```

也可以使用：`pnpm add @agentapprove/openclaw`、`yarn add @agentapprove/openclaw`、`bun add @agentapprove/openclaw`

## README

# @ agentapprove/ openclaw (英语)

[代理核准](https://agentapprove.com/) 用于 [打开Claw](https://openclaw.ai/). 批准或拒绝您的iPhone和Apple Watch的AI代理工具呼叫.

## 为什么代理批准?

-   **可见度** - 看看你的OpenClaw代理从移动设备中实时做什么
-   **集中政策** -- 定义您的默认位置( 允许、 拒绝或询问) 并管理工具、 参数和命令的自定义允许列表和拒绝列表
-   **移动核准** - 当需要人类批准时, 由您的 iPhone 或 Apple Watch 以水龙头审查并回复

规矩由你决定 代理批准执行它们.

## 重要

-   使用此插件需要有效的代理批准订阅 .
-   您必须下载 iOS 应用程序, 运行 `npx agentapprove`,并配对您的设备.
-   如果一个有效的符号没有配置,则工具调用会用设置指导被屏蔽.

## 如何运作

此插件钩入 OpenClaw 代理循环以强制执行您的批准政策 :

-   **工具( c)** - 根据您的政策评估每个工具的调用。 根据您的列表自动调用或自动拒绝, 或者在需要手动审查时向您的设备发送批准请求 .
-   **工具( c)** -- 日志工具补全到活动种子
-   **命令/消息事件** -- 监视会话活动

## 安装

```bash
openclaw plugins install @agentapprove/openclaw@0.2.16
```

## 设置

1.  **下载代理批准** 从 [应用程序存储](https://apps.apple.com/us/app/agent-approve/id6756645367) 7天免费开庭
2.  **跟随应用登入** 这将促使您运行每台机器上的安装器, 您有代理:

```bash
npx agentapprove
```

安装者处理对接,令牌设置和插件活化. 当提示要配置代理时选择 OpenClaw .

3.  **重新启动 OpenClaw 网关** 装入插件

就是这样。 现在将对照您的政策评估工具调用, 并在需要时在您的配对设备上显示批准请求 .

## 配置

插件设置 `~/.openclaw/openclaw.json`数字 :

```json
{
  "plugins": {
    "entries": {
      "openclaw": {
        "enabled": true,
        "config": {
          "apiUrl": "https://api.agentapprove.com",
          "apiVersion": "v001",
          "timeout": 300,
          "failBehavior": "ask",
          "privacyTier": "full",
          "agentName": "OpenClaw"
        }
      }
    }
  }
}
```

| 设置 | 默认 | 说明 |
| --- | --- | --- |
| `token` | 从 `~/.agentapprove/env` | 可选的 API 符号覆盖 |
| `apiUrl` | `https://api.agentapprove.com` | 代理批准 API 基础 URL |
| `apiVersion` | `v001` | API 版本前缀 |
| `timeout` | `300` | 等待批准答复的秒数 |
| `failBehavior` | `ask` | API 无法到达时的默认策略 : `allow`, (中文(简体) ), `deny`,或 `ask` |
| `privacyTier` | `full` | 在事件日志中存储哪些工具数据 : `minimal`, (中文(简体) ), `summary`,或 `full` |
| `debug` | `false` | 将调试日志写入 `~/.agentapprove/hook-debug.log` |
| `agentName` | `OpenClaw` | 显示随批准事件而发送的名称 |
| `e2eEnabled` | 从 `~/.agentapprove/env` | 为主机安装切换 E2E 密钥加载 |

对于主机或集装箱化的OpenClaw安装,您可以在服务中保守秘密 环境,并从 `openclaw.json` 使用 OpenClaw 配置 替换,例如 `"token": "${AGENTAPPROVE_TOKEN}"`。 。 。 .

## 所需资源

-   OpenClaw 运行时间
-   代理批准iOS应用和主动订阅(每月14.99美元,免费审判7天)

## 支助代理人

代理批准与OpenClaw,OpenCode,Claude Code,Cursor,OpenAI Codex,Google Antigravity,VS代码副驾驶,副驾驶CLI,Windsurf,Pi,Hermes,OpenHands等合作. 运行 `npx agentapprove` 以同时配置多个代理.

## 链接

-   [代理核准](https://agentapprove.com/)
-   [打开Claw](https://openclaw.ai/)

## 常见问题

### @agentapprove/openclaw 是什么？

代理批准 OpenClaw 插件 - 批准或拒绝您的 iPhone 和 Apple Watch 的 AI 代理工具呼叫

### 如何安装 @agentapprove/openclaw？

在项目目录运行 npm install @agentapprove/openclaw，或使用 pnpm add / yarn add / bun add。

### @agentapprove/openclaw 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/agentapprove\_\_openclaw 是否存在。

### @agentapprove/openclaw 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @agentapprove/openclaw 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @agentapprove/openclaw 可以商用吗？

@agentapprove/openclaw 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @agentapprove/openclaw 的下载量有多少？

根据 npm 官方下载统计，@agentapprove/openclaw 在 2026/10/05 – 2026/11/03 这 30 天内被下载 3,879 次，日均约 129 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @agentapprove/openclaw 还在维护吗？

最新版本 0\.2\.17 发布于 2026/08/31（2 个月前）；至今共发布 26 个版本，其中过去 12 个月发布了 26 个；首次发布于 2026/02/25。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。