名称： civic-nexus
描述： "连接至 Civic Nexus MCP，支持 100 多种集成服务。"
元数据： {"openclaw":{"requires":{"env":["NEXUS_URL","NEXUS_TOKEN"],"anyBins":["mcporter","npx"]},"primaryEnv":"NEXUS_TOKEN"}}

Civic Nexus MCP 桥接器

⚠️ 免责声明：请自行承担使用风险。官方文档请访问 docs.civic.com。

连接至 Civic Nexus，可接入包括 Gmail、PostgreSQL、MongoDB、Box 等在内的 100 多种集成服务。

设置

1. 获取 Nexus 凭证

1. 访问 nexus.civic.com 并登录。
2. 在个人资料设置中获取 MCP URL 和 访问令牌。

2. 在 OpenClaw 中配置

将以下内容添加到 ~/.openclaw/openclaw.json：

{
  "skills": {
    "entries": {
      "civic-nexus": {
        "enabled": true,
        "env": {
          "NEXUS_URL": "https://nexus.civic.com/hub/mcp?accountId=YOUR_ACCOUNT_ID&profile=YOUR_PROFILE",
          "NEXUS_TOKEN": "your-access-token"
        }
      }
    }
  }
}

3. （可选）配置 mcporter

如果已安装 mcporter（通过 npm install -g mcporter），请将以下内容添加到 ~/.openclaw/workspace/config/mcporter.json：

{
  "mcpServers": {
    "nexus": {
      "baseUrl": "https://nexus.civic.com/hub/mcp?accountId=YOUR_ACCOUNT_ID&profile=YOUR_PROFILE",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN",
        "User-Agent": "openclaw/1.0.0"
      }
    }
  }
}

代理使用指南

当用户要求通过 Nexus 与外部服务交互时，请优先尝试使用 mcporter。如果失败，则回退到 TypeScript 脚本。

使用 mcporter

# 列出所有工具
mcporter list nexus

# 搜索工具
mcporter list nexus | grep gmail

# 调用工具
mcporter call 'nexus.google-gmail-search_gmail_messages(query: "is:unread")'

备用方案：TypeScript 脚本

# 列出所有工具
npx tsx {baseDir}/nexus-tool-runner.ts --list

# 搜索工具
npx tsx {baseDir}/nexus-tool-runner.ts --search gmail

# 获取工具架构
npx tsx {baseDir}/nexus-tool-runner.ts --schema google-gmail-search_gmail_messages

# 调用工具
npx tsx {baseDir}/nexus-tool-runner.ts --call google-gmail-search_gmail_messages --args '{"query": "is:unread"}'

授权流程

部分工具首次使用时需要 OAuth 授权。当看到授权 URL 时：

1. 将 URL 展示给用户。
2. 用户授权后，继续执行：
   ```bash
   # mcporter 方式
   mcporter call 'nexus.continue_job(jobId: "JOB_ID")'

# 脚本方式
npx tsx {baseDir}/nexus-tool-runner.ts --call continue_job --args '{"job_id": "JOB_ID"}'
```

注意事项

• API 调用可能需要 10-15 秒（服务器端延迟）。
• 令牌有效期约为 30 天，过期后请从 Nexus 重新生成。
• Gmail 批量请求每次调用限制为 5-25 条消息。