← 返回 Skills 市场

AI Cold Outreach System

Name: AI Cold Outreach System
Author: joeytbuilds

作者 JoeyTbuilds · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ⚠ suspicious

总下载

当前安装

版本数

在 OpenClaw 中安装

/install ai-cold-outreach

功能描述

Complete cold email outreach system for AI agents. Handles lead generation via Apollo API, email enrichment, Saleshandy sequence creation, prospect import, w...

使用说明 (SKILL.md)

AI Cold Outreach System

End-to-end cold email outreach managed by your AI agent. From lead discovery to sending sequences — no human in the loop.

Prerequisites

Apollo.io account with API key (Basic plan $59/mo for email enrichment)
Saleshandy account with API key (Outreach plan)
Google Workspace sending accounts (2+ domains recommended)
SPF, DKIM, DMARC configured on sending domains

Quick Start

1. Configure API Keys

Store keys in your workspace:

# Apollo
export APOLLO_API_KEY="your_key"

# Saleshandy  
export SALESHANDY_API_KEY="your_key"

Or save to a JSON config (see references/config-template.json).

2. Find Leads

Use the Apollo lead generation script to search for decision-makers:

python3 scripts/apollo-search.py --titles "Owner,Founder,CEO" --keywords "aesthetic clinic" --location "United States" --max 100

This outputs a CSV with: name, email, title, organization, city, state, country.

3. Enrich Emails

Search results don't include emails. Enrich them:

python3 scripts/apollo-enrich.py --input leads-raw.csv --output leads-enriched.csv

Uses Apollo's people/match endpoint (1 credit per enrichment). Budget ~500 credits for 300 verified emails.

4. Import to Saleshandy

python3 scripts/saleshandy-import.py --csv leads-enriched.csv --step-id "YOUR_STEP_ID" --api-key "YOUR_KEY"

5. Monitor Warmup

Check email account health before sending:

python3 scripts/check-warmup.py --api-key "YOUR_KEY"

Do NOT activate sequences until all accounts score 85+.

Architecture

Apollo API (lead gen) → CSV → Saleshandy API (import) → Email Sequence → Prospects
                                    ↑
                          Email Copy Templates (references/)

Key API Endpoints

Apollo

Search: POST /api/v1/mixed_people/api_search — find people by title, keyword, location
Enrich: POST /api/v1/people/match — get email from person ID (1 credit each)
Bulk Enrich: POST /api/v1/people/bulk_match — batch enrichment (use name+company, not IDs)

Saleshandy

Base URL: https://open-api.saleshandy.com
Auth Header: x-api-key: YOUR_KEY
List Sequences: GET /v1/sequences
Import Prospects: POST /v1/sequences/prospects/import-with-field-name
List Email Accounts: POST /v1/email-accounts
Add Account to Sequence: POST /v1/sequences/{id}/email-accounts/add

See references/api-reference.md for full endpoint documentation.

Email Copy Best Practices

See references/email-templates.md for proven templates.

Key rules:

Short punchy lines. One thought per line.
Story-driven. Every email tells a specific story with real results.
Real numbers always. Never round. "$457,500" not "almost half a million."
P.S. lines are punchlines. The best hook lives in the P.S.
Never beg. Confident, almost amused tone.
3-step sequences minimum: Opener → Proof → Close
3-5 day gaps between steps

Deliverability Checklist

Before activating any sequence:

SPF record configured on sending domain
DKIM record configured and passing
DMARC record configured
Email accounts warming for 7-14 days minimum
Health scores above 85 on all accounts
Using "get" prefix domains for cold outreach (protect main domain)
Daily sending limits set conservatively (15-25/account/day to start)
Warmup tool running (Saleshandy built-in or TrulyInbox)

Troubleshooting

Issue	Fix
Apollo search returns 0 emails	Emails require enrichment — search only returns IDs
Apollo `people/search` returns 403	Use `/mixed_people/api_search` endpoint instead
Saleshandy API "Invalid token"	Header must be `x-api-key` not `api-key` or `Authorization`
Saleshandy import fails "conflictAction"	Valid values: `overwrite`, `noUpdate`, `addMissingFields`
Emails going to spam	Check warmup scores, verify DKIM, reduce daily volume
Merge tags not rendering	Use `{{First Name}}` format in Saleshandy content

安全使用建议

This skill appears to implement the advertised outreach workflow, but the registry metadata omits required API keys (APOLLO_API_KEY, SALESHANDY_API_KEY). Before installing or running it: (1) treat those service API keys as sensitive and only provide the exact Apollo/Saleshandy keys this tool needs (prefer scoped/limited keys if available); (2) run the scripts in an isolated environment (separate project account and 'get-' sending domains) to avoid harming your main domain reputation; (3) verify the skill's publisher since no homepage or source is provided — lack of provenance lowers trust; (4) review and test the scripts locally to confirm they only call Apollo and Saleshandy endpoints (they do) and do not transmit data elsewhere; (5) ensure your use complies with email laws and your organization’s policies (cold outreach can trigger spam/abuse issues). If you need higher assurance, ask the publisher to update metadata to declare required env vars and provide provenance (source repo/homepage).

功能分析

Type: OpenClaw Skill Name: ai-cold-outreach Version: 1.0.0 The skill bundle provides a functional system for automating cold email outreach using the Apollo.io and Saleshandy APIs. The included Python scripts (e.g., apollo-search.py, saleshandy-import.py) use subprocess.run with curl to interact with legitimate service endpoints, passing arguments as lists to prevent shell injection. The instructions in SKILL.md and the email templates are consistent with the stated purpose of lead generation and campaign management, with no evidence of data exfiltration, malicious execution, or prompt injection.

能力标签

cryptocan-make-purchasesrequires-sensitive-credentials

能力评估

⚠ Purpose & Capability

The skill's stated purpose (cold outreach using Apollo + Saleshandy) matches the included scripts and documentation, but the registry metadata claims 'Required env vars: none' and 'Primary credential: none' while both SKILL.md and the bundled scripts clearly require APOLLO_API_KEY and SALESHANDY_API_KEY (and the SKILL.md instructs exporting those keys). This mismatch is a coherence problem — the skill will not function without credentials but the package metadata doesn't declare them.

✓ Instruction Scope

SKILL.md instructions stay within the outreach domain: searching/enriching leads with Apollo, importing to Saleshandy, checking warmup and using email templates. The instructions do not ask the agent to read unrelated system files or exfiltrate data outside the documented APIs. They do instruct full autonomous campaign operation ('no human in the loop'), which is consistent with the skill's purpose but increases operational risk (spam/compliance).

✓ Install Mechanism

No install spec; this is instruction + shipped scripts. No downloads or archive extraction. Scripts are local Python files that call curl via subprocess — expected for this task and lower installation risk than remote fetches.

⚠ Credentials

Runtime requires service credentials (Apollo and Saleshandy API keys) and the SKILL.md also expects Google Workspace accounts and DNS control for sending domains. Those credentials are proportionate to the function, but the package metadata does not declare them. The omission reduces transparency and raises the chance users will accidentally supply more privileged credentials in the wrong place. No other unrelated secrets are requested in the code.

✓ Persistence & Privilege

Skill is not marked always:true and does not request persistent installation or modification of other skills. It runs as user-invoked scripts and does not alter system-wide agent configuration.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install ai-cold-outreach
安装完成后，直接呼叫该 Skill 的名称或使用 /ai-cold-outreach 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

Initial release: complete cold email system with Apollo, Saleshandy, lead gen, and proven email templates

元数据

Slug ai-cold-outreach

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题