OpenClaw系列---【如何安装OpenClaw？】

这里我推荐使用npm安装openclaw，理由是通用，不管windows系统，还是macos系统，还是linux系统，都是一样的。先建立一个全局概念，openclaw的工作流程是：你通过 TUI命令行或浏览器 或 WhatsApp --->发送指令---> Gateway 接收并验证权限---> Agent 思考并选择模型 ---> Agent 调用 Skills 办事 ---> Gateway 将结果返回给你。

1.安装nodejs

https://nodejs.org/zh-cn

node版本要大于22，下载好安装包之后，一路默认即可。安装完成后用下面的命令来验证是否安装成功。

node -V

2.安装openclaw

OpenClaw官网：https://openclaw.ai/,有条件的，建议在ai编辑器里执行下面的命令，这样有问题方便通过ai解决，例如：antigravity，cursor，claude code，trae，lingma都可以。

# 全局安装
npm i -g openclaw

# 后台运行(推荐)
openclaw onboard --install-daemon

# 手动运行
openclaw onboard

openclaw gateway restart

openclaw tui

# YES
# quickstart
# 除了配置模型，剩下的都可以先skip

3.修改ollama本地模型的上下文长度

OpenClaw 默认要求模型上下文窗口至少 16000 tokens，而基础模型可能只有 4096，因此需要创建自定义模型。

#导出你的大模型的modelfile，你在哪个目录下执行这个命令，Modelfile文件就会生成到那个目录下
ollama show --modelfile qwen3.5:9b > Modelfile

打开你的Modelfile文件，找到PARAMETER参数，把下面这一行复制过去

PARAMETER num_ctx 32768

创建新的长上下文模型,建议新模型名字自定义，便于区分

ollama create hqwen3.5:9b -f Modelfile

4.给openclaw配置ollama大模型

Model/auth provider 选择 Custom Provider（列表最后一项）

API Base URL 输入 http://127.0.0.1:11434/v1,默认就是

API Key 输入任意字符串（如 ollama），不可留空

Endpoint compatibility 选择 OpenAI-compatible

Model ID 输入你创建的模型名（如 hqwen3.5:9b）

后续问题 全部选择 Skip for now 或 No，注意：Enable hooks?用空格选中skip for now，直到完成。
重要：若配置时提示 Verification failed，请先确保 Ollama 服务正在运行（可执行 ollama list 测试）。

注意：如果之前启动过，下面这个gateway要选restart，不能skip，最后一步选中hatch in TUI意思是在命令行终端中使用openclaw，

5.解决由于上下文太小导致的gateway命令行中的警告日志

解决模型上下文太短导致无法使用的问题，不耽误使用，就是会引起体验不好。
这是因为 OpenClaw 从模型元数据中读取的上下文仍是 16000，虽然你已在 Ollama 中设置了 32768，但 OpenClaw 缓存了旧值。

解决步骤

找到 OpenClaw 的两个 JSON 配置文件：

C:\Users\<用户名>\.openclaw\openclaw.json

C:\Users\<用户名>\.openclaw\agents\main\agent\models.json

用记事本打开，找到 models.providers.custom-127-0-0-1-11434.models 数组中 id 为你的模型名的对象，将 contextWindow 和 maxTokens 的值从 16000 改为 32768。

示例修改后：

{
  "id": "qwen2.5:7b-32k",
  "contextWindow": 32768,
  "maxTokens": 32768,
  ...
}

保存文件后完全退出 OpenClaw TUI（按 Ctrl+C），然后重新启动：

openclaw gateway restart
openclaw tui

至此，问题已被解决，AI 可以正常对话。