OpenClaw如何更新token

OpenClaw Gateway Token更新指南：原理与两种实操方法

更新OpenClaw Gateway的访问令牌，这事儿听起来有点技术性，但其实核心逻辑很清晰：本质上就是修改配置文件里的gateway.auth.token这个值，然后让Gateway服务重新加载一下配置，新令牌就生效了。

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

方法一：使用命令行工具（推荐）

对于习惯操作终端的用户来说，命令行是最直接高效的方式。一步步来，很简单：

source ~/.nvm/nvm.sh && nvm use 24 # 若需要
# 随机生成新 token（示例）
NEW="$(openssl rand -hex 24)"
openclaw config set gateway.auth.mode token
openclaw config set gateway.auth.token "$NEW"
openclaw config validate # 若有该命令，可检查配置
openclaw gateway restart

操作完成后，记得使用新令牌来访问。例如，可以直接在终端启动控制台：

openclaw dashboard

或者在浏览器中使用包含新#token=…参数的地址。这里必须提醒一句：生成的新令牌链接，可千万别再不小心发到公开聊天群组里了。

方法二：直接编辑配置文件

如果你更喜欢直接操作文件，或者需要更精细地控制配置，那么直接修改配置文件是个好选择。

1. 找到并编辑~/.openclaw/openclaw.json文件（如果你自定义过配置路径，那就是OPENCLAW_CONFIG_PATH指向的那个文件）。
2. 在gateway.auth这个配置项下，确保"mode": "token"这一行保持不变，然后把token字段的值替换成新的字符串。具体格式参考如下：

"gateway": {
  "mode": "local",
  "auth": {
    "mode": "token",
    "token": "这里换成新 token"
  }
}

3. 文件保存之后，关键的一步来了：需要在终端执行重启命令，让更改生效。

openclaw gateway restart

可选方案：使用环境变量

有些场景下，你可能不希望把令牌明文写在配置文件里。这时，可以按照官方文档的说明，使用OPENCLAW_GATEWAY_TOKEN这样的环境变量来传递令牌。具体做法可以是在LaunchAgent plist的EnvironmentVariables里添加，或者采用你当前项目文档推荐的其他方式。在配置文件里，则可以写成"token": "${OPENCLAW_GATEWAY_TOKEN}"这类引用形式——具体以你本机OpenClaw文档中关于Gateway认证部分的说明为准。

重要注意事项

更换令牌后，有几个细节务必留心：

首先，旧的浏览器书签、以及所有包含旧#token=的链接都会立即失效，请确保后续只使用新的令牌进行访问。

其次，如果你曾经在对话或日志中不慎泄露过旧的令牌，那么按照上述步骤更换新令牌并重启Gateway，就是一项必须立即完成的安全操作。

最后，关于认证更完整的机制和选项，建议查阅OpenClaw官方文档中的“Authentication”部分（通常在站点内搜索gateway、auth、token等关键词就能找到）。