HubSpot（作者：@altf1be）

覆盖 CRM、CMS、Marketing、Conversations 和 Automation 全模块的 HubSpot 平台命令行工具（CLI）。

安装配置

1. 在 HubSpot 中创建一个 Private App：设置（Settings）> 集成（Integrations）> Private Apps
2. 设置环境变量（或在 {baseDir} 目录下创建 .env 文件）：

# 必填（Private App 模式）
HUBSPOT_ACCESS_TOKEN=pat-na1-xxxxxxxx

# 或使用 OAuth 2.0 模式（需同时设置以下三项）：
# HUBSPOT_CLIENT_ID=your-client-id
# HUBSPOT_CLIENT_SECRET=your-client-secret
# HUBSPOT_REFRESH_TOKEN=your-refresh-token

# 可选
# HUBSPOT_MAX_RESULTS=100

3. 在 HubSpot 中为该 Private App 配置必需的 权限范围（Scopes）（设置（Settings）> 集成（Integrations）> Private Apps > 你的应用 > Scopes）：

4. 安装依赖项：cd {baseDir} && npm install

命令列表

CRM — 联系人（Contacts）

# 列出联系人
node {baseDir}/scripts/hubspot.mjs contacts list

# 按邮箱搜索联系人
node {baseDir}/scripts/hubspot.mjs contacts search --query "john@example.com"

# 查看联系人详情
node {baseDir}/scripts/hubspot.mjs contacts read --id 123

# 创建联系人
node {baseDir}/scripts/hubspot.mjs contacts create --email "jane@example.com" --firstname Jane --lastname Doe

# 更新联系人
node {baseDir}/scripts/hubspot.mjs contacts update --id 123 --phone "+1234567890"

# 删除联系人（需显式指定 --confirm）
node {baseDir}/scripts/hubspot.mjs contacts delete --id 123 --confirm

CRM — 公司（Companies）

node {baseDir}/scripts/hubspot.mjs companies list
node {baseDir}/scripts/hubspot.mjs companies search --query "Acme"
node {baseDir}/scripts/hubspot.mjs companies read --id 456
node {baseDir}/scripts/hubspot.mjs companies create --name "Acme Corp" --domain "acme.com"
node {baseDir}/scripts/hubspot.mjs companies update --id 456 --industry "Technology"
node {baseDir}/scripts/hubspot.mjs companies delete --id 456 --confirm

CRM — 交易（Deals）

node {baseDir}/scripts/hubspot.mjs deals list
node {baseDir}/scripts/hubspot.mjs deals search --query "Enterprise"
node {baseDir}/scripts/hubspot.mjs deals read --id 789
node {baseDir}/scripts/hubspot.mjs deals create --name "Big Deal" --amount 50000 --stage appointmentscheduled
node {baseDir}/scripts/hubspot.mjs deals update --id 789 --stage closedwon
node {baseDir}/scripts/hubspot.mjs deals delete --id 789 --confirm

CRM — 工单（Tickets）

node {baseDir}/scripts/hubspot.mjs tickets list
node {baseDir}/scripts/hubspot.mjs tickets search --query "Bug"
node {baseDir}/scripts/hubspot.mjs tickets read --id 101
node {baseDir}/scripts/hubspot.mjs tickets create --subject "Login broken" --priority HIGH
node {baseDir}/scripts/hubspot.mjs tickets update --id 101 --stage 2
node {baseDir}/scripts/hubspot.mjs tickets delete --id 101 --confirm

CRM — 所有者（Owners）

node {baseDir}/scripts/hubspot.mjs owners list
node {baseDir}/scripts/hubspot.mjs owners list --email "john@company.com"
node {baseDir}/scripts/hubspot.mjs owners read --id 55

CRM — 管道（Pipelines）

# 列出交易管道（默认）
node {baseDir}/scripts/hubspot.mjs pipelines list

# 列出工单管道
node {baseDir}/scripts/hubspot.mjs pipelines list --object-type tickets

