# OpenClaw 配置管理

## 配置文件位置

### 主要配置文件

- **配置文件**: `~/.openclaw/openclaw.json`
- **工作区**: `~/.openclaw/workspace`（默认）
- **凭证**: `~/.openclaw/credentials/`
- **会话**: `~/.openclaw/agents/<agentId>/sessions/`
- **状态**: `~/.openclaw/`（整个目录）

### 环境变量

- `OPENCLAW_CONFIG_PATH` - 配置文件路径
- `OPENCLAW_STATE_DIR` - 状态目录路径
- `OPENCLAW_PROFILE` - 配置 profile 名称
- `ANTHROPIC_API_KEY` - Anthropic API 密钥
- `OPENAI_API_KEY` - OpenAI API 密钥

## 配置管理命令

### 查看配置

```bash
openclaw config get <key>
```

例如：

```bash
openclaw config get gateway.mode
openclaw config get agents.defaults.model
```

### 设置配置

```bash
openclaw config set <key> <value>
```

例如：

```bash
openclaw config set gateway.mode local
openclaw config set gateway.port 18789
```

### 交互式配置

```bash
openclaw configure
```

或配置特定部分：

```bash
openclaw configure --section models
openclaw configure --section gateway
openclaw configure --section channels
```

## 常用配置项

### Gateway 配置

```json5
{
  gateway: {
    mode: 'local', // 或 "remote"
    port: 18789,
    bind: '127.0.0.1', // 或 "0.0.0.0"
    auth: {
      token: 'your-token-here',
    },
  },
}
```

### Agent 配置

```json5
{
  agents: {
    defaults: {
      workspace: '~/.openclaw/workspace',
      model: 'anthropic/claude-opus-4-5',
      // 其他默认设置
    },
    list: [
      {
        id: 'main',
        identity: {
          name: 'OpenClaw',
          emoji: '🦞',
          avatar: 'avatars/openclaw.png',
        },
      },
    ],
  },
}
```

### 渠道配置示例

```json5
{
  channels: {
    telegram: {
      botToken: 'your-token',
      allowFrom: ['+1234567890'],
      dm: {
        policy: 'pairing', // 或 "open"
      },
    },
    whatsapp: {
      allowFrom: ['+1234567890'],
    },
  },
}
```

## 多实例配置

使用不同的配置文件和状态目录运行多个实例：

```bash
OPENCLAW_CONFIG_PATH=~/.openclaw/a.json \
OPENCLAW_STATE_DIR=~/.openclaw-a \
openclaw gateway --port 19001
```

## 配置文件权限

配置文件应该设置为仅所有者可读写：

```bash
chmod 600 ~/.openclaw/openclaw.json
```

`openclaw doctor` 会自动检查并修复权限问题。