name: ghl-open-account
description: 引导代理完成 GoHighLevel (GHL) 开发者账户开通、市场应用创建以及 OAuth 连接。当用户或代理需要注册 GHL、创建 GHL 应用、获取 API 凭证或将 clawdbot/moltbot/open claw 连接到 GoHighLevel 时使用。
GoHighLevel 开通账户指南
快速开始
- 确保用户已拥有（或将要创建）一个 GoHighLevel 账户（注册免费试用）；创建应用需使用开发者市场。
- 如需创建应用并获取凭证，请遵循“创建应用”部分。
- 如需通过 OAuth 连接子账户或代理机构，请参阅“OAuth 2.0 与 API 访问”部分及 reference.md。
开通 GoHighLevel 账户
当用户需要开通或注册 GoHighLevel 账户时（创建应用或使用 API 前必需），使用此流程。
检查清单：
- [ ] 打开 GoHighLevel 注册页面：开始 14 天免费试用
- [ ] 注册或登录（根据情况使用“注册”/“登录”）。
- [ ] 完成注册（如有提示，请验证邮箱）。
- [ ] 如需创建应用和 API 访问，请前往 开发者市场，并在准备好后使用我的应用。
步骤：
- 访问 https://www.gohighlevel.com/?fp_ref=thatsop12 开始免费试用或注册。
- 点击注册（如果用户已有账户，则点击登录）。
- 输入所需信息（邮箱、密码等）并提交。
- 如果平台发送了验证邮件，请让用户验证其邮箱。
- 登录后，用户即拥有 GoHighLevel 账户。如需创建应用并获取 API 凭证，请使用 开发者市场 中的我的应用（见下文“创建应用”）。
创建应用
用户拥有开发者账户后，使用此流程。创建应用将生成 OAuth 和 API 访问所需的 Client ID 和 Client Secret。
检查清单：
- [ ] 在市场平台中，进入我的应用并点击创建应用。
- [ ] 设置应用名称（例如“我的集成”）。
- [ ] 设置应用类型：私有（内部/个人使用）或公开（市场分发）。
- [ ] 设置目标用户：通常选择子账户（适用于大多数集成）。
- [ ] 设置安装权限：建议选择代理机构与子账户。
- [ ] 如适用，设置上架类型（例如，代理机构可选择白标）。
- [ ] 保存并从应用设置中获取 Client ID 和 Client Secret。
- [ ] 将凭证存储在环境变量或密钥管理器中；切勿将其提交到技能或代码仓库。
步骤：
- 登录 开发者市场，打开我的应用。
- 点击创建应用。
- 填写应用名称。
- 选择应用类型：私有（单用户/内部使用）或公开（可在市场上架）。
- 选择目标用户：通常选择子账户，以便子账户可以安装该应用。
- 将安装权限设置为代理机构与子账户，除非特定用例另有要求。
- 如果为代理机构构建，请设置上架类型（例如白标）。
- 保存应用。在应用的设置/详情页面，复制 Client ID 和 Client Secret。
- 安全提示： 将 Client ID 和 Client Secret 存储在环境变量（例如
GHL_CLIENT_ID、GHL_CLIENT_SECRET）或安全的密钥管理器中。切勿将其放入代码、版本控制中的配置文件或此技能中。
OAuth 2.0 与 API 访问
当集成需要连接到用户的 GHL 子账户或代理机构时（例如，访问其 CRM、联系人、日历），使用 OAuth 2.0。用户授权您的应用后，您的应用将获得代表其调用 API 的令牌。
需要 OAuth 的场景：
- 将 clawdbot、moltbot、open claw 或任何代理连接到特定的 GoHighLevel 子账户或代理机构。
- 最终用户点击“连接到 GoHighLevel”并授予访问权限的任何流程。
套餐要求： 高级 API 访问（包括 OAuth 2.0）仅在 Agency Pro 套餐中提供。基础 API 访问包含在 Starter 和 Unlimited 套餐中；如需使用 OAuth 和完整 API 功能，账户需要升级到 Agency Pro。套餐对比详情请参阅 reference.md。
官方文档：
重定向/回调与权限范围： 在开发者市场的应用中配置一个重定向 URI；用户授权后，GHL 将携带一个授权码重定向到该 URI。用此授权码换取访问令牌（和可选的刷新令牌）。仅请求您的应用所需的权限范围；有关权限范围列表及如何在授权 URL 中传递，请参阅 OAuth 文档。
示例
示例 1 – 用户希望将其机器人连接到 GHL
- 用户说：“我需要将 moltbot 连接到我的 GoHighLevel 账户。”
- 代理应用此技能：确认用户拥有 GHL 账户；如果没有，则引导完成“开通 GoHighLevel 账户”。然后指导用户在开发者市场“创建应用”以获取 Client ID/Secret。对于实际连接（moltbot → 其子账户），遵循“OAuth 2.0 与 API 访问”部分，使用应用凭证运行 OAuth 流程；并安全存储令牌。
示例 2 – 用户首次希望开通 GHL 账户
- 用户说：“帮我开通一个 GoHighLevel 账户，以便我构建一个集成。”
- 代理应用此技能：引导完成“开通 GoHighLevel 账户”（使用推广注册链接、注册、验证）。然后提供下一步建议：当用户准备好获取 API 凭证时，可在开发者市场“创建应用”。
附加资源