繁
繁

LOCAL AGENT ONBOARDING

把 Actionway CLI
交給你的 Agent

複製下方第一段訊息給 Codex、Claude 或其他本機 Agent。Agent 會安裝 CLI、開啟瀏覽器授權，並在連線成功後提供簡短的 Quick Start。

選擇你的 Agent 查看能力目錄

WORKS WITH YOUR LOCAL AGENT

從你已經使用的 Agent 開始。

Codex 與 Claude 可以安裝 Actionway Skill；其他能執行本機命令、開啟瀏覽器的 Agent 也可以使用 CLI。

選擇你的本機 Agent手動選擇
Codex

讓 Codex 完成 CLI 與 Skill 安裝。

Skill 安裝位置~/.codex/skills/actionway
複製以下內容給 CodexREADY / COPY
Set up Actionway for Codex.

1. Confirm the host OS is macOS or Linux. If it differs, stop and ask me to copy the matching setup message from the website.
2. If your shell is sandboxed with network restrictions (e.g. the Claude Code sandbox), first allow `registry.npmjs.org`, `actionway.ai`, and `*.actionway.ai` — for Claude Code add them to `sandbox.network.allowedDomains` in settings. Blocked egress surfaces as a bare 403. Ask me before editing settings files.
3. Install by running `curl -fsSL https://actionway.ai/install.sh | sh`. The installer checks Node.js 20+ (installing the LTS if missing), installs the Actionway CLI, and runs its doctor check. Do not use `sudo` without my approval. If doctor reports failed checks, report them and stop; do not change npm registry, proxy, CA, PATH, or shell profile without my approval.
4. Run `actionway --agent-host=codex init --install-session-id=<install-session-id>`. For this Agent, keep the same `--agent-host` declaration immediately after `actionway` on every future Actionway command. Let me approve browser access; never ask me to paste credentials.
5. Read the `skill` block in the init output and use its local `source` path. Install it at `~/.codex/skills/actionway` so Codex can load it in future sessions.
6. Replace an existing destination only if it is an earlier Actionway Skill; otherwise ask me first.
7. Verify setup with `actionway --agent-host=codex whoami`, then give me three short examples from `actionway --agent-host=codex --help`.
  1. 01

    安裝 Actionway CLI

  2. 02

    在瀏覽器中完成安全登入

  3. 03

    將 Skill 安裝到 Codex 的 Skill 目錄

WHAT HAPPENS NEXT

你只需要核准瀏覽器授權。

  1. 01

    Agent 檢查 Node 與 npm

  2. 02

    安裝 Actionway CLI

  3. 03

    瀏覽器完成安全登入

  4. 04

    Agent 安裝 Skill 並回傳範例

YOUR FIRST TASK

連接完成後，直接描述目標。

Agent 會自行探索能力、讀取輸入要求與價格；真正執行前再向你確認。

EXAMPLE 01

“把這張圖片生成一段 10 秒影片，保持人物一致。”

EXAMPLE 02

“把這段文字生成自然的中文旁白。”

EXAMPLE 03

“轉錄這段影片並告訴我鏡頭切換發生在哪裡。”

MANUAL & TROUBLESHOOTING

需要時再手動安裝

預設由 Agent 完成以下步驟。只有 Agent 無法修改本機環境，或你需要除錯時，才手動執行。

01

1. 安裝 CLI

全域安裝 Actionway CLI。執行檔名稱為 actionway。

Windows: powershell -ExecutionPolicy Bypass -Command "irm https://actionway.ai/install.ps1 | iex"
macOS/Linux: curl -fsSL https://actionway.ai/install.sh | sh
02

2. 初始化 Actionway

init 會開啟瀏覽器授權頁，並把薄 Skill 準備到本機 ~/.actionway/skill 固定路徑。不要把 Token 或憑證貼到 Agent 對話中。

Windows: actionway.cmd doctor
         actionway.cmd init
macOS/Linux: actionway doctor
             actionway init
03

3. 驗證環境

確認身分與命令目錄可讀取。完成後可直接用自然語言向 Agent 提出需求。

Windows: actionway.cmd whoami
         actionway.cmd --help
macOS/Linux: actionway whoami
             actionway --help