GoRabbit 使用文档

项目定位

GoRabbit 是一款本地优先的 AI Agent 桌面应用。当前版本已经不再只是“聊天 + 角色 + 记忆”的轻量客户端，而是围绕 Chat、Skill、Agent、Workflow、Knowledge、Integration、MCP 形成了一套完整的桌面 AI 工作台。

你可以把它理解为：

一个可切换多模型的桌面 AI 对话入口
一个可安装技能、创建智能体、编排工作流的本地 Agent 平台
一个能接入钉钉、飞书、企微、Telegram、Slack、Discord 的消息枢纽
一个带知识库、记忆、任务调度、工具审批和数据备份能力的生产力容器

当前版本亮点

Chat 三种协作模式：支持 单 Agent、自动调度、Decade 模式，复杂任务可拆成多智能体步骤执行
@ 提及智能体：在输入框中直接 @AgentName，快速点名某个 Agent 参与当前任务
附件能力升级：支持文件选择上传、剪贴板粘贴上传、图片本地预览、文本附件预览，单文件当前限制为 50MB
工具执行更透明：聊天区可实时看到工具调用卡片、审批状态、任务规划卡片、工作流执行进度
自主操作开关：可按会话开启“自主操作”，让工具执行减少人工审批干预
技能体系更完整：支持查看已安装技能、启停技能、导入 SKILL.md / 技能文件夹，并接入 Skills Hub
Agent Studio 已成型：支持创建、编辑、启停、删除本地 Agent，也可从 Agent Hub 或链接直接安装
工作流可视化编排：支持 开始 / Webhook / Agent / 技能 / 条件 / 结束 节点，运行后可查看执行轨迹
知识库已接入检索链路：支持手工录入知识、训练 .txt / .md / .markdown / .docx 文件，并向量化入库
集成中心统一化：消息平台集成、MCP 扩展接入、机器人启动与主动推送集中在同一页面管理
设置项显著扩展：支持主题预设、语言切换、顶部时钟、托盘驻留、存储根目录、自学习、默认模型、数据导入导出

开发者可玩性与 CoPaw / OpenClaw 对比

说明：以下对比基于 2026-03-08 当前 GoRabbit 仓库能力，以及 CoPaw / OpenClaw 官方公开文档，偏重开发者体验、扩展入口与产品化可玩性视角，不代表绝对优劣。

GoRabbit 对开发者更“可玩”的地方

可视化拼装链路更完整：从 Chat、角色、技能、Agent、工作流、知识库、集成、MCP 到安全检测，基本都能在桌面界面里直接配置、串联和观察结果
试错成本更低：设置向导、模型页、Agent 页、Workflow 页、调度页都已打通，适合快速进行“改配置 → 运行 → 看结果 → 继续调优”
内置资源更适合直接改造：仓库已经附带角色模板、技能资源、Agent 资源与示例工作流，开发者可以从“改现成能力”开始，而不是完全从零搭脚手架
Chat 与自动化不是割裂的：对话里可直接 @Agent、查看工具调用卡片、审批状态和规划步骤，再把稳定流程沉淀成工作流或调度任务
Channels 也已具备：虽然 GoRabbit 不是用单独的 channels 页面命名，但集成中心已经可以把钉钉、飞书、企微、Telegram、Slack、Discord 这些外部消息入口作为实际可用的对外 channels 来接入、推送和联动 Agent
支持自学习强化：设置中心已经提供自学习开关、学习频率、最近学习状态与手动触发能力，可让系统按周期从已有对话与运行数据中提炼记忆，持续强化自己的工作表现
本地优先但不封闭：既能接主流模型供应商，也能接本地 Ollama、外部 channels、MCP 与知识库，更像一个开发者自己的 AI 工作台
更适合做产品化原型：如果你不只是想“跑一个 Agent”，而是想快速验证 Agent 产品界面、协作链路、审批与交付体验，GoRabbit 更接近可以直接演示和持续迭代的产品形态

