OpenClaw简单使用配置
·
OpenClaw
前置说明
全程离线、不需要HuggingFace、对接本地Ollama;包含安装→初始化网关→绑定Ollama→切换模型→Crestodian助手→调用挖洞插件全套流程,复制命令直接运行。
一、前置必备(先做完这两步,否则OpenClaw无法运行)
1. 安装 Node.js(必须,npm/npx依赖)
- 官网下载:https://nodejs.org/ 选LTS长期版安装
- 安装完成后新开PowerShell,验证:
node -v
npm -v
输出版本号即成功。
2. 提前装好Ollama并拉取的模型
- Ollama官网下载安装:https://ollama.com/download/windows
- 终端拉取在用的模型(和项目一致)
# 推理大模型
ollama pull gemma4:31b
# 向量嵌入模型(Qdrant记忆专用)
ollama pull bge-m3:latest
- 新开一个独立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)
Safe warning, continue?→ 输入Yes回车- Setup mode:
QuickStart快速初始化 - Model Provider(模型服务商):选择
Custom Provider(自定义Ollama兼容接口) - API Base URL(Ollama地址,固定复制):
http://127.0.0.1:11434/v1 - API Key(本地无需真实密钥,随便填):
ollama-local - Endpoint Compatibility:
OpenAI-compatible - Default Main Model(主推理模型):
gemma4:31b - Embedding Model(向量记忆模型):
bge-m3:latest - Gateway port(网关端口):默认
18789直接回车 - Install gateway as system daemon?(安装后台服务)→
Yes - 其余技能/渠道配置全部选
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:31b、ollama/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
十、完整最简启动流程(日常每次使用顺序)
- 新开窗口挂住Ollama:
ollama serve(全程不关闭) - 终端启动网关:
openclaw gateway start --daemon - 进入交互聊天:
openclaw chat - 输入网站/代码审计指令,自动调用挖洞插件执行任务
更多推荐


所有评论(0)