配置手册
配置手册解释 NextClaw 的配置面。它不是新手第一步;如果你还没跑通,先看 快速开始。
配置分成几类
模型提供方
决定 NextClaw 调用哪个模型服务。包括 provider、API base、认证方式、默认模型。
相关指南:
渠道
决定用户从哪里进入 NextClaw,例如本地 UI、聊天平台或其他入口。
相关指南:
密钥
保存 API Key、token 和其他敏感信息。密钥应该集中管理,避免直接散落在普通文档和聊天记录里。
相关手册:
自动化
决定哪些任务可以按计划触发,以及是否需要绑定会话上下文。
相关指南:
外观
会话切换、更多操作和下拉选择采用统一的轻描边、圆角与柔和阴影,菜单层次随明暗主题调整。
会话切换菜单仅滚动列表,标题、时间/项目切换和搜索框始终保留在顶部。
筛选、标签和菜单使用随主题适配的轻量悬停与选中反馈;桌面会话和导航侧栏保留柔和灰阶层次,移动会话保留浅纸色反馈。工作台标签底边贴齐标签栏,会话行内操作提示优先显示在上方。
在 设置 → 外观 中选择界面主题、语言、消息布局和 SideDock 显示方式。主题会保存在当前设备并即时应用;刷新或重新打开 NextClaw 后仍会保持。
“默认”跟随当前推荐主题,目前与“素笺”效果相同。素笺以暖纸色为底,使用浅茶灰用户气泡、深灰褐文字和柔和的中性色控件,适合长时间阅读。暖墨绿配色的“纸墨”作为独立主题保留;旧默认“素白”及“简白”“纸暖”“自然”等也仍可选择。选择具体名称可固定主题,选择“默认”则跟随后续推荐。
岛屿 主题使用暖纸画布、随风轻摆的热带树和低噪声界面,适合希望工作台更安静、更有环境感的用户。系统开启“减少动态效果”时,树会保持静止。它只改变视觉表达,不改变任务、会话或工具行为。
隐私与匿名统计
NextClaw 默认发送匿名使用统计,用于估算当日、当前自然周和当前自然月的活跃安装及成功活跃。每个周期使用互不关联的随机单次回执,不发送账号、登录令牌或长期安装标识,也不包含消息、回复、工具数据、文件、URL、IP、User-Agent 或诊断日志。
你可以在 设置 → 隐私与统计 中随时关闭。关闭后,NextClaw 会停止发送并清除本地待发送回执。服务端已有数据只有匿名汇总,无法按安装反查或删除。统计结果是活跃安装估算,不等于精确人数;WAU 和 MAU 分别采用自然周和自然月,而不是滚动 7/30 日窗口。
配置修改后如何确认
nextclaw status
nextclaw doctor如果配置未生效,先看 故障排查。
什么时候用命令改配置
普通用户优先使用 UI。
当你需要脚本化、远程维护或精确修改配置路径时,再使用 nextclaw config。
完整命令见 命令索引。
所有主题均不显示用户自己的头像,用户消息通过右侧气泡区分身份。