闲社服务运行正常AI智能体自动化平台
客户端下载帮助中心服务商入驻
免费注册
技能集市 > AI智能 > cloudcc-openapi-withobject
c

CloudCC开放API

技能标识：cloudcc-openapi-withobject

CloudCC OpenAPI 调用技能 - 提供完整的 REST API 接口调用能力，支持对象/字段元数据查询

作者：admin | 来源记录：ClawHub
下载
登记来源
ClawHub
版本
V 1.0.0
检测标记
后台标记通过
免费
免费获取
0
收藏
来源与检测标记为平台登记信息，并不代表已展示可复核的检测报告。使用前请核对版本、依赖和所需权限，建议先在隔离环境中运行。
概述
安装方式
版本历史

CloudCC开放API

技能信息

  • - 名称: cloudcc-openapi-withobject
  • 版本: 2.0.0
  • 作者: 鲁班
  • 创建日期: 2026-03-20
  • 更新日期: 2026-03-20
  • 适用范围: CloudCC One 版本 OpenAPI 接口调用

安装配置

配置参数

参数说明默认值必填
orgId组织 ID-是
username
登录用户名 | - | 是 | | safetyMark | 安全标记（邮箱获取） | - | 是 | | clientId | 连接应用的 clientId | - | 是 | | secretKey | 连接应用的 secretKey | - | 是 | | apiDomain | API 网关地址（动态获取） | - | 否（自动获取） |

获取配置信息

  1. 1. 组织 ID (orgId): 系统设置 - 公司信息中查看
  2. 安全标记 (safetyMark): 个人信息 - 重置我的安全标记（发送到邮箱）
  3. clientId/secretKey: 管理设置 - 安全性控制 - 连接的应用程序

安装步骤

bash

1. 创建技能目录


mkdir -p ~/.openclaw/skills/cloudcc-openapi-withobject

2. 创建配置文件

cat > ~/.openclaw/skills/cloudcc-openapi-withobject/config.json << EOF { orgId: your-org-id, username: your-username, safetyMark: your-safety-mark, clientId: your-client-id, secretKey: your-secret-key } EOF

核心功能

1. 认证管理

  • - 动态获取组织 API 网关地址
  • 获取 accessToken 并自动刷新
  • accessToken 有效性验证
  • 认证事件日志记录

2. 元数据查询（新增 v2.0.0）

方法说明API 端点
getAllTabs获取所有选项卡（推荐用于查找对象）/openApi/common (getAllTabs)
pageQuery
查询对象数据（不带 fields 返回所有字段） | /openApi/common (pageQuery) | | getStandardObjects | 获取标准对象列表 | /api/customObject/standardObjList | | getCustomObjects | 获取自定义对象列表 | /api/customObject/list | | getObjectFields | 获取对象字段列表 | /api/fieldSetup/queryField |

注意: 元数据查询 API (/api/customObject/ 和 /api/fieldSetup/) 可能需要额外的权限或使用 Setup 服务域名。推荐使用 getAllTabs 方法查找对象 API 名称。

3. 数据操作

  • - 查询: 普通查询、分页查询、带权限查询、SQL 查询
  • 插入: 普通插入、带权限插入
  • 更新: 普通更新、带权限更新
  • 删除: 普通删除、带权限删除
  • Upsert: 插入或更新

4. 文件服务

  • - 图片上传（单张/多张）
  • 文件上传（流/base64）
  • 文件下载
  • 附件管理

5. 消息服务

  • - 发送邮件
  • 发送手机短信
  • Chatter 微帖操作

6. 审批流程

  • - 查询待审批项目
  • 批准/拒绝/重新分配
  • 提交审批

7. 安全日志（v2.1.0 新增）

  • - 自动记录所有 API 调用（服务名、对象、响应码、耗时）
  • 记录认证事件（token 请求、刷新、过期）
  • 日志自动清理（保留最近 3 天）
  • 支持日志查询、统计、导出

使用方法

快速开始

bash

1. 获取 API 网关地址


curl -X GET https://developer.apis.cloudcc.cn/oauth/apidomain?scope=cloudccCRM&orgId=YOURORGID

返回示例:

