本文章建议在洛谷观看，尤其是在缺少一些图片的情况下。
（洛谷文章审核中，名为“如何在你的电脑上养龙虾——Openclaw安装教程”）
:::warning[观前提醒]
Openclaw 具有操控你电脑的能力，所以请妥善设置你的龙虾的执行权限，并且在给予完全权限之前再三考虑你在做什么。
本文的内容部分参照于https://www.luogu.com.cn/article/yzuddffa
，未使用生成式人工智能进行内容撰写（但用于校验一些内容）。
:::
:::info[笔者系统]
Windows11 家庭版 25H2。
:::

前言

虽然现在已经过了 Openclaw 的热潮，但谁还不想有一个可以直接帮你干活的 AI 呢？况且经过这几个月的发展，Openclaw 所支持的 API 又更上一层楼了，所以配置起来还是挺容易的。 ——《从零开始的 Openclaw 配置教程》by AetherNight
我懒得写前言了。
在根据上面提到的参照文章安装 Openclaw 的时候遇到了一些问题，于是想到写一些补充。

正文

准备工作

要安装 Openclaw，我们需要安装这些东西：

• Node.js
• Git

此外，我们还需要获取一个模型的 API。

安装 Node.js

访问 Node.js 官方下载页面，在这里选定你的系统和架构，获取安装程序或者独立文件（推荐前者）：

然后一路下一步，途中记得修改安装目录到非系统盘。
到这一步时不要勾选，此选项和 Openclaw 无关且极度耗时：

安装 Git

访问 Git 官方下载页面 获取 Git，点击和你的系统对应的安装包安装（如笔者的电脑应该点击 "Git for Windows/x64 Setup"，注意不要下载 Portable 版本，需要额外的配置）。
如果访问 Github 时出现问题，可以观看这篇文章。
一路默认。
安装的时候建议修改安装路径到你的系统盘以外。
在这个界面建议勾选 "Add a Git Bash Profile to Windows Terminal"，其它选项保持不变。
然后到这个页面选择你常用的编辑器，推荐 VSCode，或者你有别的也行。

注意到上面这两张图的安装页面都是 Windows 10 的 UI，因为作者不想重新下载 Git 了，而且 Windows 11 的下载页面也差不多。

获取一个模型的 API

如果你电脑很好，那么你可以安装本地大模型（见后文）。
如果你有钱并且满 14 （大部分 API 平台需要年满 14 周岁才允许充值），那么你可以去注册付费的 API，配置方法近似（略有不同）。

显然，下文的内容针对 "免费获取 API" 这件事情。要获取免费的 API，我们访问 Agnes 然后按照步骤注册登录。
然后在弹出的页面点击 "创建新的密钥"，填入任意你喜欢的名称，然后点击右侧的复制按钮复制密钥。

安装 Openclaw

写到这里，笔者不得不重新体验一次龟速下载。

:::info[说明]
官方提供的最推荐的下载途径是在 Powershell 运行这行命令：

irm https://openclaw.ai/install.ps1 | iex

但根据笔者实测，在笔者系统上运行这行代码会报错，无法正常下载。这里带来一种另外的下载方法。
本段内容参照 https://docs.openclaw.ai/zh-CN/install#npm、pnpm-或-bun 。
:::
我们可以在 Powershell 中使用 Node.js 的 npm 命令安装：

npm install -g openclaw@latest

（这个是全局安装，不想全局安装的可以删除 -g 参数。）
显示这个页面就是正在下载，等待即可：
然后进行漫漫漫漫漫漫漫漫漫漫漫漫漫漫漫……长的等待。
碎碎念：我已经第三次安装 Openclaw 了……
第二天
当你看到类似这样的界面时，

代表安装已经完成。运行

openclaw onboard --install-daemon

来配置 Openclaw。

配置 Openclaw

运行上面的指令来开始配置。
一直保持默认（按 Enter），直到这个页面：
你可以在这里命名你的 Agent，这里笔者保持默认名称。依旧按 Enter 进入下一个配置项。
在这里按下箭头选择选项 More：

选择 Custom Provider：

