首次运行 (Archive)
Archived original-language source from the legacy CrabClaw docs. This page is intentionally not machine-translated.
安装完成后，首次打开 Crab Claw（蟹爪）会进入引导流程，帮助你完成初始配置。整个过程约 2-3 分钟。
引导流程概览
打开应用 → 系统权限 → 选择 Gateway 模式 → 配置认证 → 权限授予 → 引导对话打开应用 → 系统权限 → 选择 Gateway 模式 → 配置认证 → 权限授予 → 引导对话第一步：系统安全确认
首次启动时，操作系统可能弹出安全提示：
- macOS：Gatekeeper 安全确认，点击"打开"
- macOS：本地网络访问权限请求，点击"允许"
- Windows：SmartScreen 筛选器提示，点击"仍要运行"
Note: 这些是操作系统层级的标准安全确认，非应用行为。
第二步：选择 Gateway 模式
Gateway 是 Crab Claw 的核心服务引擎，负责处理所有 AI 对话、工具调用和频道消息。
| 模式 | 适用场景 | 说明 |
|---|---|---|
| 本机（推荐） | 个人使用 | Gateway 运行在本机，支持 OAuth 认证流程，数据完全本地化 |
| 远程 | 团队/服务器部署 | 连接到远程主机上的 Gateway，通过 SSH 或 Tailnet 访问 |
| 稍后配置 | 先体验界面 | 跳过设置，保持应用未配置状态 |
Tip: 大多数用户选择 "本机" 即可。Gateway 会以后台服务运行，不影响日常使用。
第三步：配置模型认证
选择你的 AI 模型提供商并配置认证：
Anthropic（推荐）
- API Key：输入
ANTHROPIC_API_KEY，保存后用于守护进程 - OAuth：通过浏览器完成认证流程（macOS 会检查 Keychain 中的已有凭证）
- Setup Token：在其他机器运行
claude setup-token，粘贴 token 到此处
OpenAI
- API Key：输入
OPENAI_API_KEY - OAuth（Code 订阅）：浏览器认证流程，粘贴
code#state - 配置后默认模型自动切换为
openai/gpt-5.1-codex
其他提供商
支持 xAI (Grok)、MiniMax、Moonshot (Kimi)、Cloudflare AI Gateway、Vercel AI Gateway 等。 在设置中选择对应提供商并输入 API Key 即可。
第四步：系统权限授予（macOS）
macOS 用户会被请求以下权限，根据需要选择授予：
| 权限 | 用途 | 是否必需 |
|---|---|---|
| 自动化（AppleScript） | 控制其他应用执行自动化任务 | 推荐 |
| 通知 | 消息到达和任务完成提醒 | 推荐 |
| 辅助功能 | 界面元素识别和操作 | 视觉功能需要 |
| 屏幕录制 | 视觉子智能体（灵瞳）屏幕理解 | 视觉功能需要 |
| 麦克风 | 语音输入和语音识别 | 可选 |
| 摄像头 | 视觉交互功能 | 可选 |
Tip: 权限可以随时在
系统设置 → 隐私与安全性中调整。
第五步：引导对话
所有设置完成后，应用会自动打开一个专属引导对话。智能体会：
- 自我介绍并说明能力范围
- 引导你熟悉核心功能
- 建议接下来可以尝试的操作
Note: 引导对话是独立的专用会话，不会和后续的正常对话混在一起。
配置文件位置
设置完成后，应用配置保存在以下位置：
| 内容 | 路径 |
|---|---|
| 主配置文件 | ~/.crabclaw/crabclaw.json |
| 工作区 | ~/.crabclaw/workspace/ |
| 认证凭证 | ~/.crabclaw/credentials/ |
| Agent 档案 | ~/.crabclaw/agents/ |
重新配置
如果需要修改配置，可以通过以下方式重新进入设置：
- 应用内：
设置 → 更新与安装进入安装向导 - 应用内：
设置 → 模型与认证修改模型配置 - 如果配置损坏，应用会自动进入恢复模式