# Beav 使用文档

> 从安装桌面端和浏览器插件开始，学习网页访问、素材采集、知识沉淀、内容创作、媒体处理与外部 Agent 接入。

- 原文: https://www.getbeav.com/docs

Beav 是本地优先的 AI 自媒体创作资产工作台。它把网页、评论、图片、视频、本地文件和创作结果保存在同一个工作空间，让素材可以持续被检索、引用和复用。

## 从这里开始

如果是第一次使用，按下面的顺序完成：

1. [安装 Beav 桌面端](https://www.getbeav.com/docs/getting-started/install)。
2. [安装 Chrome / Edge 浏览器插件](https://www.getbeav.com/docs/browser-extension/install)。
3. [保存第一条网页内容](https://www.getbeav.com/docs/getting-started/first-capture)。
4. [把采集内容转成选题和稿件](https://www.getbeav.com/docs/workflows/collect-to-create)。

## 常用入口

| 目标                                | 文档                                               |
| --------------------------------- | ------------------------------------------------ |
| 在浏览器、手机或服务器上使用 Beav               | [网页访问](https://www.getbeav.com/docs/remote-access)                      |
| 通过命令行安装并在本机浏览器使用 Beav             | [安装 Beav CLI](https://www.getbeav.com/docs/getting-started/cli)         |
| 保存网页、小红书、YouTube、图片或选中文字          | [采集网页与平台内容](https://www.getbeav.com/docs/browser-extension/use)         |
| 让 Beav 操作已经登录的真实浏览器页面             | [浏览器控制](https://www.getbeav.com/docs/browser-extension/browser-control) |
| 导入 Eagle 素材库并引用图片                 | [导入和使用 Eagle 素材库](https://www.getbeav.com/docs/workflows/eagle-library) |
| 查看热点并讨论创作角度                       | [浏览热点并发起讨论](https://www.getbeav.com/docs/workflows/hotspots)            |
| 生成封面、图片、视频或音频                     | [图片、视频与音频](https://www.getbeav.com/docs/workflows/media)                |
| 调用第三方 API 或自动化固定处理流程              | [环境变量与脚本](https://www.getbeav.com/docs/workflows/reusable-scripts)      |
| 让 Codex、Hermes 或 OpenClaw 使用 Beav | [连接外部 Agent](https://www.getbeav.com/docs/agent/connect)                |
| 处理安装、连接或长任务问题                     | [常见问题](https://www.getbeav.com/docs/troubleshooting)                    |

## Beav 如何组织创作

浏览器插件和本地导入负责把素材送进工作空间。知识库、媒体库和主体库保存可以长期复用的内容；选题和稿件帮助你把素材变成具体内容；图片、视频和音频结果会继续回到媒体库。

外部 Agent 连接 Beav 后，也应沿用这条路径：先读取真实素材和当前任务，再根据创作要求生成稿件或媒体，最后把结果保存回 Beav，而不是只在聊天里留下无法复用的一段文字。

## 数据与权限

Beav 默认在本机保存工作空间数据。浏览器采集、媒体生成和第三方模型调用会按用户发起的操作访问对应页面或服务。外部 Agent 的付费生成、浏览器控制、删除、发布和外部导出需要审批；详细规则见[能力与审批](https://www.getbeav.com/docs/agent/capabilities-and-approvals)。

## 开发小工具

小工具是安装在 Beav 中的本地 Mini App。它可以保存独立界面状态，并在用户授权后调用采集、知识库、资产库、媒体处理、AI 和自动化能力。

[查看小工具开发指南](https://www.getbeav.com/docs/mini-app-development)，了解包结构、`window.redbox` SDK、全部能力名称、安全边界和发布检查清单。