与 CoPaw、OpenClaw 的侧重点差异

维度	GoRabbit	CoPaw	OpenClaw
产品形态	本地优先桌面 AI 工作台，强调可视化操作与一站式编排	个人 Agent Workstation，强调多渠道接入、本地模型与模块化架构	以 Gateway 为中心的个人 AI Agent 平台，强调 channels、sessions、hooks 与 workspace 扩展
开发者上手方式	更偏界面化，适合快速拼装、演示、迭代	安装路径轻，`pip` / `Docker` / 一键脚本都比较直接	更偏 `Gateway + CLI + workspace` 思路，上手后扩展面很强
主要扩展入口	Skill、Agent、Workflow、MCP、知识库、集成中心	模块化 Agent 架构、技能系统、通道注册表、长期记忆、heartbeat	`SKILL.md`、Hooks、Webhooks、ClawHub、Gateway Protocol、WebChat
Channels / 外部通道	已通过集成中心支持钉钉、飞书、企微、Telegram、Slack、Discord 等对外消息通道	多渠道接入是核心优势之一	channels 是核心设计概念之一
自学习能力	已内置自学习开关、周期学习、状态查看与手动触发，适合持续强化记忆与行为表现	更强调长期记忆与常驻运行机制	更强调 hooks、sessions、workspace 驱动下的扩展与编排
自动化组织方式	Chat、工作流、调度中心三者串联	技能 + `cron` + heartbeat 机制	Hooks / Webhooks / Gateway 事件驱动
适合的开发目标	快速做 AI 产品原型、桌面工作台、企业内用助手与可视化流程	做多渠道个人助手，并保留较强框架模块化自由度	围绕渠道、Gateway、Hook、workspace 做更深的 Agent 定制
可玩性特点	强在“看得见、点得动、能组合、能马上验证”，同时兼顾 channels 接入与自学习强化	强在“模块化、轻部署、多渠道、长期运行”	强在“控制平面、技能生态、事件扩展、远程通道接入”

一句话理解

如果你想快速“玩出一个完整 AI 产品原型”，同时保留 channels 接入和自学习强化能力：GoRabbit 会更顺手
如果你想做多渠道个人助手，并保留较强框架模块化：CoPaw 很值得参考
如果你想围绕 Gateway、技能注册表、Hook 与消息通道做深度折腾：OpenClaw 会更有代表性

系统要求

项目	建议要求
操作系统	Windows 10+、macOS 10.15+、主流 Linux 桌面环境
Node.js	18 或以上（源码运行时）
包管理器	推荐 `pnpm` 8+
内存	至少 4 GB，复杂多 Agent / 工作流任务建议 8 GB+
磁盘	至少 1 GB 可用空间（含模型配置、日志、导出文件、附件）
网络	使用云端模型、在线 Skills/Agent Hub、Webhook/MCP 时需要网络

如果你主要使用 Ollama 本地模型、本地知识库和本地技能，GoRabbit 可以在离线或弱联网环境下工作，但外部模型与在线注册表功能仍依赖网络。

安装与启动

方式一：直接安装发行包

如果项目已经提供打包产物，可直接安装对应平台包：

Windows：.exe
macOS：.dmg
Linux：.AppImage

方式二：从源码启动

# 1. 安装依赖
pnpm install

# 2. 启动开发环境
pnpm dev

# 3. 构建桌面端资源
pnpm build

# 4. 进行类型检查
pnpm typecheck

# 5. 打包发行版
pnpm package:win
pnpm package:mac
pnpm package:linux

构建相关补充

pnpm prepare:build-assets：生成安装包图标、安装页素材
打包配置位于 electron-builder.json5
Web / Main / Preload 三层代码分别位于 src/renderer、src/main、src/preload

5 分钟快速开始

第 1 步：先完成设置向导

首次进入建议先打开 设置向导，跑一遍运行环境检查，确认依赖、网络、文件权限、数据库状态都正常。

第 2 步：配置模型供应商

