【08】常见问题与解决方案:让你的 AI 助手稳定运行

常见问题与解决方案：让你的 AI 助手稳定运行

汇集常见问题，让你遇到问题不再慌

前言

在使用 OpenClaw 的过程中，难免会遇到各种问题。本章汇集了最常见的问题和解决方案，帮助你快速解决问题。

本章内容包括：

• 安装问题

• 运行问题

• 模型问题

• 性能问题

• 网络问题

• 配置问题

第一部分：安装问题

问题 1：PowerShell 执行策略被拒绝

错误信息：

irm : 无法加载文件，因为在此系统上禁止运行脚本。

解决方案：

# 方法1：修改执行策略
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

# 方法2：使用 Bypass
powershell -ExecutionPolicy Bypass -Command “irm https://openclaw.ai/install.ps1 | iex”

问题 2：嵌套命令被拒绝

错误信息：

拒绝访问

原因：使用了 powershell -c “irm … | iex” 的嵌套写法

解决方案：

直接在 PowerShell 窗口中运行，不要使用 -c 参数：

# 正确方式
irm https://openclaw.ai/install.ps1 | iex

# 错误方式
powershell -c “irm https://openclaw.ai/install.ps1 | iex”

问题 3：npm 命令找不到

错误信息：

npm : 无法将”npm”项识别为 cmdlet…

解决方案：

1. 确认 Node.js 已安装：

node –version

2. 如果没有，下载安装：

https://nodejs.org

3. 如果已有，重启 PowerShell 或添加 PATH

问题 4：Scoop 安装失败

错误信息：

Scoop 禁止在管理员账户下安装

解决方案：

使用普通用户账户的 PowerShell，不要用管理员：

# 打开普通用户 PowerShell
Start-Process powershell

第二部分：运行问题

问题 5：Gateway 启动失败

错误信息：

Gateway service missing

解决方案：

1. 不需要安装为服务，直接运行：

openclaw gateway

2. 或者先安装服务：

openclaw gateway install

问题 6：Dashboard 打不开

错误信息：

token_missing

解决方案：

1. 使用命令自动打开：

openclaw dashboard

2. 或者手动使用带 token 的链接

3. 查看当前 token：

openclaw config get gateway.auth.token

问题 7：服务端口被占用

错误信息：

Port 18789 is already in use

解决方案：

1. 查找占用端口的进程：

netstat -ano | findstr 18789

2. 结束进程或使用其他端口：

openclaw gateway –port 18790

第三部分：模型问题

问题 8：上下文窗口太小

错误信息：

Model context window too small (4096 tokens)
Minimum required: 16000 tokens

原因：Ollama 默认上下文只有 4096 tokens

完整解决方案：

Step 1：创建 Modelfile

# 在用户目录创建
@”
FROM qwen2.5:7b
PARAMETER num_ctx 32768
“@ | Out-File -FilePath “$env:USERPROFILE\Modelfile” -Encoding ascii

Step 2：创建新模型

ollama create qwen2.5-7b-32k -f “$env:USERPROFILE\Modelfile”

Step 3：更新配置

把 openclaw.json 中的模型 ID 改为 qwen2.5-7b-32k

问题 9：模型找不到

错误信息：

Model not found: qwen2.5:7b

解决方案：

1. 查看已下载模型：

ollama list

2. 下载模型：

ollama pull qwen2.5:7b

问题 10：Ollama 连接被拒绝

错误信息：

Connection refused: http://127.0.0.1:11434

解决方案：

1. 检查 Ollama 是否运行：

ollama list

2. 重启 Ollama：

ollama serve

3. 检查服务状态：

curl http://localhost:11434

问题 11：认证失败

错误信息：

Authentication failed

解决方案：

检查 apiKey 配置，确保不是空的：

“apiKey”: “ollama”

第四部分：性能问题

问题 12：模型运行很慢

原因分析：

• 没有使用 GPU 加速

• 显存不足

• 模型太大

解决方案：

1. 检查 GPU 是否被使用：

nvidia-smi

2. 使用量化模型：

ollama pull qwen2.5:7b-q4_0

3. 关闭其他占用显存的程序

问题 13：显存不足

错误信息：

CUDA out of memory

解决方案：