{result:true,returnInfo:,returnCode:1,orgapi_address:https://xxxx.apis.cloudcc.cn/lightningapi}

2. 获取 accessToken

curl -X POST https://xxxx.apis.cloudcc.cn/lightningapi/api/cauth/token \ -H Content-Type: application/json \ -d { username:your-username, safetyMark:your-safety-mark, clientId:your-client-id, secretKey:your-secret-key, orgId:your-org-id, grant_type:password }

返回示例:

{data:{accessToken:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...},returnCode:1,result:true}

日志管理（v2.1.0 新增）

bash

查看最近的日志


~/.openclaw/skills/cloudcc-openapi-withobject/scripts/logger.sh view 50

查看统计信息

~/.openclaw/skills/cloudcc-openapi-withobject/scripts/logger.sh stats 3

搜索日志

~/.openclaw/skills/cloudcc-openapi-withobject/scripts/logger.sh search productuplist

导出日志

~/.openclaw/skills/cloudcc-openapi-withobject/scripts/logger.sh export

清理旧日志（保留最近 3 天）

~/.openclaw/skills/cloudcc-openapi-withobject/scripts/logger.sh cleanup 3

日志格式

每条日志为 JSON 格式，包含以下字段：

json
{
timestamp: 2026-03-20 12:15:30,
type: API_REQUEST,
service: pageQuery,
objectApi: productuplist,
responseCode: 1,
durationMs: 125
}

日志类型

类型说明示例
APIREQUESTAPI 调用记录记录所有 OpenAPI 调用
AUTHEVENT
认证事件 | token 请求、刷新、过期 |

元数据查询示例（v2.0.0 新增）

获取标准对象列表

bash
curl -X POST $API_DOMAIN/api/customObject/standardObjList \
-H accessToken: $TOKEN \
-H Content-Type: application/json \
-d {}

返回示例:
json
{
result: true,
data: [
{id: account, objname: 客户, label: Account, objprefix: 001},
{id: contact, objname: 联系人, label: Contact, objprefix: 003},
{id: opportunity, objname: 业务机会, label: Opportunity, objprefix: 002}
]
}

获取自定义对象列表

bash
curl -X POST $API_DOMAIN/api/customObject/list \
-H accessToken: $TOKEN \
-H Content-Type: application/json \
-d {id:}

返回示例:
json
{
result: true,
data: {
objList: [
{id: 2021A51AA0D3785lBzwh, objLabel: 产品需求研发报备记录, schemetable_name: productuplist, prefix: b70},
{id: 2023D181015EDF0f7G1y, objLabel: 需求池, schemetable_name: requirementpool, prefix: c75}
]
}
}

获取对象字段列表

bash
curl -X POST $API_DOMAIN/api/fieldSetup/queryField \
-H accessToken: $TOKEN \
-H Content-Type: application/json \
-d {prefix:b70}

返回示例:
json
{
result: true,
data: {
obj: {id: 2021A51AA0D3785lBzwh, label: 产品需求研发报备记录},
stdFields: [
{id: 1, labelName: 名称, schemefieldName: name,

标签

skill ai

通过对话安装

以下为平台配置的接入选项，并非逐项实测通过。能否安装取决于客户端支持、技能来源和运行环境：

OpenClaw WorkBuddy QClaw Kimi Claude

方式一：安装 SkillHub 和技能

帮我安装 SkillHub 和 cloudcc-openapi-withobject-1776123549 技能

方式二：设置 SkillHub 为优先技能安装源

设置 SkillHub 为我的优先技能安装源，然后帮我安装 cloudcc-openapi-withobject-1776123549 技能

通过命令行安装

skillhub install cloudcc-openapi-withobject-1776123549

下载

⬇ 下载 cloudcc-openapi-withobject v1.0.0（免费）

文件大小: 23.13 KB | 发布时间: 2026-4-14 12:51

v1.0.0 最新 2026-4-14 12:51
cloudcc-openapi-withobject 2.0.0 provides enhanced REST API support, especially for object and field metadata queries.

- Added comprehensive metadata query capabilities (standard objects, custom objects, object fields, and tabs).
- Improved authentication: dynamic API domain lookup, accessToken auto-refresh, and detailed auth event logging.
- Expanded documentation with setup, configuration, usage examples, and API endpoint descriptions.
- Enhanced data operations: improved examples for query, insert, update, delete, and upsert.
- Introduced a logging framework (to be available in v2.1.0) for all API and authentication events.
- Provided practical examples and usage tips for quickly integrating and troubleshooting.

相关推荐

s

self-improvement

Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Claude ('No, that's wrong...', 'Actually...'), (3) User requests a capability that doesn't exist, (4) An external API or tool fails, (5) Claude realizes its knowledge is outdated or incorrect, (6) A better approach is discovered for a recurring task. Also review learnings before major tasks.

AI智能
s

self-improvement

Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Claude ('No, that's wrong...', 'Actually...'), (3) User requests a capability that doesn't exist, (4) An external API or tool fails, (5) Claude realizes its knowledge is outdated or incorrect, (6) A better approach is discovered for a recurring task. Also review learnings before major tasks.

AI智能
s

self-improvement

Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Claude ('No, that's wrong...', 'Actually...'), (3) User requests a capability that doesn't exist, (4) An external API or tool fails, (5) Claude realizes its knowledge is outdated or incorrect, (6) A better approach is discovered for a recurring task. Also review learnings before major tasks.

AI智能
s

self-improvement

Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Claude ('No, that's wrong...', 'Actually...'), (3) User requests a capability that doesn't exist, (4) An external API or tool fails, (5) Claude realizes its knowledge is outdated or incorrect, (6) A better approach is discovered for a recurring task. Also review learnings before major tasks.

AI智能
返回顶部