进入 模型配置 页面，添加一个可用模型提供商：

选择类型：OpenAI / Claude / DeepSeek / Ollama / 自定义
填写名称、Base URL、API Key、模型列表
测试连接
保存并激活

第 3 步：设置默认模型

进入 设置中心，在“默认模型”处选择默认模型，后续新对话会更顺手。

第 4 步：开始对话

进入 Chat 页面后可：

新建会话
选择角色
选择协作模式：单 Agent / 自动调度 / Decade
输入问题并发送

第 5 步：体验增强能力

建议依次尝试：

在输入框中 @ 提及某个 Agent
上传一张图片或一份文档作为上下文
安装一个技能或 Agent
在知识库中训练一批 Markdown / Docx 文件
配置飞书或钉钉机器人，把结果推送到外部会话

页面与功能详解

首次启动与设置向导

设置向导负责检测当前运行环境，并对部分问题提供一键修复。

检测项	说明	是否支持自动修复
Node.js 运行时	检查运行时是否正常	否
依赖完整性	检查应用依赖是否齐全	是
网络连接	检查基础联网能力	否
DNS 解析	检查域名解析能力	否
磁盘空间	检查本地剩余空间	否
文件权限	检查读写权限	是
数据库	检查本地数据库可用性	是
代理设置	检查代理环境影响	否

当前页面还会展示系统信息，例如：

平台与架构
运行环境版本
总内存 / 可用内存
CPU
主机名与运行时间

适合场景：

第一次启动应用
打包后在新机器上部署
遇到“连接正常但功能异常”时做基础排查

Chat 对话工作台

Chat 是 GoRabbit 当前最核心、功能最完整的页面。

1. 会话与消息能力

支持多会话列表管理
支持会话重命名、删除
历史消息按分页加载，长对话不会一次性全部渲染
AI 回复支持流式输出
支持中断生成
消息支持 Markdown 渲染与代码高亮
支持消息复制与“重新生成”

2. 三种协作模式

模式	说明	适合场景
单 Agent	普通单轮 / 多轮对话模式	日常问答、写作、翻译、编程辅助
自动调度	系统自动挑选 1 个或多个 Agent 协作	中等复杂任务、需要多视角分析
Decade 模式	更偏向任务拆解、多角色协同和步骤规划	复杂任务、长链路执行、需要明确分工

当你启用 自动调度 或 Decade 模式 时：

系统会尝试生成任务计划
聊天区会出现任务规划卡片
执行期间会同步展示步骤状态
相关历史也会进入 调度中心 页面

3. @ 提及 Agent

输入框支持 @ 提及已安装 Agent：

输入 @ 后会弹出可提及智能体列表
可用上下方向键选择，按 Enter 插入
适合在当前会话中点名某个 Agent 处理特定部分任务

4. 工具调用与审批

聊天区可直接看到工具执行过程：

工具调用卡片
审批 / 拒绝入口
工具返回结果
长任务面板（运行时长、待审批数、最近日志）

如果工具停在“等待工具审批”，通常说明当前会话未开启自主操作，或工具属于需要人工确认的执行链路。

5. 自主操作

每个会话都可以单独切换 自主操作：

关闭时：高风险工具更适合逐次确认
开启时：更适合长任务、批量操作、多 Agent 协同

建议先在熟悉工作流后再长期开启自主操作，尤其是涉及文件、Shell、Webhook 和外部系统调用的场景。

6. 附件与输入能力

当前 Chat 支持以下附件能力：

点击按钮选择文件上传
打开附件面板管理待发送文件
直接粘贴图片或文件到输入框
图片附件本地预览
文本附件支持局部预览
二进制文件支持打开原文件

当前已知规则：

单文件大小限制为 50MB
常见文本、代码、JSON、YAML、CSV、Markdown 文件都可预览
图片支持常见格式：PNG / JPG / JPEG / GIF / WebP / SVG / BMP

7. 输入小技巧

