openclaw-config-helper by aaaaqwq/agi-super-skills
npx skills add https://github.com/aaaaqwq/agi-super-skills --skill openclaw-config-helper修改任何 OpenClaw 配置前,必须完成以下步骤,否则可能导致系统崩溃或功能异常!
gateway action=config.patch 或 gateway action=config.apply 的操作# 获取完整配置 schema
gateway action=config.schema
检查要点 :
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
# 使用 web_fetch 获取官方文档
web_fetch: https://docs.openclaw.ai/channels/telegram
web_fetch: https://docs.openclaw.ai/channels/whatsapp
web_fetch: https://docs.openclaw.ai/gateway/configuration-reference
或者使用搜索 :
cd ~/clawd/skills/tavily && ./scripts/tavily.sh search "OpenClaw <配置项> 配置"
向用户展示:
等待用户确认后才执行修改!
# 使用 config.patch 进行部分修改(推荐)
gateway action=config.patch raw='{"修改的路径": "值"}'
# 或使用 config.apply 进行完整替换(谨慎使用)
gateway action=config.apply raw='{"完整配置": "..."}'
# 检查配置是否生效
gateway action=config.get
# 检查 Gateway 状态
openclaw status
错误 :把群 ID 放在 groupAllowFrom 里
// ❌ 错误
"groupAllowFrom": [-1003531486855, -1003890797239] // 这是群 ID,不是用户 ID!
// ✅ 正确
"groupAllowFrom": ["8518085684"] // 用户 ID
"groups": {
"-1003531486855": {"groupPolicy": "open", "requireMention": true}
}
教训 :groupAllowFrom 是发送者白名单(用户 ID),groups 是群组白名单(群 ID)
错误 :主 bot (default account) 没有绑定到任何 agent
// ❌ 缺少 default → main 的绑定
"bindings": [
{"agentId": "ops", "match": {"accountId": "xiaoops"}},
// ... 其他 bot,但没有 default
]
// ✅ 必须添加
"bindings": [
{"agentId": "main", "match": {"channel": "telegram", "accountId": "default"}},
// ... 其他
]
错误 :OpenClaw 不支持 pass: 格式的 apiKey 引用
// ❌ 错误
"apiKey": "pass:api/xingsuancode" // 会被当作字符串直接发送
// ✅ 正确
"apiKey": "sk-f873092ea177b75b..." // 必须硬编码真实 key
| 配置项 | 类型 | 说明 |
|---|---|---|
allowFrom | 用户 ID 数组 | DM 白名单(用户 ID) |
groupAllowFrom | 用户 ID 数组 | 群组发送者白名单(用户 ID) |
groups | 对象 | 群组配置(群 ID 作为 key) |
bindings | 数组 | accountId → agentId 映射 |
accounts | 对象 | 多账号配置(key 是 accountId) |
修改配置前,确认:
config.schema 确认字段类型config.patch 而非 config.apply(除非必要)永远不要想当然地修改配置!先查文档,再改配置!
Weekly Installs
1
Repository
GitHub Stars
11
First Seen
4 days ago
Security Audits
Installed on
amp1
cline1
openclaw1
opencode1
cursor1
kimi-cli1
修改任何 OpenClaw 配置前,必须完成以下步骤,否则可能导致系统崩溃或功能异常!
gateway action=config.patch 或 gateway action=config.apply 的操作# 获取完整配置 schema
gateway action=config.schema
检查要点 :
# 使用 web_fetch 获取官方文档
web_fetch: https://docs.openclaw.ai/channels/telegram
web_fetch: https://docs.openclaw.ai/channels/whatsapp
web_fetch: https://docs.openclaw.ai/gateway/configuration-reference
或者使用搜索 :
cd ~/clawd/skills/tavily && ./scripts/tavily.sh search "OpenClaw <配置项> 配置"
向用户展示:
等待用户确认后才执行修改!
# 使用 config.patch 进行部分修改(推荐)
gateway action=config.patch raw='{"修改的路径": "值"}'
# 或使用 config.apply 进行完整替换(谨慎使用)
gateway action=config.apply raw='{"完整配置": "..."}'
# 检查配置是否生效
gateway action=config.get
# 检查 Gateway 状态
openclaw status
错误 :把群 ID 放在 groupAllowFrom 里
// ❌ 错误
"groupAllowFrom": [-1003531486855, -1003890797239] // 这是群 ID,不是用户 ID!
// ✅ 正确
"groupAllowFrom": ["8518085684"] // 用户 ID
"groups": {
"-1003531486855": {"groupPolicy": "open", "requireMention": true}
}
教训 :groupAllowFrom 是发送者白名单(用户 ID),groups 是群组白名单(群 ID)
错误 :主 bot (default account) 没有绑定到任何 agent
// ❌ 缺少 default → main 的绑定
"bindings": [
{"agentId": "ops", "match": {"accountId": "xiaoops"}},
// ... 其他 bot,但没有 default
]
// ✅ 必须添加
"bindings": [
{"agentId": "main", "match": {"channel": "telegram", "accountId": "default"}},
// ... 其他
]
错误 :OpenClaw 不支持 pass: 格式的 apiKey 引用
// ❌ 错误
"apiKey": "pass:api/xingsuancode" // 会被当作字符串直接发送
// ✅ 正确
"apiKey": "sk-f873092ea177b75b..." // 必须硬编码真实 key
| 配置项 | 类型 | 说明 |
|---|---|---|
allowFrom | 用户 ID 数组 | DM 白名单(用户 ID) |
groupAllowFrom | 用户 ID 数组 | 群组发送者白名单(用户 ID) |
groups | 对象 | 群组配置(群 ID 作为 key) |
bindings | 数组 | accountId → agentId 映射 |
accounts | 对象 | 多账号配置(key 是 accountId) |
修改配置前,确认:
config.schema 确认字段类型config.patch 而非 config.apply(除非必要)永远不要想当然地修改配置!先查文档,再改配置!
Weekly Installs
1
Repository
GitHub Stars
11
First Seen
4 days ago
Security Audits
Gen Agent Trust HubPassSocketPassSnykFail
Installed on
amp1
cline1
openclaw1
opencode1
cursor1
kimi-cli1
AI Elements:基于shadcn/ui的AI原生应用组件库,快速构建对话界面
60,400 周安装
Angular HTTP 数据获取教程:基于信号的 httpResource() 与 resource() 使用指南
1 周安装
GitHub趋势数据抓取指南:获取热门仓库与开发者数据(无官方API解决方案)
2,400 周安装
Svelte 5 最佳实践指南:Runes、Snippets、TypeScript 与性能优化
2,500 周安装
Smithery AI CLI:AI智能体市场命令行工具,连接10万+工具与技能
2,400 周安装
Linear CLI 命令行工具:从终端管理 Linear 问题,集成 Git 和 JJ
2,400 周安装
RivetKit Actor 运行时 - 构建高性能长生命周期内存进程,适用于AI智能体与实时协作
2,400 周安装