ArkClaw 教程 - AI 工具教程

产品介绍

ArkClaw 是火山引擎推出的云上 SaaS 版 AI 智能体平台，作为本土化、轻量化的字节版 OpenClaw，以开箱即用、云端托管、全场景适配为核心优势。截至 2026 年 8 月，ArkClaw 已支持 Agent 团队协作模式、Codex 编程、Hermes Agent 自动沉淀技能、自定义连接器、云电脑录制提示词、AI 诊断 等丰富功能，并有专属 Agent 团队模板（私人投研分析、漫剧/短剧创作工坊、AI 办公效率团队等）。它的主要特点包括：

Agent 团队协作

支持自主选用团队协作调度模式，智能匹配专业子 Agent，实现跨领域协同。支持查看子 Agent 执行轨迹，旧版 Agent 资产一键迁移。

Codex 编程

直接在 ArkClaw 中运行 Codex，与当前会话共享对话上下文和记忆，自然语言驱动代码生成、脚本执行、文件修改和工程处理。

Hermes Agent

让 ArkClaw 自动沉淀技能——Agent 在执行任务过程中自动学习并沉淀为可复用的技能，持续进化能力边界。

自定义连接器

支持创建自定义连接器接入第三方或自建服务，支持 OAuth 用户委托、OAuth M2M 和 JWT 身份令牌等多种认证方式。

飞书/企微深度集成

与飞书实现深度原生适配，子 Agent 现已支持企业微信消息渠道，用户可在工作台直接唤醒，一站式完成办公任务。

企业级安全与管理

云原生沙箱隔离、自定义权限策略、审计日志、用户信息脱敏、实例监控看板、Agent 模板管理，全方位企业级保障。

使用指南

系统要求

操作系统：Windows 10+、macOS 10.15+、Linux (Ubuntu 18.04+)
浏览器：Chrome 80+、Firefox 75+、Safari 13+、Edge 80+
网络连接：需要互联网连接以使用云服务

使用步骤

1. 访问官方网站

访问 ArkClaw 官方网站（https://www.volcengine.com）。

2. 登录或注册

使用火山引擎账号登录，或注册新账号。

3. 选择套餐

根据您的需求选择合适的套餐：

CodingPlan Pro：订阅周期内可永久免费使用 ArkClaw 全功能
普通 CodingPlan：享有优先体验权
Lite 版：可获得 7 天免费试用资格

4. 开始使用

登录后，您可以直接在网页上使用 ArkClaw，也可以在飞书工作台中唤醒 ArkClaw 进行使用。

5. 配置偏好

根据您的需求配置语言偏好、模型选择等设置。

配置说明

基本配置

ArkClaw 的基本配置包括：

1. AI 服务配置

OpenAI：设置 OpenAI API 密钥和模型选择
Google：设置 Google API 密钥和模型选择
其他服务：配置其他 AI 服务的 API 密钥

2. 界面设置

语言：选择界面语言
主题：选择浅色或深色主题
字体：选择字体大小和类型

高级配置

1. API 配置

在「API」设置中，可以配置：

API 密钥管理
API 调用限制
API 缓存设置

2. 安全配置

在「安全」设置中，可以配置：

用户权限管理
数据加密设置
审计日志配置

使用教程

基本使用

1. 智能助手

在「智能助手」页面，可以：

与 AI 助手进行对话
ask questions and get answers
请求 AI 生成内容
保存和管理聊天历史

2. 工作流管理

在「工作流」页面，可以：

创建新工作流
使用模板创建工作流
编辑现有工作流
删除不需要的工作流

3. API 管理

在「API」页面，可以：

管理 API 密钥
查看 API 调用历史
设置 API 调用限制

高级使用

1. 自定义 API 集成

使用 ArkClaw 的 API 集成功能：

创建自定义 API 集成
配置 API 参数
测试 API 调用
监控 API 执行情况

2. 企业级应用

在企业环境中使用 ArkClaw：

