How to use with OpenClaw

Connect OpenClaw to your Awaken account through its managed MCP registry, or install the Awaken skill.

Before you begin

Install and configure OpenClaw first. See the official OpenClaw documentation if you have not completed onboarding.

Awaken API access is currently in beta and requires a Dolphin or Whale plan. If the API Keys page says access is not enabled for your client, email beta@awaken.tax to request it.

Use a coding or messaging tool profile

OpenClaw exposes configured MCP tools in its normal coding and messaging profiles. The minimal profile hides them, and a tools deny rule for bundle-mcp disables them.

Create an API key

Keep the key private

Store the key in OpenClaw's global .env file, not directly in openclaw.json or a chat. If it is exposed, expired, or no longer needed, revoke it from Settings → API Keys and create a replacement.

1. Open API Keys

In the Awaken workspace you want to connect, open Settings → API Keys and select Create API Key.

2. Choose access

Give the key a recognizable name, choose Read for analysis or Read + Write only when OpenClaw should edit data, and optionally set an expiration.

3. Copy the secret and client ID

Copy the awaken_… secret when it appears; for security, it cannot be viewed again. Also copy the client ID shown on the API Keys page. The key is scoped to that client only.

Save the Awaken credentials

Add the API key and client ID to ~/.openclaw/.env. OpenClaw loads this global file and substitutes the variables into MCP header values.

OpenClaw secrets

# ~/.openclaw/.env
AWAKEN_API_KEY=YOUR_API_KEY
AWAKEN_CLIENT_ID=YOUR_CLIENT_ID

Add the Awaken MCP server

Register Awaken as a Streamable HTTP MCP server. The command stores the server under mcp.servers in OpenClaw's configuration.

OpenClaw MCP configuration

openclaw mcp set awaken \
  '{"url":"https://mcp.awaken.tax/mcp","transport":"streamable-http","headers":{"Authorization":"Bearer ${AWAKEN_API_KEY}","x-client-id":"${AWAKEN_CLIENT_ID}"}}'

Validate and reload

Run the doctor with a live probe to verify the saved definition and tool discovery, then reload OpenClaw's cached MCP runtimes.

Review

Show my largest taxable events this year and flag anything missing cost basis.

Clean up

Find my unreviewed transactions, explain the likely labels, and ask before changing anything.

Reports

Generate my Form 8949 report for 2025 and tell me when it is ready.

bash

openclaw mcp doctor awaken --probe
openclaw mcp reload

Prefer the Awaken skill?

How to use the Awaken skill

Install the complete Awaken skill bundle for guided API workflows without configuring MCP.

OpenClaw documentation

For configuration details and troubleshooting, see OpenClaw's official MCP CLI guide, environment variable guide, and skills configuration guide.