Enter：发送消息
Shift + Enter：换行
@：提及智能体
支持粘贴图片 / 文件直接上传

模型配置

模型配置页负责统一管理不同供应商与模型列表。

支持的供应商类型

类型	说明
OpenAI	官方 OpenAI 接口
Claude (Anthropic)	Anthropic 接口
DeepSeek	DeepSeek 官方接口
Ollama (本地)	本地模型服务
自定义	任意兼容接口

当前页面可完成的操作

添加供应商
编辑供应商
删除供应商
测试连接
激活 / 切换活跃供应商

关键字段说明

字段	说明
名称	页面显示名称，例如 `My OpenAI`
类型	供应商类型
Base URL	API 根地址
API Key	认证密钥；Ollama 可不填
模型列表	当前 UI 使用逗号分隔输入

常见预设地址

供应商	常见地址
OpenAI	`https://api.openai.com/v1`
Claude	`https://api.anthropic.com`
DeepSeek	`https://api.deepseek.com/v1`
Ollama	`http://localhost:11434/v1`

角色管理

角色页负责维护 System Prompt 风格与角色模板。

当前页面能力

查看内置角色模板
创建自定义角色
编辑自定义角色的系统提示词
删除自定义角色
导出角色为 Markdown

当前仓库内置角色模板（10 个）

名称	定位
通用助手	多任务通用 AI 助手
编程助手	编码、调试、架构建议
翻译专家	多语言翻译与润色
写作助手	文案、长文、编辑改写
数据分析专家	Excel / SQL / Python 数据分析
产品经理	需求分析、用户故事、PRD
运维专家	Linux、CI/CD、部署、容器
设计顾问	UI / UX、交互与视觉建议
教育导师	学习规划、讲解、辅导
学术研究员	研究设计、综述、学术写作

使用说明

角色的核心是 系统提示词
当前编辑器支持用 Markdown 维护提示词内容
角色适合定义“长期稳定的输出风格或工作方式”

关于导入

当前角色页已经保留导入入口，但本版本稳定可用的主流程仍以：

使用内置模板
新建自定义角色
编辑已有角色
导出角色

为主。

如果你需要批量迁移角色，建议暂时以“导出 Markdown → 本地保存 → 后续再导入”的方式管理模板资产。

记忆管理

记忆页用于查看和维护多层级记忆。

记忆层级

层级	用途
`conversation`	当前对话上下文相关记忆
`session`	会话级摘要或阶段记忆
`semantic`	事实、知识、长期语义记忆
`user_profile`	用户偏好、习惯、固定要求
`global`	全局通用信息

当前页面能力

按层级筛选记忆
搜索记忆内容
手动新增记忆
删除单条记忆

适合写进记忆的内容

用户固定偏好
长期反复出现的业务背景
某个项目约定俗成的输出格式
需要跨会话复用的事实性信息

不建议与知识库混用的情况

记忆更适合短小、稳定、偏事实或偏用户偏好
知识库 更适合文档、手册、长文本、报告、制度、FAQ 等资料型内容

技能模块

技能模块现在由两个部分组成：

已安装技能
Skills Hub

1. 已安装技能

当前已安装技能页支持：

查看已安装技能列表
启用 / 停用技能
导入单个 SKILL.md
导入一个技能文件夹
查看技能版本、工具数量、System Prompt、加载时间

对本地维护技能来说，这一页是最常用入口。

2. Skills Hub

Skills Hub 当前聚合了四类来源：

来源	说明
内置	随应用打包提供
自建	你本地维护的技能
推荐	项目内置的推荐技能包定义
在线	远程技能注册表

当前支持的安装方式：

从 Skills Hub 卡片安装 / 卸载
从链接安装技能
支持 owner/repo
支持 GitHub URL
支持原始 SKILL.md 链接

3. 当前仓库内置技能资源

当前 resources/skills/ 内置 8 个技能目录：

code-assistant
data-analyst
desktop-assistant
ppt-assistant
research-assistant
system-helper
task-runner
web-browser

