TolingCode CLI

跨境电商私人 AI 助手 - 基于 OpenClaw 的本地化 AI 自动化工具

TolingCode Skills 完全兼容 OpenClaw，为跨境卖家提供订单履约、库存管理、产品刊登、广告管理、数据分析等核心业务能力。

准备工作

系统要求

在开始之前，请确保你的系统已安装以下工具：

| 工具 | 必需 | 用途 | |------|------|------| | Node.js | ✅ 必需 | 运行 tolingcode 和 OpenClaw | | npm | ✅ 必需 | 包管理工具（随 Node.js 安装） | | Git | ⚠️ 可选 | 代码版本管理（开发技能时需要） |

1. 安装 Node.js

Node.js 是运行 tolingcode 和 OpenClaw 的基础环境。

Windows

1. 访问官网：https://nodejs.org/
2. 下载 LTS 版本（推荐）
3. 运行安装程序，按提示安装
4. 验证安装：

   node --version
   npm --version

macOS

方法 1: 使用安装包

1. 访问官网：https://nodejs.org/
2. 下载 macOS 安装包 (.pkg)
3. 双击安装

方法 2: 使用 Homebrew

brew install node

Linux (Ubuntu/Debian)

# 使用 NodeSource 仓库安装 LTS 版本
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证安装
node --version
npm --version

Linux (CentOS/RHEL)

# 安装 Node.js LTS
curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo yum install -y nodejs

# 验证安装
node --version
npm --version

2. 安装 Git（可选）

Git 用于代码版本管理，开发自定义技能时需要。

Windows

1. 访问官网：https://git-scm.com/download/win
2. 下载安装程序
3. 运行安装，使用默认选项即可
4. 验证安装：

   git --version

macOS

方法 1: 使用 Xcode Command Line Tools

xcode-select --install

方法 2: 使用 Homebrew

brew install git

Linux (Ubuntu/Debian)

sudo apt-get update
sudo apt-get install -y git
git --version

Linux (CentOS/RHEL)

sudo yum install -y git
git --version

3. 验证环境

安装完成后，运行以下命令验证：

# 检查 Node.js 版本（需要 >= 16.0.0）
node --version

# 检查 npm 版本
npm --version

# 检查 Git（如果已安装）
git --version

预期输出示例:

node: v20.10.0
npm: 10.2.3
git: version 2.42.0

4. 常见问题

Q: 安装 Node.js 后找不到 npm？

A: npm 随 Node.js 一起安装，重新安装 Node.js 即可。

Q: Windows 上命令不识别？

A: 重启命令行窗口或重新打开终端。

Q: Linux/Mac 上权限问题？

A: 使用 sudo 或在 npm 命令后加 --unsafe-perm。

Q: 需要特定 Node.js 版本吗？

A: 推荐 Node.js 16.x 或更高版本（LTS 版本）。

快速开始

1. 安装 TolingCode

# 安装最新版本
npm install -g tolingcode@latest

2. 安装 OpenClaw

# 通过 tolingcode 安装 OpenClaw（推荐）
tolingcode install openclaw

# 安装指定版本
tolingcode install openclaw -v 2026.3.7

# 强制重新安装
tolingcode install openclaw --force

3. 启动 OpenClaw Gateway

openclaw gateway start

4. 安装技能

# 安装大健云仓技能（跨境电商 B2B）
tolingcode install skills gigacloud-warehouse

# 安装订单履约管理技能
tolingcode install skills order-fulfillment

# 安装远程 Linux 运维技能
tolingcode install skills hbj-ai-shell

跨平台支持

✅ 完全支持: Windows / Linux / macOS

路径说明

| 系统 | OpenClaw 工作目录 | 全局应用目录 | |------|------------------|-------------| | Windows | C:\Users\<用户名>\.openclaw\workspace | %APPDATA%\tolingcode\apps | | Linux | /home/<用户名>/.openclaw/workspace | ~/.local/tolingcode/apps | | macOS | /Users/<用户名>/.openclaw/workspace | ~/.local/tolingcode/apps |

自定义工作目录

# 通过环境变量自定义 OpenClaw 工作目录
# Windows
set OPENCLAW_WORKSPACE=D:\my-workspace

