1Password UI 扩展

在 OpenClaw 控制台的 Tools 分组下添加一个 1Password 标签页。您可直接通过 Web UI 浏览保险库、管理技能的凭据映射，以及处理身份验证。

功能特性

Agent 安装提示

如需安装该技能，请向您的 agent 提供以下提示：

从 ClawHub 安装 1password-ui 技能。

该技能位于：~/clawd/skills/1password-ui/
请按 INSTALL_INSTRUCTIONS.md 中的步骤逐一执行。

需修改内容概要：
1. 将 1password-backend.ts 复制到 src/gateway/server-methods/1password.ts
2. 在 server-methods.ts 中注册处理器
3. 在 navigation.ts 中添加 “1password” 标签（包括 TAB_GROUPS、Tab 类型、TAB_PATHS、图标、标题、副标题）
4. 在 app.ts 中添加状态变量
5. 将 1password-views.ts 复制到 ui/src/ui/views/1password.ts
6. 在 app-render.ts 中添加视图渲染逻辑
7. 在 app-settings.ts 中添加标签加载逻辑
8. 构建并重启：pnpm build && pnpm ui:build && clawdbot gateway restart

前提条件

本地安装（Ubuntu / Windows / macOS）

1. 1Password CLI（op）：

   # macOS/Linux
   brew install 1password-cli
   
   # 或从 https://1password.com/downloads/command-line/ 下载
   

2. 启用 CLI 集成（在 1Password 应用中）：

   • 设置 → 开发者 → 勾选 “Integrate with 1Password CLI”

Docker 安装

详见下方 Docker 配置说明。

使用方法

登录

1. 打开 OpenClaw 控制台 → Tools → 1Password
2. 点击 Sign In with 1Password
3. 在弹出的 1Password 应用窗口中授权（或在终端运行 op signin）
4. 状态栏将显示 “Connected”，并附带您的账户信息

凭据映射

完成登录后，即可将 1Password 条目映射至技能：

1. 例如 Pipedream 等技能可从 1Password 读取凭据
2. 映射关系保存在 ~/clawd/config/1password-mappings.json 中
3. 格式为：{ "skillId": { "item": "Item Name", "vault": "Private", "fields": {...} } }

示例：Pipedream 与 1Password 集成

# 将 Pipedream 凭据存入 1Password
op item create --category="API Credential" --title="Pipedream Connect" 
  --vault="Private" 
  "client_id[text]=your_client_id" 
  "client_secret[password]=your_client_secret" 
  "project_id[text]=proj_xxxxx"

# 在 token 刷新脚本中使用
PIPEDREAM_1PASSWORD_ITEM="Pipedream Connect" python3 ~/clawd/scripts/pipedream-token-refresh.py

网关 RPC 方法

Docker 配置（1Password Connect）

对于基于 Docker 的 OpenClaw 部署，请使用 1Password Connect 替代 CLI。

步骤 1：部署 1Password Connect

# docker-compose.yml
services:
  op-connect-api:
    image: 1password/connect-api:latest
    ports:
      - "8080:8080"
    volumes:
      - ./1password-credentials.json:/home/opuser/.op/1password-credentials.json:ro
      - op-data:/home/opuser/.op/data

  op-connect-sync:
    image: 1password/connect-sync:latest
    volumes:
      - ./1password-credentials.json:/home/opuser/.op/1password-credentials.json:ro
      - op-data:/home/opuser/.op/data

volumes:
  op-data:

步骤 2：获取凭证

1. 访问 my.1password.com → Integrations → Secrets Automation
2. 创建一个 Connect 服务器
3. 下载 1password-credentials.json
4. 生成一个访问令牌（access token）

步骤 3：配置 OpenClaw

services:
  clawdbot:
    environment:
      - OP_CONNECT_HOST=http://op-connect-api:8080
      - OP_CONNECT_TOKEN=your-access-token

UI 会自动识别 Connect 模式。

包含文件

1password-ui/
├── SKILL.md                      # 本文档
├── INSTALL_INSTRUCTIONS.md       # 分步安装说明
├── CHANGELOG.md                  # 版本历史
├── package.json                  # 技能元数据
├── reference/
│   ├── 1password-backend.ts      # 网关 RPC 处理器
│   ├── 1password-views.ts        # UI 视图（Lit 模板）
│   ├── 1password-settings.ts     # 标签页加载逻辑
│   └── 1password-plugin.ts       # 插件注册（可选）
└── scripts/
    └── op-helper.py              # CLI / Connect 桥接脚本（供技能使用）

安全注意事项

✅ 设计即安全

⚠️ 已知风险（已记录）

文件安全

# 建议对映射文件设置如下权限
chmod 600 ~/clawd/config/1password-mappings.json

故障排查

“未找到 1Password CLI”

brew install 1password-cli
# 或从 1password.com/downloads/command-line/ 下载

“未登录”

op signin
op whoami  # 验证是否成功

登录失败 / “authorization denied”

• 确保 1Password 应用已解锁
• 启用 CLI 集成：设置 → 开发者 → 勾选 “Integrate with 1Password CLI”

Docker：“connection refused”

docker ps | grep op-connect  # 检查容器是否正在运行

Docker：“401 unauthorized”

• 确认 OP_CONNECT_TOKEN 已正确设置
• 检查令牌是否已过期

支持资源

• ClawHub：clawhub.ai/skills/1password-ui
• 1Password CLI：developer.1password.com/docs/cli
• 1Password Connect：developer.1password.com/docs/connect
• OpenClaw Discord：discord.com/invite/clawd

更新日志

v1.1.0（2025-02-11）

• 完整可用实现，含控制台 UI
• 支持通过 Web 界面启动登录流程
• 同时支持 CLI 与 Connect 模式
• 提供凭据映射系统

v1.0.0（2025-02-11）

• 初始发布，含参考实现