AI 原生 BaaS 平台 Supabase 版
AI 原生 BaaS 平台 Supabase 版
文档指南
请输入
- 文档首页
AI 原生 BaaS 平台 Supabase 版最佳实践在 ArkClaw 中使用 Supabase Skill 开发应用
复制全文
下载 pdf在 ArkClaw 中使用 Supabase Skill 开发应用
文档反馈
问问助手本文介绍了在 ArkClaw 中使用 Supabase Skill 进行资源运维、数据管理与应用开发的最佳实践。
背景信息
ArkClaw 是一个对话式的开发与运维智能代理平台，旨在通过自然语言调用各类技能（Skill），打通从云资源运维到应用发布的完整链路。开发者无需在繁杂的控制台、命令行和代码编辑器之间频繁切换，只需通过对话即可完成任务。火山引擎 Supabase Skill 正是在这一背景下，为简化 Supabase 开发与运维而设计的核心技能，它将 Supabase 的强大功能封装为一系列可通过自然语言调用的原子能力，极大提升了开发效率与体验。
应用场景
借助 ArkClaw 和 Supabase Skill，开发者可以在多种高频场景下获得显著的效率提升。以下列举了 6 个典型应用场景及其在 ArkClaw 下的实践：
操作流程
本章节将以一个待办事项（Todo）应用为例，完整演示如何通过 ArkClaw 与 Supabase Skill，一步步完成从环境准备到应用上线的全过程。
步骤一：安装 Skill
你有三种方式在 ArkClaw 中安装 Supabase Skill，选择其中一种即可。
- 方式一：通过 Zip 包安装 直接向 ArkClaw 发送指令，它会自动下载并安装。
-
- 方式二：通过 GitHub 安装 将官方仓库克隆到本地的技能目录。
-
- 方式三：通过 ClawHub 安装 从技能市场下载 Zip 包并解压到指定目录。
- 下载 Zip 压缩包。
- 将其解压到 ~/.openclaw/skills 目录下。
- 方式四：通过 Find Skill 安装 从技能市场下载 Zip 包并解压到指定目录。
- 下载 Zip 压缩包。
- 将其解压到 ~/.openclaw/skills 目录下。
步骤二：配置火山引擎访问密钥 (AK/SK)
为了让 ArkClaw 有权限操作你的火山引擎资源，你需要配置访问密钥。
- 开通服务并获取密钥
- 确保你已拥有火山引擎账户，并已开通 AIDAP 服务。
- 登录火山引擎控制台，在 访问控制 > API 访问密钥 页面创建或获取一对有效的 Access Key ID 和 Secret Access Key。更多详细信息，请参见查看 AKSK 信息。
- 配置环境变量
- 在 ArkClaw 终端中，编辑 .env 配置文件。
-
- 将你的密钥信息添加进去。
-
- 重启 ArkClaw 网关使配置生效。
-
步骤三：创建工作区与多分支环境
环境准备就绪后，我们开始创建应用所需的基础设施。
- 创建工作区：一个工作区对应一个独立的 Supabase 项目。
“帮我创建一个新的 Supabase 工作区，用于开发待办事项应用。”
- 创建开发分支：基于主干环境，创建一个用于日常开发的隔离分支。
“为我刚才创建的工作区新建一个 dev 开发分支。”
ArkClaw 会自动完成资源的创建和配置，无需手动操作。
步骤四：数据面操作
接下来，我们进行数据库相关的操作。
- 执行 SQL 与启用扩展：让 ArkClaw 为我们的应用创建 todos 表，并启用 pgvector 扩展以备后续的 AI 功能。
“在 dev 分支的数据库里，帮我创建一张名为 'todos' 的表，包含 id、task (文本)、is_completed (布尔)、created_at (时间戳) 字段。同时，请启用 pgvector 扩展。”
- 对象存储：如果应用需要存储用户头像等文件，可以创建一个存储桶。
“为应用创建一个名为 'avatars' 的私有存储桶。”
- 实时订阅：为了让任务列表能实时更新，我们为 todos 表开启实时数据推送。
“请为 'todos' 表开启实时订阅功能。”
步骤五：开发后端接口与部署到 Edge Functions
现在，我们让 ArkClaw 编写并部署后端逻辑。
- 生成后端代码：告诉 ArkClaw 你的需求，它会自动生成包含数据库操作和 API 接口的后端代码。
-
- 部署到 Edge Functions：将生成的代码一键部署为无服务器函数。
-
- ArkClaw 会返回部署成功的 API 地址，后端服务至此已上线。
步骤六：开发前端并联通后端
同理，我们让 ArkClaw 生成前端页面代码。
ArkClaw 会生成前端代码并在本地启动一个 Web 服务。
步骤七：测试与交付
- 前端验证：打开浏览器访问 ArkClaw 提供的本地地址，你应该能看到一个功能完整的待办事项应用。可以尝试添加、修改、删除任务，所有操作都会通过后端 API 实时同步到 Supabase 数据库。
- 数据确认：你可以随时回到 Supabase 的控制台，检查 todos 表中的数据是否与前端操作一致，以确认整个链路已成功打通。
至此，仅通过与 ArkClaw 的几轮对话，我们就完成了从 0 到 1 的全栈应用开发与部署。
核心能力最佳实践
除了上述端到端开发流程，你还可以通过自然语言，灵活调用 Supabase Skill 的各项能力来处理日常的运维和开发任务。
控制面：云资源运维
- 工作区生命周期管理：通过“创建/查询/暂停/恢复/销毁工作区”等指令，全面管理 Supabase 项目。
- 多分支环境管理：使用“创建/删除/重置开发分支”等指令，实现安全的环境隔离与操作。
- 权限与安全管理：通过“管理成员权限/API密钥”、“查看操作日志”等，保障资源安全。
- 成本与配额管理：用“查询资源用量”、“调整配额”等指令控制成本。
数据面：数据服务管理
- PostgreSQL 数据库管理：直接用“执行 SQL”、“启用 pg_cron 扩展”、“分析慢查询”等自然语言进行数据库管理。
- Edge Functions 管理：通过“部署/删除/调试函数”、“查看函数日志”等指令，高效管理无服务器函数。
- 对象存储服务：使用“创建存储桶”、“生成签名 URL”等指令，灵活操作对象存储。
- 实时数据能力：通过“配置数据库变更订阅”等指令，为应用赋予实时能力。
应用开发支持
- 自动生成 API 与 SDK：告诉 ArkClaw 你的数据库表结构，它可以“自动生成 RESTful API”或“为我生成用于 Flutter 的客户端 SDK”。
- 开发流程支持：通过“同步本地开发分支与云端环境”、“部署数据库迁移脚本”等指令，将 Supabase 开发无缝接入 CI/CD 流程。
参考——在其他客户端中使用 Supabase Skill
在使用其他客户端时，可以使用如下方式进行安装及配置。
步骤一：安装 Skills
你可以通过自动安装或手动安装两种方式，在支持 Agent Skills 的客户端中使用 Supabase Skill。
方式一：让 Agent 自动安装
推荐直接把安装任务交给 Agent 完成。你可以在客户端中输入如下指令：
这种方式适合 Codex、Claude Code、Cursor、Gemini CLI、VS Code Copilot 等具备 Agent Skills 能力的客户端。不同客户端的 Skill 目录可能不同，Agent 通常可以根据当前运行环境自动判断。
方式二：手动安装
如果客户端无法自动完成安装，可以手动下载并解压 Skill 包，然后将 byted-supabase 目录复制到客户端对应的 Skill 目录下。
常见客户端的 Skill 目录如下：
例如，在 Codex 中手动安装：
在 Claude Code 中手动安装：
安装完成后，重启客户端或重新打开会话，然后输入如下内容进行验证：
步骤二：配置环境变量
Supabase Skill 需要通过火山引擎 AK/SK 调用相关服务。请在运行客户端的环境中配置以下变量：
ArkClaw / OpenClaw
ArkClaw / OpenClaw 可继续使用前文介绍的 .env 配置方式：
写入：
然后重启网关：
Codex
Codex 的用户级配置文件为 ~/.codex/config.toml。
可以通过 shell_environment_policy.set 显式注入；Codex 也支持控制子进程的环境变量继承策略。
也可以从本地 Shell 环境透传：
Claude Code
Claude Code 的配置文件支持用户级、项目级和本地项目级等多个 scope，其中用户级配置位于 ~/.claude/settings.json，项目级配置位于 .claude/settings.json，本地项目级配置位于 .claude/settings.local.json。
用户级配置示例：
文件位置：
Gemini CLI
Gemini CLI 支持 Agent Skills，会从用户级和工作区级目录发现 Skill。官方文档列出的用户级目录包括 ~/.gemini/skills/ 和 ~/.agents/skills/，工作区级目录包括 .gemini/skills/ 和 .agents/skills/。
Gemini CLI 是命令行客户端，可以在启动前配置环境变量，也可以配置到 ~/.gemini/.env：
步骤三：验证配置是否生效
完成 Skill 安装和环境变量配置后，重启客户端或重新打开会话，然后输入：
如果返回鉴权失败，请检查：
- VOLCENGINE_ACCESS_KEY 和 VOLCENGINE_SECRET_KEY 是否填写正确。
- 当前客户端是否已经重启。
- 环境变量是否注入到了实际执行 Skill 脚本或 MCP Server 的进程中。
- 是否已开通 AIDAP 服务，并具备操作 Supabase 相关资源的权限。
最近更新时间：2026.05.12 17:46:55
这个页面对您有帮助吗？
有用
有用
无用
无用