基于 OpenClaw 与 httpcat 构建企业级文件管理智能体

用户层 -> OpenClaw 智能层 -> MCP 协议 -> httpcat 仓库层 优点：解耦性好。 缺点：OpenClaw 对原生 MCP 支持尚不完善。

方案二：AK/SK 认证联动

用户层 -> OpenClaw 智能层 -> REST API (AK/SK) -> httpcat 仓库层 推荐方式：通过 HTTP 调用接口，稳定性更高。

方案三：Nginx 反向代理

结构： 浏览器 (HTTPS:443) -> Nginx -> OpenClaw (18789) <-> httpcat (8888) 端口说明：

• 443：对外安全入口
• 18789：OpenClaw 网关
• 8888：httpcat 服务

四、部署步骤

准备工作

• 云服务器（2 核 4G）
• Docker 环境
• AI API Key

1. 部署 httpcat

使用二进制 + systemd 方式安装。 配置 /opt/httpcat/conf/svr.yml：

server:
  http:
    port: 8888
auth:
  enable: false
open_api_enable: true
aksk:
  access_key: your-access-key
  secret_key: your-secret-key
file:
  upload_enable: true
  enable_upload_token: true
app_key: "httpcat"
app_secret: "httpcat_app_secret"

启动服务：

systemctl restart httpcat

放行 8888 端口。

2. 部署 OpenClaw

方式 A：云平台模板

选择镜像，配置 AI 密钥，开放 18789 端口。

方式 B：Docker 部署

创建目录：

mkdir -p ~/openclaw-docker && cd ~/openclaw-docker

配置 .env：

OPENCLAW_IMAGE=openclaw-cn:latest
OPENCLAW_GATEWAY_PORT=18789
OPENCLAW_BRIDGE_PORT=18790

编写 docker-compose.yml：

services:
  openclaw-gateway:
    image: ${OPENCLAW_IMAGE}
    ports:
      - "${OPENCLAW_GATEWAY_PORT}:18789"
      - "${OPENCLAW_BRIDGE_PORT}:18790"
    command: ["node", "dist/index.js", "gateway", "--bind", "lan"]

启动：

docker compose up -d openclaw-gateway

配置 AI Provider 或运行 onboard 命令初始化。

3. HTTPS 配置

使用 Nginx 转发 443 到 18789：

server {
  listen 443 ssl;
  ssl_certificate /etc/nginx/ssl/openclaw.crt;
  ssl_certificate_key /etc/nginx/ssl/openclaw.key;
  location / {
    proxy_pass http://127.0.0.1:18789;
  }
}

4. 集成 httpcat

在 OpenClaw 工作区创建 httpcat-api.sh 脚本，实现签名与请求逻辑。 测试连接：

docker compose exec -T openclaw-gateway bash -c './httpcat-api.sh GET /api/v1/file/listFiles "dir=/"'

五、进阶：企业微信联动

技能配置

创建 SKILL.md 描述 httpcat 使用方法，确保 AI 能正确调用脚本。

回调配置

在企业微信后台配置回调 URL，指向 Nginx 的 443 端口。消息流向： 企业微信 -> 腾讯服务器 -> Nginx -> OpenClaw -> 企业微信

六、总结

通过 OpenClaw 与 httpcat 的组合，实现了从自然语言指令到文件操作的闭环。这种架构降低了文件管理的复杂度，适合企业级自动化场景。