需覆盖原配置并重启服务,否则新密钥不会被加载;可通过TUI界面或手动编辑config.yaml修改openai_api_key字段,保存后必须执行openclaw restart或systemctl restart openclaw才能生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

OpenClaw修改已保存的API Key需覆盖原配置并重启服务,否则新密钥不会被加载——直接改完config.yaml文件却不重启,所有请求仍会用旧key失败。
通过TUI界面修改API Key
运行openclaw tui命令启动交互式终端界面。
按方向键导航至Settings → API Keys菜单项,回车进入编辑页。
找到openai_api_key字段所在行,删除原有值,粘贴新密钥(注意不要带多余空格或换行)。
按Ctrl+S保存,再按Ctrl+Q退出TUI。这一步操作起来很简单,但退出后必须手动重启服务,界面本身不会自动触发重启。
手动编辑config.yaml文件
定位到配置文件路径,通常为~/.openclaw/config.yaml或项目根目录下的config.yaml。
用文本编辑器打开该文件,搜索openai_api_key:关键字,确认其位于llm:区块下。
将冒号后的内容整体替换为新密钥,确保格式为openai_api_key: "sk-xxx",引号必须保留且左右无空格。
【引号缺失会导致解析失败,服务启动时直接报错退出】
保存文件,关闭编辑器。
修改后必须执行重启操作
第一步:停止当前服务→第二步:清除残留进程→第三步:重新启动
执行openclaw restart命令,它会自动完成停服、清理、拉起三步。
若使用systemd托管,改用sudo systemctl restart openclaw,确保以相同用户权限运行。
验证是否生效:查看日志journalctl -u openclaw -n 20 --no-pager,确认最后一行出现Using API key prefix: sk-...字样。


















