OpenClaw 系列（三）——进阶玩法：Skills 扩展、多模型配置与安全加固#

1.1 内置 Skills 一览#

OpenClaw 3.8 自带 52+ 个内置 Skills，覆盖了日常使用的主要场景：

查看所有可用 Skills：

1
openclaw skills list

1.2 安装社区 Skills#

除内置技能外，OpenClaw 社区还提供了大量扩展 Skills。安装一个社区 Skill 只需：

1
# 从官方注册表安装
2
openclaw skills install <skill-name>
3

4
# 例：安装飞书集成 Skill
5
openclaw skills install feishu
6

7
# 安装后查看已安装列表
8
openclaw skills list --installed

目前热门的社区 Skills 包括：

• feishu / dingtalk：飞书、钉钉消息收发与 Webhook 集成
• notion：Notion 数据库读写与页面管理
• browser：无头浏览器操作，可填写表单、截图、爬取动态页面
• docker：容器管理操作
• database：SQLite、PostgreSQL、MySQL 查询

1.3 自定义 Skill：15 分钟上手#

Skills 的核心是一个 SKILL.md 文件，格式非常简洁：

1
---
2
name: my-custom-skill
3
description: "我的自定义技能，用于处理某类特定任务"
4
metadata:
5
  openclaw:
6
    emoji: "🔧"
7
    requires:
8
      bins: ["python3"]    # 依赖的系统命令
9
    install:
10
      - label: "说明文字"
11
---
12

13
# My Custom Skill
14

15
这里写给 Agent 看的操作指南，用自然语言描述：
16
- 当用户需要做什么时，应该怎么操作
17
- 有哪些注意事项
18
- 推荐的工作流程

把这个文件放入 ~/.openclaw/skills/my-custom-skill/SKILL.md，重启 Gateway，Agent 就能自动识别并在合适的任务中调用这个 Skill。

2.1 配置主模型与备用模型#

1
{
2
  "model": {
3
    "primary": {
4
      "provider": "anthropic",
5
      "apiKey": "sk-ant-xxxxxxx",
6
      "model": "claude-sonnet-4-5"
7
    },
8
    "fallback": {
9
      "provider": "openai",
10
      "apiKey": "sk-xxxxxxx",
11
      "baseURL": "https://api.deepseek.com/v1",
12
      "model": "deepseek-chat"
13
    }
14
  }
15
}

当主模型调用失败（如 API 限流、服务异常）时，OpenClaw 会自动切换到备用模型，保证 Agent 的可用性。

2.2 按任务类型路由模型#

OpenClaw 3.x 引入了模型路由机制，可以根据任务复杂度自动选择模型：

1
{
2
  "model": {
3
    "routing": {
4
      "simple": {
5
        "provider": "openai",
6
        "baseURL": "https://api.deepseek.com/v1",
7
        "model": "deepseek-chat"
8
      },
9
      "complex": {
10
        "provider": "anthropic",
11
        "model": "claude-sonnet-4-5"
12
      }
13
    },
14
    "complexityThreshold": 0.7
15
  }
16
}

complexityThreshold 控制切换阈值，数值越低越容易升级到强模型。你可以根据自己的使用场景和预算做调整。

2.3 结合本地模型降低成本#

对于高频但低复杂度的任务（如文件整理、信息格式化、日常问答），可以优先路由到本地 Ollama 模型：

1
{
2
  "model": {
3
    "routing": {
4
      "simple": {
5
        "provider": "ollama",
6
        "baseURL": "http://localhost:11434",
7
        "model": "qwen2.5:7b"
8
      },
9
      "complex": {
10
        "provider": "anthropic",
11
        "model": "claude-sonnet-4-5"
12
      }
13
    }
14
  }
15
}

这种”本地 + 云端混合”的方式，在实践中可以将 Token 费用降低 60%~80%，同时对复杂任务保持高质量输出。

3.1 软裁剪与硬清除#

OpenClaw 采用两阶段的上下文保护策略：

