知识库管理与日程任务

验证配置4.查看当前配置的模型openclawmodelslist5.测试模型连接openclawmodelstestdeepseek/deepseek-chat常见问题：配置后无法连接？Q1：配置后无法连接？检查项：•baseUrl

是否正确•apiKey

是否有效•网络是否能访问API地址•配置文件JSON格式是否正确常见问题：如何切换模型？Q2：如何切换模型？临时切换:openclawagent--message--modeldeepseek/deepseek-chat永久切换：修改配置文件中的primary

字段常见问题：如何添加多个模型？Q3：如何添加多个模型？在models

数组中添加多个模型对象即可每个模型需要有唯一的id//示例结构

[]

[]

{

"id":"model-1",

"name":"ModelOne"

},

{

"id":"model-2",

"name":"ModelTwo"

}

]内置API模型配置（推荐新手）适合人群：新手用户、想要快速上手的用户以下是几个常用的内置API模型配置教程。选择一个你喜欢的即可。Kimi2.5配置（推荐）特点•超长上下文：支持200万字•长文档处理：论文、报告分析专家•中文理解好：适合中文场景•套餐划算：重度使用建议购买套餐Kimi2.5LogoKimi2.5配置步骤：第一步&第二步第一步：访问KimiCode平台访问：/code第二步：购买套餐（可选）提示：OpenClaw消耗token较大，建议购买套餐更划算。推荐套餐：•Allegretto套餐：适合日常使用

•按需选择其他套餐Kimi2.5配置步骤：第三步&第四步第三步：创建APIKey1.打开控制台2.创建APIKey3.名称随便取第四步：保存APIKey☑重要：这个APIKey一定要复制并保存！点击"完成"后就无法再查看了。Kimi2.5配置步骤：第五步&成本估算第五步：配置到OpenClaw#运行配置向导

openclawonboard

#配置流程：

1.选择QuickStart

2.选择模型供应商：MoonshotAI

3.粘贴刚才复制的APIKey

4.选择默认模型：kimi-code/kimi-for-codi

5.完成其他配置成本估算：•轻度使用：10-20元/月•中度使用：30-50元/月•重度使用：建议购买套餐DeepSeek配置（性价比之王）特点•最便宜：输入0.001元/千tokens•推理能力强：适合复杂任务•编程能力出色：代码生成质量高DeepSeekLogoDeepSeek配置步骤：第一步&第二步第一步：注册并充值访问：/注意：DeepSeek采用按量付费，账户余额必须大于0才能调用API。DeepSeek配置步骤：第三步&第四步第三步：创建APIKey1.保证账号有余额2.点击"APIkeys"3.点击"创建APIkey"第四步：保存APIKey☑重要：APIKey只显示一次，务必复制保存！名称随便取，复制APIKey后妥善保存。DeepSeek配置步骤：第五步&成本估算第五步：配置到OpenClaw#运行配置向导

openclawonboard

#配置流程：

1.选择QuickStart

2.选择模型供应商：DeepSeek

3.粘贴APIKey

4.选择默认模型：deepseek-chat

5.完成其他配置成本估算：•日常使用：5-10元/月

•中度使用：10-30元/月

