玩转OpenClaw提高篇

配置文件详解

Linux或者MacOS默认路径：~/.openclaw/openclaw.json
Windows默认路径： C:\Users\用户.openclaw\openclaw.json

OpenClaw 的设计哲学是“一个配置文件管理一切”——无论你需要调整模型、添加通信渠道、修改 Gateway 行为还是配置安全权限，所有设置都集中在一个文件中

核心配置项

1. 模型配置（Primary + Fallback 双机制）
   模型配置决定 AI 智能体使用哪个大语言模型来“思考”

# 设置主模型
openclaw config set agents.defaults.model.primary anthropic/claude-opus-4-6

# 设置备用模型（主模型不可用时自动降级）
openclaw config set agents.defaults.model.fallback openai/gpt-4

OpenClaw 支持多个模型提供商，包括 Anthropic（Claude 系列）、OpenAI（GPT 系列）、Google（Gemini 系列）、Moonshot AI（Kimi 系列）等, 也支持自定义，兼容openai 格式的。

2. Skills 配置
   所有 Skills 相关配置都位于 openclaw.json 中的 skills

{
  "skills": {
    "allowBundled": ["gemini", "peekaboo"],
    "load": {
      "extraDirs": ["~/Projects/agent-scripts/skills"],
      "watch": true,
      "watchDebounceMs": 250
    },
    "install": {
      "preferBrew": true,
      "nodeManager": "npm"
    },
    "entries": {
      "peekaboo": { "enabled": true }
    }
  }
}

3. Gateway 配置

# 设置 Gateway 端口
openclaw config set gateway.port 18789

# 设置认证模式（推荐保持 token auth 开启）
openclaw config set gateway.auth.token "your-token"

4. 工作区配置文件

~/.openclaw/workspace/
├── AGENTS.md      # 代理调度规则与标准作业程序
├── BOOTSTRAP.md   # 初始化序列与核心系统提示词
├── HEARTBEAT.md   # 定时执行逻辑与主动任务状态自检
├── IDENTITY.md    # 代理身份定义与系统边界约束
├── MEMORY.md      # 长期上下文数据与既定规则的持久化存储
├── SOUL.md        # 响应语气、行为特征及输出格式配置
├── TOOLS.md       # 工具授权注册表及调用参数规范
├── USER.md        # 用户画像数据，包含特定偏好与交互限制配置
├── memory/        # 日常运行日志与短期上下文存储
└── skills/        # 已安装的第三方技能扩展目录

核心配置文件详解
SOUL.md —— AI 的灵魂与人格
SOUL.md 定义了代理的性格、核心价值观和长期指令，决定说话风格、做事方式和边界意识

## 核心身份与人格
- 角色设定：你是主人的专属 AI 助手
- 沟通风格：简单问题一针见血，复杂问题详细拆解

## 核心价值观与绝对红线
- 隐私与边界：绝对禁止泄露任何项目代码或个人隐私
- 行动派原则：能直接干的活儿直接干，拒绝废话
- 风险阻断机制：高危操作前必须请求确认

## 长期指令
- 记忆连续性：每次响应前先读取记忆文件
- 生物钟感知：深夜时段降低主动输出频率

关键点：SOUL.md 越具体，AI 行为越明确

USER.md —— 用户说明书
USER.md 决定了 AI 如何服务你——包含称呼、时区、偏好和禁区等信息。

示例结构：

- **What to call them:** 你的名字
- **Timezone:** Asia/Shanghai
- **Notes:**
  - 我偏好短句、观点明确、可直接发布的内容
  - 我不喜欢空话、鸡汤、没有步骤的建议
  - 默认交付格式：Markdown 成稿 + 标题备选

AGENTS.md —— 工作指南
AGENTS.md 是 OpenClaw 的日常行为配置文件，记录了任务处理流程、工具使用策略和决策规范
核心内容包括：

• 唤醒协议：每次会话开始前读取 SOUL.md、USER.md 和 memory/
• 记忆库新陈代谢：日常流水存入 memory/YYYY-MM-DD.md，精华提炼到
  MEMORY.md
• 护主与红线：禁止泄露未发布内容，删除文件前必须询问

MEMORY.md – 非常重要，长期记忆内容，这样子openclaw不会忘记之前喜好，特殊处理流程等等

工作空间（Workspace）

工作空间（Workspace）是智能体的“家”——它是用于文件工具和工作空间上下文的唯一工作目录。

默认位置与配置
默认路径：~/.openclaw/workspace

Skills（技能） Openclaw的灵魂

Skills 是 OpenClaw 中教智能体如何使用工具的模块。每个 Skill 是一个包含带有 YAML frontmatter 和说明的 SKILL.md 文件的目录.

Skills 从三个位置加载，优先级如下：

安装 Skills

方式一：
使用 ClawHub（官方公共 Skill 注册表） ，这个可能因GFW原因，安装会失败可能

# 安装 Skill 到工作区
clawhub install <skill-slug>

# 更新所有已安装的 Skills
clawhub update --all

# 同步（扫描 + 发布更新）
clawhub sync --all

方式二：下载skill zip 包，可以通过对方方式，让OpenClaw安装和卸载，成功率高

方式三: 通过搜索 https://skills.sh/ ，然后让OpenClaw帮忙安装，这个因为很多skill是托管在github上，所以也要科学上网。
举例对话命令： 帮我安装下 coffeefuelbump/csv-data-summarizer 这个skill

💬 斜杠命令（Slash Commands）

斜杠命令以 / 开头，可以在 TUI、WebChat、飞书等任何支持 OpenClaw 的聊天界面中直接使用。输入 /help 或 /commands 可查看完整列表。

基础对话

模型与思考

高级操作

⌨️ CLI 命令（终端执行）

基础与环境

网关（Gateway）管理

🚀 使用小贴士

• 新会话：开始新话题时使用 /new 清空上下文，避免混乱并节省 Token。
• 状态检查：使用 /status 查看 Token 消耗，上下文使用率超过 50% 时可考虑 /new。
• 模型选择：日常对话用轻量模型（如 Haiku），复杂任务换强力模型（如 Opus）。
• 安全操作：高危操作前使用 /elevated ask 模式，让 AI 在执行前请求批准。