← 返回 Skills 市场
aiwithabidi

Freshsales

作者 aiwithabidi · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
389
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install freshsales
功能描述
Freshsales CRM integration — manage contacts, leads, deals, accounts, tasks, and sales sequences via the Freshsales API. Track deal pipelines, automate lead...
使用说明 (SKILL.md)

🟢 Freshsales

Freshsales CRM integration — manage contacts, leads, deals, accounts, tasks, and sales sequences via the Freshsales API.

Features

  • Manage contacts — create, update, search, and segment
  • Lead tracking — capture, qualify, assign, and convert
  • Deal pipeline — stages, values, forecasting, and won/lost
  • Account management — company profiles and hierarchies
  • Task management — create, assign, and track sales tasks
  • Activity logging — calls, emails, meetings, and notes
  • Sales sequences — view and manage outreach campaigns
  • Search across contacts, leads, deals, and accounts
  • Reports — pipeline value, conversion rates, activity metrics
  • Filters — custom views with field-level filtering

Requirements

Variable Required Description
FRESHSALES_API_KEY ✅ API key/token for Freshsales
FRESHSALES_DOMAIN ✅ Your Freshsales domain (e.g. yourorg.freshsales.io)

Quick Start

# List contacts
python3 {baseDir}/scripts/freshsales.py contacts --limit 20

# Get contact details
python3 {baseDir}/scripts/freshsales.py contact-get 12345

# Create a contact
python3 {baseDir}/scripts/freshsales.py contact-create '{"first_name":"Jane","last_name":"Doe","email":"[email protected]"}'

# Update a contact
python3 {baseDir}/scripts/freshsales.py contact-update 12345 '{"lead_score":85}'

Commands

contacts

List contacts.

python3 {baseDir}/scripts/freshsales.py contacts --limit 20

contact-get

Get contact details.

python3 {baseDir}/scripts/freshsales.py contact-get 12345

contact-create

Create a contact.

python3 {baseDir}/scripts/freshsales.py contact-create '{"first_name":"Jane","last_name":"Doe","email":"[email protected]"}'

contact-update

Update a contact.

python3 {baseDir}/scripts/freshsales.py contact-update 12345 '{"lead_score":85}'

leads

List leads.

python3 {baseDir}/scripts/freshsales.py leads --limit 20 --sort updated_at

lead-create

Create a lead.

python3 {baseDir}/scripts/freshsales.py lead-create '{"first_name":"John","company":"Acme"}'

deals

List deals.

python3 {baseDir}/scripts/freshsales.py deals --limit 20

deal-create

Create a deal.

python3 {baseDir}/scripts/freshsales.py deal-create '{"name":"Acme Upgrade","amount":50000}'

deal-update

Update deal stage.

python3 {baseDir}/scripts/freshsales.py deal-update 789 '{"deal_stage_id":3}'

accounts

List accounts.

python3 {baseDir}/scripts/freshsales.py accounts --limit 20

tasks

List tasks.

python3 {baseDir}/scripts/freshsales.py tasks --limit 10 --status open

task-create

Create a task.

python3 {baseDir}/scripts/freshsales.py task-create '{"title":"Follow up with Acme","due_date":"2026-03-01"}'

search

Search across all entities.

python3 {baseDir}/scripts/freshsales.py search "Acme"

activities

List recent activities.

python3 {baseDir}/scripts/freshsales.py activities --limit 20

pipeline

Pipeline summary.

python3 {baseDir}/scripts/freshsales.py pipeline

Output Format

All commands output JSON by default. Add --human for readable formatted output.

# JSON (default, for programmatic use)
python3 {baseDir}/scripts/freshsales.py contacts --limit 5

# Human-readable
python3 {baseDir}/scripts/freshsales.py contacts --limit 5 --human

Script Reference

Script Description
{baseDir}/scripts/freshsales.py Main CLI — all Freshsales operations

Data Policy

This skill never stores data locally. All requests go directly to the Freshsales API and results are returned to stdout. Your data stays on Freshsales servers.

Credits

Built by M. Abidi | agxntsix.ai YouTube | GitHub Part of the AgxntSix Skill Suite for OpenClaw agents.