此外，代码中还定义了 13 个推荐技能包，例如：

翻译助手
文案写作
周报生成器
代码审查
SQL 生成器
API 文档生成
邮件撰写
会议纪要
思维导图
面试助手
Excel 公式
正则助手
Remotion 视频制作

4. 什么时候该用技能？

如果你的需求是“固定方法 + 固定提示词 + 可复用”，优先建技能。典型场景包括：

周报生成
API 文档输出
SQL / 正则 / Excel 公式生成
Remotion 视频脚本与参数整理

Agent 中心

Agent 中心已经从简单的“角色集合”升级为完整的 Agent Studio + Agent Hub。

1. 本地 Agent 管理

你可以在本地创建并维护自己的 Agent，当前可配置内容包括：

名称
描述
分类
图标
System Prompt
关联技能（以技能 ID 绑定）
最大迭代次数
超时秒数

当前表单校验规则：

最大迭代数：1 ~ 50
超时范围：30 ~ 600 秒

同时支持：

启用 / 停用 Agent
编辑 Agent
删除 Agent

2. Agent Hub

Agent Hub 当前同样整合四类来源：

来源	说明
内置	随应用打包提供
自建	本地维护
预置推荐	内置推荐 Agent 包
在线	远程注册表

支持操作：

直接安装 / 卸载
从链接安装 Agent
将安装结果回写到本地 Agent 列表

3. 当前仓库内置 Agent 资源

当前 resources/agents/ 包含 5 个内置 Agent：

code-agent
data-agent
ppt-agent
research-agent
task-agent

代码中还定义了 8 个推荐 Agent 包，包括：

项目经理
全栈工程师
内容创作者
学习教练
办公助手
技术文档专家
数据科学家
运维专家

4. 什么时候该用 Agent？

如果你的需求是“一个具备明确职责、技能组合和执行策略的智能体”，优先建 Agent。典型场景：

代码审查 Agent
研究 Agent
视频 Agent
合同 Agent
财务 Agent

在 Chat 中，Agent 可以通过：

手工选择参与协作
@ 提及
自动调度
Decade 模式拆解

进入执行链路。

工作流编排

工作流页提供可视化编排能力，适合“固定流程、多步骤任务、需要回放或复用”的场景。

当前支持的节点类型

节点	作用
开始	工作流起点
Webhook	接收外部触发事件
Agent	由某个 Agent 执行推理任务
技能	调用技能能力
条件	进行条件分支判断
结束	工作流终点

当前页面能力

新建工作流
编辑工作流名称与描述
从左侧节点库拖拽节点到画布
保存、删除工作流
运行工作流
查看每次运行的步骤状态与错误细节
比较当前草稿与已保存版本

已内置的示例工作流

当前仓库初始化时会注入 3 个示例流程：

代码审查与优化
研究报告生成
AI + Remotion 视频生产线

与 Chat 的关系

工作流不只是独立页面：

Chat 可以触发工作流相关工具
工作流运行结果会同步到 调度中心
Webhook 节点适合与 集成中心 联动

适合场景

稳定的内容生产流程
多步骤报告生成
AI + 媒体资产生产链路
需要条件分支的业务自动化

调度中心

调度中心是当前版本新增后非常关键的全局可视化页面，用于统一查看：

多智能体任务计划
工作流运行记录

1. 任务计划视图

主要展示在 Chat 中通过 自动调度 / Decade 模式 触发的任务规划结果。

可查看内容包括：

当前有多少计划
哪些计划正在执行
已完成 / 已失败 / 已取消的数量
每个计划的步骤列表与状态

支持的状态筛选：

全部计划
规划中
执行中
已完成
已失败
已取消

2. 工作流运行视图

用于查看工作流触发后的运行回放，适合：

回看某次执行结果
排查哪个节点失败
对比不同时间的运行表现

3. 适合谁使用

经常跑复杂任务的用户
需要回放多智能体执行链路的用户
需要排查工作流稳定性的开发 / 产品 / 运营人员

