文档中心

云服务器

请输入

通过应用模板快速部署OpenClaw

OpenClaw常见问题

本文为您汇总了在云服务器实例中部署OpenClaw并集成AI助手过程中常见的问题及其解决方案。

类型	常见问题
接入OpenClaw	我已经购买的云服务器，怎么快速集成OpenClaw？
使用OpenClaw	在实例中部署的OpenClaw，调用Coding Plan中的模型报错“404 The model or endpoint xxx does not exist or you do not have access to it.”，如何解决？在ECS实例中部署了OpenClaw，如何打开WebUI？为什么通过函数调用时会报错“400 请求的模型不支持函数调用，请切换到其他模型，或者如果您认为此模型应该支持函数调用，请联系管理员”？集成OpenClaw后，与机器人对话时报错“400 Input length xxxx exceeds the maximum length xxxx.”，如何解决？使用OpenClaw时，出现聊天卡顿、云服务器实例出现卡死的情况要如何处理？我能直接把命令行工具安装目录复制到另一台机器上使用吗？

接入OpenClaw

我已经购买的云服务器，怎么快速集成OpenClaw？

若您期望使用已有实例快速部署OpenClaw，请通过创建OpenClaw应用更新任务重装实例操作系统。

注意

重装操作系统会将实例系统盘中所有数据清空，且无法找回，建议您提前备份系统盘数据。

使用OpenClaw

在实例中部署的OpenClaw，调用Coding Plan中的模型报错“404 The model or endpoint xxx does not exist or you do not have access to it.”，如何解决？

出现"模型不存在或您无权访问"的404错误，通常由以下几个原因导致：

模型开通状态不正确

Coding Plan套餐需要先订阅后才能使用相关模型。请登录开通管理页面，确认报错信息中对应的模型是否已开通。

模型名称不正确

确保使用的模型名称准确无误。您可以参考配置 Model Name（配置文件指定）获取模型名称。

Base URL配置不正确

OpenClaw作为类Claude的工具，应使用兼容Anthropic接口协议的Base URL：

https://ark.cn-beijing.volces.com/api/coding

如果使用的是兼容OpenAI接口的工具，则需使用：

https://ark.cn-beijing.volces.com/api/coding/v3

使用了无效的API密钥

请检查ARK_API_KEY参数是否正确配置，且其配置的密钥需未过期。

说明

如果以上步骤检查后问题仍未解决，建议查看错误码文档获取更多排查指导，或联系技术支持协助处理。

在ECS实例中部署了OpenClaw，如何打开WebUI？

请在实例安全组“入方向”放通“18789”端口。

登录实例控制台，单击目标实例名称进入其详情页。

选择“安全组”页签，单击目标安全组（本文以Default为例）右侧“配置规则”按钮。

选择“访问控制 > 入向规则”页签，单击“添加规则”按钮。

允许通过TCP协议访问“18789”端口。

确认OpenClaw版本。

登录云服务器实例。

执行如下命令，确认当前部署的OpenClaw版本。

openclaw --version

打开WebUI界面。

Linux
Windows
使用本地PC，远程访问WebUI。
执行如下命令，获取OpenClaw授权Token。

openclaw dashboard

注意
请妥善保管返回信息中的Token，Token泄露可能导致严重的安全风险。

执行如下命令，将本地PC的18789端口映射到OpenClaw服务器的127.0.0.1:18789端口。
说明
在访问WebUI期间，确保执行如下命令的终端窗口未被关闭。
请根据实际情况调整如下参数值：
请将<user_name>替换为部署OpenClaw服务实例的登录用户名。
请将<public_ip>替换为部署OpenClaw服务实例的公网IP地址。

ssh -N -L 18789:127.0.0.1:18789 <user_name>@<public_ip>

在当前PC的浏览器中，访问http://127.0.0.1:18789?token=<your_token>地址，打开OpenClaw的WebUI界面。
说明
请将<your_token>替换为步骤1中获取的OpenClaw授权Token。
在部署OpenClaw的服务器中打开WebUI。
在PowerShell中执行如下命令，获取OpenClaw授权token。
注意
请妥善保管返回信息中的Token，Token泄露可能导致严重的安全风险。

