完整的HubSpot平台CLI——CRM联系人/公司/交易/工单、CMS博客文章/页面、营销邮件/表单/列表、对话、自动化工作流。
HubSpot by @altf1be.
功能概述
HubSpot by @altf1be.是一项面向实际任务的技能，主要用于Full HubSpot 平台 CLI 覆盖 CRM, CMS, 营销, 对话, 和自动化.；Setup. 在 HubSpot 创建一个私人 App: 设置 > 集成 > 私人 Apps.；
核心要点
- Set envir。
- 它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
- 使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
使用与执行
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。
结果检查与注意事项
执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。
HubSpot（作者：@altf1be）
覆盖 CRM、CMS、Marketing、Conversations 和 Automation 全模块的 HubSpot 平台命令行工具（CLI）。
安装配置
- 在 HubSpot 中创建一个 Private App：设置（Settings）> 集成（Integrations）> Private Apps
- 设置环境变量（或在
{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
- 在 HubSpot 中为该 Private App 配置必需的 权限范围（Scopes）（设置（Settings）> 集成（Integrations）> Private Apps > 你的应用 > Scopes）：
| 权限范围（Scope） | 说明 |
|---|---|
crm.objects.contacts.read |
查看联系人（contacts）的属性及其他详细信息 |
crm.objects.contacts.write |
创建、删除或修改联系人 |
crm.objects.companies.read |
查看公司（companies）的属性及其他详细信息 |
crm.objects.companies.write |
创建、删除或修改公司 |
crm.objects.deals.read |
查看交易（deals）的属性及其他详细信息 |
crm.objects.deals.write |
创建、删除或修改交易 |
crm.objects.owners.read |
查看分配给 CRM 记录的用户详情 |
crm.schemas.contacts.read |
查看联系人属性设置的详细信息 |
crm.schemas.companies.read |
查看公司属性设置的详细信息 |
crm.schemas.deals.read |
查看交易属性设置的详细信息 |
tickets |
查看、创建、删除或修改工单（tickets） |
automation |
工作流（Workflows） |
content |
网站（Sites）、落地页（Landing Pages）、CTA、邮件（Email）、博客（Blog）、营销活动（Campaigns） |
conversations.read |
查看消息、评论、会话线程（threads）、收件人/用户/分配详情 |
forms |
访问表单（Forms）API |
- 安装依赖项：
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
热门AI工具
相关专题
本专题聚焦Go-Zero的API开发，拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则，说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式，并给出网关聚合与接口测试的实践建议。
0
2026.11.12
本专题围绕Go-Zero的安装与工具链配置展开，讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置，说明多版本共存、升级回退与CI流水线安装的做法，并整理安装阶段的常见报错与验证步骤。
0
2026.11.12
本专题整理Go-Zero的入门知识，从框架定位、环境准备到跑通第一个API服务，讲清目录分层、配置加载、日志与中间件的基本用法，并对比Gin、Kratos的差异，帮助Go开发者建立整体认知，判断它是否适合当前项目。
0
2026.11.12
本专题从实际API接口调试场景出发，讲解Postman身份认证的完整配置流程，包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查，帮助用户正确完成接口授权与访问验证。
0
2026.11.06
围绕Postman HTTP请求头配置展开，讲解Headers选项的具体使用方式，包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法，帮助用户解决接口调试过程中遇到的请求头配置问题。
0
2026.11.06
详细介绍Postman接口请求的创建与发送方法，涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看，帮助用户掌握Postman接口请求的完整操作流程。
0
2026.11.06
DBeaver数据导入专题，整理Excel、CSV、SQL、TXT等常见文件的数据导入方法，涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作，帮助用户将本地文件中的数据写入数据库，并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。
0
2026.11.05
DBeaver安全防护专题，围绕数据库连接安全、账号密码保护和访问权限管理展开，整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法，同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项，帮助用户提高数据库日常管理的安全性。
0
2026.11.05
本专题聚焦DBeaver数据库连接配置与管理，覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库，整理相应的连接设置方法，并提供驱动缺失、认证失败和连接异常等问题的排查方向。
0
2026.11.04
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.8万人学习
共6课时 | 54.7万人学习
最新文章
