OpenClaw 彻底重置 + MiniMax OAuth 重新配置 + 飞书对接

一、前置条件

1. 服务器已启动 *** 代理（端口默认 7890）
2. 拥有 MiniMax 账号（支持 OAuth 授权）
3. 飞书应用已完成基础配置

---

二、步骤1：彻底停止 OpenClaw 网关服务

# 停止 OpenClaw 网关（官方命令）
openclaw gateway stop

---

三、步骤2：清空所有旧认证/缓存/日志残留（核心）

彻底清除历史授权、配置缓存，解决「认证卡住」问题：

# 删除授权状态 & 运行缓存
rm -rf ~/.openclaw/state ~/.openclaw/cache

# 删除授权配置文件
rm -f ~/.openclaw/auth.json ~/.openclaw/profiles.json ~/.openclaw/.env

# 清理运行日志
rm -f /tmp/openclaw-*.log

# 验证清理结果（无输出=清理完成）
ls ~/.openclaw/state ~/.openclaw/cache 2>/dev/null

---

四、步骤3：配置终端代理（解决 OAuth 超时/等待）

让 OpenClaw 的授权流量走 *** 代理，避免网络阻塞：

export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890

---

五、步骤4：验证代理连通性

curl -I https://platform.minimaxi.com

返回 HTTP/2 307 / 200 代表代理正常。

---

六、步骤5：执行官方引导重新配置

openclaw onboard --auth-choice minimax-portal

---

七、步骤6：引导流程交互操作（逐步骤）

1. 安全声明：选择 Yes 确认
2. 配置模式：选择 QuickStart
3. 现有配置：选择 Use existing values（保留原有网关配置）
4. MiniMax 节点：选择 CN（国内节点）
5. OAuth 授权
   • 复制终端给出的授权链接 + user_code
   • 浏览器打开链接，登录 MiniMax 并输入验证码
   • 等待终端自动识别授权完成
6. 套餐信息：确认 Trial 试用版有效期
7. 模型配置：默认绑定 minimax-portal/MiniMax-M2.5
8. 通道选择：选择 Feishu/Lark (飞书)
9. 飞书配置：选择 Skip (leave as-is)（保留现有配置）
10. 技能配置：
    • 配置技能：Yes
    • 安装依赖：Skip for now
    • 第三方 Key：全部选择 No
11. 钩子配置：选择 session-memory 开启会话记忆
12. 网关服务：选择 Restart 重启网关
13. 启动方式：选择 Hatch in TUI (recommended) 进入控制台

---

八、步骤7：配置完成验证

# 查看模型授权状态
openclaw models list

✅ 正常状态：minimax-portal/MiniMax-M2.5 显示 Auth: yes

# 查看网关运行状态
openclaw gateway status

---

九、步骤8：飞书机器人功能测试

向飞书机器人发送消息（如 你好），正常回复即代表配置完成。

---

十、关键注意事项

1. OAuth 卡住核心原因：未走代理 / 旧授权残留，必须先清理再配置
2. 代理必须配置：export 代理是 OAuth 成功的关键
3. 授权时效：user_code 有效期短，需 1 分钟内完成网页授权
4. 残留清理：state/cache 目录是授权核心残留，必须删除