把 NetClaw Agent 装到你的电脑里 — 一步都不省略
这是一份给从来没装过软件的人看的 NetClaw Agent 安装教程。所有安装包都打包好挂在 netclawsec.com/download 上——下载对应你系统的 ZIP、解压、双击一个文件,剩下的全是浏览器里点几下,就能让 NetClaw Agent(你电脑里的 AI 助手)跑起来。
NetClaw Agent 是一款"住在你电脑里的 AI 助手"——基于 Hermes 改造,自带网页版界面(WebUI)。装好以后会自动打开浏览器,你在网页里跟它聊天、让它帮你写文档、改文件、做数据分析,不需要打开命令行、不需要装 VSCode、不需要懂代码。
NetClaw API(在 netclawapi.top 注册)就是"它跟 AI 大模型说话用的钱包"。你在 netclawapi.top 充人民币 → 拿一把"密钥"(API key) → 把密钥粘贴到 NetClaw Agent 的引导页 → 它就能正常工作了。
- 一台 Mac(必须是 M1/M2/M3/M4 芯片)或 Windows 10/11 电脑,能上网
- 一个手机号(用来在 netclawapi.top 收注册短信)
- 能用微信或支付宝付钱(最低 10 元起)
- 大约 15–25 分钟的连续时间
本教程的所有安装包统一挂在 netclawsec.com/download。Mac 和 Windows 各一个 ZIP,按你的系统下对应那个就行。
下载安装包并解压
所有安装包挂在 netclawsec.com/download。页面上有两个 ZIP——netclaw-agent-mac.zip(给苹果电脑)和 netclaw-agent-windows.zip(给微软电脑)。按你电脑系统下对应的那个,另一个不用管。
选你的操作系统
在 Mac 上下载并解压
-
用浏览器(Safari / Chrome 都行)打开 netclawsec.com/download。
页面上能看到两个下载卡片,找到"macOS"那一张。
-
点 macOS 卡片上的"下载 ZIP"按钮。
浏览器会下载
netclaw-agent-mac.zip(约 67 MB,国内通常 30 秒–1 分钟)。下载完成的文件默认放在"下载"文件夹(Finder 左侧栏可见)。 -
到"下载"文件夹里,双击 zip 文件。
Mac 会自动解压出一个同名文件夹
netclaw-agent-mac,里面有这几个文件:NetClaw-Assistant-macOS-Portable.tar.gz— 便携版压缩包(约 67 MB)NetClaw助手-macOS一键启动WebUI浏览器.command— 一键安装并启动浏览器的脚本README.txt— 文字版安装提示
下载文件夹里出现了 netclaw-agent-mac 文件夹,里面能看见 .dmg 和 .command 两个文件。下一步双击 .command 那个就行。
在 Windows 上下载并解压
-
用浏览器(Edge / Chrome 都行)打开 netclawsec.com/download。
页面上能看到两个下载卡片,找到"Windows"那一张。
-
点 Windows 卡片上的"下载 ZIP"按钮。
浏览器会下载
netclaw-agent-windows.zip(约 55 MB)。下载完成的文件默认放在"下载"文件夹(资源管理器左侧栏可见)。 -
右键单击 zip 文件 → 选"全部解压" → 弹窗里点"解压"。
解压出来一个同名文件夹
netclaw-agent-windows,里面有:NetClaw-Assistant-Portable-USB.tar.gz— 便携版压缩包NetClaw助手-Windows一键启动WebUI浏览器.cmd— 一键启动脚本NetClaw-API-Key.url— 一键打开 API key 申请页的快捷方式README.txt— 文字版安装提示
必须先"全部解压"得到一个独立文件夹,然后在那个文件夹里双击 .cmd。不解压、直接在 zip 浏览界面里双击会因为找不到旁边的 .tar.gz 而失败。
NetClaw Agent 的 Windows 版是"便携版"——程序、配置、聊天记录都放在那个解压出来的文件夹里。建议把解压出的 netclaw-agent-windows 文件夹整个移到一个稳定位置(比如 D:\NetClaw\ 或桌面),不要留在"下载"里——以后清下载文件夹会被一起删。
解压出的文件夹里能看见 .tar.gz 和 .cmd 两个文件。下一步双击 .cmd 那个就行。
双击运行一键安装脚本
解压出的文件夹里那个"一键启动脚本"会自动帮你做几件事:(1) 把安装包解压/挂载、(2) 把 NetClaw Agent 复制到电脑上能找到的位置、(3) 立刻打开浏览器 / Agent 窗口。整个过程你只需要双击 + 等几秒。
选你的操作系统
在 Mac 上一键安装
-
在解压出的
netclaw-agent-mac文件夹里,双击NetClaw助手-macOS一键启动WebUI浏览器.command。双击后会自动弹出一个 Terminal 黑窗口,里面会一行行刷出
[NetClaw] 准备安装 NetClaw Agent.app之类的提示。 -
很可能第一次双击时 Mac 会弹一个红色警告框:"无法打开 NetClaw助手-macOS一键启动WebUI浏览器.command,因为无法验证开发者"。这是 macOS Gatekeeper 的标准保护。
解决办法(任选其一):
- 方法 A(最快):把警告框关掉。右键单击那个 .command 文件 → 选"打开"。再次弹出的对话框里有一个"打开"按钮(这次是可点的),点它即可。
- 方法 B:警告框关掉。打开"系统设置" → "隐私与安全性"。在底部"安全性"区域会有一行"已阻止使用 NetClaw助手-macOS一键启动WebUI浏览器.command,因为来自身份不明的开发者",右边点"仍要打开",按提示输入电脑开机密码即可。
-
脚本运行过程会显示几行进度,类似:
[NetClaw] [01] 检查 macOS 运行环境 [NetClaw] [02] 首次准备 macOS 便携版,请不要拔出 U 盘 [NetClaw] [03] 清理未完成的旧解压目录 [NetClaw] 解压 12345 个文件...... 完成 [NetClaw] [04] 设置启动权限 [NetClaw] [05] 启动 WebUI 并打开浏览器看到最后一行"已完成"就说明装好了。这个 Terminal 窗口可以直接关。
-
默认浏览器(Safari / Chrome)会自动打开
http://127.0.0.1:9119——这个网址是 NetClaw Agent 在你本机起的一个小服务器,只有你自己能访问,不上互联网。页面上能看到一个"请粘贴 NetClaw API key"或类似的输入框,就说明装机部分完成。下一步去网上申请这把 key。
整个程序被解压到了你下载文件夹里的 netclaw-agent-mac/NetClaw-Assistant-macOS-Portable/(包括 Python 运行时、配置、聊天记录、缓存)。这是"便携版" — 不写注册表、不污染系统,但反过来意味着 这个文件夹就是它的家,不要删。建议把 netclaw-agent-mac 整个文件夹移到一个稳定位置(比如桌面或 ~/Documents/),日常使用就再次双击同一个 .command 即可秒启动。
说明你的 Mac 是 Intel 芯片,跑不了这个 zip。本教程随附的安装包只支持 M1/M2/M3/M4。Intel Mac 用户需要联系技术支持取 Intel 版安装包。
NetClaw Agent 窗口(或浏览器里的 WebUI)已经自动打开,正在向你要 API key。先不要关,等下第 6 步要回来用。下面 4 步先去 netclawapi.top 把 key 弄到手。
在 Windows 上一键启动
-
在解压出的
netclaw-agent-windows文件夹里,双击NetClaw助手-Windows一键启动WebUI浏览器.cmd。会跳出一个黑色的 CMD 窗口。第一次启动时会显示"正在首次准备 NetClaw 助手便携版..."并解压一会儿(约 30–60 秒)。以后再点这个文件就直接启动,秒开。
-
可能弹出 SmartScreen 警告:"Windows 已保护你的电脑"。
这是 Windows 对未签名脚本的标准提示。点窗口里的"更多信息"链接,下方会出现一个"仍要运行"按钮,点它即可。
-
解压完成后,CMD 窗口会自动启动
NetClaw-Assistant.exe——一个独立的应用程序窗口会跳出来,里面就是 NetClaw Agent 的 WebUI。页面上能看到一个"请粘贴 NetClaw API key"或类似的输入框,就说明启动成功。
所有数据展开到了你解压出的 netclaw-agent-windows\NetClaw-Assistant-Portable\ 目录下(包括程序、配置、聊天记录、缓存)。这个版本是"便携版"——程序不写注册表、不污染系统,但反过来意味着 这个文件夹就是它的家。不要再删了。下次想用:再次双击 NetClaw助手-Windows一键启动WebUI浏览器.cmd 即可(会秒启动);想换电脑就把整个 netclaw-agent-windows 文件夹复制走。
意思是 .cmd 旁边没找到 NetClaw-Assistant-Portable-USB.tar.gz。最常见的原因是 没"全部解压",直接在 zip 浏览界面里双击 .cmd。回到第 1 步重新解压一遍。
NetClaw Agent 应用窗口已经打开,里面 WebUI 在向你要 API key。先不要关,等下第 6 步要回来用。下面 4 步先去 netclawapi.top 把 key 弄到手。
在 netclawapi.top 注册账号
NetClaw Agent 自己只是一个壳——真正帮你思考的是后面的 AI 大模型。netclawapi.top 是为它配套的"模型供应商"——你给它充人民币,它替你跟 Claude / GPT 等大模型对接。一句话:在这边注册账号 → 充人民币 → 拿到 API 密钥 → 把密钥粘贴到 NetClaw Agent 的引导页 → Agent 就能开始正常工作。
步骤
-
用浏览器打开网址 https://netclawapi.top/。
页面会是这样的深色风格——中间有 hero 文案"让 AI 为你 ...",右上角有"开始使用"按钮:
-
点右上角的"开始使用"按钮,会弹出登录窗口。
新用户也走这个入口——你只要选"手机登录"输手机号 + 短信验证码,系统就会自动给你建账号(不需要单独注册流程)。
-
填写手机号 → 点"获取验证码" → 在手机短信里看到 6 位数字 → 填进"验证码"格子。
同时上面会有一张图形验证码(4 位数字),照着填进去。
-
勾上下面那一行"我已阅读并同意《用户协议》和《隐私政策》"。
不勾上"立即登录"按钮就是灰色的、点不了。
-
点"立即登录"。
登录成功后会自动跳到你的"控制台"(dashboard)页面——下一步就在这里操作。
登录弹窗消失,页面变成你的"控制台",能看到余额、套餐、API 密钥这些卡片。注册阶段完成。
充值(最低 10 元就能开始用)
NetClaw Agent 跟大模型说话是按"调用次数"扣钱的。每次调用大约几分到几毛钱(看模型和问题长度),所以充 10 块钱其实能用很久。等你用顺手了再充更多。
步骤
-
登录后会先看到这样的"控制台"页面:
左边竖排菜单,最显眼位置是"账户余额"卡片(新账户为 ¥0)。
- 点左上角顶部的"充值"按钮,会弹出充值窗口:
-
点 ¥10(或者直接输入自定义金额,最低 1 元)。
新手第一次推荐先充 10 元。等你确认全流程跑通、Claude Code 真能在你电脑里聊天了,再考虑充 100 或更多。
-
选"微信支付"或"支付宝"。
选好后,下方会出现一个二维码 + 应付金额。
-
用手机打开微信/支付宝 → 点"扫一扫" → 对准电脑屏幕上的二维码。
手机上会弹出付款确认页,输入支付密码或人脸识别,点"确认付款"。
- 电脑上的页面会自动跳到"支付成功",余额刷新到 ¥10.00。
用 Claude Sonnet 或 Haiku 模型聊天,一来一回大概几分到几毛钱。10 块钱够你试用相当长一段时间。如果出现 Opus 这种贵模型,单次对话可能 0.5-2 元,量大要注意。后续学会"看用量"再说。
余额从 ¥0 变成 ¥10(或你充的金额)。回到首页能看到"账户余额"那张卡片显示新的数字。
创建一把"API 密钥"
API 密钥是一串很长的字符(看起来像 sk-ncw-prod-XXXXXXXX...,一般 50 来个字母数字),可以理解成"让 NetClaw Agent 能用你账号余额的钥匙"。这把钥匙等于钱——任何拿到钥匙的人都能用你的余额,所以一定要保管好。
步骤
-
访问 netclawapi.top/apidoc,点页面顶部的"管理 API 密钥"按钮,弹出密钥管理窗口。
已有账号会显示已创建的密钥列表(空账号则空表):
- 点右上角"+ 新建密钥"按钮,弹窗内会展开一行创建表单。
-
给密钥起个名字。比如 "NetClaw Agent 主"。
名字只是给你自己分辨用的(同一个账号可以有好几个密钥,比如一个给笔记本、一个给台式机,方便分别管理)。
- 选择渠道策略(默认"价格优先"即可,省钱)。
- 点蓝色"确认创建"按钮,立即生成完整密钥字符串:
把刚才复制的密钥立刻贴到 Mac 的"备忘录" / Windows 的"记事本"里保存。命名为 "NetClaw Agent API key"。下面第 6 步就要用它。
如果不小心关了弹窗没复制到——回到密钥列表,把刚建的那条"删除",然后重新"创建新密钥",再小心点。
- 不要发给任何人,包括客服(任何正规客服都不会问你要密钥)
- 截图发任何地方之前,先用马赛克或贴纸把中间一段盖住。可接受样子:
sk-ncw-prod-XXXXXXXXXXX...a8f3(前缀+后 4 位即可,中间务必涂黑) - 不要提交到 GitHub 等公开网站——爬虫几分钟就会扫到,账户余额可能秒空
- 万一不小心泄露:立即回密钥页"禁用"或"删除",再建一把新的
本教程中所有展示密钥的图片都统一打码为 sk-ncw-prod-XXXXXX...。你在自己后台看到的会是完整真实的字符串。请记得:以后你自己截图发出去之前,也要这样打码处理,养成习惯。
把密钥粘贴到 NetClaw Agent
第 2 步装好 NetClaw Agent 后,它的 WebUI 已经打开并停在"引导页"上等你输入 API key。现在你已经从 netclawapi.top 拿到了那串以 sk-ncw- 开头的密钥——把它粘进去就齐活了。
步骤
-
切回 NetClaw Agent 的浏览器标签页(如果不小心关了:双击解压文件夹里的 .command(Mac)/ .cmd(Windows)即可重启,或浏览器里直接访问
http://127.0.0.1:9119)。页面上会有一个标着"NetClaw API Key" / "请粘贴你的 API key"之类的输入框,下方一个"开始"或"完成"按钮。
-
把第 5 步保存好的密钥(
sk-ncw-prod-...)整段粘贴进输入框。记得:以前如果你保存到了备忘录/记事本里,复制时整段都选上,前后不要少字符。
-
点"开始"或"完成"按钮。
如果密钥正确,引导页会自动跳到 NetClaw Agent 的主聊天界面。如果密钥有问题,下方会出红色错误提示——回去检查密钥是否复制完整。
-
试着对它说一句话:
在聊天框输入"你好,请告诉我今天的日期,并简单介绍一下你能帮我做什么。",按回车(或点发送)。几秒后 NetClaw Agent 会回复你一段中文。
NetClaw Agent 给你回复了一段话——说明 装机 + 充值 + 密钥 三件事全部跑通。从今往后,双击解压文件夹里的 .command(Mac)/ .cmd(Windows)就能直接进对话,不用再配任何东西。
意思是 NetClaw API 没认出这把钥匙。常见原因:(1) 复制时漏了字符或多了空格——回到 netclawapi.top 后台 → 密钥管理 → 删旧的、建一把新的、再复制一遍;(2) 密钥被禁用——后台看一眼状态;(3) 在 netclawapi.top 充值还没到账(极少数情况)——等几分钟刷一下后台余额。
账户没钱了。回 netclawapi.top → 充值中心,再充一笔,刷新 NetClaw Agent 即可。
NetClaw Agent 里左下角通常有"设置"或齿轮按钮,点进去能找到"API key"那一项,重新粘贴新值即可。也可以直接编辑配置文件——Mac 在 ~/Library/Application Support/NetClaw Agent/,Windows 在解压目录的 NetClaw-Assistant-Portable\data\netclaw\.env,里面 NETCLAW_API_KEY=... 那一行就是。
常见问题 · 故障排查
Mac 双击 .command 报"无法验证开发者,已被阻止"
这是 macOS Gatekeeper 的标准保护,不代表脚本有问题。两种解决方式(任选其一):
- 右键打开:警告框关掉。在 Finder 里右键单击那个 .command 文件 → 选"打开" → 弹出的对话框里点"打开"。
- 系统设置放行:警告框关掉。打开"系统设置 → 隐私与安全性",底部"安全性"区域有一行"已阻止 ... 因为来自身份不明的开发者",点旁边的"仍要打开"。
Mac 报"当前安装包是 Apple Silicon 版"
说明你的 Mac 是 Intel 芯片。这个 dmg 只支持 M1/M2/M3/M4。Intel Mac 用户需要联系技术支持取 Intel 版安装包。
Mac 报"找不到运行包"或解压失败
意思是 .command 旁边没找到 NetClaw-Assistant-macOS-Portable.tar.gz。最常见的原因:没"双击 zip 解压",直接在压缩包里运行了 .command。回到第 1 步,把下载的 zip 双击解压成独立文件夹后,再进文件夹双击 .command。
Windows 弹"Windows 已保护你的电脑" / SmartScreen 阻止
SmartScreen 对未签名脚本的标准提示。不是病毒。点窗口里的"更多信息"链接 → 下方出现"仍要运行"按钮 → 点它即可。
Windows 报"解压失败"或"找不到 NetClaw-Assistant-Portable-USB.tar.gz"
意思是 .cmd 旁边没找到那个 .tar.gz 文件。最常见的原因:没"全部解压",直接在 zip 浏览界面里双击了 .cmd。
- 右键单击下载的 zip → 选"全部解压" → 弹窗里点"解压",得到一个独立的文件夹。
- 进入这个独立文件夹,再双击 .cmd。
- 如果是把文件夹复制到本机硬盘的,确认整个文件夹都复制走了,包括那个 50+ MB 的 .tar.gz。
引导页粘贴密钥后报 401(密钥无效 / Unauthorized)
NetClaw API 没认出这把钥匙。检查:
- 密钥是不是整段复制了——前面以
sk-ncw-开头,整串大约 50 个字符,前后不能漏 - 密钥是不是已经被你删掉/禁用——去 netclawapi.top 后台 → API 密钥页查状态
- 是不是把测试密钥和正式密钥搞混了——重新建一把,再贴一遍
调用模型报 402 / 余额不足
账户余额没了。回 netclawapi.top 控制台 → 充值中心,再充一笔,回 NetClaw Agent 重新提问即可。
NetClaw Agent 长时间转圈 / 连接超时
常见原因:
- 挂了 VPN/翻墙工具跟 netclawapi.top 打架了。临时关掉 VPN 试试,或者让 VPN 把 netclawapi.top 走"直连"。
- 电脑网络本身慢——切别的 wifi 或开热点试试。
- 选了 Opus 这种重型模型——在 NetClaw Agent 里把模型切到 Sonnet 或 Haiku 会快很多。
怎么换密钥?以前的还能用吗
去 netclawapi.top 后台 API 密钥页:(1) 创建新密钥 → 复制;(2) 把旧密钥"禁用"或"删除"。然后在 NetClaw Agent 里:左下角"设置" / 齿轮按钮 → "API key" → 把旧值替换成新值 → 保存。或者直接编辑配置文件——Mac 在 ~/Library/Application Support/NetClaw Agent/,Windows 在 NetClaw-Assistant-Portable\data\netclaw\.env,里面 NETCLAW_API_KEY=... 那一行就是。
怎么看自己花了多少钱
去 netclawapi.top 后台 → "📈 用量统计"或"📜 调用日志",会按天/按密钥列出每次调用的耗费。
怎么彻底卸载 NetClaw Agent
看你当初怎么装的:
- Mac:把整个解压出的
netclaw-agent-mac文件夹删掉即可——便携版不写系统目录,删完就干净。 - Windows:把整个解压出的
netclaw-agent-windows文件夹删掉即可——便携版不写注册表,删完就干净。
另外去 netclawapi.top 后台把 API 密钥也"禁用 / 删除",防止万一被别人捡走的密钥继续花你的钱。
下载 zip 太慢 / 中途断了
(1) 换浏览器试试(Chrome / Edge / Safari)。(2) 用迅雷之类的下载工具贴 netclawsec.com/download 上"下载 ZIP"按钮的链接(右键 → 复制链接)。(3) 实在不行联系技术支持,可以走 U 盘寄送。
第二天打开 NetClaw Agent 又要我重新粘贴密钥
这通常说明上次没"保存成功"。检查:(1) 第一次粘贴密钥后,引导页有没有真的跳到主聊天界面?没跳就是没保存进去;(2) Windows 用户:解压出来的整个 netclaw-agent-windows 文件夹有没有被移动 / 删除?里面 data\netclaw\.env 是密钥的家。重新粘贴一次,确认看到主聊天界面再关程序。