跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像AI 生图工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / BashAI

OpenClaw gateway start 报 401 Invalid API key 环境变量配置问题

OpenClaw gateway 使用 systemd 启动时出现 401 Invalid API key 错误,而前台运行正常。原因在于 systemd 服务环境与当前 Shell 环境变量隔离,导致自定义的 API 代理地址和密钥未生效。解决方法是在 systemd 用户服务的 [Service] 部分添加 Environment 配置项,指定 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN,随后重载并重启服务即可。

蜜桃汽水发布于 2026/3/30更新于 2026/7/2754 浏览

问题现象

使用 openclaw gateway run 前台运行时一切正常,但切换到 openclaw gateway start(systemd 后台服务)后报错:

HTTP 401: Invalid API key 

明明配置文件里 API key 写得好好的,为什么会这样?


原因分析

run 与 start 的区别在于环境变量继承方式:

  • run:前台运行,直接继承当前 Shell 的环境变量。
  • start:通过 systemd 启动后台服务,环境变量处于隔离状态。

当前 Shell 中设置了如下环境变量:

export ANTHROPIC_BASE_URL=https://api.aigocode.com
export ANTHROPIC_AUTH_TOKEN=sk-xxx...

gateway run 能继承这些变量,因此可用。但 systemd 服务启动时,这些变量不存在。虽然 openclaw.json 配置文件中写了 apiKey,但 OpenClaw 优先读取环境变量。当环境变量缺失时,可能默认调用 Anthropic 官方 API,导致配置文件中的 Key 验证失败返回 401。


解决方案

将环境变量添加到 systemd service 文件中。

Step 1:找到 service 文件

cat ~/.config/systemd/user/openclaw-gateway.service 

Step 2:在 [Service] 部分添加环境变量

[Service]
# ... 其他配置 ...
Environment=ANTHROPIC_BASE_URL=https://api.aigocode.com
Environment=ANTHROPIC_AUTH_TOKEN=sk-你的 key
[Install]
WantedBy=default.target

⚠️ 注意:Environment 必须放在 [Service] 部分内,不能放在 [Install] 后面,否则 systemd 会忽略该配置。

Step 3:重新加载并重启服务

systemctl --user daemon-reload
systemctl --user restart openclaw-gateway 

踩坑记录

若使用 >> 追加环境变量到文件末尾,可能会将其加到 [Install] 部分之后。systemd 日志会提示:

Unknown key name 'Environment' in section 'Install', ignoring.

这会导致配置不生效。


总结

问题的本质是前台运行和后台服务的环境变量隔离。如果使用第三方 API 代理(如 aigocode)或自定义 ANTHROPIC_BASE_URL,务必将这些变量添加到 systemd service 配置中。

目录

  1. 问题现象
  2. 原因分析
  3. 解决方案
  4. Step 1:找到 service 文件
  5. Step 2:在 [Service] 部分添加环境变量
  6. ... 其他配置 ...
  7. Step 3:重新加载并重启服务
  8. 踩坑记录
  9. 总结
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • Visual Studio 中基于 libmodbus 的 C++ Modbus RTU 主站示例
  • TCP TIME_WAIT 状态的作用及服务端状态过多原因
  • 无人机远程路径规划:A*算法与GPS精准定位
  • FPGA 高速通信:Aurora64B/66B IP 使用指南
  • 近十年视觉任务中的对抗攻击研究综述
  • GitHub 学生认证及 VSCode 中 Copilot 使用教程
  • 无人机相关法律法规全体系梳理
  • C++左值与右值深度解析
  • Vivado FPGA 开发流程详解
  • OpenClaw self-improving-agent 技能详解:让 AI 从错误中自主学习
  • 网络安全行业发展前景与零基础转行建议
  • 破局新农业数智化困境:低代码不是“捷径”,而是重构生产逻辑的技术密钥
  • Xilinx Vivado 付费 IP 核 License 状态解读与获取
  • 基于 NestJS + Vue3 的企业级前后端分离快速开发脚手架
  • AIGC 时代如何打造卓越的技术文档
  • 常见滤波算法原理与应用场景对比
  • YOLO26:Ultralytics 发布端到端视觉 AI 新突破
  • LangBot:企业级即时通讯 AI 机器人平台
  • 绿联 NAS 配置 WebDAV 公网访问并使用 RaiDrive 挂载
  • 前端调用摄像头拍照,并使用 Vue Cropper 进行裁剪

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online