—# OpenClaw 新功能：如何使用命名模型登录配置管理多账号
一句话总结
OpenClaw 最新版本支持命名模型登录配置（Named Model Login Profiles），让你可以用一条命令切换不同的 AI 模型账号，彻底告别反复登录的烦恼。
为什么需要这个功能？
在使用 AI Agent 开发工具时，开发者经常面临这样的场景：工作时需要连接公司的企业版模型，个人项目又要切换到免费额度账号，测试时还可能需要第三个沙箱环境。以前每次切换都要重新执行完整的 OAuth 登录流程，耗时且容易出错。
OpenClaw 的命名配置功能正是为了解决这个痛点而生。
—
核心功能详解
什么是命名模型登录配置？
命名模型登录配置允许你为每个 OAuth 认证流程指定一个唯一标识符（Profile ID）。系统会将认证信息保存在本地，后续通过 --profile-id 参数即可快速切换，无需重复授权。
基础用法：创建第一个命名配置
创建名为 "work" 的工作账号配置
openclaw models auth login --profile-id=work
创建名为 "personal" 的个人账号配置
openclaw models auth login --profile-id=personal
执行后，OpenClaw 会启动浏览器完成 OAuth 授权，并将令牌与 work 或 personal 绑定存储。
切换配置：一行命令搞定
查看所有已保存的配置
openclaw models auth list
使用指定配置执行命令
openclaw models run "分析这段代码" --profile-id=work
设置默认配置（省略 --profile-id 时使用）
openclaw config set default_profile work
配置文件存储位置
OpenClaw 将认证信息存储在本地安全目录：
| 操作系统 | 路径 |
|———|——|
| macOS | ~/.config/openclaw/profiles/ |
| Linux | ~/.config/openclaw/profiles/ |
| Windows | %APPDATA%\OpenClaw\profiles\ |
每个配置以 JSON 文件形式保存，命名规则为 {profile_id}.json。
—
高级使用场景
场景一：团队开发环境隔离
为不同项目创建独立配置
openclaw models auth login --profile-id=project-alpha
openclaw models auth login --profile-id=project-beta
在 CI/CD 脚本中指定配置
openclaw models deploy --profile-id=project-alpha --env=production
场景二：多模型提供商管理
OpenAI 账号
openclaw models auth login openai --profile-id=openai-pro
Anthropic 账号
openclaw models auth login anthropic --profile-id=claude-team
本地 Ollama 实例（无需 OAuth，直接配置）
openclaw models config set ollama.local --profile-id=local-dev
场景三：自动化脚本中的配置注入
// 在 Node.js 脚本中动态选择配置
const { execSync } = require('child_process');
function runWithProfile(profileId, prompt) {
const command = openclaw models run "${prompt}" --profile-id=${profileId};
return execSync(command, { encoding: 'utf-8' });
}
// 根据环境变量自动切换
const profile = process.env.OPENCLAW_PROFILE || 'default';
const result = runWithProfile(profile, '优化这段 SQL 查询');
console.log(result);
—
安全与权限管理
配置文件的权限控制
建议为配置文件目录设置严格的文件权限：
Linux/macOS：确保只有当前用户可读写
chmod 700 ~/.config/openclaw/profiles/
chmod 600 ~/.config/openclaw/profiles/*.json
敏感信息处理
OpenClaw 使用系统密钥链（macOS Keychain、Windows Credential Manager、Linux Secret Service）加密存储访问令牌，配置文件仅保存元数据。
清理过期配置
删除指定配置
openclaw models auth logout --profile-id=old-project
清理所有过期令牌
openclaw models auth cleanup --expired-only
—
常见问题 FAQ
Q1: 不指定 –profile-id 时会怎样？
使用默认配置。如果从未设置过，OpenClaw 会提示你创建或选择现有配置。建议通过 openclaw config set default_profile {id} 设置常用默认项。
Q2: 命名配置支持哪些特殊字符？
Profile ID 仅支持小写字母、数字、连字符（-）和下划线（_），长度限制为 3-32 个字符。例如：prod-us-east-1 ✓，My Profile! ✗。
Q3: 可以共享配置文件给团队成员吗？
不推荐。配置文件包含个人 OAuth 令牌，共享会导致安全风险。团队应各自执行登录命令，或使用 OpenClaw 的团队许可证功能（如有）。
Q4: 如何排查配置切换失败的问题？
启用调试模式查看详细日志
openclaw models run "test" --profile-id=work --debug
验证配置是否有效
openclaw models auth verify --profile-id=work
常见原因：令牌过期（重新登录）、网络代理问题、或该配置未绑定目标模型提供商。
Q5: 旧版本升级后，之前的登录状态会丢失吗？
不会。未命名的历史配置会自动迁移为 default 配置，所有功能保持兼容。建议迁移后主动重命名为有意义的 ID 以便管理。
—
总结与下一步
OpenClaw 的命名模型登录配置功能让多账号管理变得简单高效。关键收益：
- ✅ 一次登录，永久复用
- ✅ 多环境秒级切换
- ✅ 团队协作更安全
- ✅ 自动化脚本更灵活
立即尝试：
openclaw update # 升级到最新版本
openclaw models auth login --profile-id=my-first-profile
—
相关阅读
—
参考来源