知识库

知识库负责存放资料型内容，并作为 Chat / Agent 的检索来源之一。

1. 当前支持的两种入库方式

方式 A：手工创建知识条目

适合：

FAQ
项目约定
产品背景
简短制度 / 规则说明

方式 B：文件训练入库

当前支持文件类型：

.txt
.md
.markdown
.docx

2. 文件训练流程

训练时会自动完成：

文本抽取
内容分块
分类
向量化
写入知识项与知识分块表

页面会展示最近一次训练结果：

总文件数
成功处理数
跳过数
生成分块数
分类统计
被跳过文件及原因

3. 当前页面能力

搜索知识内容
新增知识
编辑知识
删除知识
选择文件批量训练

4. 适合放进知识库的内容

操作手册
产品方案
客服 FAQ
研究资料
内部规范
Markdown 文档集

5. 与工具链的关系

当前内置工具包含 knowledge_search，因此知识库内容不仅能在页面中查看，也能进入 Chat / Agent / Workflow 的执行链路。

集成中心与 MCP

集成中心现在承担两类职责：

外部消息平台集成
MCP 扩展管理

一、消息平台集成

当前页面支持以下平台类型：

类型	当前用途
钉钉	Webhook 推送、App/OpenAPI 发送、双向机器人
飞书	Webhook 推送、App 模式发送、双向机器人
企业微信	Webhook 模式接入与发送
Telegram	发送消息 / 外部推送入口
Slack	Webhook 推送
Discord	Webhook 推送

二、消息发送类型

当前发送面板支持：

文本
Markdown
图片
文档 / 文件

同时支持：

直接填写 URL
选择本地文件
配置默认目标 ID / 目标类型
与 Chat 中 send_message 工具共享默认推送目标

三、钉钉 / 飞书的当前增强点

钉钉

支持主动推送消息
支持 App/OpenAPI 发送图片与文件
发送会话图片 / 文件时建议配置 openConversationId + robotCode
支持双向机器人启动 / 停止

飞书

支持主动推送消息
App 模式下支持原生发送图片 / 文件
支持双向机器人启动 / 停止
可配置默认目标，如 chat_id

四、集成与 Agent 的关系

每个集成可以关联到 Agent，使外部消息更容易接入 GoRabbit 的处理链。

五、MCP 管理

MCP（Model Context Protocol）接入已经整合进当前页面。

支持两种安装方式：

接入方式	说明
NPM 包	直接安装 MCP 包
本地命令	通过自定义命令启动 MCP Server

可配置内容：

MCP 名称
描述
启动参数（每行一个）
环境变量（KEY=VALUE）

安装完成后：

MCP 暴露的工具会注入到 Chat 可调用工具列表
页面会显示 Ready 数量与工具总数
工具链中还提供 mcp_server_list / install / refresh / remove 等能力

六、适合优先接入的 MCP

如果你第一次使用 MCP，推荐从这些方向开始：

文件系统
浏览器
数据库
内部 API

安全检测

安全检测页当前聚焦 运行环境与接口连通性，而不是角色或权限资产管理。

当前扫描项

类别	项目
网络	网络连接、DNS 解析、代理设置
API	OpenAI、Anthropic、DeepSeek 端点
系统	文件权限、数据目录
安全	密钥加密、数据库完整性

当前页面能力

一键运行安全扫描
按类别查看结果
统计通过 / 警告 / 异常数量
查看系统信息

与工具审批的关系

需要注意：

安全检测页 负责环境检查
聊天页 负责工具执行审批与运行反馈
设置页 提供“最大权限模式”等开关

因此，如果你遇到的是“工具迟迟不执行”，优先回到 Chat 查看是否在等待审批；如果你遇到的是“接口完全连不上”，优先在安全检测页排查。

设置中心

设置页是当前版本扩展最多的页面之一。

1. 外观主题

支持：

浅色
深色
跟随系统
多套主题色预设