openclaw dashboard

后续，您可以当前服务器的浏览器中，访问http://127.0.0.1:18789?token=<your_token>地址，打开OpenClaw的WebUI界面。
说明
请将<your_token>替换为上一步中获取的OpenClaw授权Token。

为什么通过函数调用时会报错“400 请求的模型不支持函数调用，请切换到其他模型，或者如果您认为此模型应该支持函数调用，请联系管理员”？

该问题是由于您的模型不支持函数调用导致的，建议您切换至支持函数调用的模型，查看支持函数调用的模型。

集成OpenClaw后，与机器人对话时报错“400 Input length xxxx exceeds the maximum length xxxx.”，如何解决？

对话推理阶段，模型会把全量上下文数据作为输入参数整合至单次推理请求中，以此实现会话记忆能力。当上下文长度突破模型的最大输入长度限制时，将会出现该错误并中断推理流程。建议您定期重置会话，避免当前会话中的上下文过长：

通过IM对话框清理

若您将OpenClaw与飞书等IM工具进行集成，可在对应IM工具的OpenClaw机器人对话窗口中输入/new或/reset指令开启新对话，即可清理上一个对话的上下文信息。

通过WebUI清理

若您通过OpenClaw的WebUI与其对话，可打开WebUI界面，并在Chat页面中单击“New session”按钮开启新对话，即可清理上一个对话的上下文信息。

使用OpenClaw时，出现聊天卡顿、云服务器实例出现卡死的情况要如何处理？

当您通过多个渠道与OpenClaw对话，或执行更新、重启、日志查询等操作时，OpenClaw可能会为每项任务创建新的进程。若多个进程同时争抢实例资源，可能导致对话卡顿、实例卡死等问题。此时，您可以：

优化内存使用配置。

操作视频

Replay

Play
00:00 / 00:00 Live

00:00

Fullscreen

Cssfullscreen

1x

2x
1.5x
1x
0.75x
0.5x

Click and hold to drag

操作步骤

登录部署OpenClaw的云服务器实例。

执行如下命令，创建脚本文件。

vim /root/config_swap.sh

按i键进入编辑模式，将如下脚本内容复制、粘贴入文件。

#!/bin/bash
set -e
# 如果当前系统已经存在/swapfile，跳过设置
if [ -f /swapfile ]; then
echo "The swapfile already exists..."
else
fallocate -l 2G /swapfile
# 先修改文件权限,只允许root读写
chmod 600 /swapfile
# 设置为swap文件
mkswap -f /swapfile
# 最后启用swap文件
swapon /swapfile
fi
#永久启用swap，需添加到根分区所在行之后
if ! grep -q "^/swapfile" /etc/fstab; then
echo "/swapfile swap swap defaults 0 0" >> /etc/fstab
fi
#持久化设置swappiness
if grep -q '^vm\.swappiness' /etc/sysctl.conf ;then
sed -i 's/^vm\.swappiness[[:space:]]*=[[:space:]]*[0-9]\+$/vm.swappiness = 20/' /etc/sysctl.conf
else
echo 'vm.swappiness = 20' >> /etc/sysctl.conf
fi
sysctl -w vm.swappiness=20

按esc键退出编辑模式，输入:wq按回车键，保存并退出文件。

执行如下命令运行脚本文件，优化内存使用配置。

bash /root/config_swap.sh

回显如下所示时，表示已完成内存使用优化。

若优化内存使用配置后，该问题依旧出现，建议您：

（推荐）升级实例配置，使用更高规格（例如4vCPU、8GiB）的实例部署OpenClaw。了解更多。

通过云服务器控制台重启目标实例。了解更多。

我能直接把命令行工具安装目录复制到另一台机器上使用吗？

不能。工具每次发起请求时，服务器都会校验设备指纹是否与AppID匹配。如果您直接将工具的安装目录复制到另一台机器上，由于设备指纹不匹配，当您在另一台电脑上运行时，系统会检测到环境变化并判定为未注册状态。您需要在那台新电脑上重新运行安装程序来完成新设备的注册和绑定。

最近更新时间：2026.10.14 17:52:03

这个页面对您有帮助吗？

有用

无用