专题-FunClaw

更新时间:
复制为 MD 格式

FunClaw(养虾)是 Agent 开放平台管理后台中面向 OpenClaw 的专题入口。管理员在管理后台完成模型、存储、配额、技能、镜像等全局配置,开发者在开发者控制台领养并使用 OpenClaw 运行实例(虾)。本文介绍 FunClaw 的核心能力、管理员界面功能和用户界面功能。

产品概述

FunClaw 是 Agent 开放平台中面向 OpenClaw 的专题入口。每只「虾」对应一个 OpenClaw 运行实例。

能力

说明

智能对话

基于大模型的自然语言交互,支持多轮对话、上下文记忆和图片传递。

技能扩展

安装管理员配置的技能或手动上传自定义技能,聊天入口按「企业」和「我的」分区浏览。

定时任务

通过自然语言设置定时提醒和自动化任务。

人格角色

切换不同的人格角色,适应多种使用场景。

知识库

接入企业知识库或自建知识库,实现基于私有数据的智能问答(RAG)。

文件管理

在界面上浏览、上传、下载、编辑和新建工作空间中的文件。

多渠道集成

支持钉钉、飞书、企业微信和个人微信,支持扫码完成配对。

可观测

开箱即用的可观测插件,默认开启。

VPC 私网访问

将虾部署在指定 VPC 内访问内网资源,也可通过 fc-vpc-proxy 技能代理访问。

一虾一角色

每只虾绑定独立 RAM 角色,管理员集中配置权限策略,实现最小权限与隔离。

自定义镜像

添加自定义运行镜像,批量对虾执行版本切换。

OpenAPI

提供管理员 API Key 和 OpenAPI,可编程地代用户创建、查询和管理虾实例。

内置阿里云 CLI

在虾的运行环境中可直接使用阿里云 CLI。

心跳上报

每只虾持续向平台上报心跳。管理员在龙虾总览页面可查看在线状态和最近心跳时间,便于排查异常实例。节省模式下,平台基于心跳检测自动管理 IM 消息的冷启动。

产品亮点

亮点

说明

极速启动

虾的启动和重启时间约 40 秒至 60 秒。

工作空间持久化

工作空间挂载对象存储 OSS,实例重启后所有文件和配置原样保留。

多模型、多提供商

开箱即用支持大模型服务平台百炼、智谱 GLM、月之暗面 Kimi、深度求索 DeepSeek,同时支持自定义模型服务端点(OpenAI 兼容)。

安全与隔离

密钥统一由管理员配置,虾环境中不能直接获取大模型 API Key,对话过程中可安全访问环境变量中的密钥。

灵活的成本控制

节省模式(关页即回收资源)、Token 月配额(系统默认 + 用户级自定义)、多档规格(1c1g 至 4c8g 共六档)。

文件交互

对话中涉及文件时自动引导用户到文件管理页面下载。

技能生态

内置 agent-browser、self-improvement、find-agentrun-skills、searxng 等常用技能,支持自定义技能上传。

多渠道即时通讯

支持钉钉、飞书、企业微信和个人微信,除钉钉外均支持扫码配对。

可观测与运维

基于 OpenTelemetry 的可观测大盘,龙虾总览页面提供实例、监控、日志快捷链接,内置阿里云 CLI。

VPC 私网访问

一键开启 VPC 访问,虾可直接访问 RDS、Redis、ECS、内部 HTTP 服务等私网资源。

一虾一角色

每只虾绑定独立 RAM 角色,OSS 访问策略自动附加,新虾自动继承策略集合。

自定义镜像

支持上传自定义镜像(ACR 企业版或个人版),支持批量镜像变更任务。

OpenAPI 与 API Key

管理员 OpenAPI 和 API Key 管理,可通过 WebSocket(wsUrl + gatewayToken)直接与虾交互。

资源可见性控制

新建资源默认「仅本用户空间可见」,管理员和拥有者可调整可见范围。

角色与界面

角色

入口

主要职责

管理员

管理后台 > 专题 > 养虾 FunClaw

