面向房产经纪人的 GHL CRM:GoHighLevel API 自动化 - Openclaw Skills

作者:互联网

2026-03-30

AI教程

什么是 面向房产经纪人的 GHL CRM?

面向房产经纪人的 GHL CRM 技能在 AI 代理与 GoHighLevel (GHL) 生态系统之间架起了一座强大的桥梁。该技能专为房地产行业设计,使开发人员和经纪人能够自动化核心 CRM 功能,如线索录入、流水线阶段移动和直接消息传递。通过利用 Openclaw Skills,用户可以将手动数据录入转变为高效的脚本驱动工作流,直接与 GHL API v2 交互。

此技能确保房产经纪人可以专注于成交,而不是管理软件。它处理复杂的任务,如搜索重复联系人、管理日历空闲时间,并以高精度和开发者友好的控制方式将线索加入自动化培育序列。

下载入口:https://github.com/openclaw/skills/tree/main/skills/danielfoch/ghl-crm-for-realtors

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install ghl-crm-for-realtors

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 ghl-crm-for-realtors。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

面向房产经纪人的 GHL CRM 应用场景

  • 自动化新线索录入,防止重复条目并应用 Zillow 或 Open House 等来源标签
  • 根据交易进展在流水线阶段中移动房地产潜在客户
  • 通过检索空闲时段并直接在 GHL 日历上安排来管理客户预约
  • 发送并跟踪会话线程中的后续消息,以保持线索参与度
  • 将联系人加入高转化率的营销工作流,进行长期培育
面向房产经纪人的 GHL CRM 工作原理
  1. 该技能通过验证 HIGHLEVEL_TOKEN 和 LOCATION_ID 环境变量进行初始化。
  2. 执行设置向导以测试连接性并确保 API 环境配置正确。
  3. AI 代理利用辅助脚本将自然语言请求转换为 GHL API v2 命令。
  4. 获取联系人、流水线或日历的实时数据,为请求的操作提供上下文。
  5. 执行写入操作(如创建联系人或更新商机),并进行安全检查以确保数据完整性。

面向房产经纪人的 GHL CRM 配置指南

要在 Openclaw Skills 框架内开始使用此技能,请设置您的环境变量:

export HIGHLEVEL_TOKEN="your_private_integration_token"
export HIGHLEVEL_LOCATION_ID="your_sub_account_id"

运行配置向导:

python3 scripts/setup-wizard.py

使用主 API 脚本执行房产经纪人命令:

python3 scripts/ghl-api.py  [args...]

面向房产经纪人的 GHL CRM 数据架构与分类体系

该技能将房产经纪人数据组织为几个功能域:

领域 描述
联系人 包括身份数据、自定义字段和来源标签(例如:买家、卖家)。
商机 在 GHL 中跟踪交易状态、流水线阶段和线索价值。
会话 管理消息历史记录和外呼通信日志。
日历 存储预约排程的元数据和空闲时间。
工作流 将联系人 ID 映射到特定的自动化触发器和加入状态。
name: ghl-crm-for-realtors
description: Use this skill for GoHighLevel CRM work for realtors: contact lookup and updates, opportunity/pipeline actions, conversation messaging, calendar slots, and workflow enrollment using GoHighLevel API v2.

GHL CRM for Realtors

Use this skill when a user wants realtor CRM actions in GoHighLevel (GHL), including lead follow-up, pipeline movement, appointment booking context, and messaging workflows.

Required Environment

Set these variables before running the scripts:

  • HIGHLEVEL_TOKEN (Private Integration token)
  • HIGHLEVEL_LOCATION_ID (sub-account location ID)

Optional runtime variables:

  • PYTHONUNBUFFERED=1

Setup

If the user asks to connect or set up GHL, run:

python3 scripts/setup-wizard.py

The wizard validates credentials and tests API connectivity.

Primary Script

Use the helper script for direct actions:

python3 scripts/ghl-api.py  [args...]

Common commands for realtor workflows:

  • test_connection
  • search_contacts [query]
  • get_contact [contact_id]
  • create_contact [json]
  • update_contact [contact_id] [json]
  • list_opportunities
  • list_pipelines
  • list_conversations
  • send_message [contact_id] [message]
  • list_calendars
  • get_free_slots [calendar_id] [start_date] [end_date]
  • list_workflows
  • add_to_workflow [contact_id] [workflow_id]

Realtor-Focused Playbooks

New Lead Intake

  1. search_contacts to prevent duplicates.
  2. If not found, create_contact with source tags (for example: buyer, zillow, open-house).
  3. Add next-step task/note using supported contact endpoints.

Pipeline Progress

  1. list_opportunities to inspect active deals.
  2. Move stage using the opportunity update command path in ghl-api.py.
  3. Confirm stage and status in response payload.

Follow-Up Messaging

  1. Resolve contact first (search_contacts or get_contact).
  2. Send message with send_message.
  3. Re-check conversation history with list_conversations.

Appointment Assist

  1. list_calendars
  2. get_free_slots for date range.
  3. Use the calendar endpoints in script for appointment creation if requested.

Safety Rules

  • Never print or echo raw tokens in chat output.
  • Prefer dry informational reads before write actions when intent is ambiguous.
  • Validate contact/opportunity IDs from GHL responses instead of guessing.
  • If an API error returns 401/403, stop and ask for corrected scopes or token.

References

Load these only as needed:

  • references/contacts.md
  • references/opportunities.md
  • references/conversations.md
  • references/calendars.md
  • references/troubleshooting.md