初次使用
在昨天安装成功的基础上,今天开始准备使用,初次使用过程中也是问题重重,经过不断排查,最终解决,能够实现本地化部署,安全对接大模型了,进行首次实战的应用-聊天。
1.首次进入OpenClaw

  1. 首次使用,需要网关令牌。
    openclaw config get gateway.auth.token
    在这里插入图片描述

  2. 输入下面命令,获取网关令牌(token)
    在这里插入图片描述

  3. 但是在登录界面输入令牌,点击【连接】后并不能进入操作界面,反而出现错误提示:
    origin not allowed (open the Control UI from the gateway host or allow it in gateway.controlUi.allowedOrigins)
    因为你正尝试从局域网的其他设备(IP地址)访问OpenClaw的控制UI,而OpenClaw出于安全策略,只允许从网关主机自身(localhost)访问。
    如果你希望无需隧道、直接通过IP地址访问,需要修改OpenClaw配置,将你的浏览器访问地址加入白名单。

  4. 输入 openclaw dashboard --no-open 获得带token的url
    在这里插入图片描述

  5. 拷贝URL,输入到你的电脑上的浏览器地址中,即可进入,前提是在本地电脑建立 SSH 隧道,访问 Web 界面:
    1)建立隧道命令:ssh -L 18789:127.0.0.1:18789 root@192.168.0.102
    2)然后使用浏览器访问OpenClaw
    在这里插入图片描述