2. 语言

当前支持：

zh-CN
en-US

3. 存储根目录

你可以自定义 GoRabbit 的本地数据落盘根目录。当前系统会按 类型 / 日期 / 来源 自动归档：

附件上传
数据导出
文档 / PPT / HTML 产物
截图
日志
缓存

未自定义时，默认落盘到：

系统文档目录/GoRabbit

4. 顶部时钟

当前时钟组件支持：

数字时钟
翻页时钟
极简时钟
卡片时钟

并支持：

12/24 小时制
显示 / 隐藏秒数
显示 / 隐藏日期
显示 / 隐藏星期

5. 运行偏好

当前可配置：

自动记忆（autoMemory）
自学习开关
自学习间隔（小时）
默认模型
Agent 默认超时时长
Agent 默认最大迭代次数

6. 桌面行为

支持：

关闭窗口时最小化到托盘
最大权限模式开关

7. 数据管理

设置页支持：

导出数据
导入数据

需要注意：

导入会覆盖当前应用数据
适合迁移设备、备份恢复、多人协作环境下快速还原

内置资源与生态

支持的模型提供商

提供商	当前状态
OpenAI	已支持
Claude / Anthropic	已支持
DeepSeek	已支持
Ollama	已支持
自定义兼容端点	已支持

当前仓库内置角色模板

通用助手
编程助手
翻译专家
写作助手
数据分析专家
产品经理
运维专家
设计顾问
教育导师
学术研究员

当前仓库内置技能 / Agent / 推荐包

类型	数量	说明
`resources/skills/` 内置技能目录	8	随应用打包提供
推荐技能包	13	代码常量中定义，可在 Skills Hub 中展示
`resources/agents/` 内置 Agent 目录	5	随应用打包提供
推荐 Agent 包	8	代码常量中定义，可在 Agent Hub 中展示
示例工作流	3	初始化数据库时注入

常用内置工具能力

当前内置工具大致可分为以下几类：

类别	代表能力
浏览器 / 网络	`web_fetch`、`screenshot`、`open_url`
文件系统	`file_read`、`file_write`、`file_list`、`file_search`、`file_tree`、`open_path`
系统	`shell_exec`、`system_info`、`desktop_notify`
记忆 / 知识	`memory_search`、`memory_save`、`memory_delete`、`knowledge_search`
外部消息	`send_message`
调度 / 计划	`agent_dispatch`、`plan_query`、`plan_cancel`、`task_schedule`
工作流	`workflow_list`、`workflow_create`、`workflow_trigger`
MCP	`mcp_server_list`、`mcp_server_install`、`mcp_server_refresh`、`mcp_server_remove`
文档 / 媒体	`ppt_generate_html`、`video_render_remotion`

其中 task_schedule 当前支持：

一次性延时：5s、10m、1h
周期执行：every 30s

数据存储与目录结构

1. 默认存储根目录

默认情况下，GoRabbit 会把运行产物存放到：

文档/GoRabbit

2. 资源目录组织方式

当前资源落盘路径按如下结构管理：

<storageRoot>/<type>/<YYYY>/<MM>/<DD>/<source>/

常见类型包括：

attachments
exports
documents
screenshots
logs
cache

3. 数据库存储内容

当前本地数据库中会保存的核心数据包括：

会话与消息
消息归档
模型供应商
记忆
角色
集成配置
工具调用审计记录
技能
Agent
多智能体任务计划
工作流
工作流运行记录
知识条目与知识分块

4. 安全相关说明

模型 API Key 为本地存储
安全检测页会检查密钥加密与数据库完整性
数据导入导出建议在可信设备上进行

常见问题

Q1：我该怎么使用本地 Ollama？

进入 模型配置，新增 Ollama (本地) 类型，Base URL 通常填写：

http://localhost:11434/v1

然后填入本机已有模型名即可。Ollama 一般不要求 API Key。

Q2：单 Agent、自动调度、Decade 模式怎么选？