• 软裁剪（Soft Trim）：当上下文达到模型限制的 30% 时，保留最近的对话内容，压缩较早的历史记录
• 硬清除（Hard Reset）：当上下文达到 50% 时，自动生成历史摘要，用摘要替换原始对话，释放空间

这意味着 OpenClaw 在执行非常长的任务时，会自动”总结压缩”历史，避免失控。但这也意味着：对于超长任务，早期的细节可能会被压缩丢失。

3.2 实践建议#

对于需要保留全程细节的重要任务，建议在指令中明确要求：

1
【重要】请在每完成一个子任务时，输出一段结构化的进度摘要，包含：已完成步骤、当前状态、下一步计划。

这样即使上下文被压缩，关键的结构化信息也会保留在摘要中，不会丢失。

3.3 利用长期记忆#

OpenClaw 有一套基于向量检索的长期记忆系统，会自动保存重要对话和用户偏好。你也可以主动让 Agent 记住某些信息：

1
记住：我习惯把所有下载文件整理到 ~/Documents/Downloads-Sorted/ 目录，并按年月分类。

下次执行相关任务时，Agent 会自动从记忆中检索这条偏好，无需重复说明。

4.1 严格的访问控制白名单#

这是最基础也最重要的一步。在配置文件中，一定要填写 allowFrom 白名单，只允许你自己的账号下达指令：

1
{
2
  "channels": {
3
    "telegram": {
4
      "botToken": "你的Token",
5
      "allowFrom": ["你的数字用户ID"]
6
    },
7
    "whatsapp": {
8
      "allowFrom": ["+861xxxxxxxxxx"]
9
    }
10
  }
11
}

没有白名单的情况下，任何知道你 Bot 地址的人都可以向你的 Agent 下达指令——这是极其危险的。

4.2 关闭不必要的公网暴露#

默认情况下，OpenClaw Gateway 只监听本地回环地址（127.0.0.1），这是安全的。不要为了远程访问方便，将其直接绑定到 0.0.0.0 或公网 IP。

正确的远程访问方式是使用 Tailscale（一种零配置 VPN）建立私有网络通道：

1
# 安装 Tailscale 后，通过私有 IP 访问
2
openclaw gateway --port 18789 --host 100.x.x.x  # Tailscale 分配的私有 IP

这样就算你在外面，也可以安全地访问家里的 OpenClaw，而不需要暴露公网端口。

4.3 限制 Agent 的文件系统访问范围#

可以在配置中设置工作目录白名单，防止 Agent 误操作不该碰的系统文件：

1
{
2
  "agent": {
3
    "workspace": "~/OpenClaw-Workspace",
4
    "allowedPaths": [
5
      "~/Documents",
6
      "~/Desktop",
7
      "~/OpenClaw-Workspace"
8
    ],
9
    "blockedPaths": [
10
      "~/.ssh",
11
      "~/.aws",
12
      "/etc",
13
      "/System"
14
    ]
15
  }
16
}

blockedPaths 中的目录，Agent 无法读写，有效防止敏感凭证泄露。

4.4 启用 ACP 身份溯源（3.8 新特性）#

OpenClaw 3.8 新增了 ACP（Agent Communication Protocol）身份溯源机制，对于多 Agent 协作场景尤为重要。它为每个 Agent 会话附加可验证的签名来源和 Trace ID，形成完整的可审计链路：

1
{
2
  "acp": {
3
    "provenance": "meta+receipt"
4
  }
5
}

• off：默认关闭，不影响现有行为
• meta：每个会话携带来源元数据和 Trace ID
• meta+receipt：额外注入可见回执，在对话中形成完整审计记录

如果你的 OpenClaw 被用于自动化工作流或多 Agent 场景，建议至少开启 meta 级别。

4.5 定期检查日志与异常行为#

OpenClaw 会记录所有工具调用日志，存放在 ~/.openclaw/logs/ 目录。养成定期检查的习惯：

1
# 查看最近的操作日志
2
tail -f ~/.openclaw/logs/gateway.log
3

4
# 查看工具调用记录
5
cat ~/.openclaw/logs/tool-calls.jsonl | tail -50

如果发现异常的命令执行记录（特别是你不记得下达过的指令），立即排查来源。