OpenClaw

前置说明

全程离线、不需要HuggingFace、对接本地Ollama;包含安装→初始化网关→绑定Ollama→切换模型→Crestodian助手→调用挖洞插件全套流程,复制命令直接运行。

一、前置必备(先做完这两步,否则OpenClaw无法运行)

1. 安装 Node.js(必须,npm/npx依赖)

  1. 官网下载:https://nodejs.org/ 选LTS长期版安装
  2. 安装完成后新开PowerShell,验证:
node -v
npm -v

输出版本号即成功。

2. 提前装好Ollama并拉取的模型

  1. Ollama官网下载安装:https://ollama.com/download/windows
  2. 终端拉取在用的模型(和项目一致)
# 推理大模型
ollama pull gemma4:31b
# 向量嵌入模型(Qdrant记忆专用)
ollama pull bge-m3:latest
  1. 新开一个独立PowerShell窗口,挂住Ollama后台服务,全程不要关这个窗口
ollama serve

正常输出 Listening on 127.0.0.1:11434 代表Ollama服务就绪。

二、安装 OpenClaw(两种方式任选其一)

方式1:npm全局安装(推荐,所有终端直接调用openclaw命令)

# 切换国内镜像加速(避免下载失败)
npm config set registry https://registry.npmmirror.com
# 全局安装
npm install -g openclaw
# 验证安装成功
openclaw -v

输出版本号=安装完成。

方式2:一键脚本安装

管理员PowerShell运行:

iwr -useb https://openclaw.ai/install.ps1 | iex

三、一键初始化配置(解决Gateway缺失、配置丢失报错,核心步骤)

关闭之前打开的 openclaw crestodian 窗口,新开干净PowerShell,执行初始化向导:

openclaw onboard --install-daemon

向导每一步严格按下面填写(适配本地Ollama)

  1. Safe warning, continue? → 输入 Yes 回车
  2. Setup mode:QuickStart 快速初始化
  3. Model Provider(模型服务商):选择 Custom Provider(自定义Ollama兼容接口)
  4. API Base URL(Ollama地址,固定复制):http://127.0.0.1:11434/v1
  5. API Key(本地无需真实密钥,随便填):ollama-local
  6. Endpoint Compatibility:OpenAI-compatible
  7. Default Main Model(主推理模型):gemma4:31b
  8. Embedding Model(向量记忆模型):bge-m3:latest
  9. Gateway port(网关端口):默认 18789 直接回车
  10. Install gateway as system daemon?(安装后台服务)→ Yes
  11. 其余技能/渠道配置全部选 Skip for now 跳过

向导执行完成后,会自动生成配置文件、后台启动Gateway网关,不会再报网关无法连接。

四、网关状态管理(最常用3条命令,解决连接报错)

1. 查看网关是否正常运行

openclaw gateway status

✅正常输出:Gateway running on ws://127.0.0.1:18789
❌异常:提示未运行,执行下面启动命令

2. 后台静默启动网关(日常使用)

openclaw gateway start --daemon

3. 重启网关(修改模型/配置后必执行)

openclaw gateway restart

4. 停止网关

openclaw gateway stop

五、本地模型管理 + 切换模型(永久/临时两种方式)

5.1 扫描本地Ollama所有模型(让OpenClaw识别gemma4/bge-m3)

openclaw models scan
# 列出全部识别到的模型
openclaw models list
# 查看当前使用模型
/models status
# 切换本地Ollama模型
/model ollama/gemma4:31b
# 重启网关(网关断开一键修复)
/gateway restart
# 清空当前对话会话
/reset
# 退出Crestodian
/exit

列表会出现:
ollama/gemma4:31bollama/bge-m3:latest

5.2 永久设置全局默认模型(重启依然生效)

# 默认对话推理模型
openclaw models set ollama/gemma4:31b
# 向量嵌入模型(给Qdrant长期记忆使用)
openclaw models set-embed ollama/bge-m3:latest

5.3 临时切换模型(仅当前对话窗口生效,不修改全局配置)

场景1:进入Crestodian/chat会话内切换

先进入对话:

openclaw crestodian local

会话内直接输入指令切换:

# 切换主模型
/model ollama/gemma4:31b
# 查看当前正在使用的模型
/models status
# 查看全部可用模型列表
/models list

场景2:单次执行任务临时指定模型

openclaw run --model ollama/qwen2.5:14b --task "审计网站源码漏洞"

六、Crestodian助手使用

6.1 启动Crestodian(配置/排错/对话专用助手)

方式1(最简)直接输入 openclaw 回车自动进入Crestodian

openclaw

方式2 显式启动本地Crestodian

openclaw crestodian local

6.2 Crestodian内常用内置指令

# 重启网关(网关断连一键修复)
/crestodian restart gateway
# 重置当前会话,清空短期对话
/reset
# 新建干净会话
/new
# 切换模型
/model ollama/gemma4:31b
# 退出Crestodian
/exit

6.3 报错 Gateway: not reachable 修复方案

进入Crestodian后直接输入这条指令一键修复:

/crestodian restart gateway

七、3种使用OpenClaw的模式(对话/批量任务/可视化面板)

模式1:交互式聊天(日常挖洞、代码审计,推荐)

openclaw chat

进入后直接发自然语言指令,自动调用之前安装的 yaklang/hack-skills 网站挖洞插件,示例:

使用yaklang全套红队技能扫描本地靶站 http://127.0.0.1/dvwa,遍历全部页面挖掘OWASP Top10漏洞,输出漏洞HTTP复现包、风险等级、修复代码,扫描记录存入Qdrant长期向量记忆

模式2:一次性批量任务(无需交互,直接输出报告)

openclaw run --task "扫描当前项目PHP源码,查找SQL注入、文件上传、命令执行漏洞,输出markdown审计报告"

模式3:Web可视化管理面板(浏览器操作)

openclaw dashboard

自动打开浏览器 http://127.0.0.1:18789,可视化切换模型、管理会话、查看技能、导出漏洞报告。

八、联动已安装的挖洞技能(yaklang/hack-skills等)

1. 把Hermes/Codex的技能一键迁移到OpenClaw(无需重复安装)

openclaw migrate --from ~/.agents

自动导入:yaklang/hack-skills、Anthropic-Cybersecurity-Skills等全部安全插件。

2. 验证技能加载成功

进入 openclaw chat 输入:

列出我所有已安装的安全渗透类skill

能看到102个yaklang挖洞技能=迁移成功。

九、常见报错一键修复(对应遇到的问题)

报错1:Gateway: not reachable at ws://127.0.0.1:18789

# 方案1:重启网关
openclaw gateway restart
# 方案2:Crestodian内一键修复
openclaw
/crestodian restart gateway
# 方案3:重新完整初始化
openclaw onboard --install-daemon

报错2:openclaw 不是内部或外部命令

npm install -g openclaw
# 安装完成后新开终端再运行

报错3:Ollama接口连接超时

确认单独窗口 ollama serve 保持运行,不要关闭;重新执行初始化向导。

报错4:模型不存在

执行扫描命令重新识别本地Ollama模型:

openclaw models scan

十、完整最简启动流程(日常每次使用顺序)

  1. 新开窗口挂住Ollama:ollama serve(全程不关闭)
  2. 终端启动网关:openclaw gateway start --daemon
  3. 进入交互聊天:openclaw chat
  4. 输入网站/代码审计指令,自动调用挖洞插件执行任务
Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