# Linux/Mac
export OPENCLAW_WORKSPACE=/path/to/my-workspace

# 然后安装技能
tolingcode install skills gigacloud-warehouse

系统要求

• Node.js: >= 16.0.0
• npm: >= 7.0.0
• OpenClaw: 自动安装（通过 tolingcode install openclaw）

命令参考

安装命令

# 安装 OpenClaw
tolingcode install openclaw

# 安装技能
tolingcode install skills <skill-name>

# 安装应用
tolingcode install apps <app-name>

# 指定版本安装
tolingcode install skills <skill-name> -v 2026.3.8

# 全局安装应用
tolingcode install apps <app-name> -g

# 强制重新安装 OpenClaw
tolingcode install openclaw --force

查看和搜索

# 列出所有可用包
tolingcode list

# 只列出技能
tolingcode list skills

# 只列出应用
tolingcode list apps

# 搜索技能
tolingcode search 电商
tolingcode search gigacloud
tolingcode search order

发布技能（开发者）

tolingcode publish ./my-skill \
  --type skills \
  --name my-skill \
  --version 2026.3.9

其他命令

# 查看使用示例
tolingcode examples

# 查看版本
tolingcode --version

# 查看帮助
tolingcode --help
tolingcode install --help

核心能力

电商平台技能

| 功能 | 描述 | |------|------| | 订单履约 | 自动处理订单发货 | | 智能备货 | AI 预测库存 | | 产品上架 | 自动发布商品 | | 价格管理 | 修改产品价格 | | 广告管理 | 自动调整广告 | | 数据分析 | 获取平台报告 |

海外仓技能

| 功能 | 描述 | |------|------| | 实时库存 | 获取仓库库存 | | 出入库单 | 查询入库/出库 | | 创建出库单 | 创建订单出库 | | LTL 出运 | 创建 LTL 运输单 | | 运费查询 | 获取物流费用 |

物流技能

• 物流报价、创建面单、物流跟踪
• 支持：FedEx、UPS、DHL、Amazon Logistics、ITTRACK

支持平台

电商平台: Amazon、eBay、AliExpress、Wish、Shopee、Lazada、Mercado Libre、Etsy、Wayfair、TikTok Shop 等

独立站: Shopify、WooCommerce、Magento、BigCommerce

零售平台: Walmart、Target、Costco、Best Buy 等

海外仓: 支持 100+ 海外仓系统 (中通国际、Walmart WFS、马士基、RMS 红鼠等)

版本规范

使用日期版本号：YYYY.M.D（无前导零）

示例：

• ✅ 2026.3.9
• ❌ 2026.03.09

私有 Registry

TolingCode 支持从私有 Registry 安装技能：

# 设置私有 Registry 地址
set TOLINGCODE_REGISTRY=http://your-registry.com/api/registry

# 安装技能
tolingcode install skills your-skill

部署私有 Registry

参考 server/registry.js 部署自己的技能注册中心。

环境变量

| 变量 | 默认值 | 说明 | |------|--------|------| | TOLINGCODE_REGISTRY | https://toling.me/api/registry | Registry 服务器地址 | | OPENCLAW_WORKSPACE | ~/.openclaw/workspace | OpenClaw 工作目录 |

相关链接

• Registry: https://toling.me
• GitHub: https://github.com/tolingcode/tolingcode
• OpenClaw: https://github.com/openclaw/openclaw
• OpenClaw 文档: https://docs.openclaw.ai
• 问题反馈: GitHub Issues

开发

# 克隆仓库
git clone https://github.com/tolingcode/tolingcode.git
cd tolingcode

# 安装依赖
npm install

# 本地测试
npm link

# 运行命令
tolingcode --help

更新日志

2026.3.21

• ✨ 新增：支持通过 tolingcode install openclaw 安装/更新 OpenClaw
• ✨ 新增：支持 --force 参数强制重装 OpenClaw
• ✨ 新增：支持 -v 参数指定 OpenClaw 版本
• 🎨 改进：统一命令入口，所有安装通过 tolingcode 管理
• 📝 改进：完善帮助信息和文档

作者: 韩宝军 (TolingCode)
License: MIT