← Back to Skills Marketplace
bobofrivia

Eyun Freight

by BobOfRivia · GitHub ↗ · v1.1.1 · MIT-0
cross-platform ✓ Security Clean
151
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install eyun-freight
Description
Query ocean freight rates and search shipping prices via the Eyun freight assistant
README (SKILL.md)

Eyun 运价助手

通过 Eyun 货运系统查询运价、搜索航运报价。

触发时机

  • 用户询问运价、海运/空运报价
  • 用户需要查询特定航线(如上海→洛杉矶)的运价
  • 用户需要解析或提取报价文本中的运价数据

盯价任务由 eyun_watch skill 处理,本 skill 不涉及。

步骤零:查询 Skill 配置

在执行任何操作前,必须先查询配置,获取接口地址和认证信息。

openclaw config get skills.entries.eyun_freight

从返回结果中读取所有配置项,后续步骤中的 EYUN_BASE_URLEYUN_COMPANY_ID 等值均来自此配置,禁止自行猜测或填充任何配置值


步骤一:调用接口

使用 exec 执行以下命令,将 EYUN_BASE_URLEYUN_COMPANY_ID 替换为步骤零读取到的实际值,\x3C用户的原始问题> 替换为经过 JSON 转义的用户原文:

curl -s -X POST "EYUN_BASE_URL/chat/sync" \
  -H "Content-Type: application/json" \
  -H "company-id: EYUN_COMPANY_ID" \
  -d "{\"message\": \"\x3C用户的原始问题>\", \"session_id\": null, \"source\": \"im\"}"

多轮会话

  • 第一轮:session_idnull,响应会返回 session_id
  • 后续轮次:将上一轮返回的 session_id 填入,保持对话上下文
  • 每轮均需传 "source": "im",确保运价结果以 Markdown 格式返回

响应格式

{
  "answer": "助手的文字回答",
  "session_id": "会话 ID",
  "blocks": []
}

步骤二:处理响应

  1. answer 字段内容原文转发给用户,不得删改、概括或重新表述
  2. 如果 blocks 不为空,将其作为结构化数据展示(如运价表格)
  3. 保存 session_id,下一轮继续传入以维持对话上下文

错误处理

  • HTTP 4xx:如实告知用户请求有误,不自行补充答案
  • HTTP 5xx:告知用户服务暂时不可用,建议稍后重试
  • 网络超时/无响应:告知用户连接失败,不用自己的知识填充运价

角色定位

远端 Eyun 系统是真正的运价助手,你是透明传话者。

用户感知不到你的存在——在用户眼中,他们始终在和"运价助手"对话。远端 Eyun 返回的 answer 就是运价助手说的话,你的职责是将其原文呈现给用户,不加任何自己的包装或旁白,不打断这个对话的连续性。

行为准则

  • 禁止任何旁白:不得输出"按照技能流程"、"正在调用接口"、"已读取技能指引"、"远端回复如下"等过程性或转述性文字;直接呈现远端内容,不做任何引导语
  • 禁止确认查询条件:收到用户问题后直接调用接口,不得先向用户展示解析结果并要求确认,没有"确认步骤"
  • 禁止替用户决定:不主动建议用户"应该选哪个运价"、"建议接受这个报价"等
  • 禁止创造内容:远端返回什么就展示什么,不补充、不推断、不捏造未返回的信息
  • 禁止代替回答:若远端返回错误或空结果,如实告知用户,不用自己的知识填充答案
  • 遇到歧义追问:信息不足时向用户提问,不自行假设后继续执行
Usage Guidance
This skill forwards the user's exact query to whatever EYUN_BASE_URL you configure and returns the remote service's response verbatim. Before installing, ensure EYUN_BASE_URL points to a trusted internal or vendor-managed endpoint (not an arbitrary public URL), and understand that any sensitive information you send will be transmitted to that endpoint. Verify the EYUN_COMPANY_ID value is appropriate for the intended account and that your OpenClaw config entry only contains values you expect. Be aware that the remote service controls the returned text (it could contain unexpected or malicious instructions), so limit use for sensitive data and prefer network/account isolation and monitoring when enabling this skill.
Capability Analysis
Type: OpenClaw Skill Name: eyun-freight Version: 1.1.1 The eyun-freight skill is a standard integration designed to query ocean freight rates from a remote API. It uses curl to send user queries to a configured EYUN_BASE_URL and returns the response to the user. The instructions in SKILL.md focus on maintaining a transparent proxy persona and correctly handling session IDs, with no evidence of data exfiltration, unauthorized execution, or malicious intent.
Capability Assessment
Purpose & Capability
Name/description, required binaries (curl), and required environment variables (EYUN_BASE_URL, EYUN_COMPANY_ID) align with a service that queries an external Eyun freight API. Requesting the skill's configured values via the OpenClaw config is coherent for locating the endpoint and company id.
Instruction Scope
Runtime instructions explicitly tell the agent to read the skill config and POST the user's raw question to EYUN_BASE_URL/chat/sync, then return the remote 'answer' verbatim. This stays within the stated purpose, but it means the agent will transmit the user's unmodified query to an external service and will surface whatever the remote service returns without local filtering or modification.
Install Mechanism
Instruction-only skill with no install spec and no code files — nothing is written to disk by an installer. This is the lowest-risk install model.
Credentials
Only EYUN_BASE_URL and EYUN_COMPANY_ID are required; both are directly relevant. EYUN_COMPANY_ID is declared primary. There are no unrelated secrets or extraneous environment variables requested.
Persistence & Privilege
Skill is not forced-always, does not request system-wide changes, and only reads its own skill config via 'openclaw config get'. It does not modify other skills or system-wide settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install eyun-freight
  3. After installation, invoke the skill by name or use /eyun-freight
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.1
eyun-freight 1.1.1 - No file changes detected in this release. - Skill behavior, usage, and documentation remain unchanged from the previous version.
v1.0.2
- Changed main environment variable from EYUN_WHALE_IDENTITY to EYUN_COMPANY_ID. - Updated all references, interface headers, and instructions to use EYUN_COMPANY_ID accordingly. - No changes to functionality or user-facing behavior.
v1.1.0
Summary: Clarifies usage instructions, updates handling of price watch tasks, and adds strict behavioral guidelines. - Removes price watch management from this skill; now handled by `eyun_watch`. - Requires fetching configuration dynamically before making API calls; hardcoding config values is prohibited. - Adds strict guidelines to forward Eyun system answers verbatim, without paraphrasing, commentary, or additional context. - Details exact error handling and response forwarding procedures. - Enhances behavioral rules to forbid any content creation, confirmation steps, or user guidance outside of remote system responses.
v0.1.0
eyun-freight 0.1.0 initial release - Enables querying ocean freight rates and searching shipping prices via Eyun Freight Assistant. - Supports management of price watch tasks, including creating reminders. - Handles both one-off and multi-turn conversations using a session mechanism. - Accepts user questions in natural language about shipping rates and logistics. - Returns structured responses, including direct answers and optional data blocks for rate tables.
Metadata
Slug eyun-freight
Version 1.1.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 4
Frequently Asked Questions

What is Eyun Freight?

Query ocean freight rates and search shipping prices via the Eyun freight assistant. It is an AI Agent Skill for Claude Code / OpenClaw, with 151 downloads so far.

How do I install Eyun Freight?

Run "/install eyun-freight" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Eyun Freight free?

Yes, Eyun Freight is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Eyun Freight support?

Eyun Freight is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Eyun Freight?

It is built and maintained by BobOfRivia (@bobofrivia); the current version is v1.1.1.

💬 Comments