配置与设置
摘要
OpClaw 没有配置表单。配置是它自己的工作，你只在旁边说一句。后台一共 13 个配置域——身份与岗位、同事与关系、消息通道、模型接入、会话策略、图片与文件预处理、网关、任务通知、语音设备、扩展钩子、工具与权限、心跳自检、配置版本。本页逐个说清它们管什么、你平时怎么改、以及哪些改动要重启才生效。
为什么没有配置表单
原因很实际：这些配置项本质上是数字化的事情——填令牌、选模型、对渠道账号、配路径白名单。把它们做成表单，等于要求你先学会一套技术概念，再自己承担填错的责任。
OpClaw 的做法反过来：你说业务语言，它翻译成配置动作。
| 你说 | 它改 |
|---|---|
| 「以后叫我老王」 | 身份与岗位里的称呼 |
| 「把企业微信接上」 | 消息通道 + 同事与关系 |
| 「回答长内容时换回原来那个模型」 | 模型接入的默认模型 |
| 「我同事找我时只回答一般问题」 | 同事与关系里的身份级别 |
| 「只允许读共用目录，别碰我私人目录」 | 工具与权限里的可读路径 |
13 个配置域
| # | 配置域 | 管什么 | 你平时怎么说 |
|---|---|---|---|
| 1 | 身份与岗位 | 它是谁、叫什么、负责什么、能用哪些工具 | 「以后叫我老王」「只做办公类的事」 |
| 2 | 同事与关系 | 谁、从哪条通道、以什么身份找它（本人 / 同事 / 访客） | 「我同事用微信找我时只答一般问题」 |
| 3 | 消息通道 | 挂了哪几条通道、各通道的账号与开关 | 「把企业微信接上」「Mattermost 先停掉」 |
| 4 | 模型接入 | 用哪些模型、各自别名与上游、超时时间 | 「换个更快的模型」「长内容用原来那个」 |
| 5 | 会话与上下文 | 会话怎么划分、历史怎么带 | 「每次新话题都当新会话」 |
| 6 | 图片与文件预处理 | 图片识别用哪个模型、单个文件大小上限 | 「图片识别换成更准的模型」 |
| 7 | 网关与端口 | 监听地址、端口、日志级别 | 部署与运维场景 |
| 8 | 任务与通知 | 任务通知是否开启、通知节奏 | 「任务有变化马上告诉我」 |
| 9 | 语音设备 | 语音硬件接入与设备登记 | 「把这台设备登记给我」 |
| 10 | 扩展钩子 | 在内置行为上挂自定义扩展 | 进阶用法，按需 |
| 11 | 工具与权限 | 可读写哪些路径、哪些工具可用 | 「只允许读共用目录」 |
| 12 | 心跳自检 | 自己多久检查一次状态 | 运维场景 |
| 13 | 配置版本 | 配置格式版本，用于升级兼容 | 系统维护，一般不用管 |
逐域说明
1. 身份与岗位
决定它是谁：称呼、负责范围、可以用哪些工具。这是最常改的一个域——你希望它像个什么样的助手，都在这里定。
你：「以后汇报一律用『结论在前、数据在后』的写法，另外只做办公相关的事。」它：更新自己的岗位口径与工具范围。
2. 同事与关系
这一域是关系表，不是参数表。它记录：谁、经哪条通道、以什么身份来找它。
| 身份 | 它能给的 |
|---|---|
| 本人 | 全部能力 |
| 同事 / 已知联系人 | 你授权范围内的响应 |
| 访客 / 未识别 | 只答一般问题，不下任务、不提你的资料 |
你：「我同事老王用微信找我，只回答公司公开信息，别动我的文件。」它：在关系表里加一条，并把老王标为受限身份。
3. 消息通道
每条通道一组开关与凭据，逐条独立。启用与否是即时生效的，接错了随时关。
4. 模型接入
可以同时挂多个模型，给它们起别名，分别指定上游与超时。日常只需要管两件事：默认用哪个、什么场景用哪个。
你：「日常用快的那个，写长文的时候换回原来那个。」它：设置默认模型与场景切换规则。
5. 会话与上下文
决定会话怎么切分，以及它每次带上多少历史。直接影响到两件事：省钱（历史越长越贵）与是不是会串话题（上一件事的上下文带进下一件）。
你：「每次换话题都当新的会话，别把上一个任务的东西带进来。」它：调整会话划分策略。
6. 图片与文件预处理
- 图片识别模型：你发图片时，先用哪个模型看图（默认是一个专门的视觉模型）。
- 单文件大小上限：默认 20MB。超过就先压缩，或者分片发。
7. 网关与端口
实例监听在哪个地址、哪个端口，日志详细程度如何。这些属于部署参数——你自己跑一个实例时用得上；用托管服务时一般不用碰。
8. 任务与通知
控制任务状态变化时的通知：是否通知、多久汇总一次（默认节奏是每分钟检查）。任务多的时候，把节奏调慢一点可以少打扰。
9. 语音设备
语音硬件接入的口子。把设备登记到你的实例之后它才能用；未登记的设备会被直接拒绝——这是防止别人拿一台设备接进来。
10. 扩展钩子
在内置行为的前后挂自定义动作。属于进阶用法，日常用不到。
11. 工具与权限
| 项 | 说明 |
|---|---|
| 可读路径 | 它允许读哪些目录 |
| 可写路径 | 它允许写哪些目录 |
| 工具开关 | 读写文件、执行命令、抓网页、操作浏览器等逐个开关 |
这是安全上最该管的一域：想让它的活动范围收窄，都在这里说。
12. 心跳自检
它自己多久检查一次运行状态（默认 30 秒）。属于运维参数。
13. 配置版本
配置格式的版本号，用于升级时做兼容判断。你不用管。
改完什么时候生效
| 改动类型 | 生效方式 |
|---|---|
| 消息通道、同事与关系 | 即时生效，不用重启 |
| 身份与岗位、模型、工具与权限、会话策略等 | 一般在随后的对话里生效 |
| 网关监听地址与端口 | 需要重启实例才生效 |
需要重启的改动，它会明确告诉你「这项要重启才生效」，不会让你以为改完了。
配置改动是可追溯的
每一次配置改动都会留痕：时间、改了什么、改动前后的取值，以及这份配置的指纹。用途是复盘——同一件事它这周的做法和上周不一样，可以翻回去看当时改了什么。
这也意味着：改错了能改回来。说「把刚才那个改动退回去」就行。
常见问题
我能直接看配置原文吗？ 能。工作台的「配置总览」视图展示各配置域的当前取值与条目数；看板是只读的，改还是在对话里改。
配置会不会被别的东西覆盖？ 不会。配置只有一份真源，改动都落在这一份上。
换模型会让我丢记忆吗？ 不会。模型是可替换的资源，记忆与资料在实例里。
多人共用怎么办？ OpClaw 是个人形态，一个实例对应一个人。要让一个岗位服务多个人，那是 aimate 组织版的事，见OpClaw 与 aimate。