1. 使用更小的模型：

ollama pull qwen2.5:3b

2. 使用量化版本：

ollama pull qwen2.5:7b-q4_0

3. 停止其他模型：

ollama stop all

问题 14：内存不足

检查方法：

Get-Process | Where-Object {$_.WorkingSet -gt 500MB} | Select-Object Name, @{N=’Memory(MB)’;E={[math]::Round($_.WorkingSet/1MB,2)}}

解决方案：

• 升级内存

• 使用更小的模型

• 关闭其他程序

第五部分：网络问题

问题 15：无法下载模型

原因分析：

• 网络问题

• 防火墙阻止

• 下载源问题

解决方案：

1. 检查网络：

ping ollama.com

2. 使用代理（如果有）：

set HTTP_PROXY=http://127.0.0.1:7890
set HTTPS_PROXY=http://127.0.0.1:7890
ollama pull qwen2.5:7b

3. 重试下载

问题 16：API 请求超时

错误信息：

Request timeout

解决方案：

1. 检查网络连接

2. 增加超时时间（修改配置）

3. 使用本地模型替代云端

第六部分：配置问题

问题 17：配置文件损坏

解决方案：

1. 备份当前配置：

copy “$env:USERPROFILE\.openclaw\openclaw.json” “$env:USERPROFILE\.openclaw\openclaw.json.bak”

2. 重置配置：

openclaw onboard

问题 18：配置不生效

解决方案：

1. 重启 Gateway：

# Ctrl+C 停止
# 重新启动
openclaw gateway

2. 或者完全重启：

openclaw restart

诊断工具

运行健康检查

openclaw doctor

正常输出示例：

Node.js v22.11.0
npm v10.9.0
Ollama is running
Gateway is ready
Some skills need dependencies

查看日志

# 查看最近日志
openclaw logs

# 实时查看日志
openclaw logs -f

# 查看错误日志
openclaw logs –error

检查配置

# 查看完整配置
openclaw config get

# 查看特定项
openclaw config get models
openclaw config get agents.defaults.model

性能优化建议

1. 模型优化

# 使用量化模型
ollama pull qwen2.5:7b-q4_0

# 清理未使用模型
ollama prune

# 减少上下文窗口（如果不需要长文本）

2. 系统优化

# 清理 Ollama 缓存
ollama cleanup

# 关闭不必要的后台程序
# 分配更多显存给 Ollama

3. 网络优化

# 使用本地模型作为主力
# 配置合理的超时时间
# 启用连接复用

紧急情况处理

完全重置 OpenClaw

# 1. 停止所有服务
Ctrl+C

# 2. 删除配置
Remove-Item -Recurse “$env:USERPROFILE\.openclaw”

# 3. 重新初始化
openclaw onboard

卸载重装

# 1. 卸载 OpenClaw
npm uninstall -g openclaw

# 2. 清理配置
Remove-Item -Recurse “$env:USERPROFILE\.openclaw”

# 3. 重新安装
irm https://openclaw.ai/install.ps1 | iex

常见错误代码

错误码	含义	解决方案

E001	配置文件错误	重置配置
E002	模型未找到	下载模型
E003	连接失败	检查 Ollama
E004	认证失败	检查 API Key
E005	上下文太小	创建 32k 模型
E006	显存不足	使用更小模型
E007	权限不足	以管理员运行

获取帮助

官方资源

• 官方文档：https://docs.openclaw.ai

• Discord 社区：https://discord.gg/openclaw

• GitHub Issues：https://github.com/openclaw/openclaw

社区资源

• 本教程系列

• Stack Overflow

• Reddit r/OpenClaw

总结

本章汇集了：

• 18 个常见问题及解决方案

• 诊断工具使用方法

• 性能优化建议

• 紧急情况处理方法

恭喜你！

完成了本系列全部 8 篇教程，你已经：

• 了解 OpenClaw 是什么

• 准备好了电脑环境

• 安装了 OpenClaw

• 部署了本地大模型

• 配置了多模型

• 安装了 Skills

• 学会了故障排除

现在你可以开始使用你的本地 AI 助手了！

关注公众号：跟着鹏鹏学技术

教程全部完成！

如果有任何问题，欢迎在公众号留言！