创建第一个 Agent (Archive)

Archived original-language source from the legacy CrabClaw docs. This page is intentionally not machine-translated.

本指南将带你在 5 分钟内创建并运行第一个 AI 智能体。

前置条件

• Crab Claw 已安装（参见 安装指南）
• 已完成首次运行配置（参见 首次运行）
• 至少配置了一个模型提供商的 API Key

第一步：创建工作区

crabclaw agent add my-first-agent

crabclaw agent add my-first-agent

这会在 ~/.crabclaw/agents/my-first-agent/agent/ 下创建工作区目录，包含以下模板文件：

第二步：配置 Agent 人格

编辑 SOUL.md，定义智能体的基本人格：

# 人格

你是一个友好、高效的个人助理。

## 边界

- 不执行危险的系统命令
- 不访问敏感隐私数据
- 操作前先确认用户意图

## 语气

简洁明了，中文优先。遇到不确定的问题，坦诚说明。

# 人格

你是一个友好、高效的个人助理。

## 边界

- 不执行危险的系统命令
- 不访问敏感隐私数据
- 操作前先确认用户意图

## 语气

简洁明了，中文优先。遇到不确定的问题，坦诚说明。

第三步：开始对话

方式一：命令行

crabclaw gateway

crabclaw gateway

Gateway 启动后，打开浏览器访问 http://127.0.0.1:18789/ 进入 Control UI。

方式二：消息频道

如果你已配置 Telegram、Discord 等频道，可以直接通过这些频道与智能体对话。

第四步：测试能力

试着发送以下消息测试智能体的不同能力：

你好，自我介绍一下    → 测试基本对话
帮我搜索一下 Rust 语言的最新版本  → 测试网页搜索
读取 ~/Desktop/test.txt 的内容   → 测试文件读取

你好，自我介绍一下    → 测试基本对话
帮我搜索一下 Rust 语言的最新版本  → 测试网页搜索
读取 ~/Desktop/test.txt 的内容   → 测试文件读取

理解 Agent 生命周期

用户消息 → 意图分析 → 工具匹配 → 技能注入 → LLM 处理 → 工具执行 → 回复用户

用户消息 → 意图分析 → 工具匹配 → 技能注入 → LLM 处理 → 工具执行 → 回复用户

1. 意图分析: 系统分析消息的意图层级（问候/查询/任务等）
2. 工具匹配: 根据意图从能力树中匹配可用工具
3. 技能注入: 将匹配工具的 SKILL.md 指令注入 LLM 上下文
4. LLM 处理: 模型生成回复或工具调用
5. 工具执行: 执行工具调用（需审批的操作会先请求确认）
6. 回复用户: 将结果通过当前频道返回

下一步

• 工具系统 — 了解可用的内置工具
• 消息频道 — 接入 Telegram、Discord 等频道
• 定时任务 — 配置定期执行的自动化任务