OpenClaw 2026.3.31 本地部署与飞书接入完全指南

目录

一、OpenClaw 介绍

1.1 什么是 OpenClaw

OpenClaw 是一款开源的个人 AI Agent 系统，可以运行在你的个人电脑或服务器上。相比以往的 AI Agent，OpenClaw 最大的不同在于：

  • 完全属于你：私人助理，拥有长期记忆
  • 能力持续进化：通过 Skill 不断扩展能力
  • 更高权限：能直接操作你电脑
  • 本地运行：数据安全，隐私可控
  • 7×24 小时待命：主动干活，不用等你

1.2 核心特性

特性 说明
多模型支持 支持 Kimi、ChatGPT、Claude 等多种大模型
Skill 系统 丰富的技能生态，可扩展能力
多平台接入 支持飞书、Telegram、Discord 等
本地执行 可以在你的电脑上执行各种任务
长期记忆 记住你的对话和偏好

二、环境准备

2.1 系统要求

  • 操作系统：Windows 10/11、macOS、Linux
  • Node.js：v18 或更高版本
  • npm：v9 或更高版本
  • 内存：建议 4GB 以上
  • 磁盘空间：至少 1GB 可用空间

2.2 安装 Node.js 和 npm

Windows 系统
  1. 访问 Node.js 官网
  2. 下载 LTS 版本（长期支持版）
  3. 双击安装包，按提示安装
  4. 重启终端，验证安装：
node --version
npm --version

2.3 准备 API Key

本文使用 Kimi 月之暗面 作为示例：

  1. 访问 Kimi 开放平台
  2. 注册账号并登录
  3. 创建 API Key
  4. 保存好你的 API Key（格式：sk-xxxxx）

三、安装指南

3.1 选择正确的版本

重要提示：

  • OpenClaw 最新版本（2026.4.x）不兼容飞书插件
  • 飞书插件最高兼容 2026.3.31 版本

3.2 安装 OpenClaw 2026.3.31

# 全局安装指定版本
npm install -g openclaw@2026.3.31

3.3 验证安装

# 检查版本
npx openclaw --version

# 应该输出：OpenClaw 2026.3.31

四、快速开始

4.1 初始化配置

方法一：使用向导（推荐）
npx openclaw configure

按照提示操作即可。

方法二：手动创建配置文件

创建配置文件目录：

# 创建 .openclaw 目录
New-Item -Path "$env:USERPROFILE\.openclaw" -ItemType Directory -Force

4.2 首次启动

# 启动 OpenClaw 网关（前台运行）
npx openclaw gateway

看到类似输出表示启动成功：

🦞 OpenClaw 2026.3.31
02:13:31+08:00 [gateway] listening on ws://127.0.0.1:18789

4.3 打开 Web UI

# 打开 Control UI
npx openclaw dashboard

浏览器会自动打开，你应该能看到 OpenClaw 的界面。

五、Workspace 空间配置

5.1 Workspace 是什么

Workspace 是 OpenClaw 用来存储文件和数据的工作目录。

5.2 默认 Workspace 位置

系统 默认位置
Windows C:\Users\你的用户名\.openclaw\workspace
macOS ~/.openclaw/workspace
Linux ~/.openclaw/workspace

5.3 自定义 Workspace

修改 openclaw.json 配置：

{
  "agents": {
    "defaults": {
      "workspace": "D:\\你的自定义路径\\openclaw-workspace"
    }
  }
}

5.4 Workspace 目录结构

workspace/
├── sessions/      # 对话会话记录
├── memory/        # 记忆文件
├── files/         # 上传的文件
└── temp/          # 临时文件

六、openclaw.json 配置详解

6.1 配置文件位置

配置文件位于：

C:\Users\你的用户名\.openclaw\openclaw.json

6.2 完整配置示例（Kimi + 飞书）

