# Ally Claw 使用指南

# 概览

**Ally Claw（AllyClaw）** 是基于 OpenClaw 的 AI 营销伙伴。它为团队提供独立工作空间，可通过聊天诊断表现变化，获取以利润为先的行动建议。

本指南介绍 ecom-attribuly-v3 中面向客户的体验：状态页 `/ally-claw` 和聊天页 `/ally-claw/chat`。

# 开始前的准备

1. 工作空间使用 **Pro** 或 **Enterprise** 套餐。
2. 团队能访问左侧 **Ally Claw** 页面。
3. 拥有足够对话额度，聊天会消耗额度。

若套餐不包含 AllyClaw，会显示 **Upgrade Required**，可点击按钮进入 Billing。

# 访问 Ally Claw

打开应用，在左侧导航点击 Ally Claw，查看工作空间状态。若已就绪，系统可能自动打开聊天页面。

# 状态页展示什么

页面帮助你确认工作空间是否已开通，以及当前能否开始聊天。

## 当前状态

- **Not created**：组织尚未创建 AllyClaw 实例。
- **Creating**：实例正在创建。
- **Syncing**：系统正在刷新实例状态。
- **Ready**：实例可用。
- **Blocked**：实例存在但尚不可用。
- **Multiple Claws detected**：组织有多条实例记录，请联系支持清理。

## 工作空间设置

- **Loaded / Setup complete**：设置看起来已完成。
- **Missing / Setup incomplete**：必要设置尚未完成，可尝试刷新。
- **Unavailable / Waiting**：实例仍在创建。

## 聊天访问状态

此区域显示能否打开聊天，不展示连接详情。

- **Ready**：可以进入聊天。
- **Loading**：正在检查聊天是否就绪。
- **Error**：无法确定聊天入口。
- **Unavailable / Waiting**：工作空间尚未就绪。

## 热门问题（前 10 个）

页面可能展示常用营销分析问题。点击 **Copy prompt** 可复制到其他地方，点击 **Use in chat** 可直接发送至 AllyClaw Chat。

# 激活工作空间

状态为 Not created 时：

1. 点击 **Create Claw**。
2. 等待创建实例，可能需要几分钟。
3. 页面会自动刷新状态，也可点击 **Refresh status**。

创建过程中可能显示 Creating 或 Syncing。

# 进入聊天

Claw status 为 **Opened / Ready**，且 Chat access 为 **Ready** 时，点击 **Enter chat** 打开 `/ally-claw/chat`。

# 使用 AllyClaw Chat

## 基本聊天流程

1. 在 **Ask AllyClaw anything...** 输入框中填写问题。
2. 点击 **Send**。
3. 回答会实时流式显示。
4. 如需停止生成，点击 **Stop**。

## 对话历史

Conversation history 面板支持切换历史对话。点击 **New chat** 开始新对话。

## 内置快捷提示

可使用“上周表现如何？”“昨天表现如何？”“运行漏斗分析”“分析着陆页表现”等快捷提示，快速开始常见分析。

## 退出聊天

点击 **Exit chat** 断开连接，返回状态页。

# 归还 Claw：移除工作空间

1. 打开 `/ally-claw`。
2. 点击 **Return Claw**。
3. 确认提示。

系统会提交终止请求并移除实例记录。再次聊天前需要创建新的 Claw。

# 排查问题

## Upgrade Required

套餐不包含 AllyClaw。请在 Billing 升级至 Pro 或 Enterprise。

## 聊天不可用或连接失败

1. 返回 `/ally-claw`，点击 **Refresh status**。
2. 使用 **Enter chat** 重新打开聊天。
3. 若显示 **Authentication failed**，重新打开 Ally Claw 后重试。

## Multiple Claws detected

组织存在多条 AllyClaw 实例记录。请联系支持并提供组织或团队信息，以便清理多余记录。

## 设置显示 Missing / Setup incomplete

通常表示实例或设置尚未完全完成。稍等后点击 Refresh status；如果长时间仍缺失，请联系支持。

# 常见问题

## 会向用户展示连接详情或令牌吗？

不会。状态页只显示能否打开聊天，进入聊天时由系统处理连接详情。

## 为什么 Creating 或 Syncing 会持续一段时间？

系统正在创建和验证实例。根据基础设施负载，可能需要几分钟。

## 聊天会消耗额度吗？

会。对话使用现有额度。

# 版本

| 版本 | 日期 | 说明 |
| --- | --- | --- |
| 1.0 | 2026-04-30 | 首版英文用户指南草稿 |