📅 Need help setting up OpenClaw for your business? Book a free consultation

安全使用建议
This skill appears to be a legitimate Freshsales CLI, but there are a few red flags you should address before installing or providing credentials: (1) The script never substitutes FRESHSALES_DOMAIN into API calls (API_BASE uses the literal '{domain}'), so network requests will fail or behave unexpectedly — ask the author to fix the URL construction to use the declared domain. (2) The script will look for FRESHSALES_API_KEY in a .env under WORKSPACE or ~/.openclaw/workspace/.env if the env var is not set; this file access is not documented and may read local secrets. Prefer setting FRESHSALES_API_KEY explicitly, or review the .env lookup code. (3) Because the code has these inconsistencies, treat it as untrusted until corrected: run it in a sandboxed or test environment, use a limited-scope API key, and review/patch the code to properly use FRESHSALES_DOMAIN and to avoid undocumented file reads.
功能分析
Type: OpenClaw Skill Name: freshsales Version: 1.0.0 The skill is classified as suspicious due to two main vulnerabilities in `scripts/freshsales.py`. Firstly, it attempts to read the `FRESHSALES_API_KEY` from `~/.openclaw/workspace/.env` if not present in environment variables, which is a local file access capability that could be abused. Secondly, it directly interpolates user-provided `args.id` into API URL paths (e.g., `/contacts/{args.id}`) without explicit sanitization, posing a potential URL path injection vulnerability. No evidence of intentional malicious behavior like data exfiltration to unauthorized third parties, persistence, or prompt injection against the agent was found in `SKILL.md`.
能力评估
⚠ Purpose & Capability
The skill declares FRESHSALES_DOMAIN as a required env var, but the bundled script never reads or substitutes that variable into API requests (API_BASE contains an unformatted '{domain}' placeholder). Requesting a domain variable that the code doesn't use is incoherent and suggests either a bug or sloppy packaging.
⚠ Instruction Scope
SKILL.md claims 'never stores data locally' and documents only FRESHSALES_API_KEY/FRESHSALES_DOMAIN, but the script will attempt to read a .env file from a workspace path (WORKSPACE env or ~/.openclaw/workspace/.env) to find the API key. That file lookup is not documented and is additional file system access beyond the stated instructions.
✓ Install Mechanism
No install spec (instruction-only plus a Python stdlib script). Nothing is written to disk by an installer; risk from install mechanism is low.
⚠ Credentials
Only FRESHSALES_API_KEY and FRESHSALES_DOMAIN are declared (primary credential is FRESHSALES_API_KEY), which is reasonable for a CRM integration — but FRESHSALES_DOMAIN is unused and the script additionally inspects WORKSPACE and a local .env file for the API key. The implicit dependence on WORKSPACE/.env is not declared and increases the scope of environment/config access.
✓ Persistence & Privilege
The skill is not always-enabled, does not modify other skills, and has no installer that grants persistent elevated privileges. It does read a local .env if present but does not persist new data or change system settings.
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install freshsales
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /freshsales 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
Freshsales CRM integration skill — initial release. - Manage contacts, leads, deals, accounts, tasks, and sales sequences using the Freshsales API. - Includes tracking of deal pipelines, automated lead assignments, activity logging, and sales reporting. - Designed for Python 3.10+; no external dependencies (stdlib only). - CLI commands for all major Freshsales CRM operations with JSON or human-readable output. - No data stored locally; all requests made directly to Freshsales.
元数据
Slug freshsales
版本 1.0.0
许可证 —
累计安装 0
当前安装数 0
历史版本数 1
常见问题

Freshsales 是什么？

Freshsales CRM integration — manage contacts, leads, deals, accounts, tasks, and sales sequences via the Freshsales API. Track deal pipelines, automate lead... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 389 次。

如何安装 Freshsales？

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

Freshsales 是免费的吗？

是的，Freshsales 完全免费（开源免费），可自由下载、安装和使用。

Freshsales 支持哪些平台？

Freshsales 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Freshsales？

由 aiwithabidi（@aiwithabidi）开发并维护，当前版本 v1.0.0。

推荐 Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 留言讨论