•重度使用：30-50元/月国产大模型配置（其他选项）1.DeepSeek配置（性价比之王）•最便宜：输入0.001元/千tokens•推理能力强：适合复杂任务•编程能力出色：代码生成质量高DeepSeek的API调用是按量付费的，你的账户余额必须大于0才能正常调用接口。如果账户没钱或余额不足，API请求会直接失败，所以提前充值是保证服务可用的必要操作。其他大模型也是同理，你要去找到对应网址去充值，然后获取APIkeys。Moonshot配置步骤：第一步&第二步1.注册账号访问：/注册并登录2.获取APIKey1.进入"API管理"2.点击"创建APIKey"3.复制APIKeyMoonshot配置步骤：第三步&第四步3.配置到OpenClaw{

"models":{

"mode":"merge",

"providers":{

"moonshot":{

"baseUrl":"/v1",

"apiKey":"sk-你的API密钥",

"auth":"api-key",

"api":"openai-chat",

"models":[

{

"id":"moonshot-v1-8k",

"name":"Kimik2.5",

"contextWindow":8000,

"maxTokens":4096

}

]

}

},

"agents":{

"defaults":{

"model":{

"primary":"moonshot/moonshot-v1-8k"

}

}

}

}4.重启GatewayopenclawgatewayrestartMoonshot成本估算&其他国产大模型成本估算•日常使用：10-20元/月•中度使用：20-50元/月•重度使用：50-100元/月3.其他国产大模型模型特点价格官网GLM-4多模态能力强中等文心一言百度生态中高通义千问阿里生态中等国际模型配置（可选）如果需要使用Claude、GPT等国际模型：•直接使用官方API（需要魔法）•使用第三方API服务（国内直连）推荐第三方API：•价格便宜50%-70%•国内直连，无需魔法•支持支付宝、微信支付成本对比&省钱技巧成本对比省钱技巧•日常对话：用DeepSeek（最便宜）•长文档：用Kimi（长上下文）•复杂任务：用Claude（质量最高）常见问题解决：安装问题Q1:Node.js版本不对#检查版本

node--version

#如果低于22，升级

nvminstall22

nvmuse22Q2:权限错误Windows:以管理员身份运行PowerShellQ3:网络连接失败•检查网络连接•尝试使用代理•或使用云端部署常见问题解决：API配置问题Q1:APIKey无效•检查是否完整复制（包括sk-前缀）•检查是否有多余空格•检查账户余额是否充足Q2:模型不可用•检查模型ID是否正确•检查API服务是否正常•尝试切换其他模型Q3:Token消耗太快•使用更便宜的模型（DeepSeek）•优化提示词•定期清理会话历史常见问题解决：Gateway问题Q1:Gateway无法启动#查看日志

tail-f~/.openclaw/logs/gateway.log

#重启Gateway

openclawgatewayrestartQ2:端口被占用#查看端口占用

lsof-i:18789

#修改端口

openclawconfigsetgateway.port18790X版本升级指南：为什么要升级？▲重要提示：目前推荐使用2026.2.9版本。2026.2.12版本存在已知bug（Issue#15141），会导致heartbeat和消息处理功能异常。为什么要升级？•新功能和改进•性能优化•安全修复•Bug修复•更好的兼容性推荐版本：当前推荐版本：2026.2.9已知问题版本：2026.2.12：Session路径验证bug，影响heartbeat和Telegram/飞书消息处理升级方式选择&方式一：npm直接升级（推荐）检查当前版本#查看当前版本

openclaw--version

#查看配置文件版本

cat~/.openclaw/openclaw.json|grepversion升级方式选择安装方式升级方法难度推荐度云端部署重新部署镜像★★★★★★★★★Docker拉取新镜像★★★★★★★★★本地安装（npm）npm升级★★★★★★★★★本地安装（源码）gitpull★★★★★★★★★★升级步骤：备份配置&停止Gateway第一步：备份配置#备份整个配置目录

cp-r~/.openclaw~/.openclaw.backup-$(date+%Y%m%d)

#验证备份

ls-la~/.openclaw.backup-*第二步：停止Gateway服务#停止Gateway

openclawgatewaystop

#验证已停止

openclawgatewaystatus升级步骤：卸载旧版本&安装新版本第三步：卸载旧版本#卸载旧版本

npmuninstall-gopenclaw

#验证卸载

whichopenclaw#应该没有输出第四步：安装新版本#安装推荐版本2026.2.9（需要--force）

npminstall-gopenclaw@2026.2.9--force△版本选择说明：推荐安装2026.2.9版本（稳定），避免安装2026.2.12版本（存在bug）。△为什么需要--force？npm会检测到已存在的文件，使用--force强制覆盖。升级步骤：修复配置&重启Gateway第五步：修复配置#运行doctor工具自动修复配置

openclawdoctor--fixdoctor工具会自动更新入口点、检查兼容性、修复已知问题。第六步：重启Gateway#重启Gateway

openclawgatewayrestart

#等待几秒后检查状态

sleep5

openclawgatewaystatus升级步骤：验证升级&升级示例第七步：验证升级#检查版本

openclaw--version

#检查Gateway状态

openclawgatewaystatus

#测试连接

openclawchannelsstatus成功的输出应该显示：

2026.2.9

Runtime:running(pidxxxxx,stateactive)

RPCprobe:ok

Listening:*:18789升级示例：真实升级过程升级背景：原版本2026.2.1-zh.3→目标版本2026.2.9图：升级前版本检查图：使用npminstall--force结果：升级成功，配置自动迁移，Gateway运行正常。方式二：官方脚本升级&方式三：Docker升级方式二：官方脚本升级#运行升级脚本

curl-fsSLhttps://openclaw.ai/install.sh|bash缺点：可能遇到npm错误，不如方式一可靠。方式三：Docker升级#停止并删除旧容器

dockercomposedown

#拉取最新镜像

dockercomposepull

#启动新容器

dockercomposeup-dopenclaw-cn-gateway方式四：云端部署升级&升级后的变化方式四：云端部署升级（腾讯云Lighthouse）1.进入轻量应用服务器控制台2.选择你的OpenClaw实例3.点击"重置应用"4.选择最新的OpenClaw镜像5.等待重置完成6.重新配置API（配置会保留）升级后的变化配置文件自动迁移：•更新配置文件格式•迁移旧版本配置•创建备份文件服务管理改进：•LaunchAgent/Service自动更新•路径更新为新版本•日志位置统一已知警告&升级故障排查已知警告Configwarnings:plugins.entries.feishu:pluginfeishu:duplicatepluginiddetected说明：这是一个已知的插件重复警告，不影响正常使用。升级故障排查问题1：npminstall报错EEXIST症状npmerrorcodeEEXIST

npmerrorpath/usr/local/bin/openclaw

npmerrorEEXIST:filealreadyexists解决方案#使用--force参数强制覆盖npminstall-gopenclaw@2026.2.9--force升级故障排查问题2：Gateway启动失败症状Gatewaynotrunning解决方案#运行doctor修复

openclawdoctor--fix

#重启Gateway

openclawgatewayrestart

#查看详细日志

tail-f~/.openclaw/logs/gateway.log问题3：配置文件版本不匹配症状ConfigwaslastwrittenbyanewerOpenClaw(2026.2.6-3);currentversionis2026.2.1-zh.3解决方案#升级到推荐版本2026.2.9

npminstall-gopenclaw@2026.2.9--force

openclawdoctor--fix升级故障排查问题4：插件加载失败症状pluginnotfound:xxx解决方案#重新安装插件

openclawpluginsinstall

#或禁用有问题的插件

openclawconfigsetplugins.allow[]问题5：端口被占用症状Error:listenEADDRINUSE:addressalreadyinuse:::18789解决方案#查找占用端口的进程

lsof-i:18789

#停止旧的Gateway进程

kill-9[PID]#或修改端口openclawconfigsetgateway.port18790

openclawgatewayrestart回滚到旧版本&升级最佳实践回滚到旧版本如果升级后遇到问题，可以回滚到旧版本。方式一：从备份恢复#停止Gateway

openclawgatewaystop恢复配置&降级#恢复配置

cp-r~/.openclaw.backup-20260213/*~/.openclaw/

#降级到旧版本（以中文版为例）

npmuninstall-gopenclaw

npminstall-g@qingchencloud/openclaw-zh@2026.2.1-zh.3--force

#重启Gateway

openclawgatewayrestart方式二：安装指定版本#查看可用版本npmviewopenclawversions#安装指定版本npminstall-gopenclaw@2026.2.8--force#修复配置&重启Gateway#修复配置

openclawdoctor--fix

#重启Gateway

openclawgatewayrestart升级最佳实践升级前必做•1.备份配置•2.记录当前版本•3.导出重要配置•4.检查磁盘空间升级时注意&升级后验证升级时注意•使用--force参数•运行doctor修复•检查Gateway状态•查看日志升级后验证•检查版本号•测试Gateway连接•验证插件功能•测试