API Base URL 填写 https://api.agnes-ai.cn/v1。
下一步选择默认的 Paste API key now，
在输入填写你在 Agnes 平台申请的 API 的密钥。
下一个选项保持默认。
再下一个选项我们填写 agnes-2.5-flash。
Endpoint ID 和 Model alias 保持默认即可。
下一步 Does this model support image input，agnes-2.5-flash 模型拥有图像理解能力，我们用上下箭头选择 Yes。
弹出这行字代表 API 配置完成：
接下来的选项我们可以选择 Yes，让 Openclaw 帮我们测试 API 配置是否正确，如果你有足够的自信也可以选择 No 然后手动对话。
下一步 Select channel 是让你配置接入聊天软件，没有必要可以选择 Skip for now，有这方面需求可以让 Agent 帮你配置。
下一页让你选择 Search Provider，但是这些基本上都要求你提供 API，我们稍后用 skill 实现这一点。
再下一步会让你选择 skill 的依赖，按空格选择 Skip for now，然后按 Enter 确定。
接下来 Openclaw 会自己安装网关，我们等待它安装，当页面类似这样即为完成：

如果你的 Agent 说英文也没有问题，直接问他能不能说中文，Agent 就会开始用中文和你交流。

运行 Openclaw

要打开上文的在 Shell 里运行的聊天页面，只需要输入 openclaw 即可。
但是我们注意到页面显示 disconnected，这是因为我们没有启动网关（配置后 Openclaw 自动在后台启动网关，重启需要手动启动），输入 openclaw gateway 即可启动网关，然后重新启动聊天页面即可。要关闭网关，输入 openclaw gateway stop。
但是在 Shell 里面聊天还是太不优雅了，而且设置比较麻烦，这里提供一种通过面板聊天的方法：在网关开启的情况下在 Shell 里输入 openclaw dashboard，稍等片刻便会开启这样的聊天窗口：

解决一些问题

:::info[哪些问题？]

1. Agnes-2.5-flash 模型支持 512 KB 的上下文窗口，但是 Openclaw 默认上下文大小为 128 KB，这无疑是令人愤怒的。
2. 我们刚才跳过了联网步骤，现在要安装用于联网的 Skill。

:::

解决上下文窗口大小

直接在聊天框里输入“将你的 contextWindow 大小设置为 512000”即可（根据你设置的执行权限，可能需要你的确认或者调整）。

解决联网问题

在聊天框输入 “安装技能 multi-search-engine”，随后重启网关和 dashboard。
聊天输入 “现在的金价是多少？”，应该能得到答案。
（笑点解析，作者第一次问这个问题的时候发现配置失败了）
如果安装失败则你的 Agent 可能因为安全问题给你安装了 multi-search-engine-simple，可以输入“安装@gpyangyoujun/multi-search-engine”来安装原版，实测正常。

配置本地大模型（可选）

:::warning[观前提示]
运行本地大模型需要比较好的显卡且至少有 4~8 G 显存。
:::

安装大模型

安装 Ollama

访问 Ollama 官网，进入后直接点击右上角的 Download，这里推荐点击 Download Manually 下载安装包，包体比较大，下载时间可能较长。
下载后依旧点开安装，由于这个安装程序无法更改下载位置所以请务必确保您的 C 盘空间足够。
下载完成后会弹出一个窗口，直接关掉。

安装大模型

这里以 qwen2.5:7b 为例，运行

ollama pull qwen2.5-7b

拉取模型。

笔者受电脑限制安装此模型，电脑好的可以自己换比较好的模型。

然后重新运行 openclaw onboard --classic，选择 QuickStart。
在 Model/auth provider 页面现在可以看到 Ollama(detected) 选项，选择这个选项。
下一步选择 Ollama；
选择 Local only；
base URL 保持默认；
下一步选择我们安装的模型；
接下来的操作和普通安装相同。
最后选择 Restart，Openclaw 会自动重启网关。
在聊天窗口输入 /clear 重置聊天（不然还要存储上下文），就可以开始和你的本地大模型聊天了！
（不建议本地安装大模型，感觉 qwen2.5-7b 比 Agnes 的免费模型都**）