OpenClaw本地部署指南 - Moonshot模型配置(完美解决Http 401报错,对话no output问题)
摘要:本文详细介绍了如何在Linux系统上部署OpenClaw并配置Moonshot模型实现语音交互。关键步骤包括安装Node.js环境、初始化OpenClaw配置、获取Moonshot API密钥,特别强调需将baseUrl修改为国内版"https://api.moonshot.cn/v1"以避免401错误。文章还分享了配置认证信息、测试模型调用等具体操作,并提供了常见问题的
想让你的机器人具备语音交互能力?试试 Seeed Studio 的 ReSpeaker 系列。
我会后续出reSpeaker XVF3800与Openclaw联动实现语音输入的教程,完全开发源码。
产品相关源码: Seeed-Projects
reSpeaker XVF3800 是一款基于 XMOS XVF3800 芯片的专业级 4 麦克风圆形阵列麦克风,即使在嘈杂的环境中也能清晰地拾取目标语音。它具备双模式、360° 远场语音拾取(最远 5 米)、自动回声消除 (AEC)、自动增益控制 (AGC)、声源定位 (DoA)、去混响、波束成形和噪声抑制等功能。得益于它的超强拾音降噪能力,小智拥有了更灵动的耳朵。
ReSpeaker 四麦克风阵列 | Seeed Studio购买链接 淘宝天猫均有售
环境信息
- 操作系统: Linux 5.15.148-tegra (arm64)
- Node.js版本: v22.22.0
- OpenClaw版本: 最新版
- 目标模型: Moonshot (月之暗面)
部署步骤
1. 安装OpenClaw
#安装Node.js
# 使用 nvm 或包管理器:
# 通过 nvm 安装(推荐)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
source ~/.bashrc
nvm install 22
# 或通过 apt 安装(Ubuntu/Debian)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
# 全局安装OpenClaw
npm install -g openclaw
# 或者
curl -fsSL https://openclaw.ai/install.sh | bash
# 验证安装
openclaw --version
2. 初始化配置
# 初始化OpenClaw配置
openclaw init
# 启动Gateway服务
openclaw gateway start

3. 配置Moonshot模型
3.1 获取API密钥
- 访问 Moonshot官网
- 注册账号并获取API密钥
- 注意区分国内版和国际版



3.2 配置认证信息
创建或编辑认证配置文件:
# 认证配置文件路径
~/.openclaw/openclaw.json
添加Moonshot认证信息:
{
"moonshot": {
"apiKey": "your-moonshot-api-key-here"
}
}
3.3 关键配置修改
重要发现:需要修改OpenClaw配置文件中的baseUrl
配置文件路径:
~/.openclaw/openclaw.json
原始配置(国际版,会导致401错误,对话返回no output):
{
"model": {
"moonshot": {
"baseUrl": "https://api.moonshot.ai/v1",
"model": "moonshot-v1-8k"
}
}
}
修正后的配置(国内版):
{
"model": {
"moonshot": {
"baseUrl": "https://api.moonshot.cn/v1",
"model": "moonshot-v1-8k"
"apiKey": "your-api-key"
}
}
}
遇到的问题及解决方案
问题1: HTTP 401 Unauthorized错误
现象:
- 模型调用返回401错误
- 提示认证失败
原因分析:
- 最初使用的是Moonshot国际版API端点
- 可能存在地域访问限制或认证机制差异
解决方案:
- 将baseUrl从
https://api.moonshot.ai/v1修改为https://api.moonshot.cn/v1 - 确保使用国内版API密钥
问题2: 无响应输出
现象:
- 请求发送成功,但无返回内容
- 控制台显示请求已发送,但无回复
原因分析:
- API端点选择错误导致请求被丢弃
- 网络路由问题
解决方案:
- 同样需要通过修改baseUrl使用国内版端点解决
验证部署
1. 检查服务状态
# 查看Gateway状态
openclaw gateway status
# 查看会话列表
openclaw sessions list
2. 测试模型调用
# 发送测试消息
openclaw sessions send --message "你好,请介绍一下你自己"
![[Pasted image 20260204094433.png]]
3. 配置文件检查
确保配置文件包含正确的模型设置:
{
"model": {
"default": "moonshot/kimi-k2-0905-preview",
"moonshot": {
"baseUrl": "https://api.moonshot.cn/v1",
"apiKey": "your-api-key",
"timeout": 30000
}
}
}
相关资源
OpenClaw本地部署的关键在于正确配置模型API端点。对于Moonshot模型,国内用户应特别注意使用正确的baseUrl。通过将端点从国际版切换到国内版,可以有效解决401认证错误和无响应问题。
如遇其他问题,建议查看OpenClaw日志文件或寻求社区支持。
更多推荐




所有评论(0)