避坑指南：OpenClaw安装Qwen3.5-9B常见的5个配置错误

避坑指南：OpenClaw安装Qwen3.5-9B常见的5个配置错误

1. 为什么需要这篇指南

上周我在本地部署OpenClaw对接Qwen3.5-9B时，经历了从满怀期待到崩溃边缘的全过程。本以为按照官方文档就能轻松搞定，结果在npm权限、端口冲突、模型地址配置等环节接连踩坑。最痛苦的是，有些错误提示非常隐晦，排查起来像在解谜。

这篇文章记录了我实际遇到的5个典型配置错误，以及最终验证有效的解决方案。如果你也准备在OpenClaw中使用Qwen3.5-9B，这些经验或许能帮你节省数小时的折腾时间。

2. npm权限不足导致的安装失败

2.1 现象描述

执行官方推荐的一键安装命令后，控制台抛出EACCES权限错误：

npm ERR! Error: EACCES: permission denied, access '/usr/local/lib/node_modules'

这是macOS/Linux系统下的经典问题。由于Node.js默认将全局包安装在系统目录，普通用户没有写入权限。

2.2 三种解决方案

方案A：使用sudo临时提权（快速但不够安全）

sudo npm install -g openclaw@latest

虽然简单有效，但以root身份运行npm存在安全风险。建议仅在测试环境使用。

方案B：更改npm默认安装目录（推荐）

mkdir ~/.npm-global npm config set prefix '~/.npm-global' echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc source ~/.zshrc

重新安装后，所有全局包都会存放在用户目录下。

方案C：使用nvm管理Node.js版本

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash nvm install --lts nvm use --lts

nvm会自动处理权限问题，且支持多版本Node.js切换。

3. 网关端口冲突导致服务启动失败

3.1 典型错误现象

执行openclaw gateway start后，控制台显示：

Error: listen EADDRINUSE: address already in use :::18789

这说明默认端口18789已被其他进程占用。在我的案例中，冲突来自之前测试时未正确退出的OpenClaw实例。

3.2 排查与解决方案

步骤1：确认占用进程

lsof -i :18789

输出示例：

node 12345 username 12u IPv6 0x1234567890 0t0 TCP *:18789 (LISTEN)

步骤2：终止冲突进程

kill -9 12345 # 替换为实际PID

步骤3：修改默认端口（可选）

如果希望保留原端口占用，可以修改OpenClaw配置：

{ "gateway": { "port": 18790 } }

修改后需要重启网关服务：

openclaw gateway restart

4. 模型地址格式错误导致连接失败

4.1 错误配置示例

在对接本地部署的Qwen3.5-9B时，我最初这样配置模型地址：

{ "models": { "providers": { "local-qwen": { "baseUrl": "127.0.0.1:5000", "apiKey": "sk-no-key-required", "api": "openai-completions" } } } }

结果网关日志显示：

[ERROR] Failed to connect to model provider: Invalid URL

4.2 正确配置要点

必须包含协议头：地址需要以http://或https://开头

"baseUrl": "http://127.0.0.1:5000"

注意路径后缀：部分API服务需要完整路径

"baseUrl": "http://127.0.0.1:5000/v1"

验证连接性：配置后执行诊断命令

openclaw models list

正常输出应包含新配置的模型信息。

5. 模型版本不匹配导致能力异常

5.1 问题表现

虽然成功连接了Qwen3.5-9B，但执行任务时出现以下异常：

• 简单指令能响应，但复杂任务输出乱码
• 上下文记忆长度明显不足
• 工具调用功能失效

5.2 根本原因

检查配置文件发现模型参数未正确设置：

{ "models": { "providers": { "local-qwen": { "models": [ { "id": "qwen3-9b", "name": "My Qwen", "contextWindow": 2048, // 实际应为32768 "maxTokens": 512 // 实际应为8192 } ] } } } }

Qwen3.5-9B的实际能力参数与默认值差异较大。

5.3 正确参数配置

{ "id": "qwen3-9b", "name": "Qwen3.5-9B", "contextWindow": 32768, "maxTokens": 8192, "capabilities": ["tool-use", "multi-turn"] }

修改后需要执行：

openclaw gateway restart openclaw models sync

6. 飞书通道配置遗漏关键参数

6.1 典型错误现象

飞书机器人能接收消息但无法响应，网关日志显示：

[WARN] Feishu message received but no valid session

6.2 缺失的必要配置

除了基本的appId和appSecret外，还需要：

{ "channels": { "feishu": { "encryptKey": "你的Encrypt Key", "verificationToken": "你的Verification Token" } } }

这些参数需要在飞书开放平台的应用配置中获取。

6.3 完整配置检查流程

1. 在飞书开放平台确认所有必要参数已开启
2. 检查openclaw.json是否包含全部4个参数
3. 重启网关服务
4. 在飞书群组中@机器人测试响应

openclaw gateway restart openclaw channels test feishu

7. 诊断工具与实用命令

遇到问题时，可以依次运行以下诊断命令：

检查核心服务状态

openclaw doctor

列出已加载模型

openclaw models list --verbose

测试通道连接

openclaw channels test feishu

查看详细日志

openclaw logs --tail=100

这些命令能帮助快速定位大多数配置问题。

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。