单 Agent：日常问答、单角色写作、普通编程问题
自动调度：希望系统自动选 1~多个 Agent 协作
Decade 模式：希望系统显式拆解步骤、做多角色协同与长链路执行

Q3：为什么我的任务停在“等待工具审批”？

这是正常现象，说明当前任务涉及工具调用且仍需确认。你可以：

在聊天中的工具卡片里点击批准
或在当前会话开启“自主操作”

Q4：角色导入现在能直接用吗？

当前版本角色页已经预留导入入口，但稳定主流程仍是：使用内置模板 / 新建 / 编辑 / 导出。如果你要做模板迁移，建议暂时以导出 Markdown 的方式管理。

Q5：知识库训练时为什么有文件被跳过？

常见原因：

文件扩展名不受支持
文本太短
无法切分出有效内容
文件读取失败

你可以在知识库页查看最近一次训练结果中的“跳过文件列表”。

Q6：飞书 / 钉钉如何发送图片和文件？

飞书：推荐使用 App 模式（App ID + App Secret + 目标 ID）
钉钉：推荐使用 App/OpenAPI 模式，并提供 openConversationId + robotCode

纯 Webhook 模式下，部分平台会退化为文本链接说明，而不是真实文件渲染。

Q7：如何更换数据目录或做整机迁移？

进入 设置中心：

调整存储根目录
使用“导出数据”做备份
在新机器中使用“导入数据”恢复

如果你正在从旧版使用文档迁移，请注意：当前版本的 GoRabbit 已经覆盖 技能、Agent、工作流、知识库、调度中心、MCP、机器人集成与扩展设置 等模块，使用方式与早期版本相比已有明显变化。建议优先以本文件为准。

团队备注：GoRabbit 当前由 NeoVerseAi & krTalk 持续推进。社区仍在搭建中，产品处于持续迭代版本阶段，部分版本会开放内测体验，欢迎关注后续更新与内测使用信息。

GoRabbit 使用文档

项目定位

当前版本亮点

开发者可玩性与 CoPaw / OpenClaw 对比

GoRabbit 对开发者更“可玩”的地方

与 CoPaw、OpenClaw 的侧重点差异

一句话理解

系统要求

安装与启动

方式一：直接安装发行包

方式二：从源码启动

构建相关补充

5 分钟快速开始

第 1 步：先完成设置向导

第 2 步：配置模型供应商

第 3 步：设置默认模型

第 4 步：开始对话

第 5 步：体验增强能力

页面与功能详解

首次启动与设置向导

Chat 对话工作台

1. 会话与消息能力

2. 三种协作模式

3. @ 提及 Agent

4. 工具调用与审批

5. 自主操作

6. 附件与输入能力

7. 输入小技巧

模型配置

支持的供应商类型

当前页面可完成的操作

关键字段说明

常见预设地址

推荐使用方式

角色管理

当前页面能力

当前仓库内置角色模板（10 个）

使用说明

关于导入

记忆管理

记忆层级

当前页面能力

适合写进记忆的内容

不建议与知识库混用的情况

技能模块

1. 已安装技能

2. Skills Hub

3. 当前仓库内置技能资源

4. 什么时候该用技能？

Agent 中心

1. 本地 Agent 管理

2. Agent Hub

3. 当前仓库内置 Agent 资源

4. 什么时候该用 Agent？

工作流编排

当前支持的节点类型

当前页面能力

已内置的示例工作流

与 Chat 的关系

适合场景

调度中心

1. 任务计划视图

2. 工作流运行视图

3. 适合谁使用

知识库

1. 当前支持的两种入库方式

2. 文件训练流程

3. 当前页面能力

4. 适合放进知识库的内容

5. 与工具链的关系

集成中心与 MCP

一、消息平台集成

二、消息发送类型

三、钉钉 / 飞书的当前增强点

四、集成与 Agent 的关系

五、MCP 管理

六、适合优先接入的 MCP

安全检测

当前扫描项

当前页面能力