全局配置(模型、存储、配额等)、权限管理、模板管理、镜像管理

用户(开发者)

开发者控制台 > 养虾 FunClaw

领养和使用虾、对话交互、文件管理

管理员界面功能详解

管理员通过「管理后台 > 专题 > 养虾 FunClaw」进入管理页面,采用侧边 Tab 导航。首次进入时,若模型和存储未配齐,系统会显示引导卡片。

龙虾总览

查看和管理平台上所有用户创建的虾实例。

功能

说明

列表展示

展示所有虾实例,包括别名、名称、创建者、模型、运行时规格(CPU/内存)、创建和更新时间。

按创建者用户名或邮箱搜索。

排序

按创建时间、更新时间、别名、名称、创建者、模型等多维度排序。

存为模板

将指定虾的当前配置保存为模板。

删除

管理员可直接删除用户侧的虾实例。

模型配置

配置 FunClaw 使用的 AI 大模型服务,是启用 FunClaw 的必要前提。

配置项

说明

服务提供商

内置大模型服务平台百炼(支持按量付费和 Token Plan 两种计费模式)、智谱 GLM、月之暗面 Kimi、深度求索 DeepSeek,同时支持自定义提供商(OpenAI 兼容)。

API 端点

选择自定义提供商时,填写模型服务的 API 地址。

API Key

模型服务的访问密钥,以脱敏方式展示。

连通性测试

保存前自动测试 API Key 连通性。

编辑提供商

支持修改已配置的模型服务提供商。

存储配置

登录对象存储 OSS 控制台,从当前地域的可用 Bucket 列表中选择一个 OSS Bucket,用于虾的工作空间持久化。这是启用 FunClaw 的必要前提。

重要

Bucket 一旦选定后不可更改,请谨慎选择。

技能配置

从 AgentRun 中选择技能并启用,启用后 FunClaw 用户可在对话中安装使用。

说明

首次进入技能配置页面时列表为空,需单击添加技能从 AgentRun 中选择可用技能。若列表为空,请先在开发者控制台中创建技能。

AgentRun 中内置以下常用技能:

技能名称

说明

agent-browser

浏览器能力,支持网页访问与信息提取。

self-improvement

自我提升,持续优化对话质量。

find-agentrun-skills

发现并推荐可用技能。

fc-vpc-proxy

通过函数计算 FC 代理方式访问 VPC 内资源。

默认搜索引擎,提供联网搜索能力。

知识库配置

从可用知识库列表中选择并启用知识库,启用后对所有用户可见。支持跳转到知识库详情或文档召回页面。

环境变量

为虾的运行时环境配置全局环境变量(键值对形式),常用于配置技能所需的密钥和参数。支持表单编辑和 JSON 编辑两种方式,保存时覆盖所有已有变量。环境变量已完成安全加固。

OPENCLAW_CUSTOM_CONFIG_B64 为自定义配置环境变量,值为 Base64 编码的 JSON 字符串,用于向虾的运行时注入自定义配置项(如技能参数、第三方服务凭证等)。虾启动时自动解码并加载。

模板管理

将已配置好的虾保存为模板,用户领养时可基于模板快速创建预配置好的虾。支持模板列表展示、搜索和排序、新建模板(异步复制工作空间数据)、行内编辑和删除。

Token 配额

管理平台的 Token 使用配额,控制模型调用成本。

功能

说明

系统默认月配额

设置所有用户的默认月 Token 配额。

当月总消耗

查看平台当月 Token 总消耗量。

用户配额管理

为单个用户设置自定义月配额,也可设为跟随系统默认值。

用户侧可自行查看本月配额和使用情况。

说明

选择百炼 Token Plan 计费模式时,Token 消耗从本平台配额中扣减;选择按量付费模式时,费用由百炼平台直接结算。

高级配置

节省模式

开启后,用户可创建按量付费实例,关闭页面即回收资源。

说明

节省模式下,定时任务不可用。IM 消息渠道可正常使用,虾下线时平台基于心跳检测自动冷启动实例。