{
  "meta": {
    "lastTouchedVersion": "2026.3.31"
  },
  "auth": {
    "profiles": {
      "moonshot:default": {
        "provider": "moonshot",
        "mode": "api_key"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "moonshot": {
        "baseUrl": "https://api.moonshot.cn/v1",
        "api": "openai-completions",
        "models": [
          {
            "id": "kimi-k2.5",
            "name": "Kimi K2.5",
            "reasoning": false,
            "input": ["text", "image"],
            "contextWindow": 262144,
            "maxTokens": 262144
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "moonshot/kimi-k2.5"
      },
      "workspace": "C:\\Users\\你的用户名\\.openclaw\\workspace"
    }
  },
  "tools": {
    "profile": "full",
    "exec": {
      "ask": "off"
    },
    "web": {
      "search": {
        "enabled": true,
        "provider": "kimi"
      }
    }
  },
  "channels": {
    "feishu": {
      "appId": "你的飞书AppID",
      "appSecret": "你的飞书AppSecret",
      "enabled": true,
      "streaming": true,
      "footer": {
        "elapsed": true,
        "status": true
      },
      "dmPolicy": "open",
      "groupPolicy": "open",
      "allowFrom": ["*"]
    }
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "controlUi": {
      "allowInsecureAuth": true
    }
  },
  "plugins": {
    "entries": {
      "feishu": {
        "enabled": true
      }
    },
    "allow": ["feishu"]
  }
}

6.3 配置项详解

6.3.1 模型配置
配置项 说明 示例值
baseUrl API 地址 https://api.moonshot.cn/v1
contextWindow 上下文窗口 262144（26万 tokens）
maxTokens 最大输出 262144
6.3.2 飞书配置
配置项 说明 可选值
enabled 是否启用 true / false
streaming 流式回复 true / false
dmPolicy 私聊策略 open / closed / requireMention
groupPolicy 群聊策略 open / closed / requireMention

七、接入飞书机器人

参考：
https://zhuanlan.zhihu.com/p/2014639892630622934
这是openclaw接入飞书的详细教程

但是在下载飞书插件时要参考：
https://www.feishu.cn/content/article/7613711414611463386
这是飞书官方的openclaw接入插件！！！

八、常见问题与解决方案

8.1 安装问题

问题 1：npm 安装失败

错误信息：

npm ERR! network timeout

解决方案：

# 切换到淘宝镜像
npm config set registry https://registry.npmmirror.com

# 重新安装
npm install -g openclaw@2026.3.31
问题 2：Amazon Bedrock 插件加载失败

错误信息：

Error: Cannot find module '@aws-sdk/client-bedrock'

解决方案：
这个插件不是必需的，修改配置文件只允许飞书插件：

{
  "plugins": {
    "allow": ["feishu"]
  }
}

8.2 启动问题

问题 3：端口被占用

错误信息：

Error: listen EADDRINUSE: address already in use :::18789

解决方案：

# 停止已有的网关
npx openclaw gateway stop

# 或者强制启动（会杀掉占用端口的进程）
npx openclaw gateway --force
问题 4：Web UI 无法访问（Internal Server Error）

错误信息：

500 Internal Server Error

解决方案：
不要直接访问 http://127.0.0.1:18789/，使用以下命令：

# 使用 dashboard 命令打开
npx openclaw dashboard

这会打开带 token 的完整 URL。

8.3 飞书问题

问题 5：机器人不回复消息

可能原因：

  1. 权限配置不正确
  2. 机器人未加入群组
  3. 事件订阅未启用

解决方案：

  1. 检查飞书开放平台的权限配置
  2. 确认机器人已加入群组
  3. 检查事件订阅是否启用长连接模式
  4. 查看 OpenClaw 日志：npx openclaw logs --follow
问题 6：机器人回复没有流式效果

解决方案：
确认配置文件中开启了流式回复：

{
  "channels": {
    "feishu": {
      "streaming": true
    }
  }
}
问题 7：机器人回复没有耗时和状态信息

解决方案：
开启 footer 配置：

{
  "channels": {
    "feishu": {
      "footer": {
        "elapsed": true,
        "status": true
      }
    }
  }
}

九、常用命令汇总

9.1 网关管理

命令 说明
npx openclaw gateway 前台启动网关
npx openclaw gateway start 后台启动网关服务
npx openclaw gateway stop 停止网关服务
npx openclaw gateway restart 重启网关服务
npx openclaw gateway status 查看网关状态

9.2 配置管理

命令 说明
npx openclaw configure 交互式配置向导
npx openclaw config get <path> 查看配置项
npx openclaw config set <path> <value> 设置配置项

9.3 状态和日志

命令 说明
npx openclaw status 查看服务状态
npx openclaw dashboard 打开 Web UI
npx openclaw logs 查看日志
npx openclaw logs --follow 实时跟踪日志

9.4 插件管理

命令 说明
npx openclaw plugins list 列出已安装插件
npx openclaw plugins install <plugin> 安装插件
npx openclaw plugins uninstall <plugin> 卸载插件

9.5 通道管理

命令 说明
npx openclaw channels list 列出已配置通道
npx openclaw channels add <channel> 添加通道
npx openclaw channels remove <channel> 移除通道

十、CSDN 自动发表（Skill 开发指南）

10.1 简介

OpenClaw 没有内置的 CSDN 发布 Skill，但你可以自己开发！下面是完整的开发指南。

10.2 准备工作

10.2.1 获取 CSDN Cookie
  1. 在浏览器中登录 CSDN
  2. 按 F12 打开开发者工具
  3. 切换到 Network（网络）标签
  4. 刷新页面，找到任意请求
  5. 在请求头中找到 Cookie，复制完整内容
10.2.2 了解 CSDN 发布 API

CSDN 的发布接口（逆向工程）：

POST https://blog.csdn.net/phoenix/web/blog/article

10.3 创建自定义 Skill

10.3.1 Skill 目录结构

在 OpenClaw 配置目录下创建 Skill：

C:\Users\你的用户名\.openclaw\skills\
└── csdn-publish\
    ├── package.json
    ├── index.js
    └── skill.json
10.3.2 创建 package.json
{
  "name": "csdn-publish",
  "version": "1.0.0",
  "description": "CSDN 自动发布 Skill",
  "main": "index.js",
  "dependencies": {
    "axios": "^1.6.0"
  }
}
10.3.3 创建 skill.json
{
  "id": "csdn-publish",
  "name": "CSDN 自动发布",
  "description": "自动发布文章到 CSDN",
  "version": "1.0.0",
  "author": "你的名字",
  "skills": [
    {
      "id": "publish-to-csdn",
      "name": "发布到 CSDN",
      "description": "将文章发布到 CSDN 博客",
      "parameters": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "description": "文章标题"
          },
          "content": {
            "type": "string",
            "description": "文章内容（Markdown 格式）"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "文章标签"
          },
          "category": {
            "type": "string",
            "description": "文章分类"
          }
        },
        "required": ["title", "content"]
      }
    }
  ]
}
10.3.4 创建 index.js
const axios = require('axios');

