OpenClaw 配置指南

OpenClaw 是一个强大的 AI 助手框架，本文记录了我的配置文件结构和关键设置。

配置文件位置

OpenClaw 的主配置文件位于：

~/.openclaw/openclaw.json

基本配置结构

1. 认证配置

"auth": {
  "profiles": {
    "zai:default": {
      "provider": "zai",
      "mode": "api_key"
    }
  }
}

使用 ZAI 提供的 GLM 模型，需要配置 API key。

2. Agents 配置

"agents": {
  "defaults": {
    "model": {
      "primary": "zai/glm-4.7",
      "fallbacks": ["zai/glm-4.5-flash"]
    },
    "workspace": "/home/hamburgerwang/.openclaw/workspace",
    "maxConcurrent": 4
  },
  "list": [
    {
      "id": "main"
    },
    {
      "id": "software-engineer",
      "name": "software-engineer",
      "workspace": "/home/hamburgerwang/.openclaw/workspace-software-engineer",
      "agentDir": "/home/hamburgerwang/.openclaw/agents/software-engineer/agent",
      "identity": {
        "name": "CodeBot",
        "theme": "Software Engineer AI",
        "emoji": "💻"
      }
    }
  ],
  "allowlist": ["main", "software-engineer"]
}

• main: 默认主 agent
• software-engineer: 专门的编程助手，有独立的 workspace
• allowlist: 允许 sessions_spawn 调用的 agent 列表

3. Channels 配置

支持多种消息渠道：

"channels": {
  "imessage": {
    "enabled": true,
    "cliPath": "imsg",
    "dmPolicy": "pairing",
    "groupPolicy": "allowlist"
  },
  "feishu": {
    "enabled": true,
    "appId": "cli_a901989e97389cd3",
    "domain": "feishu",
    "groupPolicy": "open"
  }
}

• iMessage: 支持 Apple 设备的消息
• Feishu (飞书): 企业协作工具集成

4. Gateway 配置

"gateway": {
  "port": 18789,
  "mode": "local",
  "bind": "loopback",
  "auth": {
    "mode": "token",
    "token": "your-token-here"
  }
}

• port: Gateway 服务端口
• mode: local 模式，只监听本地
• bind: loopback 只允许本机访问

5. Tools 配置

Agent 间通信设置：

"tools": {
  "agentToAgent": {
    "enabled": true,
    "allow": ["main", "software-engineer"]
  }
}

允许 main 和 software-engineer 之间互相调用。

Workspace 说明

每个 agent 有独立的工作空间：

• Main workspace: ~/.openclaw/workspace
• Software-engineer workspace: ~/.openclaw/workspace-software-engineer

工作空间包含：

• SOUL.md: Agent 的人格定义
• USER.md: 用户信息
• IDENTITY.md: Agent 身份信息
• MEMORY.md: 长期记忆
• memory/YYYY-MM-DD.md: 每日记录

常用命令

# 查看 Gateway 状态
openclaw gateway status

# 启动 Gateway
openclaw gateway start

# 停止 Gateway
openclaw gateway stop

# 重启 Gateway
openclaw gateway restart

# 查看配置
openclaw gateway config.get

# 应用配置
openclaw gateway config.apply

总结

OpenClaw 的配置采用 JSON 格式，结构清晰，易于扩展。主要模块包括：

1. auth: 认证配置
2. agents: Agent 定义和管理
3. channels: 消息渠道集成
4. gateway: 服务网关设置
5. tools: 工具和权限配置

通过合理配置，可以实现多 agent 协作、多渠道接入和安全的本地运行。