APP 快速上手

从零安装桌面 APP 到完成第一个任务，大约需要 10 分钟。

为什么要用桌面 APP

Web 端是工作空间的"遥控器"，桌面 APP 是真正的"执行端"。只有 APP 端能：

• ✅ 读写本地文件（整理目录、生成报告、修改代码）
• ✅ 执行 Shell 命令（npm install、git 操作、运行脚本）
• ✅ 接入 IM 渠道（Telegram、钉钉、飞书、Teams 等 14+ 平台）
• ✅ 创建定时任务（每天自动跑、Cron 表达式、通知推送）
• ✅ 配置 LLM 模型（多家 API Key、能力标记）
• ✅ 装 MCP 工具（扩展 AI 能力）
• ✅ 沙箱执行（隔离运行不信任的代码）
• ✅ 管理账户记忆（查看、编辑、图谱可视化）

Web 端虽然界面更轻，但所有"动手做"的能力必须由至少一台 APP 节点提供。

第 1 步 · 下载与安装

获取安装包

平台支持

第 2 步 · 启动与登录

1. 在应用列表或 Launchpad 中找到 Workspace（macOS）/ Workspace（Windows）并启动
2. 首次启动显示登录界面
3. 使用与 Web 端相同的企业账户登录（邮箱/手机号/SSO）
4. 登录成功后，APP 自动注册为节点到 Gateway

登录后默认进入 Claw 对话页面。左侧菜单依次是 Claw / Search / 工作流 / 智能体，底部是 ⚙️ 设置 / 🌐 语言 / 🟢 用户头像。

第 3 步 · 配置一个 LLM 模型

Agent 需要至少一个 LLM 才能工作。桌面 APP 独有"模型配置"功能 —— 你需要提供一个 API Key。

推荐首选：Claude Sonnet 4

1. 左下角点击 ⚙️ 设置
2. 左侧菜单选择 模型
3. 点击 + 添加模型
4. 选择供应商 Anthropic
5. 粘贴你的 Anthropic API Key（从 https://console.anthropic.com 获取）
6. 选择模型 claude-sonnet-4 或 claude-3-5-sonnet
7. 保存

模型选型速查

详细的选型建议和能力矩阵见 模型配置 和 支持的模型列表。

第 4 步 · 第一次对话

回到 Claw（左侧菜单第一项）：

1. 输入框下方显示：
   • 节点名称：Workspace (你的电脑名)
   • 模型：刚才配置的模型
   • 工作目录：默认是你的主目录（点击可切换）
2. 输入一个任务（例如 列出我桌面上的所有文件）
3. 按 Enter 发送

Agent 会：

• 自动调用 List Directory 工具
• 实时流式显示执行过程
• 完成后输出结果

第 5 步 · 试试真正的工具调用

试一些更复杂的任务来感受 Agent Loop：

简单任务

                      
                      帮我在桌面创建一个 hello.txt 文件，内容是"Hello from Workspace"

                    

→ Agent 调用 Write File 工具，自动创建文件

需要确认的命令（首次会弹窗）

                      
                      在桌面创建一个 demo 目录，初始化为 git 仓库

                    

→ Agent 调用 Bash（P1 级别工具，第一次会弹权限确认窗口）
→ 看清命令后点"允许"或"总是允许"

多步任务（体验 Agent Loop）

                      
                      帮我整理桌面文件：
1. 按扩展名分类（图片 / 文档 / 代码 / 其他）
2. 为每类创建子目录
3. 把文件移动到对应目录

                    

→ Agent 自动分解为多步：列文件 → 分类 → 创建目录 → 移动文件
→ 你在对话中能看到每一步的工具调用

第 6 步 · 开启自动化能力

到这一步你已经会用基础能力。接下来是 APP 独有的"超能力"：

🤖 定时任务（让 Agent 定期自动跑）

设置 → 定时任务 → 新建。详见 定时任务。

💬 IM 渠道（让团队在群里用 AI）

设置 → 渠道 → 选择 Telegram / 钉钉 / 飞书等，按步骤配置。详见 渠道配置。

🧩 MCP 工具（扩展更多能力）

设置 → 工具 → MCP 工具区 → 添加 MCP 服务器。详见 工具管理。

🧠 预注册子代理（配置专业角色）

设置 → 子代理 → 新建（如"代码审查员"、"文档编写者"）。详见 子代理管理。

🛡️ 运行时安全（调整工具权限级别）

设置 → 运行时安全 → 调整 Bash/Web Fetch 等工具的 P0/P1/P2 级别。详见 运行时安全。

第 7 步 · 让 AI 记住你

在对话中说：

                      
                      请记住，我偏好用 TypeScript 写代码，代码风格使用 2 空格缩进。

                    

Agent 会调用 memory_manage 工具写入账户记忆。下次新建对话时，这个偏好会自动注入，Agent 自然就会按你的偏好回复。

在 APP → 设置 → 记忆 中可以查看、编辑、删除所有记忆，也支持图谱可视化查看知识点间的关联。详见 记忆管理。

常见问题

Q：Web 端怎么知道 APP 已经在线

Web 端 → 空间管理 → Claw 菜单查看节点列表。你的 APP 应该显示为 Agent 类型节点。如果看不到，检查 APP 是否已登录且网络正常。

Q：让团队同事也能用我这台 APP

把 APP 节点设为 enterprise 范围：

1. APP → 设置 → 运行时安全 → 节点
2. 把节点可见性改为 企业（enterprise）
3. 同组织的成员就能在自己的 Web 端看到并调用这台节点了

注意：设为 enterprise 意味着同事的任务可能会在你的电脑上运行，包括文件读写和命令执行。请确认你信任团队成员。

Q：APP 可以多开吗

同一账户不建议多开 —— 会产生多个节点注册，可能引起路由混乱。如果需要多设备协作，每台设备一台 APP。

Q：能不能离线使用

大部分功能需要连接 Gateway 和 LLM API，离线不可用。未来可能支持部分本地离线能力（如本地 LLM）。

下一步

• 想全面了解 APP 设置 → APP 设置总览
• 想学高阶用法 → 对话交互、子代理
• 想管理组织 → 空间管理总览