无需编程基础,将逐步指导你完成从准备到实际使用的全过程。内容涵盖AI模型API Key的获取、Windows/Mac/Linux多系统安装流程、配置方法及使用技巧,并解决安装失败、操作不熟练等常见问题。它是一款能够全天候工作的电脑AI助手,可自动浏览网页、编写代码、处理日常办公任务。跟随本指南操作,即可轻松拥有你的专属智能助理。
一、了解小龙虾(OpenClaw)是什么?无需编程知识!它是一个运行在你电脑中的“AI私人助理”,能够帮助你完成以下任务:
✅ 自动浏览网页、填写表单、查询资料(解放双手)
✅ 操作电脑:安装软件、编写代码、发送邮件(替代重复性劳动)
✅ 全天候运行,在你休息时持续工作
✅ 具备学习能力,逐渐适应你的使用习惯和需求
核心原理:小龙虾本身是一个工具框架,需要配合“AI模型”才能发挥作用,类似于拥有厨房后还需厨师才能烹饪。
二、第一步:准备工作(完成两项内容)1. 费用与系统要求
- 软件本身:永久免费使用
- AI模型:根据使用量计费,普通用户月费在合理范围内
- 电脑配置:支持Windows、Mac、Linux系统,近五年购买的设备均可流畅运行(建议使用备用电脑,以免影响主要工作)
2. 获取API Key
这是关键步骤!“API Key”是你与AI模型建立连接的凭证,请妥善保管。
操作步骤:
- 根据指引完成相应操作
- 在账户信息中找到“API Key”(由字母和数字组成的字符串)
- 复制该密钥并暂存至文本文件中(后续步骤将使用)
请根据您的操作系统选择对应的安装步骤,直接复制命令使用,无需修改。
情况一:Mac 用户(苹果电脑)
- 打开“终端”:按下
Command + 空格,输入“终端”,然后按回车键(如果找不到,可直接搜索“终端”)。 - 复制以下命令,粘贴到终端窗口中,按回车执行:
curl -fsSL https://clawd.org.cn/install.sh | bash -s -- --registry https://registry.npmmirror.com - 等待 1 到 3 分钟,当终端显示 “OpenClaw installed successfully!” 即表示安装成功。
情况二:Windows 用户
- 打开“PowerShell”:右键点击屏幕左下角的“开始”菜单,选择“Windows PowerShell”。
- 复制以下命令,粘贴到 PowerShell 窗口中,按回车执行:
iwr -useb https://clawd.org.cn/install.ps1 -OutFile install.ps1; ./install.ps1 -Registry https://registry.npmmirror.com - 等待安装过程完成(期间请勿关闭窗口,保持耐心)。
若安装失败,可按以下步骤排查
- 首先安装 “Node.js”:在搜索引擎中查找 “Node.js 官网下载”,根据指引完成安装(通常只需一路点击“下一步”即可)。
- 重新运行上述安装命令。
- 如果问题依旧存在,可以参考相关技术社区的安装指南文档。
安装完成后,需要进行两项基础配置才能正常使用。
1. 设置 API Key 与工作路径
安装过程中,终端会提示您进行配置:
- 当询问“工作空间安装路径”时,直接按回车键使用默认路径即可。
- 当询问“AI 模型的 API Key”时,请将之前保存的密钥粘贴进去,然后按回车确认。
2. 安装核心功能模块(共需安装 4 个)
小龙虾的核心功能由不同的模块提供,请按顺序执行以下命令。每个命令粘贴到终端后按回车执行,请等待前一个命令执行完成后再输入下一个。
# 1. 浏览器操作模块(用于网页浏览、表单填写等)
claw install browser
# 2. 桌面控制模块(用于软件安装、代码编写等)
claw install desktop-control
# 3. 记忆模块(用于记录用户习惯)
claw install vector-memory
# 4. 自动更新模块(用于自动升级版本)
claw install auto-updater
3. 访问操作界面
完成所有配置后,打开您的网页浏览器,在地址栏输入:http://127.0.0.1:18789/,即可访问小龙虾的操作界面。
无需学习复杂操作,只需在操作界面或终端中说出以下指令,小龙虾即可执行相应任务:
- 基础操作:“帮我打开百度”、“搜索 2026 年最新 AI 新闻”
- 办公操作:“帮我写一封工作汇报邮件”、“提醒我明天上午 10 点开会”
- 电脑操作:“帮我安装微信”、“整理桌面文件到对应文件夹”
助手的智能不会自动提升,但你可以通过编辑文件让它越来越了解你的需求。核心在于使用三层“Markdown文件”(后缀为.md,可使用记事本等文本编辑器编辑),这些文件位于安装时指定的工作路径中,打开即可修改。
核心原则:不是调整模型,而是完善文件!
第一天和第四十天使用的是同一个AI模型,但经过四十天的文件积累,助手将更贴合你的使用习惯,这才是提升体验的关键。
三层文件结构说明与示例
第一层:身份层(定义助手的基本属性和服务对象)
-
SOUL.md(人格文件):定义其性格与职责
# SOUL.md ## 核心身份:我的办公助手 性格:细致、高效、言简意赅 职责:协助处理日常工作事务(记录笔记、整理文件、撰写文案) 原则:1. 不泄露个人隐私信息 2. 所有输出简洁明确 3. 不确定的事项需先确认 -
IDENTITY.md(标识文件):提供快速参考,便于多智能体协作时识别
- 名称:小爪 - 角色:办公助手 - 风格:高效、可靠、简洁 - 常用表情符号:✅ - USER.md(用户档案):记录你的基本情况和偏好
- 姓名:张三 - 时区:中国北京(作息规律,23点后不发送提醒) - 职业:互联网运营 - 偏好:1. 文案简洁,避免冗长 2. 文件按“日期+名称”格式整理 3. 不推荐口味较重的餐厅(偏好清淡饮食)
第二层:操作层(定义工作流程与自我维护机制)
-
AGENTS.md(行为规则):规定其工作流程
# AGENTS.md ## 每次会话前执行: 1. 读取SOUL.md(确认自身身份) 2. 读取USER.md(确认服务对象) 3. 查阅最近2天的日志(了解近期动态) ## 记忆规则: - 当用户指示“记住这个”时,将信息写入记忆文件 - 系统重启后不保留临时记忆,需依赖文件记录 ## 安全规则: - 不直接删除重要文件(可移至回收站) - 不泄露手机号、邮箱等个人隐私信息 - HEARTBEAT.md(自我修复机制):在出现异常时自动执行恢复操作
## 健康检查(每次启动时执行) 1. 检查浏览器是否正常运行,若无法打开则自动重启 2. 检查定时任务是否超时(超过26小时则发出提醒) 3. 监控常用功能(如浏览器、桌面控制)状态,发现异常则尝试自动重新安装
第三层:知识层(助手的记忆库)
- MEMORY.md(长期记忆):记录重要事项(无需记录琐碎信息)
# MEMORY.md ## 重要偏好: - 汇报邮件标题格式:【日期】+【事项】+【汇报人】 - 桌面文件分类:工作/生活/素材/临时 ## 经验记录: - 2026年3月5日:曾误删“工作素材”文件夹,此后删除操作前需确认
Q1:API Key 丢失如何处理?
A:前往您购买 AI 模型服务的平台,在个人中心的 API 管理页面重新生成密钥即可。
Q2:该工具是否会泄露个人隐私?
A:不会。API Key 仅存储在您的本地设备中,不会上传至任何服务器,相比网页版 AI 工具具有更高的安全性。
Q3:月度使用费用是否会超出预期?
A:普通用户每月费用通常在 7.9 至 49 元之间。只有在频繁执行复杂任务(如撰写长篇内容或长时间数据采集)时才会产生额外费用,您可以在 AI 平台中设置消费限额以控制支出。
Q4:是否可以同时管理多个独立实例?
A:可以。只需为每个实例创建独立的工作目录并分别配置身份文件,例如分别用于处理工作事务与生活事务。
随时随地看视频