CRM — 关联关系（Associations，v4）

# 列出从联系人到公司的关联关系
node {baseDir}/scripts/hubspot.mjs associations list --from-type contacts --from-id 123 --to-type companies

# 创建关联关系
node {baseDir}/scripts/hubspot.mjs associations create --from-type contacts --from-id 123 --to-type companies --to-id 456 --type-id 1

# 删除关联关系（需显式指定 --confirm）
node {baseDir}/scripts/hubspot.mjs associations delete --from-type contacts --from-id 123 --to-type companies --to-id 456 --confirm

CRM — 属性（Properties）

# 列出联系人属性（默认）
node {baseDir}/scripts/hubspot.mjs properties list

# 列出交易属性
node {baseDir}/scripts/hubspot.mjs properties list --object-type deals

CRM — 互动记录（Engagements）

node {baseDir}/scripts/hubspot.mjs engagements notes
node {baseDir}/scripts/hubspot.mjs engagements emails
node {baseDir}/scripts/hubspot.mjs engagements calls
node {baseDir}/scripts/hubspot.mjs engagements tasks
node {baseDir}/scripts/hubspot.mjs engagements meetings

CMS — 博客文章（Blog Posts）

node {baseDir}/scripts/hubspot.mjs blog-posts list
node {baseDir}/scripts/hubspot.mjs blog-posts list --state PUBLISHED
node {baseDir}/scripts/hubspot.mjs blog-posts read --id 1001
node {baseDir}/scripts/hubspot.mjs blog-posts create --name "My Post"
node {baseDir}/scripts/hubspot.mjs blog-posts update --id 1001 --name "Updated Title"

CMS — 页面（Pages）

node {baseDir}/scripts/hubspot.mjs pages list
node {baseDir}/scripts/hubspot.mjs pages read --id 2001

CMS — 域名（Domains）

node {baseDir}/scripts/hubspot.mjs domains list

Marketing — 邮件营销活动（Email Campaigns）

node {baseDir}/scripts/hubspot.mjs email-campaigns list
node {baseDir}/scripts/hubspot.mjs email-campaigns read --id 3001

Marketing — 表单（Forms）

node {baseDir}/scripts/hubspot.mjs forms list
node {baseDir}/scripts/hubspot.mjs forms read --id 4001

Marketing — 营销邮件（Marketing Emails）

node {baseDir}/scripts/hubspot.mjs marketing-emails list
node {baseDir}/scripts/hubspot.mjs marketing-emails read --id 5001
node {baseDir}/scripts/hubspot.mjs marketing-emails stats --id 5001

Marketing — 联系人列表（Contact Lists）

node {baseDir}/scripts/hubspot.mjs lists list
node {baseDir}/scripts/hubspot.mjs lists read --id 6001

Conversations

node {baseDir}/scripts/hubspot.mjs conversations list
node {baseDir}/scripts/hubspot.mjs conversations read --id 7001
node {baseDir}/scripts/hubspot.mjs messages list --thread-id 7001

Automation — 工作流（Workflows）

node {baseDir}/scripts/hubspot.mjs workflows list
node {baseDir}/scripts/hubspot.mjs workflows read --id 8001

安全性

• 认证方式：Bearer Token（Private App）或 OAuth 2.0（支持自动刷新）
• 不向 stdout 输出任何密钥或令牌
• 所有删除操作均需显式指定 --confirm 参数
• 内置限流机制，失败时采用指数退避重试（最多重试 3 次）
• OAuth 令牌缓存路径：~/.cache/openclaw/hubspot-token.json
• 懒加载配置校验（仅在执行命令时触发校验）

依赖项

• commander — CLI 框架
• dotenv — 环境变量加载工具
• Node.js 内置 fetch（要求 Node.js 版本 ≥ 18）

作者

Abdelkrim BOUJRAF — ALT-F1 SRL，布鲁塞尔 🇧🇪 🇲🇦
X（原 Twitter）: @altf1be