2.进行OpenClaw 认证配置
7. 进入操作主界面后,试用第一个功能:聊天。
本以为非常简单的功能,却花费笔者半天时间的探索,才将聊天功能调通。如果读者能够理解OpenClaw的配置文件,并进行正确配置,会顺利得多。
在第一次输入聊天内容,笔者碰到第一问题,API密钥问题。当时屏幕上出现错误信息:
Agent failed before reply: No API key found for provider “anthropic”. Auth store: /root/.openclaw/agents/main/agent/auth-profiles.json (agentDir: /root/.openclaw/agents/main/agent). Configure auth for this agent (openclaw agents add ) or copy auth-profiles.json from the main agentDir.
Logs: openclaw logs --follow
在这里插入图片描述
原因 OpenClaw 智能体(agent)正在尝试调用 Anthropic 的模型(如 Claude),但是没有找到有效的认证信息。需要配置 Anthropic 的 API 密钥。
8. 获取API密钥
由于Anthropic 是美国公司(Claude 模型的开发者),无法获取API Key,好在国内有兼容平台,在硅基流动(https://cloud.siliconflow.cn/)平台上,笔者获取的API Key。
在这里插入图片描述

3.配置API密钥
首先设置环境变量:
export ANTHROPIC_BASE_URL=“https://api.siliconflow.cn”
export ANTHROPIC_API_KEY=“你的硅基流动API Key”
export ANTHROPIC_MODEL=“Pro/MiniMaxAI/MiniMax-M2.5”
选择一个模型,可从模型广场获取(注意,有好多模型不能使用,笔者这里走了很多弯路)
如果想将设置永久生效,需要将变量配置到到 bashrc文件中,然后重新启用配置文件。
echo ‘export ANTHROPIC_BASE_URL=“https://api.siliconflow.cn”’ >> ~/.bashrc
echo ‘export ANTHROPIC_API_KEY=“sk-xxxxxkh”’ >> ~/.bashrc
echo ‘export ANTHROPIC_MODEL=“Pro/MiniMaxAI/MiniMax-M2.5”’ >> ~/.bashrc
source ~/.bashrc

  1. 认证目录配置
    配置好环境变量后,笔者满心喜欢,重启 OpenClaw。
    openclaw gateway restart
    不料使用环境变量方法并不可行,问题依旧,还是直接修改配置文件openclaw.json 才行。 除了 openclaw.json 配置文件外,还需要增加认证配置文件。
    首先创建认证配置文件目录
    mkdir -p ~/.openclaw/agents/main/agent

然后, 创建认证配置 auth-profiles.json 文件,方法如下:
cat > ~/.openclaw/agents/main/agent/auth-profiles.json << ‘EOF’
{
“profiles”: {
“anthropic”: {
“type”: “api_key”,
“provider”: “anthropic”,
“key”: “sk-cfkqxxxxxxxxxpkh”
}
}
}
EOF

最后,验证文件是否创建成功。
cat ~/.openclaw/agents/main/agent/auth-profiles.json

3.设置OpenClaw服务
为了操作便利,实现开机自动运行,笔者将OpenClaw设置为服务,过程如下:

  1. 安装网关服务
    openclaw gateway install

  2. 启动服务
    systemctl --user start openclaw-gateway.service

  3. 设置开机自启
    systemctl --user enable openclaw-gateway.service

  4. 查看服务状态
    systemctl --user status openclaw-gateway.service
    在这里插入图片描述

  5. 查看实时日志(类似 tail -f)
    openclaw logs --follow
    在这里插入图片描述
    完成服务配置后,重启服务,再次进行聊天功能测试。

4.聊天出现:HTTP 403 forbidden: Request not allowed

  1. 原因 OpenClaw 在尝试调用模型 API 时,因为某些原因被服务器拒绝了。核准配置文件,缺少硅基流动的配置信息:
    “models”: {
    “providers”: {
    “siliconflow”: {
    “type”: “anthropic”,
    “baseUrl”: “https://api.siliconflow.cn”,
    “apiKey”: “你的硅基流动API Key”,
    “models”: [
    {
    “id”: “Pro/MiniMaxAI/MiniMax-M2.5”,
    “name”: “MiniMax-M2.5”,
    “contextWindow”: 200000,
    “maxTokens”: 8192
    },
    {
    “id”: “deepseek-ai/DeepSeek-V3”,
    “name”: “DeepSeek-V3”,
    “contextWindow”: 64000
    }
    ]
    }
    },
    “default”: “siliconflow/Pro/MiniMaxAI/MiniMax-M2.5”
    }

  2. 配置完成后,在web上聊天出现 HTTP 404: Not Found
    原因是 OpenClaw 在尝试调用模型 API 时,请求的地址(URL)是错误的。结合之前配置的是硅基流动(SiliconFlow),很可能是 API 的 baseURL 配置有误。
    配置文件~/.openclaw/agents/main/agent/auth-profiles.json修改如下:
    {
    “profiles”: {
    “anthropic”: {
    “type”: “api_key”,
    “provider”: “anthropic”,
    “key”: “sk-cfkxxtxxxxkh”,
    “baseURL”: “https://api.siliconflow.cn”
    },

    }

3.运行 openclaw doctor 诊断
doctor 命令显示 OpenClaw 运行正常,没有发现严重错误。这说明核心服务是好的,问题应该出在具体的模型配置上。
但是运行测试命令:
curl -v https://api.siliconflow.cn/v1/models
-H “Authorization: Bearer 硅基Key”
返200 你的硅基流动 API Key 是有效的。你的服务器能够正常访问硅基流动的 API 服务。

  1. 检查浏览器端 ,反应正常,没有前端报错。
  2. 还是调试服务器端,输入测试命令:
    openclaw agent --agent main --message “你好,这是一条测试消息。” --model "Pro/MiniMaxAI/MiniMax-M2.5"失败。出现404错误。
  3. 连续改换几个模型,包括DeepSeek-V3还是失败,继续出现 404错误。
    [root@localhost .openclaw]# openclaw agent --agent main --message “你好,用DeepSeek-V3测试”

🦞 OpenClaw 2026.3.13 (61d171a) — Your config is valid, your assumptions are not.
│gateway connect failed: Error: gateway closed (1000):

Gateway agent failed; falling back to embedded: Error: gateway closed (1000 normal closure): no close reason
Gateway target: ws://127.0.0.1:18789
Source: local loopback
Config: /root/.openclaw/openclaw.json
Bind: lan
02:19:44 [agent/embedded] embedded run agent end: runId=b5497608-b5dc-4aab-8a21-fb764680c29e isError=true model=Pro/deepseek-ai/DeepSeek-V3 provider=siliconflow error=HTTP 404: Not Found
02:19:44 [agent/embedded] embedded run failover decision: runId=b5497608-b5dc-4aab-8a21-fb764680c29e stage=assistant decision=surface_error reason=model_not_found provider=siliconflow/Pro/deepseek-ai/DeepSeek-V3 profile=-
HTTP 404: Not Found

  1. 继续更改模型,经过长时间的测试,终于找到了一个可用的模型:THUDM/glm-4-9b-chat
    在这里插入图片描述
  2. 重新使用模型THUDM/glm-4-9b-chat配置openclaw,重启后,终于进入正常使用状态:
    在这里插入图片描述
    总结下,首次使用OpenClaw,需要配置好运行参数、认证配置,特别是正确配置好大模型,才能正常使用。今天才开张第一个功能:聊天功能,期待继续努力,挖掘更多功能,真正实现数字助理员的作用。
Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