龙虾规格

选择虾的运行时资源规格。

规格

适用场景

1c1g

轻量级对话场景

1c2g

一般对话与少量技能

2c2g

标准使用

2c4g

多技能并行

4c4g

高负载场景

4c8g

重度使用与大量文件处理

说明

规格变更仅对新创建的虾生效。

权限策略(一虾一角色)

每只虾创建时自动绑定一个独立的 RAM 角色。管理员可统一声明附加到该角色的权限策略。

功能

说明

策略列表

展示当前虾角色附加的所有权限策略,区分「系统策略」和「自定义策略」。

添加策略

从 RAM 可用策略中选择并附加到虾角色。

删除策略

从虾角色中移除指定策略。

OSS 存储访问权限自动附加。管理员变更权限策略后,新创建的虾自动继承最新策略集合;已存在的虾不受影响,需手动更新。

VPC 访问

开启后,新创建的虾部署在指定 VPC 内,可直接访问 RDS、Redis、ECS 及内部 HTTP/gRPC 等私网资源。

配置项

说明

VPC

从当前地域可用 VPC 列表中选择。

交换机

支持多选,建议选择两个及以上不同可用区的交换机以保障高可用。

安全组

选择虾运行时使用的安全组,决定虾可访问的网络范围。

说明

启用 VPC 是使用容器镜像服务 ACR 企业版自定义镜像的前置条件。

消息渠道

配置用户可见的消息渠道范围,支持钉钉、飞书、企业微信和个人微信,所有渠道均支持扫码配对。

说明

变更消息渠道配置会影响所有用户的可见渠道,操作前需确认。

镜像管理

管理虾的运行镜像,支持内置镜像与自定义镜像,并提供批量镜像变更能力。

镜像列表

功能

说明

内置默认镜像

平台维护的默认镜像,始终可用。

添加自定义镜像

填入镜像地址,选择 ACR 类型(企业版或个人版),系统自动启动镜像加速。

设为默认

将已加速完成的自定义镜像设为默认,后续新建虾使用此镜像。

重置为内置镜像

撤回自定义默认设置,恢复使用内置镜像。

删除

删除当前未被使用的自定义镜像。

使用量统计

每张镜像展示当前被多少只虾使用。

说明

ACR 企业版需先在高级配置中开启 VPC 并提供实例 ID。ACR 个人版无需 VPC 配置。镜像地址不可重复,如需更新请修改 Tag。

镜像变更任务

功能

说明

创建变更任务

选择目标镜像,支持「全量虾」或「指定虾」两种范围。

批量大小

每批并行切换的虾数量。

批次间隔

每批之间的等待时间(秒),便于灰度与观察。

任务列表

展示任务状态(运行中、已完成、失败、已取消)与明细进度。支持取消运行中的任务。

API 文档

集中展示管理员 OpenAPI 的使用说明与 cURL 示例,方便将 FunClaw 嵌入企业内部系统。

接口

说明

认证方式

通过 Authorization: Bearer YOUR_API_KEY 头部认证。

按用户名查询用户

返回 userId 及 userSpaces,用于后续代用户创建虾。

代用户创建虾

在指定用户空间下创建虾,支持设置模型、节省模式和别名。

检查虾就绪状态

轮询确认虾实例已启动就绪。

获取虾列表和详情

分页获取,响应包含 wsUrl 和 gatewayToken,可用于 WebSocket 直连。

zipfile 参数

创建虾时支持通过 zipfile 参数上传 ZIP 压缩包,内容自动解压到虾的工作空间,用于批量初始化文件。

访问权限控制

FunClaw 的访问权限通过管理后台顶层的权限管理功能控制,而非 FunClaw 专题页面内配置。

控制方式

说明

用户组级别

权限管理 > 用户组管理中编辑用户组时,开启或关闭「养虾 FunClaw」访问权限开关。

用户级别

权限管理 > 用户管理中编辑用户时,单独开启或关闭该用户的 FunClaw 访问权限。

用户界面功能详解

