← 返回 Skills 市场
byungkyu

Salesforce

作者 byungkyu · GitHub ↗ · v1.2.2 · MIT-0
cross-platform ✓ 安全检测通过
19598
总下载
8
收藏
0
当前安装
13
版本数
在 OpenClaw 中安装
/install salesforce-api
功能描述
Salesforce CRM API integration with managed OAuth. Install only if you need Salesforce CRM administration. Connect with the narrowest Salesforce permissions available, prefer sandbox orgs for destructive or batch work, verify the intended connection ID before each request, and revoke unused connections promptly. This integration can mutate CRM records — approve only specific write actions after checking the exact sObject, record IDs, and consequence. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. The endpoints documented here are the intended surface, not a technical limit — the `maton api` passthrough can reach others the connection permits. Default to read and list calls, and confirm every write or new connection with the user.
安全使用建议
Install this only if you want an agent to help administer Salesforce. Use OAuth with the narrowest Salesforce permissions available, prefer a sandbox or read-only scope where possible, pin the intended connection ID, and approve writes or deletes only after checking the exact object, record IDs, payload, and consequence.
能力评估
Credentials
The skill needs network access, Bash commands, and access to Salesforce through the Maton gateway; the authority is broad because maton api is a passthrough to any endpoint the Salesforce connection permits, but this breadth is clearly disclosed and tied to the CRM administration purpose.
Install Mechanism
Installation relies on third-party Maton CLI packages via npm or Homebrew, with optional SDK packages; this is expected for the integration but users should install only from the documented Maton package sources.
Instruction Scope
The skill repeatedly instructs the agent to default to read/list calls, verify record IDs and connection targets, treat Salesforce content as untrusted data, and obtain explicit user confirmation before POST, PUT, PATCH, DELETE, connection creation, or destructive/batch actions.
Persistence & Privilege
OAuth tokens or API keys are stored by the Maton CLI/SDK in OS credential storage and config profiles, which is disclosed; the skill also explicitly tells agents not to read, print, export, or persist credentials and contains no background worker or hidden persistence instructions.
Purpose & Capability
The stated purpose is Salesforce CRM API administration, and the documented capabilities cover Salesforce queries, sObject CRUD, composite/batch calls, connection management, and optional SDK/raw HTTP access through Maton; these are purpose-aligned and disclosed.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install salesforce-api
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /salesforce-api 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.2.2
Resolve remaining audit findings: state one consistent endpoint policy instead of conflicting scope claims, qualify the local-execution and high-impact wording, note that locale examples are illustrative, and correct app-specific auth, method and upload-path documentation
v1.2.1
Address security-audit findings: disclose the api passthrough in the access-scope and description text, warn on irreversible connection deletion, add response data-minimization guidance, and correct app-specific auth and request-body notes
v1.2.0
CLI-first rewrite with the Maton SDK examples; clarify that the CLI and SDKs keep separate credential stores, and reword webhook egress warnings
v1.1.0
CLI-first rewrite: the maton CLI with OAuth login is the documented path, every example is a maton command, SDK examples added, and the raw HTTP fallback feeds the key on stdin instead of reading it from the environment
v1.0.8
- Removed the file skill-card.md. - No other functional or documentation changes in this release.
v1.0.7
- Adds CLI and Homebrew installation instructions for Maton CLI, expanding usage options. - Updates API examples and references from Salesforce API version v59.0 to v63.0. - Documents direct CLI commands for common actions (SOQL queries, connections) alongside Python and HTTP examples. - Clarifies connection management and explicit connection selection, now with CLI examples. - Improves authentication instructions by including CLI login/interactive login commands. - No functional/API changes to the underlying integration; documentation update only.
v1.0.6
- Added strong security guidance: treat the API key as secret, rotate if exposed, and revoke unused Salesforce connections promptly. - Updated description and usage to emphasize least-privilege OAuth, sandbox use for risky actions, and always verifying connection ID before requests. - Clarified that only supported/documented endpoint paths should be used. - Instructions now require explicit user confirmation with details before any write or batch operation; added steps to confirm record and intended impact. - Emphasized defaulting to read-only actions and increased caution on all composite/batch operations.
v1.0.5
- Updated all Maton API endpoints from gateway.maton.ai and ctrl.maton.ai to api.maton.ai for consistency. - Clarified instructions for specifying a Salesforce connection via the Maton-Connection header, emphasizing its use when multiple connections exist. - Added a new "Security & Permissions" section requiring explicit user approval before any write operations (create, update, delete). - Removed LICENSE.txt file.
v1.0.4
- Added a metadata.clawdbot section to SKILL.md, specifying a brain emoji and required environment variable (MATON_API_KEY). - No functional changes to code or documentation content.
v1.0.3
- No file changes were detected in this version. - Documentation, API references, code examples, and usage instructions remain unchanged. - No new features, bug fixes, or enhancements introduced in this release.
v1.0.2
- Added suggestion to use the api-gateway skill for other third party apps in the description. - Updated all connection management, quick start, and usage examples to use Python scripts instead of curl/bash. - No changes to the skill logic or API endpoints; documentation improvements only.
v1.0.1
- Base URL instructions clarified to use /salesforce/{native-api-path}, explaining direct mapping to Salesforce endpoints. - Expanded OAuth connection example response to include fields such as creation_time, last_updated_time, and metadata. - Instructions now explain explicitly how to specify a Salesforce connection with the Maton-Connection header and clarify default selection. - Authentication steps updated to mention creating a Maton account if you don't have one. - Minor improvements for clarity in usage and connection handling instructions.
v1.0.0
Salesforce skill has been redesigned to use managed OAuth and direct REST API integration via Maton. - Replaced CLI-based workflow with Maton-powered REST API endpoints. - Managed Salesforce authentication, connections, and environments via Maton control panel. - Added example code for Python and JavaScript. - Documented CRUD, SOQL/SOSL query, composite, batch, describe, and admin operations. - Centralized error handling and streamlined usage with a single API key.
元数据
Slug salesforce-api
版本 1.2.2
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 13
常见问题

Salesforce 是什么?

Salesforce CRM API integration with managed OAuth. Install only if you need Salesforce CRM administration. Connect with the narrowest Salesforce permissions available, prefer sandbox orgs for destructive or batch work, verify the intended connection ID before each request, and revoke unused connections promptly. This integration can mutate CRM records — approve only specific write actions after checking the exact sObject, record IDs, and consequence. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. The endpoints documented here are the intended surface, not a technical limit — the `maton api` passthrough can reach others the connection permits. Default to read and list calls, and confirm every write or new connection with the user. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 19598 次。

如何安装 Salesforce?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install salesforce-api」即可一键安装,无需额外配置。

Salesforce 是免费的吗?

是的,Salesforce 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Salesforce 支持哪些平台?

Salesforce 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Salesforce?

由 byungkyu(@byungkyu)开发并维护,当前版本 v1.2.2。

💬 留言讨论