macOS 应用引导

概述

本指南描述了 Clawdbot macOS 应用的首次运行引导体验，涵盖从初始启动到代理引导的设置过程。

设置流程

引导遵循 8 个步骤：

步骤 1：欢迎

初始欢迎屏幕，包含关于 Clawdbot 功能的安全提示。

步骤 2：Gateway 选择

选择你的 Gateway 模式：

步骤 3：认证

对于本地设置，使用你的 AI 提供商进行认证：

• Anthropic OAuth - 适用于 Claude Pro/Max 订阅者
• Anthropic API Key - 直接 API 访问
• OpenAI - GPT 模型
• 其他提供商 - 各种选项

OAuth 流程会打开浏览器进行 PKCE 认证。在提示时粘贴代码/状态值。

凭证存储在：~/.clawdbot/credentials/oauth.json

步骤 4：设置向导

Gateway 驱动的配置：

• 端口和网络设置
• 频道集成
• 技能安装

步骤 5：权限

macOS 需要显式授予权限：

按提示授予权限。某些功能需要特定权限才能运行。

步骤 6：CLI 安装

可选安装全局 clawdbot 命令：

# 安装到 /usr/local/bin/clawdbot
clawdbot --version

步骤 7：引导聊天

用于代理介绍的专用会话：

• 代理创建工作区（~/.clawdbot/workspace）
• 初始化文件：AGENTS.md、BOOTSTRAP.md、IDENTITY.md、USER.md
• 进行问答以个性化你的体验
• 了解你的偏好和使用场景

步骤 8：就绪

设置完成。你现在可以：

• 与你的助手聊天
• 配置其他频道
• 安装技能
• 自定义你的工作区

Gateway 模式

本地模式

• Gateway 在你的 Mac 上运行
• OAuth 流程直接工作
• 凭证存储在本地
• 最适合个人使用

远程模式

使用远程 Gateway 时：

• 所有凭证位于 Gateway 主机上
• 工作区文件在远程机器上
• 本地 Mac 仅作为客户端
• 适用于共享或服务器部署

代理引导

首次运行时，代理会：

1. 创建工作区目录
2. 初始化指令文件
3. 进行个性化问答
4. 配置初始偏好

引导文件

故障排除

权限问题

如果功能不工作：

1. 打开系统偏好设置 → 隐私与安全性
2. 检查每个权限类别
3. 确保 Clawdbot 已启用
4. 如需要，重启应用

OAuth 失败

如果认证失败：

1. 检查你的网络连接
2. 验证你的订阅状态
3. 尝试手动输入 API 密钥
4. 检查 ~/.clawdbot/credentials/ 是否有问题

Gateway 无法启动

1. 检查端口 18789 是否可用
2. 查看 /tmp/clawdbot/ 中的日志
3. 从终端尝试 clawdbot health

下一步

• 设置指南 - 详细配置
• 构建助手 - 创建你的助手
• 频道 - 连接消息平台