208 lines
5.3 KiB
Markdown
208 lines
5.3 KiB
Markdown
---
|
||
title: OpenClaw 完整配置文档
|
||
source:
|
||
author: shenwei
|
||
published:
|
||
created:
|
||
description:
|
||
tags: []
|
||
---
|
||
|
||
# OpenClaw 完整配置文档
|
||
|
||
> 最后更新: 2026-03-15 20:30
|
||
|
||
---
|
||
|
||
## 1. 概览
|
||
|
||
- **版本**: 2026.3.13
|
||
- **Gateway 状态**: 运行中 (pid 30771)
|
||
- **Gateway 端口**: 18789
|
||
- **绑定地址**: 127.0.0.1 (loopback)
|
||
- **配置文件**: ~/.openclaw/openclaw.json
|
||
|
||
---
|
||
|
||
## 2. Agent 列表
|
||
|
||
| Agent ID | 名称 | Workspace | 模型 | 路由规则 |
|
||
|----------|------|-----------|------|----------|
|
||
| main | (默认) | ~/.openclaw/workspace | MiniMax-M2.5 | 0 (默认) |
|
||
| xinghui | 星辉 | ~/.openclaw/workspace-agent-xinghui | MiniMax-M2.5 | 1 (telegram bot1) |
|
||
| xingyao | 星曜 | ~/.openclaw/workspace-agent-xingyao | MiniMax-M2.5 | 1 (telegram bot2) |
|
||
|
||
### 2.1 路由绑定 (Bindings)
|
||
|
||
| Agent | 匹配条件 |
|
||
|-------|----------|
|
||
| xinghui | channel: telegram, accountId: bot1 |
|
||
| xingyao | channel: telegram, accountId: bot2 |
|
||
|
||
---
|
||
|
||
## 3. Workspace 目录
|
||
|
||
| Workspace | 路径 | 说明 |
|
||
|-----------|------|------|
|
||
| main | ~/.openclaw/workspace | 默认工作空间 |
|
||
| xinghui | ~/.openclaw/workspace-agent-xinghui | 星辉工作空间 |
|
||
| xingyao | ~/.openclaw/workspace-agent-xingyao | 星曜工作空间 |
|
||
|
||
---
|
||
|
||
## 4. 可用模型 (Models)
|
||
|
||
### 4.1 MiniMax Portal
|
||
|
||
| 模型 ID | 名称 | 上下文窗口 | 最大输出 | 思考模式 |
|
||
|---------|------|-----------|---------|----------|
|
||
| MiniMax-M2.5 | MiniMax M2.5 | 200K | 8192 | 否 |
|
||
| MiniMax-M2.5-highspeed | MiniMax M2.5 Highspeed | 200K | 8192 | 是 |
|
||
| MiniMax-M2.5-Lightning | MiniMax M2.5 Lightning | 200K | 8192 | 是 |
|
||
|
||
### 4.2 DeepSeek (自定义 Provider)
|
||
|
||
| 模型 ID | 名称 | 上下文窗口 | 最大输出 |
|
||
|---------|------|-----------|---------|
|
||
| deepseek-reasoner | deepseek-reasoner | 16K | 4096 |
|
||
| deepseek-chat | deepseek-chat | 16K | 4096 |
|
||
|
||
### 4.3 默认模型配置
|
||
|
||
- **主模型**: minimax-portal/MiniMax-M2.5
|
||
- **备用模型**:
|
||
1. custom-api-deepseek-reasoner/deepseek-reasoner
|
||
2. custom-api-deepseek-chat/deepseek-chat
|
||
3. minimax-portal/MiniMax-M2.5-highspeed
|
||
4. minimax-portal/MiniMax-M2.5-Lightning
|
||
|
||
---
|
||
|
||
## 5. 频道 (Channels)
|
||
|
||
### 5.1 Telegram 配置
|
||
|
||
| Account | Bot Token | DM策略 | 群组策略 | 状态 |
|
||
|---------|-----------|--------|----------|------|
|
||
| default | 8414432613:AAG9hvKfILGSsbc1EMEZW1QVym9Quc5aHWk | pairing | open | 已配置 |
|
||
| bot1 | 8709222939:AAEfvZrvvU5vZFsmacsR5nmpkJ2Jb5JgfRg | pairing | allowlist | 已配置 |
|
||
| bot2 | 8414432613:AAG9hvKfILGSsbc1EMEZW1QVym9Quc5aHWk | pairing | allowlist | 已配置 |
|
||
|
||
### 5.2 全局 Telegram 配置
|
||
|
||
- **全局代理**: http://127.0.0.1:10808 (科学上网)
|
||
- **群组策略**: allowlist (⚠️ 需配置 groupAllowFrom)
|
||
- **流式传输**: partial
|
||
|
||
### 5.3 待修复问题
|
||
|
||
⚠️ **警告**: 以下 account 的 groupPolicy 是 allowlist，但 groupAllowFrom 为空，会导致群消息被静默丢弃：
|
||
- channels.telegram (全局)
|
||
- channels.telegram.accounts.bot1
|
||
- channels.telegram.accounts.bot2
|
||
|
||
**解决方案**: 添加 sender IDs 到 groupAllowFrom，或将 groupPolicy 改为 "open"
|
||
|
||
---
|
||
|
||
## 6. 已安装技能 (Skills)
|
||
|
||
| 技能名称 | 路径 | 状态 |
|
||
|----------|------|------|
|
||
| accli | ~/.openclaw/skills/accli | ✅ 已安装 |
|
||
| apple-notes | ~/.openclaw/skills/apple-notes | ✅ 已安装 |
|
||
| apple-reminders | ~/.openclaw/skills/apple-reminders | ✅ 已安装 |
|
||
| gog | ~/.openclaw/skills/gog | ✅ 已安装 |
|
||
| ontology | ~/.openclaw/skills/ontology | ✅ 已安装 |
|
||
| self-improving-agent | ~/.openclaw/skills/self-improving-agent | ✅ 已安装 |
|
||
|
||
---
|
||
|
||
## 7. 认证 (Auth)
|
||
|
||
### 7.1 Auth Providers
|
||
|
||
| Provider | 模式 | 说明 |
|
||
|----------|------|------|
|
||
| minimax-portal | oauth | MiniMax OAuth 认证 |
|
||
|
||
---
|
||
|
||
## 8. Gateway 配置
|
||
|
||
| 配置项 | 值 |
|
||
|--------|-----|
|
||
| 端口 | 18789 |
|
||
| 模式 | local |
|
||
| 绑定 | loopback (127.0.0.1) |
|
||
| 认证模式 | token |
|
||
| Tailscale | off |
|
||
|
||
### 8.1 禁止命令 (Deny Commands)
|
||
|
||
以下命令在节点上被禁止执行：
|
||
- camera.snap
|
||
- camera.clip
|
||
- screen.record
|
||
- contacts.add
|
||
- calendar.add
|
||
- reminders.add
|
||
- sms.send
|
||
|
||
---
|
||
|
||
## 9. 插件 (Plugins)
|
||
|
||
| 插件 | 状态 |
|
||
|------|------|
|
||
| telegram | ✅ 启用 |
|
||
| minimax-portal-auth | ✅ 启用 |
|
||
|
||
---
|
||
|
||
## 10. 文件结构
|
||
|
||
```
|
||
~/.openclaw/
|
||
├── openclaw.json # 主配置文件
|
||
├── agents/ # Agent 目录
|
||
│ ├── main/agent/
|
||
│ ├── xinghui/agent/
|
||
│ └── xingyao/agent/
|
||
├── workspace/ # main 工作空间
|
||
├── workspace-agent-xinghui/ # 星辉工作空间
|
||
├── workspace-agent-xingyao/ # 星曜工作空间
|
||
├── skills/ # 已安装技能
|
||
├── credentials/ # 凭证存储
|
||
├── devices/ # 设备配置
|
||
├── cron/ # 定时任务
|
||
├── logs/ # 日志文件
|
||
└── telegram/ # Telegram 数据
|
||
```
|
||
|
||
---
|
||
|
||
## 11. 常用命令
|
||
|
||
```bash
|
||
# 查看所有 Agent
|
||
openclaw agents list
|
||
|
||
# 查看 Agent 绑定
|
||
openclaw agents list --bindings
|
||
|
||
# 查看频道状态
|
||
openclaw channels list
|
||
|
||
# 查看 Gateway 状态
|
||
openclaw gateway status
|
||
|
||
# 重新启动 Gateway
|
||
openclaw gateway restart
|
||
```
|
||
|
||
---
|
||
|
||
*文档生成时间: 2026-03-15 20:30*
|