class CSDNPublisher {
  constructor() {
    this.cookie = process.env.CSDN_COOKIE;
  }

  async publishArticle(params) {
    const { title, content, tags = [], category = '技术' } = params;

    try {
      const response = await axios({
        method: 'POST',
        url: 'https://blog.csdn.net/phoenix/web/blog/article',
        headers: {
          'Cookie': this.cookie,
          'Content-Type': 'application/json',
          'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36'
        },
        data: {
          title: title,
          markdowncontent: content,
          content: this.markdownToHtml(content),
          tags: tags.join(','),
          categories: category,
          type: 'original',
          readType: 'public',
          level: '1'
        }
      });

      if (response.data.code === 200) {
        return {
          success: true,
          url: `https://blog.csdn.net/你的用户名/article/details/${response.data.data.id}`,
          message: '发布成功！'
        };
      } else {
        return {
          success: false,
          message: response.data.message || '发布失败'
        };
      }
    } catch (error) {
      return {
        success: false,
        message: `发布失败：${error.message}`
      };
    }
  }

  markdownToHtml(markdown) {
    return markdown
      .replace(/^### (.*$)/gim, '<h3>$1</h3>')
      .replace(/^## (.*$)/gim, '<h2>$1</h2>')
      .replace(/^# (.*$)/gim, '<h1>$1</h1>')
      .replace(/\*\*(.*)\*\*/gim, '<strong>$1</strong>')
      .replace(/\*(.*)\*/gim, '<em>$1</em>')
      .replace(/\n/gim, '<br>');
  }
}

module.exports = {
  'publish-to-csdn': async (params) => {
    const publisher = new CSDNPublisher();
    return await publisher.publishArticle(params);
  }
};

10.4 安装和配置 Skill

10.4.1 安装依赖
# 进入 Skill 目录
cd "$env:USERPROFILE\.openclaw\skills\csdn-publish"

# 安装依赖
npm install
10.4.2 配置环境变量

设置 CSDN Cookie：

# Windows PowerShell
$env:CSDN_COOKIE = "你的完整Cookie"

# 或者在系统环境变量中设置
10.4.3 在 OpenClaw 中启用 Skill

修改 openclaw.json：

{
  "tools": {
    "alsoAllow": ["csdn-publish"]
  }
}

10.5 使用 Skill

在飞书中对 OpenClaw 说：

帮我发布一篇文章到 CSDN：
标题：OpenClaw 部署完全指南
内容：（你的文章内容，Markdown 格式）
标签：OpenClaw, AI, 飞书
分类：技术

或者直接使用：

使用 csdn-publish skill 发布文章
标题：我的文章
内容：...

10.6 注意事项

重要提醒：

  1. Cookie 有效期：CSDN Cookie 会过期，需要定期更新
  2. 频率限制：不要频繁发布，避免被封号
  3. 内容质量：确保文章内容符合 CSDN 规范
  4. 法律风险：仅供学习使用，请勿滥用

10.7 替代方案

如果不想自己开发 Skill，也可以：

  1. 让 OpenClaw 帮你写好文章
  2. 手动复制到 CSDN 发布
  3. 使用浏览器自动化工具（如 Selenium）

参考资料

总结

恭喜你！现在你已经：

  • 了解了 OpenClaw 是什么
  • 成功安装了 OpenClaw 2026.3.31
  • 配置了 Kimi 月之暗面 API
  • 接入了飞书机器人
  • 知道了如何开发自定义 Skill
  • 了解了常见问题的解决方案

祝你使用愉快！有问题随时问我！

作者：我迪加在东北
最后更新：2026-04-14
版本：v1.0

OpenClaw 2026.3.31 本地部署与飞书接入完全指南

目录

一、OpenClaw 介绍

1.1 什么是 OpenClaw

OpenClaw 是一款开源的个人 AI Agent 系统，可以运行在你的个人电脑或服务器上。相比以往的 AI Agent，OpenClaw 最大的不同在于：

  • 完全属于你：私人助理，拥有长期记忆
  • 能力持续进化：通过 Skill 不断扩展能力
  • 更高权限：能直接操作你电脑
  • 本地运行：数据安全，隐私可控
  • 7×24 小时待命：主动干活，不用等你

1.2 核心特性

特性 说明
多模型支持 支持 Kimi、ChatGPT、Claude 等多种大模型
Skill 系统 丰富的技能生态，可扩展能力
多平台接入 支持飞书、Telegram、Discord 等
本地执行 可以在你的电脑上执行各种任务
长期记忆 记住你的对话和偏好

二、环境准备

2.1 系统要求

  • 操作系统：Windows 10/11、macOS、Linux
  • Node.js：v18 或更高版本
  • npm：v9 或更高版本
  • 内存：建议 4GB 以上
  • 磁盘空间：至少 1GB 可用空间

2.2 安装 Node.js 和 npm

Windows 系统
  1. 访问 Node.js 官网
  2. 下载 LTS 版本（长期支持版）
  3. 双击安装包，按提示安装
  4. 重启终端，验证安装：
node --version
npm --version

2.3 准备 API Key

本文使用 Kimi 月之暗面 作为示例：

  1. 访问 Kimi 开放平台
  2. 注册账号并登录
  3. 创建 API Key
  4. 保存好你的 API Key（格式：sk-xxxxx）

三、安装指南

3.1 选择正确的版本

重要提示：

  • OpenClaw 最新版本（2026.4.x）不兼容飞书插件
  • 飞书插件最高兼容 2026.3.31 版本

3.2 安装 OpenClaw 2026.3.31

# 全局安装指定版本
npm install -g openclaw@2026.3.31

3.3 验证安装

# 检查版本
npx openclaw --version

# 应该输出：OpenClaw 2026.3.31

四、快速开始

4.1 初始化配置

方法一：使用向导（推荐）
npx openclaw configure

按照提示操作即可。

方法二：手动创建配置文件

创建配置文件目录：

# 创建 .openclaw 目录
New-Item -Path "$env:USERPROFILE\.openclaw" -ItemType Directory -Force

4.2 首次启动

# 启动 OpenClaw 网关（前台运行）
npx openclaw gateway

看到类似输出表示启动成功：

🦞 OpenClaw 2026.3.31
02:13:31+08:00 [gateway] listening on ws://127.0.0.1:18789

4.3 打开 Web UI

# 打开 Control UI
npx openclaw dashboard

浏览器会自动打开，你应该能看到 OpenClaw 的界面。

五、Workspace 空间配置

5.1 Workspace 是什么

Workspace 是 OpenClaw 用来存储文件和数据的工作目录。

5.2 默认 Workspace 位置

系统 默认位置
Windows C:\Users\你的用户名\.openclaw\workspace
macOS ~/.openclaw/workspace
Linux ~/.openclaw/workspace

5.3 自定义 Workspace

修改 openclaw.json 配置：

{
  "agents": {
    "defaults": {
      "workspace": "D:\\你的自定义路径\\openclaw-workspace"
    }
  }
}

5.4 Workspace 目录结构

workspace/
├── sessions/      # 对话会话记录
├── memory/        # 记忆文件
├── files/         # 上传的文件
└── temp/          # 临时文件

六、openclaw.json 配置详解

6.1 配置文件位置

配置文件位于：

C:\Users\你的用户名\.openclaw\openclaw.json

6.2 完整配置示例（Kimi + 飞书）

{
  "meta": {
    "lastTouchedVersion": "2026.3.31"
  },
  "auth": {
    "profiles": {
      "moonshot:default": {
        "provider": "moonshot",
        "mode": "api_key"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "moonshot": {
        "baseUrl": "https://api.moonshot.cn/v1",
        "api": "openai-completions",
        "models": [
          {
            "id": "kimi-k2.5",
            "name": "Kimi K2.5",
            "reasoning": false,
            "input": ["text", "image"],
            "contextWindow": 262144,
            "maxTokens": 262144
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "moonshot/kimi-k2.5"
      },
      "workspace": "C:\\Users\\你的用户名\\.openclaw\\workspace"
    }
  },
  "tools": {
    "profile": "full",
    "exec": {
      "ask": "off"
    },
    "web": {
      "search": {
        "enabled": true,
        "provider": "kimi"
      }
    }
  },
  "channels": {
    "feishu": {
      "appId": "你的飞书AppID",
      "appSecret": "你的飞书AppSecret",
      "enabled": true,
      "streaming": true,
      "footer": {
        "elapsed": true,
        "status": true
      },
      "dmPolicy": "open",
      "groupPolicy": "open",
      "allowFrom": ["*"]
    }
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "controlUi": {
      "allowInsecureAuth": true
    }
  },
  "plugins": {
    "entries": {
      "feishu": {
        "enabled": true
      }
    },
    "allow": ["feishu"]
  }
}

6.3 配置项详解

6.3.1 模型配置
配置项 说明 示例值
baseUrl API 地址 https://api.moonshot.cn/v1
contextWindow 上下文窗口 262144（26万 tokens）
maxTokens 最大输出 262144
6.3.2 飞书配置
配置项 说明 可选值
enabled 是否启用 true / false
streaming 流式回复 true / false
dmPolicy 私聊策略 open / closed / requireMention
groupPolicy 群聊策略 open / closed / requireMention

七、接入飞书机器人

7.1 创建飞书机器人

步骤 1：进入飞书开放平台
  1. 访问 飞书开放平台
  2. 使用飞书账号登录
  3. 点击右上角「创建应用」
步骤 2：填写应用信息
  • 应用名称：OpenClaw（或你喜欢的名字）
  • 应用描述：OpenClaw AI 助手
  • 应用图标：可以上传小龙虾图标
步骤 3：获取 App ID 和 App Secret
  1. 在应用主页，找到「凭证与基础信息」
  2. 复制 App ID（格式：cli_xxxxx）
  3. 复制 App Secret（点击「查看」获取）

7.2 配置应用权限

在「权限管理」中，添加以下权限：

权限名称 权限描述 必须
im:message 发送消息 是
im:message.group_at_messages 接收群消息 是
im:message.p2p_msg 接收私聊消息 是
contact:user.base 获取用户基本信息 是

7.3 配置事件订阅

  1. 进入「事件与回调」
  2. 选择「使用长连接接收事件/回调」
  3. 启用以下事件：
    • im.message.receive_v1（消息接收）
    • im.message.message_read_v1（消息已读）

7.4 安装飞书插件

# 安装飞书官方插件
npx openclaw plugins install @openclaw/feishu

7.5 配置飞书机器人

方法一：使用命令配置
# 添加飞书通道
npx openclaw channels add feishu

按照提示输入：

  • App ID
  • App Secret
方法二：手动编辑配置文件

打开 openclaw.json，添加或修改飞书配置：

{
  "channels": {
    "feishu": {
      "appId": "cli_你的AppID",
      "appSecret": "你的AppSecret",
      "enabled": true,
      "streaming": true,
      "footer": {
        "elapsed": true,
        "status": true
      },
      "dmPolicy": "open",
      "groupPolicy": "open",
      "allowFrom": ["*"]
    }
  }
}

7.6 发布应用并添加到群组

步骤 1：发布应用
  1. 在飞书开放平台，点击「版本管理与发布」
  2. 点击「创建版本」
  3. 填写版本信息，提交审核
  4. 等待审核通过（通常很快）
步骤 2：添加到群组
  1. 打开飞书，进入你的群组
  2. 点击群组设置 → 添加机器人
  3. 搜索并添加你的 OpenClaw 机器人

7.7 测试机器人

  1. 在飞书群组中 @机器人
  2. 或者直接私聊机器人
  3. 发送消息：你好
  4. 机器人应该会回复你！

八、常见问题与解决方案

8.1 安装问题

问题 1：npm 安装失败

错误信息：

npm ERR! network timeout

解决方案：

# 切换到淘宝镜像
npm config set registry https://registry.npmmirror.com

# 重新安装
npm install -g openclaw@2026.3.31
问题 2：Amazon Bedrock 插件加载失败

错误信息：

Error: Cannot find module '@aws-sdk/client-bedrock'

解决方案：
这个插件不是必需的，修改配置文件只允许飞书插件：

{
  "plugins": {
    "allow": ["feishu"]
  }
}

8.2 启动问题

问题 3：端口被占用

错误信息：

Error: listen EADDRINUSE: address already in use :::18789

解决方案：

# 停止已有的网关
npx openclaw gateway stop

# 或者强制启动（会杀掉占用端口的进程）
npx openclaw gateway --force
问题 4：Web UI 无法访问（Internal Server Error）

错误信息：

500 Internal Server Error

解决方案：
不要直接访问 http://127.0.0.1:18789/，使用以下命令：

# 使用 dashboard 命令打开
npx openclaw dashboard

这会打开带 token 的完整 URL。

8.3 飞书问题

问题 5：机器人不回复消息

可能原因：

  1. 权限配置不正确
  2. 机器人未加入群组
  3. 事件订阅未启用

解决方案：

  1. 检查飞书开放平台的权限配置
  2. 确认机器人已加入群组
  3. 检查事件订阅是否启用长连接模式
  4. 查看 OpenClaw 日志：npx openclaw logs --follow
问题 6：机器人回复没有流式效果

解决方案：
确认配置文件中开启了流式回复：

{
  "channels": {
    "feishu": {
      "streaming": true
    }
  }
}
问题 7：机器人回复没有耗时和状态信息

解决方案：
开启 footer 配置：

{
  "channels": {
    "feishu": {
      "footer": {
        "elapsed": true,
        "status": true
      }
    }
  }
}

九、常用命令汇总

9.1 网关管理

命令 说明
npx openclaw gateway 前台启动网关
npx openclaw gateway start 后台启动网关服务
npx openclaw gateway stop 停止网关服务
npx openclaw gateway restart 重启网关服务
npx openclaw gateway status 查看网关状态

9.2 配置管理

命令 说明
npx openclaw configure 交互式配置向导
npx openclaw config get <path> 查看配置项
npx openclaw config set <path> <value> 设置配置项

9.3 状态和日志

命令 说明
npx openclaw status 查看服务状态
npx openclaw dashboard 打开 Web UI
npx openclaw logs 查看日志
npx openclaw logs --follow 实时跟踪日志

9.4 插件管理

命令 说明
npx openclaw plugins list 列出已安装插件
npx openclaw plugins install <plugin> 安装插件
npx openclaw plugins uninstall <plugin> 卸载插件

9.5 通道管理

命令 说明
npx openclaw channels list 列出已配置通道
npx openclaw channels add <channel> 添加通道
npx openclaw channels remove <channel> 移除通道

十、CSDN 自动发表（Skill 开发指南）

10.1 简介

OpenClaw 没有内置的 CSDN 发布 Skill，但你可以自己开发！下面是完整的开发指南。

10.2 准备工作

10.2.1 获取 CSDN Cookie
  1. 在浏览器中登录 CSDN
  2. 按 F12 打开开发者工具
  3. 切换到 Network（网络）标签
  4. 刷新页面，找到任意请求
  5. 在请求头中找到 Cookie，复制完整内容
10.2.2 了解 CSDN 发布 API

CSDN 的发布接口（逆向工程）：

POST https://blog.csdn.net/phoenix/web/blog/article

10.3 创建自定义 Skill

10.3.1 Skill 目录结构

在 OpenClaw 配置目录下创建 Skill：

C:\Users\你的用户名\.openclaw\skills\
└── csdn-publish\
    ├── package.json
    ├── index.js
    └── skill.json
10.3.2 创建 package.json
{
  "name": "csdn-publish",
  "version": "1.0.0",
  "description": "CSDN 自动发布 Skill",
  "main": "index.js",
  "dependencies": {
    "axios": "^1.6.0"
  }
}
10.3.3 创建 skill.json
{
  "id": "csdn-publish",
  "name": "CSDN 自动发布",
  "description": "自动发布文章到 CSDN",
  "version": "1.0.0",
  "author": "你的名字",
  "skills": [
    {
      "id": "publish-to-csdn",
      "name": "发布到 CSDN",
      "description": "将文章发布到 CSDN 博客",
      "parameters": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "description": "文章标题"
          },
          "content": {
            "type": "string",
            "description": "文章内容（Markdown 格式）"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "文章标签"
          },
          "category": {
            "type": "string",
            "description": "文章分类"
          }
        },
        "required": ["title", "content"]
      }
    }
  ]
}
10.3.4 创建 index.js
const axios = require('axios');

class CSDNPublisher {
  constructor() {
    this.cookie = process.env.CSDN_COOKIE;
  }

  async publishArticle(params) {
    const { title, content, tags = [], category = '技术' } = params;

    try {
      const response = await axios({
        method: 'POST',
        url: 'https://blog.csdn.net/phoenix/web/blog/article',
        headers: {
          'Cookie': this.cookie,
          'Content-Type': 'application/json',
          'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36'
        },
        data: {
          title: title,
          markdowncontent: content,
          content: this.markdownToHtml(content),
          tags: tags.join(','),
          categories: category,
          type: 'original',
          readType: 'public',
          level: '1'
        }
      });

      if (response.data.code === 200) {
        return {
          success: true,
          url: `https://blog.csdn.net/你的用户名/article/details/${response.data.data.id}`,
          message: '发布成功！'
        };
      } else {
        return {
          success: false,
          message: response.data.message || '发布失败'
        };
      }
    } catch (error) {
      return {
        success: false,
        message: `发布失败：${error.message}`
      };
    }
  }

  markdownToHtml(markdown) {
    return markdown
      .replace(/^### (.*$)/gim, '<h3>$1</h3>')
      .replace(/^## (.*$)/gim, '<h2>$1</h2>')
      .replace(/^# (.*$)/gim, '<h1>$1</h1>')
      .replace(/\*\*(.*)\*\*/gim, '<strong>$1</strong>')
      .replace(/\*(.*)\*/gim, '<em>$1</em>')
      .replace(/\n/gim, '<br>');
  }
}

module.exports = {
  'publish-to-csdn': async (params) => {
    const publisher = new CSDNPublisher();
    return await publisher.publishArticle(params);
  }
};

10.4 安装和配置 Skill

10.4.1 安装依赖
# 进入 Skill 目录
cd "$env:USERPROFILE\.openclaw\skills\csdn-publish"

# 安装依赖
npm install
10.4.2 配置环境变量

设置 CSDN Cookie：

# Windows PowerShell
$env:CSDN_COOKIE = "你的完整Cookie"

# 或者在系统环境变量中设置
10.4.3 在 OpenClaw 中启用 Skill

修改 openclaw.json：

{
  "tools": {
    "alsoAllow": ["csdn-publish"]
  }
}

10.5 使用 Skill

在飞书中对 OpenClaw 说：

帮我发布一篇文章到 CSDN：
标题：OpenClaw 部署完全指南
内容：（你的文章内容，Markdown 格式）
标签：OpenClaw, AI, 飞书
分类：技术

或者直接使用：

使用 csdn-publish skill 发布文章
标题：我的文章
内容：...

10.6 注意事项

重要提醒：

  1. Cookie 有效期：CSDN Cookie 会过期，需要定期更新
  2. 频率限制：不要频繁发布，避免被封号
  3. 内容质量：确保文章内容符合 CSDN 规范
  4. 法律风险：仅供学习使用，请勿滥用

10.7 替代方案

如果不想自己开发 Skill，也可以：

  1. 让 OpenClaw 帮你写好文章
  2. 手动复制到 CSDN 发布
  3. 使用浏览器自动化工具（如 Selenium）

参考资料

总结

恭喜你！现在你已经：

  • 了解了 OpenClaw 是什么
  • 成功安装了 OpenClaw 2026.3.31
  • 配置了 Kimi 月之暗面 API
  • 接入了飞书机器人
  • 知道了如何开发自定义 Skill
  • 了解了常见问题的解决方案

祝你使用愉快！有问题随时问我！

作者：你的名字
最后更新：2026-04-14
版本：v1.0

# python # java # opencv # 人工智能 # gitlab
Logo
AtomGit开源社区

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。

更多推荐

cover

Python基础 - 初识字典dict 键值对映射的无序集合

avatar AtomGit开源社区

从零开发一个基于Esp32智能手表的项目总结

这个项目是我从传统 STM32 面向过程开发走向面向对象架构的一次试水。尽管通过这次复盘，我理清了“输入 -> 有限状态机（FSM） -> UI 驱动”的交互闭环，也规范了模块化分层的逻辑，但它暴露出的眼光局限和技术断层同样明显。承认不完美是走向深度的开始，后续的重点将放在脱离框架的底层底座构建、功耗精细化控制以及更通用的平台级解耦设计上，继续向业内成熟的开源架构看齐。

avatar AtomGit开源社区
cover

WinForm嵌入第三方窗体：99%的开发者都输给了这个API陷阱！

avatar AtomGit开源社区