设置团队协作
配置访问权限
监控系统性能
生成使用报告

技能扩展

技能市场

ArkClaw 提供技能市场，您可以：

浏览和安装官方技能
安装第三方技能
创建和分享自定义技能

创建自定义技能

1. 技能结构

ArkClaw 技能采用模块化设计，每个技能都是一个独立的文件夹，结构如下：

                        skills/
                        └── my_skill/
                            ├── manifest.json
                            ├── main.js
                            └── icon.png
                    

2. 技能清单

                        {
                            "name": "My Skill",
                            "version": "1.0.0",
                            "description": "A custom skill for ArkClaw",
                            "author": "Your Name",
                            "main": "main.js",
                            "icon": "icon.png",
                            "permissions": [
                                "api",
                                "workflow",
                                "tasks"
                            ]
                        }
                    

3. 技能实现

                        // main.js
                        module.exports = {
                            init: function(arkclaw) {
                                // 初始化技能
                                console.log('My Skill initialized');
                            },
                            
                            actions: {
                                hello: {
                                    description: 'Say hello',
                                    execute: function(args, context) {
                                        return 'Hello from My Skill!';
                                    }
                                }
                            },
                            
                            triggers: {
                                onApiCall: function(apiCall) {
                                    // 处理 API 调用事件
                                    console.log('API called:', apiCall);
                                }
                            }
                        };
                    

4. 安装技能

将技能文件夹复制到 ArkClaw 的 skills 目录，然后在 ArkClaw 的「技能」页面启用技能。

自动化配置

工作流自动化

ArkClaw 的工作流自动化配置采用可视化界面，您可以：

1. 触发条件

时间触发：按固定时间或间隔触发
事件触发：基于系统事件触发
手动触发：用户手动点击触发
API 触发：通过 API 请求触发
条件触发：基于特定条件触发

2. 执行步骤

AI 操作：调用 AI 服务执行任务
API 操作：调用外部 API
数据操作：处理和转换数据
通知操作：发送通知和警报

自动化示例

1. API 监控工作流

配置一个自动监控 API 调用的工作流：

触发条件：每小时执行一次
执行步骤：
1. 获取 API 调用统计
2. 分析调用趋势
3. 检测异常情况
4. 发送监控报告

2. 内容生成工作流

配置一个自动生成内容的工作流：

触发条件：每天早上 9:00
执行步骤：
1. 收集最新新闻
2. 使用 AI 生成内容摘要
3. 创建社交媒体帖子
4. 发布到多个平台

常见问题

安装问题

Q: 安装过程中出现错误怎么办？

A: 确保您的操作系统满足系统要求，并且有足够的权限安装软件。如果仍然出现错误，可以联系 ArkClaw 支持团队。

Q: 安装后无法启动怎么办？

A: 检查是否有足够的系统资源，并且没有防火墙或安全软件阻止 ArkClaw 运行。

使用问题

Q: 如何配置 AI 服务？

A: 在「设置」>「AI 服务」中，选择要配置的 AI 服务，输入 API 密钥并保存。

Q: 如何创建自定义工作流？

A: 在「工作流」页面，点击「创建工作流」按钮，使用可视化编辑器配置触发条件和执行步骤。

Q: 如何使用 API 集成？

A: 在「API」页面，点击「创建集成」按钮，配置 API 连接参数和认证信息。

技术问题

Q: ArkClaw 支持哪些 AI 服务？

A: ArkClaw 支持 OpenAI、Google、Anthropic 等主流 AI 服务，您可以在「设置」>「AI 服务」中配置。

Q: 如何备份 ArkClaw 数据？

A: 在「设置」>「备份」中，可以备份和恢复 ArkClaw 的数据。

其他问题

Q: 如何获取帮助？

A: 可以查看官方文档、联系支持团队，或加入社区论坛。

Q: 如何升级到最新版本？

A: 在「设置」>「关于」中，点击「检查更新」按钮，按照提示完成升级。