用户(开发者)通过「开发者控制台 > 养虾 FunClaw」进入使用界面。

说明

管理员需先为用户所在用户组或用户本人开启「养虾 FunClaw」访问权限。

虾列表页

主入口页面,展示当前用户拥有的所有虾。首次进入无虾时,系统自动引导领养。

功能

说明

卡片列表

以卡片网格形式展示所有虾实例。

按虾名称或描述搜索过滤。

Token 用量

展示当月 Token 使用量与配额。

领养新虾

进入领养流程创建新虾。

选择虾

单击虾卡片进入全屏对话工作区。

删除虾

删除指定虾实例。

领养新虾

全屏领养页面,引导用户创建一只新虾。

基础设置

配置项

说明

创建方式

空白创建或基于模板创建。

选择模板

基于模板创建时,选择管理员预设的模板。

名字

为虾起一个名字(必填)。

节省模式

开启或关闭节省模式(管理员启用后可见)。

渠道设置(选填)

预配置即时通讯消息渠道,包括钉钉、飞书、企业微信和个人微信,均支持扫码配对。

说明

节省模式下渠道设置可正常使用,虾下线时 IM 消息自动触发冷启动。

更多设置

配置项

说明

模型

从管理员配置的可用模型列表中选择(支持搜索)。

描述

为虾添加简要描述(创建后也可编辑)。

对话工作区

单击某只虾进入全屏对话工作区,这是 FunClaw 的核心交互界面。虾的启动和重启时间约 40 秒至 60 秒。

功能

说明

智能对话

与虾进行多轮自然语言对话,支持传递图片。

技能安装

安装管理员配置的技能或手动上传自定义技能。

定时任务

通过对话创建和管理定时任务。

人格切换

通过对话设置不同的人格角色。

知识库

启用和检索管理员已开放的知识库。

快捷指令

使用 /new、/status、/clear 等快捷指令。

就绪检测

自动检测虾的运行状态,就绪后方可开始对话。

重启

手动强制重启虾实例。

启动中编辑

实例启动过程中可编辑配置,避免配置错误导致无法启动又无法修复。

文件引导

对话中涉及文件时,自动引导用户到文件管理下载。

对话工作区展示当前用户的 Token 配额使用情况,超限时提示用户。

技能与知识库浮层

在对话输入栏中单击「技能」或「知识库」打开双 Tab 浮层:

Tab

数据来源

说明

企业技能 / 企业知识库

管理员集中启用的全局资源

默认选中,打开浮层即加载首屏。

我的技能 / 我的知识库

当前用户空间下自行创建或导入的资源

首次切换时懒加载。

两个 Tab 各自独立分页(每页 5 条),支持关键词搜索。单击条目将「启用 xxx 技能/知识库」填入输入框,由用户确认后发送。

文件管理

在界面上管理虾工作空间中的文件,支持浏览目录结构、上传、下载、在线编辑和新建文件。

资源工作台

在开发者控制台的「我的工作台」中管理 AgentRuntime、工具、知识库、记忆等资源。虾在对话中可直接调用这些资源。

可见性控制

开关状态

含义

开启(默认)

资源仅在本用户空间内可见,不出现在跨空间的企业聚合列表中。

关闭

资源可被聚合列表检索到,用于向企业内其他空间共享。

说明

所有新建资源默认「仅本空间可见」。此可见性同时影响对话浮层中「企业技能/企业知识库」Tab 的数据来源:只有非私有资源才出现在企业侧列表。

管理员初始化配置流程

首次使用 FunClaw 时,按以下步骤完成初始化:

  1. 配置模型服务:在模型配置页面添加至少一个模型服务提供商。

  2. 配置存储:在存储配置页面选择用于工作空间持久化的 OSS Bucket。

  3. (可选)配置技能:启用需要对用户开放的技能。

  4. (可选)配置知识库:启用需要对用户开放的知识库。

  5. (可选)配置权限:为目标用户组或用户开启 FunClaw 访问权限。

完成以上配置后,用户即可在开发者控制台中看到「养虾 FunClaw」入口。