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 内资源。 |
searxng | 默认搜索引擎,提供联网搜索能力。 |
知识库配置
从可用知识库列表中选择并启用知识库,启用后对所有用户可见。支持跳转到知识库详情或文档召回页面。
环境变量
为虾的运行时环境配置全局环境变量(键值对形式),常用于配置技能所需的密钥和参数。支持表单编辑和 JSON 编辑两种方式,保存时覆盖所有已有变量。环境变量已完成安全加固。
OPENCLAW_CUSTOM_CONFIG_B64 为自定义配置环境变量,值为 Base64 编码的 JSON 字符串,用于向虾的运行时注入自定义配置项(如技能参数、第三方服务凭证等)。虾启动时自动解码并加载。
模板管理
将已配置好的虾保存为模板,用户领养时可基于模板快速创建预配置好的虾。支持模板列表展示、搜索和排序、新建模板(异步复制工作空间数据)、行内编辑和删除。
Token 配额
管理平台的 Token 使用配额,控制模型调用成本。
功能 | 说明 |
系统默认月配额 | 设置所有用户的默认月 Token 配额。 |
当月总消耗 | 查看平台当月 Token 总消耗量。 |
用户配额管理 | 为单个用户设置自定义月配额,也可设为跟随系统默认值。 |
用户侧可自行查看本月配额和使用情况。
选择百炼 Token Plan 计费模式时,Token 消耗从本平台配额中扣减;选择按量付费模式时,费用由百炼平台直接结算。
高级配置
节省模式
开启后,用户可创建按量付费实例,关闭页面即回收资源。
节省模式下,定时任务不可用。IM 消息渠道可正常使用,虾下线时平台基于心跳检测自动冷启动实例。
龙虾规格
选择虾的运行时资源规格。
规格 | 适用场景 |
1c1g | 轻量级对话场景 |
1c2g | 一般对话与少量技能 |
2c2g | 标准使用 |
2c4g | 多技能并行 |
4c4g | 高负载场景 |
4c8g | 重度使用与大量文件处理 |
规格变更仅对新创建的虾生效。
权限策略(一虾一角色)
每只虾创建时自动绑定一个独立的 RAM 角色。管理员可统一声明附加到该角色的权限策略。
功能 | 说明 |
策略列表 | 展示当前虾角色附加的所有权限策略,区分「系统策略」和「自定义策略」。 |
添加策略 | 从 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 嵌入企业内部系统。
接口 | 说明 |
认证方式 | 通过 |
按用户名查询用户 | 返回 userId 及 userSpaces,用于后续代用户创建虾。 |
代用户创建虾 | 在指定用户空间下创建虾,支持设置模型、节省模式和别名。 |
检查虾就绪状态 | 轮询确认虾实例已启动就绪。 |
获取虾列表和详情 | 分页获取,响应包含 wsUrl 和 gatewayToken,可用于 WebSocket 直连。 |
zipfile 参数 | 创建虾时支持通过 |
访问权限控制
FunClaw 的访问权限通过管理后台顶层的权限管理功能控制,而非 FunClaw 专题页面内配置。
控制方式 | 说明 |
用户组级别 | 在中编辑用户组时,开启或关闭「养虾 FunClaw」访问权限开关。 |
用户级别 | 在中编辑用户时,单独开启或关闭该用户的 FunClaw 访问权限。 |
用户界面功能详解
用户(开发者)通过「开发者控制台 > 养虾 FunClaw」进入使用界面。
管理员需先为用户所在用户组或用户本人开启「养虾 FunClaw」访问权限。
虾列表页
主入口页面,展示当前用户拥有的所有虾。首次进入无虾时,系统自动引导领养。
功能 | 说明 |
卡片列表 | 以卡片网格形式展示所有虾实例。 |
搜索 | 按虾名称或描述搜索过滤。 |
Token 用量 | 展示当月 Token 使用量与配额。 |
领养新虾 | 进入领养流程创建新虾。 |
选择虾 | 单击虾卡片进入全屏对话工作区。 |
删除虾 | 删除指定虾实例。 |
领养新虾
全屏领养页面,引导用户创建一只新虾。
基础设置
配置项 | 说明 |
创建方式 | 空白创建或基于模板创建。 |
选择模板 | 基于模板创建时,选择管理员预设的模板。 |
名字 | 为虾起一个名字(必填)。 |
节省模式 | 开启或关闭节省模式(管理员启用后可见)。 |
渠道设置(选填)
预配置即时通讯消息渠道,包括钉钉、飞书、企业微信和个人微信,均支持扫码配对。
节省模式下渠道设置可正常使用,虾下线时 IM 消息自动触发冷启动。
更多设置
配置项 | 说明 |
模型 | 从管理员配置的可用模型列表中选择(支持搜索)。 |
描述 | 为虾添加简要描述(创建后也可编辑)。 |
对话工作区
单击某只虾进入全屏对话工作区,这是 FunClaw 的核心交互界面。虾的启动和重启时间约 40 秒至 60 秒。
功能 | 说明 |
智能对话 | 与虾进行多轮自然语言对话,支持传递图片。 |
技能安装 | 安装管理员配置的技能或手动上传自定义技能。 |
定时任务 | 通过对话创建和管理定时任务。 |
人格切换 | 通过对话设置不同的人格角色。 |
知识库 | 启用和检索管理员已开放的知识库。 |
快捷指令 | 使用 /new、/status、/clear 等快捷指令。 |
就绪检测 | 自动检测虾的运行状态,就绪后方可开始对话。 |
重启 | 手动强制重启虾实例。 |
启动中编辑 | 实例启动过程中可编辑配置,避免配置错误导致无法启动又无法修复。 |
文件引导 | 对话中涉及文件时,自动引导用户到文件管理下载。 |
对话工作区展示当前用户的 Token 配额使用情况,超限时提示用户。
技能与知识库浮层
在对话输入栏中单击「技能」或「知识库」打开双 Tab 浮层:
Tab | 数据来源 | 说明 |
企业技能 / 企业知识库 | 管理员集中启用的全局资源 | 默认选中,打开浮层即加载首屏。 |
我的技能 / 我的知识库 | 当前用户空间下自行创建或导入的资源 | 首次切换时懒加载。 |
两个 Tab 各自独立分页(每页 5 条),支持关键词搜索。单击条目将「启用 xxx 技能/知识库」填入输入框,由用户确认后发送。
文件管理
在界面上管理虾工作空间中的文件,支持浏览目录结构、上传、下载、在线编辑和新建文件。
资源工作台
在开发者控制台的「我的工作台」中管理 AgentRuntime、工具、知识库、记忆等资源。虾在对话中可直接调用这些资源。
可见性控制
开关状态 | 含义 |
开启(默认) | 资源仅在本用户空间内可见,不出现在跨空间的企业聚合列表中。 |
关闭 | 资源可被聚合列表检索到,用于向企业内其他空间共享。 |
所有新建资源默认「仅本空间可见」。此可见性同时影响对话浮层中「企业技能/企业知识库」Tab 的数据来源:只有非私有资源才出现在企业侧列表。
管理员初始化配置流程
首次使用 FunClaw 时,按以下步骤完成初始化:
配置模型服务:在模型配置页面添加至少一个模型服务提供商。
配置存储:在存储配置页面选择用于工作空间持久化的 OSS Bucket。
(可选)配置技能:启用需要对用户开放的技能。
(可选)配置知识库:启用需要对用户开放的知识库。
(可选)配置权限:为目标用户组或用户开启 FunClaw 访问权限。
完成以上配置后,用户即可在开发者控制台中看到「养虾 FunClaw」入口。