atools-tool

ATools CLI for OpenClaw:

• proxy compatibility for sub2api-style upstreams
• one-click installer
• interactive OpenClaw model config

Expected Usage

atools-tool <command>

Available command:

atools-tool openclaw

Interactive flow:

1. Check local proxy status (127.0.0.1:18888); if not running, ask whether to start it first
2. Select default model: gpt-5.2 / gpt-5.2-codex / gpt-5.5
3. Configure reasoning: off / on
4. Configure thinking strength: off|minimal|low|medium|high|xhigh
5. Input API key (leave empty to keep current key)

Selection UX:

• TTY terminal: use ↑/↓ and Enter
• Non-TTY: falls back to number input

If proxy startup fails during atools-tool openclaw, the CLI now prints environment-aware troubleshooting hints (systemd user bus, permissions, port readiness) and does not silently fail.

Rollback to codex-compatible defaults:

atools-tool openclaw

Recommended selections:

1. gpt-5.5
2. off
3. low
4. Input your ATools key (same as ATOOLS_OAI_KEY)

Install (npm)

npm i -g @autotask/atools-tool

Default full install (recommended):

npm i -g @autotask/atools-tool && atools-tool install-proxy && atools-tool openclaw

Optional installer command:

atools-tool install-proxy --help

atools-tool install-proxy service behavior by platform (legacy alias: atools-tool-install):

• Linux: systemd user service (fallback to detached process if systemctl --user is unavailable)
• macOS: launchd user agent (~/Library/LaunchAgents)
• Windows: Task Scheduler user task (ONLOGON + start now)

By default, installer does not hard-force a single outbound model. Proxy normalizes sub2api/<model> to plain model id for codex-compatible upstreams.

Proxy Command

atools-tool serve --port 18888 --upstream https://sub2api.atools.live

Repo Install

git clone https://github.com/aak1247/atools-tool.git
cd atools-tool
./install.sh

Bootstrap Install

For a fresh Linux/macOS/WSL machine without node, npm, codex, or claude, use the bootstrap script:

curl -fsSL https://raw.githubusercontent.com/aak1247/atools-tool/main/bootstrap-install.sh | bash

With an AutoTask API key:

curl -fsSL https://raw.githubusercontent.com/aak1247/atools-tool/main/bootstrap-install.sh | AUTOTASK_OAI_KEY=sk-xxx bash

What bootstrap installs/configures:

• Installs Node.js/npm to ~/.local/opt/nodejs if Node.js >=20 is not available
• Installs global npm CLIs to ~/.local: @autotask/atools-tool, @openai/codex, @anthropic-ai/claude-code
• Adds ~/.local/bin to shell startup files
• Runs atools-tool install to configure Codex, Claude Code, and OpenClaw

Windows PowerShell:

iwr https://raw.githubusercontent.com/aak1247/atools-tool/main/bootstrap-install.ps1 -UseB | iex

Windows installs Node.js to %LOCALAPPDATA%\AutoTask\nodejs when needed and npm global CLIs to %USERPROFILE%\.local.

Windows PowerShell with an AutoTask API key:

$env:AUTOTASK_OAI_KEY="sk-xxx"; iwr https://raw.githubusercontent.com/aak1247/atools-tool/main/bootstrap-install.ps1 -UseB | iex

Windows PowerShell with China mirrors:

$env:AUTOTASK_OAI_KEY="sk-xxx"
$p="$env:TEMP\bootstrap-install.ps1"
iwr https://raw.githubusercontent.com/aak1247/atools-tool/main/bootstrap-install.ps1 -UseB -OutFile $p
powershell -ExecutionPolicy Bypass -File $p -UseChinaMirror

atools-tool install configures:

• Codex ~/.codex/config.toml with model_provider=autotask and base_url=http://newapi.autotask.run/v1
• Codex ~/.codex/auth.json with OPENAI_API_KEY when an API key is provided
• Claude Code ~/.claude/settings.json with ANTHROPIC_BASE_URL=http://newapi.autotask.run
• OpenClaw config when ~/.openclaw/openclaw.json exists

Optional overrides:

curl -fsSL https://raw.githubusercontent.com/aak1247/atools-tool/main/bootstrap-install.sh | \
  AUTOTASK_BASE_URL=http://newapi.autotask.run NODE_MAJOR=22 INSTALL_CLAUDE=0 bash

Linux/macOS/WSL with China mirrors:

curl -fsSL https://raw.githubusercontent.com/aak1247/atools-tool/main/bootstrap-install.sh | \
  AUTOTASK_OAI_KEY=sk-xxx USE_CHINA_MIRROR=1 bash

What Installer Changes

• patches ~/.openclaw/openclaw.json
• patches ~/.openclaw/agents/main/agent/models.json
• patches ~/.openclaw/agents/main/agent/auth-profiles.json (if API key is available)
• service install by platform:
  • Linux: creates/enables ~/.config/systemd/user/openclaw-atools-proxy.service
    • if user bus/systemd is unavailable (for example container/root without login bus), installer auto-falls back to detached proxy process
  • macOS: creates/enables ~/Library/LaunchAgents/openclaw-atools-proxy.plist
  • Windows: creates/updates scheduled task openclaw-atools-proxy
• restarts openclaw-gateway.service only on Linux (unless --no-restart)

Default proxy log:

/tmp/openclaw/atools-compat-proxy.log

Uninstall

./scripts/uninstall.sh

License

MIT